Releases: rfernandezdo/inventariographdrawio
🚀 Azure Infrastructure Diagrams for Draw.io v2.0.0
🚀 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
- 📖 Setup Guide - Complete OIDC configuration
- 🔄 Migration Guide - Step-by-step migration from v1.x
- 💡 Examples - 15+ workflow examples
- 📋 Changelog - Complete change history
🎯 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?
- 🐛 Found a bug? Open an issue
- 💬 Have questions? Check our discussions
- 📚 Need examples? Browse our documentation
👏 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
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
- Setup Guide: SETUP_GITHUB_ACTION.md
- Complete Documentation: ACTION_README.md
- Usage Examples: EXAMPLES.md
- Workflow Templates: .github/workflows/
🔧 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!