[GitHub Discussions] Azure-specific documentation gaps #358
Description
Summary
Based on analysis of 820 GitHub discussions from dotnet/aspire.
Question counts:
| Topic | Questions |
|---|---|
| Azure (total) | 106 |
| Azure Container Apps | 30+ |
| Azure Functions | 15+ |
| Azure Storage | 10+ |
| Azure PostgreSQL | 10+ |
| RBAC/Permissions | 10+ |
Gaps in Existing Docs
1. ⚠️ Azure Container Apps Customization
Docs exist: Various ACA docs ✅ but limited customization guidance
Discussions:
- Deployment of single project on Azure Container Apps aspire#11600: Deployment of single project on Azure Container Apps
- Deploy container app with a custom domain aspire#10976: Deploy container app with a custom domain
- Aspire Dashboard return Error 404 on Azure aspire#9353: Aspire Dashboard return Error 404 on Azure
- Customization of Azure Container Apps on Npm Apps aspire#6400: Customization of Azure Container Apps on Npm Apps
What's missing:
- Custom domain configuration for ACA
- Selective resource deployment to ACA
- ACA customization for JavaScript apps
- Service discovery behavior on ACA (https+http)
2. ❌ Cross-Subscription Resources
Docs exist: None for cross-subscription patterns
Discussions:
- azd up - cross subscription resource aspire#13029: azd up - cross subscription resource
- Questions around deploying to existing resources aspire#9343: Questions around deploying to existing resources
What's needed:
- AsExisting from different subscriptions
- Multi-resource-group deployments
- Existing resource integration patterns
3. ⚠️ Azure Functions Deployment
Docs exist: azure-functions-integration ✅ but deployment gaps
Discussions:
- Cosmos DB & Azure Functions differences aspire#9829: Cosmos DB & Azure Functions differences
- How to deal with excessive logging from storage blob/queue triggers in Azure Functions? aspire#12503: Excessive logging from storage blob/queue triggers
- Azure Functions (isolated) project does not start via AddAzureFunctionsProject on macOS – no error, no output, port unavailable aspire#8375: Azure Functions does not start via AddAzureFunctionsProject on macOS
What's missing from azure-functions-integration:
- Worker runtime configuration for deployment
- Deployment prompts and pre-configuration
- KEDA scaling configuration
- macOS troubleshooting
4. ⚠️ RBAC/Permissions
Docs exist: manage-azure-role-assignments ✅ but deployment permissions unclear
Discussions:
- Transition to Azure RBAC aspire#14108: Transition to Azure RBAC
- Issue with AppConfig - Roles deployment aspire#12877: Issue with AppConfig - Roles deployment
- Aspire 9.4, CommunicationServices and removed AzureBicepResource.KnownParameters.PrincipalId? aspire#10819: AzureBicepResource.KnownParameters.PrincipalId removed
What's missing from manage-azure-role-assignments:
- Required Azure permissions for
aspire deploy - Troubleshooting permission errors
- Minimal RBAC requirements
- Breaking changes for RBAC (migration guide)
5. ⚠️ Azure Storage SAS Patterns
Docs exist: azure-blob-storage ✅ but SAS patterns missing
Discussions:
- Is it intended that the Azure Storage provider create containers like blobs? aspire#8402: Is it intended that the Azure Storage provider create containers like blobs?
- SAS URI questions (from Discord analysis)
What's missing from azure-blob-storage:
- SAS URI generation permissions
- User delegation vs account SAS
- Local vs deployed authentication differences
Data Source
- GitHub Discussions: 820 total
- Azure-related: 106 discussions
- Date range: Project inception - February 2026
- Verified against:
aspire-list_docs(38 Azure docs)