Skip to content

Releases: rfernandezdo/inventariographdrawio

🚀 Azure Infrastructure Diagrams for Draw.io v2.0.0

07 Aug 06:38

Choose a tag to compare

🚀 Azure Infrastructure Diagrams for Draw.io v2.0.0

🔄 BREAKING CHANGES - Migration to OIDC Authentication

Version 2.0.0 introduces enhanced security by migrating from service principal secrets to OIDC (OpenID Connect) authentication using azure/login@v2.

⚠️ Action Required for Existing Users

If you're upgrading from v1.x, you must migrate your workflows. See our Migration Guide for step-by-step instructions.

🆕 What's New in v2.0

🛡️ Enhanced Security

  • OIDC Authentication: Eliminates long-lived secrets and reduces attack surface
  • Automatic Token Rotation: Azure handles token lifecycle automatically
  • Azure Native: Uses Azure's recommended authentication method for GitHub Actions
  • Federated Credentials: Industry-standard security without managing secrets

🔧 Technical Improvements

  • Updated Azure CLI: Latest stable version for better compatibility
  • Simplified Schema: Cleaner input parameters (removed azure-credentials)
  • Better Error Handling: Clearer authentication error messages
  • Modern Standards: Follows GitHub Actions and Azure best practices

📋 Migration Summary

Before (v1.x)

- uses: rfernandezdo/inventariographdrawio@v1
  with:
    azure-credentials: ${{ secrets.AZURE_CREDENTIALS }}
    diagram-mode: 'all'

After (v2.0)

permissions:
  id-token: write  # Required for OIDC

steps:
  - name: Azure Login
    uses: azure/login@v2
    with:
      client-id: ${{ secrets.AZURE_CLIENT_ID }}
      tenant-id: ${{ secrets.AZURE_TENANT_ID }}
      subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}

  - name: Generate Diagrams
    uses: rfernandezdo/inventariographdrawio@v2
    with:
      diagram-mode: 'all'

🚀 Core Features (Unchanged)

Multiple Diagram Modes: Infrastructure, Components, Network, and All-in-one multi-page
Multi-Tenant Support: Filter by tenant or include all tenants
High Performance: Process 1000+ resources in under 2 seconds
Smart Filtering: Include/exclude specific resources, subscriptions, or management groups
Automated Workflows: Weekly reports, change detection, multi-environment documentation
Export Options: Both draw.io files and JSON exports for custom analysis
Official Azure Icons: Visual representation using Microsoft's official iconography

📖 Quick Start

name: Generate Azure Infrastructure Diagrams
on:
  workflow_dispatch:
  schedule:
    - cron: '0 6 * * 1'  # Weekly on Monday

permissions:
  id-token: write
  contents: write
  pull-requests: write

jobs:
  generate-diagrams:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Azure Login
        uses: azure/login@v2
        with:
          client-id: ${{ secrets.AZURE_CLIENT_ID }}
          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}

      - name: Generate Infrastructure Diagram
        uses: rfernandezdo/inventariographdrawio@v2
        with:
          diagram-mode: 'all'
          output-path: 'docs/azure-infrastructure.drawio'
          commit-changes: 'pr'

📚 Documentation

🎯 Why Upgrade?

  • 🔒 Better Security: OIDC is more secure than long-lived secrets
  • 🚀 Future-Proof: Aligns with Azure and GitHub best practices
  • 🔧 Easier Maintenance: No more secret rotation headaches
  • 📈 Better Compliance: Meets enterprise security requirements

🆘 Need Help?

👏 Thank You

Thank you to all users who have provided feedback and helped improve this action. Your input makes every release better!


Full Changelog: v1.0.0...v2.0.0


Azure Infrastructure Diagrams for Draw.io - v1.0.1

05 Aug 16:18

Choose a tag to compare

Azure Infrastructure Diagrams for Draw.io - v1.0.1

🎉 Initial release of Azure Infrastructure Diagrams as a GitHub Action!

🚀 Key Features

Automated Azure Infrastructure Diagrams

  • 4 Diagram Modes: Infrastructure (hierarchical), Components (grouped), Network (topology), All (multi-page)
  • Multi-Tenant Support: Filter by tenant or include all tenants
  • Advanced Filtering: Include/exclude specific resources, subscriptions, or management groups
  • High Performance: Handles 1000+ resources in under 2 seconds

GitHub Integration

  • Flexible Workflows: Push directly or create pull requests
  • Rich Outputs: Resource counts, tenant info, and file paths
  • Multiple Examples: 15+ ready-to-use workflow templates
  • Error Handling: Comprehensive diagnostics and troubleshooting

Enterprise Ready

  • Security: Minimal permissions (Reader role only)
  • Privacy: No external data transmission
  • Scalability: Proven with large Azure environments
  • Compliance: Perfect for audits and governance

🎯 Quick Start

- name: Generate Azure Infrastructure Diagram
  uses: rfernandezdo/inventariographdrawio@v1
  with:
    azure-credentials: ${{ secrets.AZURE_CREDENTIALS }}
    diagram-mode: 'all'
    commit-changes: 'pr'

📚 Documentation

🔧 What's Included

  • Complete GitHub Action with all inputs/outputs
  • 3 ready-to-use workflow examples
  • Comprehensive documentation and setup guides
  • Python CLI tool for local usage
  • Enterprise-grade performance and security

Perfect for infrastructure documentation, compliance reporting, and automated architecture analysis!