microsoft / microsoft/aspire.dev
[GitHub Discussions] Azure-specific documentation gaps
@IEvangelist is already working on this.
Since Jun 2, 2026.
- Dominant language
- MDX
- Stars
- 193
- Forks
- 87
- Avg merge
- 1d 22h
- Merged PRs (30d)
- 73
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:
- https://github.com/dotnet/aspire/discussions/11600: Deployment of single project on Azure Container Apps
- https://github.com/dotnet/aspire/discussions/10976: Deploy container app with a custom domain
- https://github.com/dotnet/aspire/discussions/9353: Aspire Dashboard return Error 404 on Azure
- https://github.com/dotnet/aspire/discussions/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:
- https://github.com/dotnet/aspire/discussions/13029: azd up - cross subscription resource
- https://github.com/dotnet/aspire/discussions/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:
- https://github.com/dotnet/aspire/discussions/9829: Cosmos DB & Azure Functions differences
- https://github.com/dotnet/aspire/discussions/12503: Excessive logging from storage blob/queue triggers
- https://github.com/dotnet/aspire/discussions/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:
- https://github.com/dotnet/aspire/discussions/14108: Transition to Azure RBAC
- https://github.com/dotnet/aspire/discussions/12877: Issue with AppConfig - Roles deployment
- https://github.com/dotnet/aspire/discussions/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:
- https://github.com/dotnet/aspire/discussions/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)
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.