Skip to content

Instantly share code, notes, and snippets.

@davidfowl

davidfowl/analysis-results.json

Created January 17, 2026 22:10
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save davidfowl/5e53cd9b4f020f9fce8b0d68855aa188 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save davidfowl/5e53cd9b4f020f9fce8b0d68855aa188 to your computer and use it in GitHub Desktop.
Download ZIP
Aspire Discussions Analysis - 100 Latest Discussions (2026-01-17)
Raw
analysis-results.json
This file has been truncated, but you can view the full file.
{
"analyzed_at": "2026-01-17T22:02:29.875944Z",
"scope": "200 most recent unanswered Q&A discussions",
"total_discussions": 200,
"unique_discussions": 172,
"duplicate_discussions": 28,
"discussions": [
{
"discussion_number": 13976,
"title": "Using Aspire with Azure API Management in an Azure Landing Zones architecture?",
"url": "https://github.com/dotnet/aspire/discussions/13976",
"category": "Q&A",
"author": "mikkelh-SDU",
"created_at": "2026-01-16T22:04:15Z",
"updated_at": "2026-01-17T19:56:41Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Using Aspire with Azure API Management in an Azure Landing Zones architecture?. Technologies involved: azure, nodejs. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-integrations",
"area-orchestrator",
"area-deployment",
"area-templates",
"area-azd"
],
"suggested_labels": [
"area-orchestrator",
"help wanted",
"area-azd",
"nodejs",
"area-templates",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"https",
"local"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"nodejs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Resource lifecycle",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Resource lifecycle' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Resource lifecycle",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13911,
13849,
13707,
13694,
13675,
13629,
13484,
13329,
13204,
13069
]
},
{
"discussion_number": 13911,
"title": "How to debug \"aspire publish\" and \"aspire deploy\"",
"url": "https://github.com/dotnet/aspire/discussions/13911",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2026-01-14T18:47:52Z",
"updated_at": "2026-01-17T19:57:41Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to debug \"aspire publish\" and \"aspire deploy\". This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-deployment",
"area-cli"
],
"suggested_labels": [
"area-cli",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"bug"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"debug",
"aspire deploy"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to debug \"aspire publish\" and \"aspire deploy\"",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13911:\n- **Discussion**: [How to debug \"aspire publish\" and \"aspire deploy\"](https://github.com/dotnet/aspire/discussions/13911)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to debug \"aspire publish\" and \"aspire deploy\"\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #13911 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069,
13022
]
},
{
"discussion_number": 13849,
"title": "Bicep parameters of types different than string",
"url": "https://github.com/dotnet/aspire/discussions/13849",
"category": "Q&A",
"author": "mhjit",
"created_at": "2026-01-12T08:31:50Z",
"updated_at": "2026-01-12T08:31:50Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Bicep parameters of types different than string. Technologies involved: azure, azure-storage. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-templates"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-templates",
"azure-storage",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"bicep",
"config",
"ui",
"cors",
"azure"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-storage"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Bicep parameters of types different than string",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13849:\n- **Discussion**: [Bicep parameters of types different than string](https://github.com/dotnet/aspire/discussions/13849)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Bicep parameters of types different than string\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs, Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #13849 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs",
"Section: Define your stack in code"
],
"detailed_response": "## Deploying Aspire to Azure Container Apps\n\n### Solution\n\nUse `azd` (Azure Developer CLI) for seamless deployment:\n\n### Step-by-Step Guide\n\n```bash\n# Initialize azd in your project\nazd init\n\n# Deploy to Azure\nazd up\n\n# For production, provision first\nazd provision\nazd deploy\n```\n\n### Code Example (AppHost Configuration)\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithExternalHttpEndpoints(); // Exposes publicly\n\n// Add Azure resources\nvar storage = builder.AddAzureStorage(\"storage\")\n .RunAsEmulator(); // Local dev only\n\nbuilder.Build().Run();\n```\n\n### Source Code Reference\n\nAzure provisioning: `src/Aspire.Hosting.Azure/Provisioning/`\nContainer Apps manifest: `src/Aspire.Hosting.Azure.ContainerApps/`\n\n### Infrastructure Configuration\n\n```csharp\n// Custom Azure configuration\nbuilder.AddAzureContainerApps(\"aca\")\n .ConfigureInfrastructure(infra =>\n {\n var env = infra.GetProvisionableResources()\n .OfType<ContainerAppEnvironment>()\n .Single();\n env.Properties.ZoneRedundant = true;\n });\n```\n\n### Common Pitfalls\n\n- **Secrets**: Use Azure Key Vault for production secrets\n- **Scaling**: Configure min/max replicas in production\n- **Networking**: Consider VNet integration for private resources\n\n### Additional Resources\n\n- Azure Container Apps documentation\n- azd templates for Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13707,
13694,
13675,
13629,
13329,
13204,
13069,
13022
]
},
{
"discussion_number": 13809,
"title": "Why aren't static resources served if the app is not in Development environment?",
"url": "https://github.com/dotnet/aspire/discussions/13809",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2026-01-08T18:54:55Z",
"updated_at": "2026-01-08T18:54:55Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Why aren't static resources served if the app is not in Development environment?. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"environment",
"ui",
"endpoint",
"development"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Why aren't static resources served if the app is not in Deve...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13809:\n- **Discussion**: [Why aren't static resources served if the app is not in Development environment?](https://github.com/dotnet/aspire/discussions/13809)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Why aren't static resources served if the app is not in Development environment?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #13809 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375,
9544
]
},
{
"discussion_number": 13790,
"title": "Pass in build arguments to projects",
"url": "https://github.com/dotnet/aspire/discussions/13790",
"category": "Q&A",
"author": "tobias-varden",
"created_at": "2026-01-07T13:19:28Z",
"updated_at": "2026-01-07T13:19:28Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Pass in build arguments to projects. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Pass build arguments",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Pass in build arguments to projects",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13790:\n- **Discussion**: [Pass in build arguments to projects](https://github.com/dotnet/aspire/discussions/13790)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Pass in build arguments to projects\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Pass build arguments, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #13790 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Pass build arguments' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Pass build arguments",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444,
9420
]
},
{
"discussion_number": 13707,
"title": "How to dynamically generate prometheus configuration",
"url": "https://github.com/dotnet/aspire/discussions/13707",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-12-26T16:54:24Z",
"updated_at": "2026-01-17T20:01:39Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to dynamically generate prometheus configuration. This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-telemetry"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"wrong"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"metrics",
"endpoint"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to dynamically generate prometheus configuration",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13707:\n- **Discussion**: [How to dynamically generate prometheus configuration](https://github.com/dotnet/aspire/discussions/13707)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to dynamically generate prometheus configuration\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #13707 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Configuring Prometheus with Aspire\n\n### Solution\n\nUse `WithContainerFiles` to dynamically generate Prometheus configuration with resolved endpoints:\n\n### Code Example\n\n```csharp\nvar prometheus = builder.AddContainer(\"prometheus\", \"prom/prometheus\")\n .WithHttpEndpoint(targetPort: 9090);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithHttpEndpoint(name: \"metrics\", port: 9090);\n\nprometheus.WithReference(api.GetEndpoint(\"metrics\"));\n\nprometheus.WithContainerFiles(\"/etc/prometheus\", async (ctx, ct) =>\n{\n var apiEndpoint = api.GetEndpoint(\"metrics\");\n \n var config = $\"\"\"\n global:\n scrape_interval: 15s\n \n scrape_configs:\n - job_name: 'api'\n metrics_path: '/metrics'\n static_configs:\n - targets: ['host.docker.internal:{apiEndpoint.Property(EndpointProperty.TargetPort)}']\n \"\"\";\n \n return [new ContainerFile { \n Name = \"prometheus.yml\", \n Contents = config \n }];\n});\n```\n\n### Source Code Reference\n\nContainer file generation: `src/Aspire.Hosting/Containers/ContainerResourceBuilderExtensions.cs`\nEndpoint resolution: `src/Aspire.Hosting/ApplicationModel/EndpointReference.cs`\n\n### Step-by-Step Guide\n\n1. **Add Prometheus container**: `AddContainer(\"prometheus\", \"prom/prometheus\")`\n2. **Create metrics endpoints**: `WithHttpEndpoint(name: \"metrics\", ...)`\n3. **Reference endpoints**: Use `WithReference` for networking\n4. **Generate config**: Use `WithContainerFiles` callback\n5. **Use endpoint properties**: Access `Port` or `Property(EndpointProperty.TargetPort)`\n\n### Common Pitfalls\n\n- **Callback timing**: Endpoint resolution happens at build time\n- **Container networking**: Use correct hostname (host.docker.internal vs container name)\n- **File permissions**: Set proper `UnixFileMode` for config files\n\n### Additional Resources\n\n- Aspire Dashboard for built-in metrics visualization\n- OpenTelemetry Prometheus exporter for .NET\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13694,
13675,
13629,
13329,
13204,
13069,
13022
]
},
{
"discussion_number": 13694,
"title": "Guidance required for Self-Hosting Aspire (.NET 10) on a Linux VPS",
"url": "https://github.com/dotnet/aspire/discussions/13694",
"category": "Q&A",
"author": "shefat2002",
"created_at": "2025-12-23T05:12:35Z",
"updated_at": "2025-12-23T15:17:44Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Guidance required for Self-Hosting Aspire (.NET 10) on a Linux VPS. This may indicate a potential issue or bug. Technologies involved: postgres, redis, kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-orchestrator",
"area-deployment",
"area-service-discovery",
"area-cli"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"azure",
"postgres",
"area-cli",
"azure-container-apps",
"blazor-wasm",
"kubernetes",
"docker-compose",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"area-deployment",
"redis"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"fails"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"sql",
"run"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"redis",
"kubernetes",
"docker-compose",
"azure",
"azure-container-apps",
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Guidance required for Self-Hosting Aspire (.NET 10) on a Lin...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13694:\n- **Discussion**: [Guidance required for Self-Hosting Aspire (.NET 10) on a Linux VPS](https://github.com/dotnet/aspire/discussions/13694)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Guidance required for Self-Hosting Aspire (.NET 10) on a Linux VPS\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: See also, Environment variables, [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #13694 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: Environment variables"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13675,
13629,
13329,
13227,
13204,
13069
]
},
{
"discussion_number": 13675,
"title": "Not able to run redis from Docker Desktop for an Aspire application",
"url": "https://github.com/dotnet/aspire/discussions/13675",
"category": "Q&A",
"author": "dipudivakaran79",
"created_at": "2025-12-21T18:50:12Z",
"updated_at": "2025-12-21T23:55:14Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Not able to run redis from Docker Desktop for an Aspire application. This may indicate a potential issue or bug. Technologies involved: redis, azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-telemetry"
],
"suggested_labels": [
"area-app-model",
"redis",
"azure",
"area-dashboard",
"area-integrations",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"failed",
"error_code"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"docker",
"config",
"ui",
"test",
"redis"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"redis",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs",
"Configure a persistent container"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Not able to run redis from Docker Desktop for an Aspire appl...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13675:\n- **Discussion**: [Not able to run redis from Docker Desktop for an Aspire application](https://github.com/dotnet/aspire/discussions/13675)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Not able to run redis from Docker Desktop for an Aspire application\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs, Configure a persistent container\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #13675 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance",
"See the 'Configure a persistent container' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs",
"Section: Configure a persistent container"
],
"detailed_response": "## Deploying Aspire to Azure Container Apps\n\n### Solution\n\nUse `azd` (Azure Developer CLI) for seamless deployment:\n\n### Step-by-Step Guide\n\n```bash\n# Initialize azd in your project\nazd init\n\n# Deploy to Azure\nazd up\n\n# For production, provision first\nazd provision\nazd deploy\n```\n\n### Code Example (AppHost Configuration)\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithExternalHttpEndpoints(); // Exposes publicly\n\n// Add Azure resources\nvar storage = builder.AddAzureStorage(\"storage\")\n .RunAsEmulator(); // Local dev only\n\nbuilder.Build().Run();\n```\n\n### Source Code Reference\n\nAzure provisioning: `src/Aspire.Hosting.Azure/Provisioning/`\nContainer Apps manifest: `src/Aspire.Hosting.Azure.ContainerApps/`\n\n### Infrastructure Configuration\n\n```csharp\n// Custom Azure configuration\nbuilder.AddAzureContainerApps(\"aca\")\n .ConfigureInfrastructure(infra =>\n {\n var env = infra.GetProvisionableResources()\n .OfType<ContainerAppEnvironment>()\n .Single();\n env.Properties.ZoneRedundant = true;\n });\n```\n\n### Common Pitfalls\n\n- **Secrets**: Use Azure Key Vault for production secrets\n- **Scaling**: Configure min/max replicas in production\n- **Networking**: Consider VNet integration for private resources\n\n### Additional Resources\n\n- Azure Container Apps documentation\n- azd templates for Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13629,
13329,
13227,
13204,
13069
]
},
{
"discussion_number": 13670,
"title": "Launching Desktop Applications",
"url": "https://github.com/dotnet/aspire/discussions/13670",
"category": "Q&A",
"author": "DuNuNuBatman",
"created_at": "2025-12-20T22:30:17Z",
"updated_at": "2025-12-20T22:30:17Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Launching Desktop Applications. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Host external executables in Aspire",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Host external executables in Aspire' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Host external executables in Aspire",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13790,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444,
9420
]
},
{
"discussion_number": 13629,
"title": "Aspire image complications in corporate Azure Virtual Desktop",
"url": "https://github.com/dotnet/aspire/discussions/13629",
"category": "Q&A",
"author": "AlexPrice17",
"created_at": "2025-12-18T09:39:25Z",
"updated_at": "2025-12-19T17:53:52Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire image complications in corporate Azure Virtual Desktop. This may indicate a potential issue or bug. Technologies involved: docker-compose, azure, azure-servicebus. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"good first issue",
"area-tooling",
"azure-eventhubs",
"area-templates",
"azure-servicebus",
"docker-compose",
"azure",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"docker",
"config",
"ui",
"test",
"servicebus"
],
"is_question": true,
"question_type": "how-to",
"complexity": "basic",
"technologies_mentioned": [
"docker-compose",
"azure",
"azure-servicebus",
"azure-eventhubs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Azure Service Bus queue",
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire image complications in corporate Azure Virtual Deskto...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13629:\n- **Discussion**: [Aspire image complications in corporate Azure Virtual Desktop](https://github.com/dotnet/aspire/discussions/13629)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire image complications in corporate Azure Virtual Desktop\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add Azure Service Bus queue, \u2014 AppHost.cs\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #13629 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Azure Service Bus queue' section for guidance",
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Azure Service Bus queue",
"Section: \u2014 AppHost.cs"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13329,
13204,
13069,
13022
]
},
{
"discussion_number": 13484,
"title": "Testing from JavaScript",
"url": "https://github.com/dotnet/aspire/discussions/13484",
"category": "Q&A",
"author": "parched",
"created_at": "2025-12-11T00:30:42Z",
"updated_at": "2025-12-13T10:18:52Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Testing from JavaScript. Technologies involved: nodejs. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"nodejs",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard",
"test",
"endpoint",
"run",
"node"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"nodejs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13790,
13670,
12509,
12227,
11970,
11212,
10910,
10455,
9828
]
},
{
"discussion_number": 13329,
"title": "Postgres Development / Production (Helm)",
"url": "https://github.com/dotnet/aspire/discussions/13329",
"category": "Q&A",
"author": "RyanMnM",
"created_at": "2025-12-04T11:49:19Z",
"updated_at": "2025-12-04T11:49:19Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Postgres Development / Production (Helm). Technologies involved: postgres, kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"postgres",
"kubernetes",
"area-service-discovery",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"test",
"postgres"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"kubernetes"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: Define your stack in code"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13227,
13204,
13069
]
},
{
"discussion_number": 13227,
"title": "Use AddRedisClient with ServiceProvider",
"url": "https://github.com/dotnet/aspire/discussions/13227",
"category": "Q&A",
"author": "EliveltonRepolho",
"created_at": "2025-11-27T22:34:19Z",
"updated_at": "2025-11-28T00:04:40Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Use AddRedisClient with ServiceProvider. Technologies involved: postgres, redis. Topic relates to configuration.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-orchestrator",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"help wanted",
"good first issue",
"area-tooling",
"postgres",
"area-cli",
"documentation",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"redis"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"ui",
"database",
"aws"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": [
"postgres",
"redis"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Aspire i",
"\u2014 Program.cs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Use AddRedisClient with ServiceProvider",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13227:\n- **Discussion**: [Use AddRedisClient with ServiceProvider](https://github.com/dotnet/aspire/discussions/13227)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Use AddRedisClient with ServiceProvider\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Aspire i, \u2014 Program.cs\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #13227 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Aspire i' section for guidance",
"See the '\u2014 Program.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Aspire i",
"Section: \u2014 Program.cs"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13694,
13675,
13329,
13069,
12906,
12484,
12338,
12114,
11885
]
},
{
"discussion_number": 13204,
"title": "Service Discovery: How to Resolve It?",
"url": "https://github.com/dotnet/aspire/discussions/13204",
"category": "Q&A",
"author": "thuptit",
"created_at": "2025-11-26T10:11:21Z",
"updated_at": "2025-12-03T01:07:37Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to service discovery: resolve it?. This may indicate a potential issue or bug. Technologies involved: docker-compose, azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-service-discovery",
"area-cli"
],
"suggested_labels": [
"azure",
"area-cli",
"azure-container-apps",
"docker-compose",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"docker",
"environment",
"ui",
"aca"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"docker-compose",
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: [Flexible deployments](#local-first-production-ready)"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13069,
13022
]
},
{
"discussion_number": 13069,
"title": "postgres table exists but it is throwing table not exists error.",
"url": "https://github.com/dotnet/aspire/discussions/13069",
"category": "Q&A",
"author": "RedEye-Developers",
"created_at": "2025-11-20T14:05:49Z",
"updated_at": "2025-11-20T14:45:51Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about postgres table exists but it is throwing table not exists error.. This appears to report an error or unexpected behavior. Technologies involved: postgres. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"postgres",
"area-cli",
"area-service-discovery",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"issue",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"container",
"config",
"console",
"database",
"endpoint"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"postgres"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add PostgreSQL client"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] postgres table exists but it is throwing table not exists er...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #13069:\n- **Discussion**: [postgres table exists but it is throwing table not exists error.](https://github.com/dotnet/aspire/discussions/13069)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: postgres table exists but it is throwing table not exists error.\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add PostgreSQL client\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #13069 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Add PostgreSQL client' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add PostgreSQL client"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 13022,
"title": "Aspire.Hosting.JavaScript WithLifetime",
"url": "https://github.com/dotnet/aspire/discussions/13022",
"category": "Q&A",
"author": "stefannikolei",
"created_at": "2025-11-18T07:46:22Z",
"updated_at": "2025-11-18T07:53:57Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire.Hosting.JavaScript WithLifetime. Technologies involved: sqlserver. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"help wanted",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"ui",
"database",
"inner loop",
"iresource"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"sqlserver"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Project resource type",
"Configure a persistent container",
"Custom resources",
"Aspire",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Project resource type' section for guidance",
"See the 'Configure a persistent container' section for guidance",
"See the 'Custom resources' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Project resource type",
"Section: Configure a persistent container"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 12983,
"title": "CancellationToken is automatically triggered after ~30 seconds in Debug mode",
"url": "https://github.com/dotnet/aspire/discussions/12983",
"category": "Q&A",
"author": "sharpzilla",
"created_at": "2025-11-16T06:45:19Z",
"updated_at": "2025-11-16T06:45:20Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about CancellationToken is automatically triggered after ~30 seconds in Debug mode. This may indicate a potential issue or bug. Technologies involved: rabbitmq. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-deployment",
"area-tooling"
],
"suggested_labels": [
"area-tooling",
"area-deployment",
"rabbitmq"
],
"is_potential_issue": true,
"issue_indicators": [
"bug",
"problem"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"publish",
"config",
"rabbitmq",
"debug"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"rabbitmq"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] CancellationToken is automatically triggered after ~30 secon...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12983:\n- **Discussion**: [CancellationToken is automatically triggered after ~30 seconds in Debug mode](https://github.com/dotnet/aspire/discussions/12983)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: CancellationToken is automatically triggered after ~30 seconds in Debug mode\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #12983 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Define your stack in code",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 12906,
"title": "Ability to restore a backup to a postgres container?",
"url": "https://github.com/dotnet/aspire/discussions/12906",
"category": "Q&A",
"author": "brendonparker",
"created_at": "2025-11-11T19:53:49Z",
"updated_at": "2025-11-12T07:25:34Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Ability to restore a backup to a postgres container?. Technologies involved: postgres. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"postgres",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"ui",
"test",
"database",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Configure a persistent container"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Ability to restore a backup to a postgres container?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12906:\n- **Discussion**: [Ability to restore a backup to a postgres container?](https://github.com/dotnet/aspire/discussions/12906)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Ability to restore a backup to a postgres container?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Configure a persistent container\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #12906 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Configure a persistent container' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Configure a persistent container"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 12561,
"title": "Allow running and debugging a Linux-only project on aspire",
"url": "https://github.com/dotnet/aspire/discussions/12561",
"category": "Q&A",
"author": "TiagoMoscoso",
"created_at": "2025-10-31T14:15:51Z",
"updated_at": "2025-10-31T18:18:43Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Allow running and debugging a Linux-only project on aspire. This may indicate a potential issue or bug. Technologies involved: wsl, vs. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"wsl",
"good first issue",
"area-tooling",
"vs",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"bug"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"docker",
"environment",
"ui",
"port",
"debug"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "basic",
"technologies_mentioned": [
"wsl",
"vs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Allow running and debugging a Linux-only project on aspire",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12561:\n- **Discussion**: [Allow running and debugging a Linux-only project on aspire](https://github.com/dotnet/aspire/discussions/12561)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Allow running and debugging a Linux-only project on aspire\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Flexible deployments](#local-first-production-ready), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #12561 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Flexible deployments](#local-first-production-ready)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 12518,
"title": "Why are Aspire projects taking so long to be restored? It's more than 2 mins every single time.",
"url": "https://github.com/dotnet/aspire/discussions/12518",
"category": "Q&A",
"author": "egvijayanand",
"created_at": "2025-10-30T09:54:37Z",
"updated_at": "2025-10-31T02:43:09Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Why are Aspire projects taking so long to be restored? It's more than 2 mins eve. Topic relates to general.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "general",
"subtopics": [],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Why are Aspire projects taking so long to be restored? It's ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12518:\n- **Discussion**: [Why are Aspire projects taking so long to be restored? It's more than 2 mins every single time.](https://github.com/dotnet/aspire/discussions/12518)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Why are Aspire projects taking so long to be restored? It's more than 2 mins every single time.\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of general in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"general"
],
"priority": "high",
"rationale": "Discussion #12518 reveals documentation gap for general"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about general may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
11660,
11382,
9374,
9355,
7536
]
},
{
"discussion_number": 12509,
"title": "Aspire and running multiple git worktree at once",
"url": "https://github.com/dotnet/aspire/discussions/12509",
"category": "Q&A",
"author": "andrew-vdb",
"created_at": "2025-10-30T03:22:03Z",
"updated_at": "2025-10-30T19:40:21Z",
"state": "closed",
"comments_count": 5,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire and running multiple git worktree at once. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-service-discovery"
],
"suggested_labels": [
"area-service-discovery",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire and running multiple git worktree at once",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12509:\n- **Discussion**: [Aspire and running multiple git worktree at once](https://github.com/dotnet/aspire/discussions/12509)\n- **Category**: Q&A\n- **Comments**: 5\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire and running multiple git worktree at once\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 5) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #12509 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13790,
13670,
13484,
12227,
11970,
10910,
10455,
9828,
9444,
9420
]
},
{
"discussion_number": 12484,
"title": "Overriding Kestrel endpoints from appsettings.json?",
"url": "https://github.com/dotnet/aspire/discussions/12484",
"category": "Q&A",
"author": "CharlieDigital",
"created_at": "2025-10-29T13:06:30Z",
"updated_at": "2025-10-29T13:06:31Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Overriding Kestrel endpoints from appsettings.json?. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-tooling",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"endpoint",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Resource replicas",
"Environment variables",
"Define your stack in code",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Resource replicas' section for guidance",
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Resource replicas",
"Section: Environment variables"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
12338,
12114,
11885,
10765,
10682,
10418,
10375,
9544
]
},
{
"discussion_number": 12354,
"title": ".Net Aspire Single Service Nvim Debugging",
"url": "https://github.com/dotnet/aspire/discussions/12354",
"category": "Q&A",
"author": "MicheleGiuliettiDev",
"created_at": "2025-10-24T21:38:03Z",
"updated_at": "2025-10-24T21:47:54Z",
"state": "closed",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about .Net Aspire Single Service Nvim Debugging. This may indicate a potential issue or bug. Topic relates to local-dev.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-tooling"
],
"suggested_labels": [
"area-tooling"
],
"is_potential_issue": true,
"issue_indicators": [
"bug"
],
"severity": "medium",
"topic": "local-dev",
"subtopics": [
"local"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] .Net Aspire Single Service Nvim Debugging",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12354:\n- **Discussion**: [.Net Aspire Single Service Nvim Debugging](https://github.com/dotnet/aspire/discussions/12354)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: .Net Aspire Single Service Nvim Debugging\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of local-dev in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"local-dev"
],
"priority": "medium",
"rationale": "Discussion #12354 reveals documentation gap for local-dev"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about local-dev is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
5822
]
},
{
"discussion_number": 12338,
"title": "OpenTelemetry OTLP exporter failures are silently swallowed in Aspire default setup",
"url": "https://github.com/dotnet/aspire/discussions/12338",
"category": "Q&A",
"author": "nilsmagnuseriksson",
"created_at": "2025-10-24T06:10:45Z",
"updated_at": "2025-10-24T15:07:21Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about OpenTelemetry OTLP exporter failures are silently swallowed in Aspire default se. This appears to report an error or unexpected behavior. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-service-discovery",
"area-telemetry"
],
"suggested_labels": [
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"fails",
"bug",
"issue"
],
"severity": "high",
"topic": "configuration",
"subtopics": [
"config",
"dashboard",
"message",
"telemetry",
"endpoint"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] OpenTelemetry OTLP exporter failures are silently swallowed ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12338:\n- **Discussion**: [OpenTelemetry OTLP exporter failures are silently swallowed in Aspire default setup](https://github.com/dotnet/aspire/discussions/12338)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: OpenTelemetry OTLP exporter failures are silently swallowed in Aspire default setup\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #12338 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
12484,
12114,
11885,
10765,
10682,
10418,
10375,
9544
]
},
{
"discussion_number": 12227,
"title": "Hidden resources",
"url": "https://github.com/dotnet/aspire/discussions/12227",
"category": "Q&A",
"author": "Plasmadog",
"created_at": "2025-10-20T21:17:05Z",
"updated_at": "2025-10-20T21:17:05Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Hidden resources. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Hidden resources",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12227:\n- **Discussion**: [Hidden resources](https://github.com/dotnet/aspire/discussions/12227)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Hidden resources\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #12227 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13790,
13670,
13484,
12509,
11970,
10910,
10455,
9828,
9444,
9420
]
},
{
"discussion_number": 12204,
"title": "How to run Aspire in a .NET SDK container without docker client?",
"url": "https://github.com/dotnet/aspire/discussions/12204",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-10-20T16:42:31Z",
"updated_at": "2025-10-21T14:50:56Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to run aspire in a .net sdk container without docker client?. This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-cli"
],
"suggested_labels": [
"area-orchestrator",
"area-app-model",
"area-dashboard",
"area-cli"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"failed",
"bug",
"wrong",
"stack_trace",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"docker",
"ui",
"test",
"db",
"port"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to run Aspire in a .NET SDK container without docker cli...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12204:\n- **Discussion**: [How to run Aspire in a .NET SDK container without docker client?](https://github.com/dotnet/aspire/discussions/12204)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to run Aspire in a .NET SDK container without docker client?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #12204 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 12114,
"title": "Database-per-tenant multi-tenancy with Aspire",
"url": "https://github.com/dotnet/aspire/discussions/12114",
"category": "Q&A",
"author": "jmezach",
"created_at": "2025-10-17T07:54:26Z",
"updated_at": "2025-10-21T07:58:37Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Database-per-tenant multi-tenancy with Aspire. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"ui",
"database",
"entra",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Database-per-tenant multi-tenancy with Aspire",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #12114:\n- **Discussion**: [Database-per-tenant multi-tenancy with Aspire](https://github.com/dotnet/aspire/discussions/12114)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Database-per-tenant multi-tenancy with Aspire\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "high",
"rationale": "Discussion #12114 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
12484,
12338,
11885,
10765,
10682,
10418,
10375,
9544
]
},
{
"discussion_number": 11970,
"title": "How to cancel an HTTP command when input is cancelled?",
"url": "https://github.com/dotnet/aspire/discussions/11970",
"category": "Q&A",
"author": "Kralizek",
"created_at": "2025-10-12T16:15:30Z",
"updated_at": "2025-10-12T16:15:31Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to cancel an http command when input is cancelled?. This may indicate a potential issue or bug. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"area-tooling"
],
"is_potential_issue": true,
"issue_indicators": [
"bug"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"dashboard",
"test",
"message",
"endpoint",
"debug"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Custom HTTP commands",
"Environment variables",
"Custom resources"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Custom HTTP commands' section for guidance",
"See the 'Environment variables' section for guidance",
"See the 'Custom resources' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Custom HTTP commands",
"Section: Environment variables"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
10910,
10455,
9828,
9444,
9420
]
},
{
"discussion_number": 11940,
"title": "Docker Compose: Add restart policy to all compute resources",
"url": "https://github.com/dotnet/aspire/discussions/11940",
"category": "Q&A",
"author": "lvde0",
"created_at": "2025-10-10T06:49:38Z",
"updated_at": "2025-10-10T07:15:26Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Docker Compose: Add restart policy to all compute resources. Technologies involved: docker-compose. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"docker-compose",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"publish",
"environment",
"ui",
"docker"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"docker-compose"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: [Flexible deployments](#local-first-production-ready)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 11885,
"title": "Service-Default Http and Grpc Instrumentation Doubt.",
"url": "https://github.com/dotnet/aspire/discussions/11885",
"category": "Q&A",
"author": "RedEye-Developers",
"created_at": "2025-10-07T14:33:03Z",
"updated_at": "2025-10-07T14:34:16Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Service-Default Http and Grpc Instrumentation Doubt.. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-telemetry",
"area-cli"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"good first issue",
"area-cli",
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"ui",
"message",
"telemetry",
"endpoint"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Service-Default Http and Grpc Instrumentation Doubt.",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #11885:\n- **Discussion**: [Service-Default Http and Grpc Instrumentation Doubt.](https://github.com/dotnet/aspire/discussions/11885)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Service-Default Http and Grpc Instrumentation Doubt.\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "high",
"rationale": "Discussion #11885 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Configuring Prometheus with Aspire\n\n### Solution\n\nUse `WithContainerFiles` to dynamically generate Prometheus configuration with resolved endpoints:\n\n### Code Example\n\n```csharp\nvar prometheus = builder.AddContainer(\"prometheus\", \"prom/prometheus\")\n .WithHttpEndpoint(targetPort: 9090);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithHttpEndpoint(name: \"metrics\", port: 9090);\n\nprometheus.WithReference(api.GetEndpoint(\"metrics\"));\n\nprometheus.WithContainerFiles(\"/etc/prometheus\", async (ctx, ct) =>\n{\n var apiEndpoint = api.GetEndpoint(\"metrics\");\n \n var config = $\"\"\"\n global:\n scrape_interval: 15s\n \n scrape_configs:\n - job_name: 'api'\n metrics_path: '/metrics'\n static_configs:\n - targets: ['host.docker.internal:{apiEndpoint.Property(EndpointProperty.TargetPort)}']\n \"\"\";\n \n return [new ContainerFile { \n Name = \"prometheus.yml\", \n Contents = config \n }];\n});\n```\n\n### Source Code Reference\n\nContainer file generation: `src/Aspire.Hosting/Containers/ContainerResourceBuilderExtensions.cs`\nEndpoint resolution: `src/Aspire.Hosting/ApplicationModel/EndpointReference.cs`\n\n### Step-by-Step Guide\n\n1. **Add Prometheus container**: `AddContainer(\"prometheus\", \"prom/prometheus\")`\n2. **Create metrics endpoints**: `WithHttpEndpoint(name: \"metrics\", ...)`\n3. **Reference endpoints**: Use `WithReference` for networking\n4. **Generate config**: Use `WithContainerFiles` callback\n5. **Use endpoint properties**: Access `Port` or `Property(EndpointProperty.TargetPort)`\n\n### Common Pitfalls\n\n- **Callback timing**: Endpoint resolution happens at build time\n- **Container networking**: Use correct hostname (host.docker.internal vs container name)\n- **File permissions**: Set proper `UnixFileMode` for config files\n\n### Additional Resources\n\n- Aspire Dashboard for built-in metrics visualization\n- OpenTelemetry Prometheus exporter for .NET\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
10765,
10682,
10418,
10375,
9544
]
},
{
"discussion_number": 11774,
"title": "Azure ContainerApps Auth (6104ad52-755e-428b-9fb5-5fdf4d2c4d53) does not include https://spaincentral.ext.azurecontainerapps.dev/sso",
"url": "https://github.com/dotnet/aspire/discussions/11774",
"category": "Q&A",
"author": "apb-aursel",
"created_at": "2025-10-01T12:43:16Z",
"updated_at": "2025-10-01T12:43:17Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Azure ContainerApps Auth (6104ad52-755e-428b-9fb5-5fdf4d2c4d53) does not include. Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-deployment"
],
"suggested_labels": [
"help wanted",
"azure-container-apps",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"dashboard",
"auth",
"https",
"azure"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Azure ContainerApps Auth (6104ad52-755e-428b-9fb5-5fdf4d2c4d...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #11774:\n- **Discussion**: [Azure ContainerApps Auth (6104ad52-755e-428b-9fb5-5fdf4d2c4d53) does not include https://spaincentral.ext.azurecontainerapps.dev/sso](https://github.com/dotnet/aspire/discussions/11774)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Azure ContainerApps Auth (6104ad52-755e-428b-9fb5-5fdf4d2c4d53) does not include https://spaincentral.ext.azurecontainerapps.dev/sso\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #11774 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 11660,
"title": "Any WaitforSucessfulCompletion method?",
"url": "https://github.com/dotnet/aspire/discussions/11660",
"category": "Q&A",
"author": "xaviergxf",
"created_at": "2025-09-25T09:26:03Z",
"updated_at": "2025-09-29T07:17:02Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Any WaitforSucessfulCompletion method?. Topic relates to general.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "general",
"subtopics": [],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Any WaitforSucessfulCompletion method?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #11660:\n- **Discussion**: [Any WaitforSucessfulCompletion method?](https://github.com/dotnet/aspire/discussions/11660)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Any WaitforSucessfulCompletion method?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of general in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"general"
],
"priority": "high",
"rationale": "Discussion #11660 reveals documentation gap for general"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about general may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
12518,
11382,
9374,
9355,
7536
]
},
{
"discussion_number": 11427,
"title": "Apple Container support?",
"url": "https://github.com/dotnet/aspire/discussions/11427",
"category": "Q&A",
"author": "quoctuancqt",
"created_at": "2025-09-16T08:00:43Z",
"updated_at": "2025-09-23T13:58:45Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Apple Container support?. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"port",
"run",
"container"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Apple Container support?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #11427:\n- **Discussion**: [Apple Container support?](https://github.com/dotnet/aspire/discussions/11427)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Apple Container support?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Code-centric control](#define-your-stack-in-code), Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #11427 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 11382,
"title": "What's the idiomatic way to duplicate resources?",
"url": "https://github.com/dotnet/aspire/discussions/11382",
"category": "Q&A",
"author": "KennethHoff",
"created_at": "2025-09-13T09:12:27Z",
"updated_at": "2025-09-14T02:11:21Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about What's the idiomatic way to duplicate resources?. Topic relates to general.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "general",
"subtopics": [],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] What's the idiomatic way to duplicate resources?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #11382:\n- **Discussion**: [What's the idiomatic way to duplicate resources?](https://github.com/dotnet/aspire/discussions/11382)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: What's the idiomatic way to duplicate resources?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of general in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"general"
],
"priority": "high",
"rationale": "Discussion #11382 reveals documentation gap for general"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about general may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
12518,
11660,
9374,
9355,
7536
]
},
{
"discussion_number": 11212,
"title": "How to debug a resource failing to start?",
"url": "https://github.com/dotnet/aspire/discussions/11212",
"category": "Q&A",
"author": "impworks",
"created_at": "2025-09-02T10:30:10Z",
"updated_at": "2025-09-02T10:30:10Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to debug a resource failing to start?. This may indicate a potential issue or bug. Technologies involved: postgres, redis, rabbitmq. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-orchestrator",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"azure",
"rabbitmq",
"wsl",
"area-tooling",
"postgres",
"area-cli",
"redis",
"nodejs",
"vs",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"failed",
"failing",
"bug",
"wrong"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"docker",
"ui",
"test",
"database",
"rabbitmq"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"redis",
"rabbitmq",
"azure",
"nodejs",
"wsl",
"vs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to debug a resource failing to start?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #11212:\n- **Discussion**: [How to debug a resource failing to start?](https://github.com/dotnet/aspire/discussions/11212)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to debug a resource failing to start?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Observability from the start](#opentelemetry-developer-dashboard), Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #11212 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13484,
13329,
13227
]
},
{
"discussion_number": 11173,
"title": "Getting token from console",
"url": "https://github.com/dotnet/aspire/discussions/11173",
"category": "Q&A",
"author": "olimovalisher",
"created_at": "2025-08-29T10:45:38Z",
"updated_at": "2025-08-29T15:20:26Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Getting token from console. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-deployment"
],
"suggested_labels": [
"area-dashboard",
"area-deployment",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"publish",
"environment",
"console"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Flexible deployments](#local-first-production-ready)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Getting token from console",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #11173:\n- **Discussion**: [Getting token from console](https://github.com/dotnet/aspire/discussions/11173)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Getting token from console\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Flexible deployments](#local-first-production-ready)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #11173 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Flexible deployments](#local-first-production-ready)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 11012,
"title": "Get information from running Aspire Hosts",
"url": "https://github.com/dotnet/aspire/discussions/11012",
"category": "Q&A",
"author": "vandenbergjp",
"created_at": "2025-08-19T20:00:39Z",
"updated_at": "2025-08-21T04:00:43Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 13484,
"duplicate_reason": "Title similarity: 44%, Keyword overlap: 6%, Topic overlap: 75%",
"plain_text_analysis": "User is seeking guidance about Get information from running Aspire Hosts. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-service-discovery",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"area-templates",
"area-service-discovery",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"test",
"endpoint"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Configure a persistent container",
"Environment variables",
"Aspire",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Configure a persistent container' section for guidance",
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Configure a persistent container",
"Section: Environment variables"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10976,
"title": "Deploy container app with a custom domain",
"url": "https://github.com/dotnet/aspire/discussions/10976",
"category": "Q&A",
"author": "smirkingsquiggly",
"created_at": "2025-08-15T12:14:38Z",
"updated_at": "2025-08-17T14:25:06Z",
"state": "closed",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Deploy container app with a custom domain. This may indicate a potential issue or bug. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-deployment",
"area-azd"
],
"suggested_labels": [
"area-azd",
"area-deployment",
"azure"
],
"is_potential_issue": true,
"issue_indicators": [
"error"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"message",
"port",
"azure",
"container"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Deploy container app with a custom domain",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10976:\n- **Discussion**: [Deploy container app with a custom domain](https://github.com/dotnet/aspire/discussions/10976)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Deploy container app with a custom domain\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Code-centric control](#define-your-stack-in-code), Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #10976 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10927,
"title": "Aspire Publishing Pipeline - Deploy to Azure from on-premises Devops Server",
"url": "https://github.com/dotnet/aspire/discussions/10927",
"category": "Q&A",
"author": "ekomsctr",
"created_at": "2025-08-12T13:58:32Z",
"updated_at": "2025-09-10T17:05:33Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire Publishing Pipeline - Deploy to Azure from on-premises Devops Server. Technologies involved: azure, azure-container-apps, vs. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-deployment",
"area-cli",
"area-tooling",
"area-azd"
],
"suggested_labels": [
"help wanted",
"area-azd",
"area-tooling",
"area-cli",
"azure-container-apps",
"vs",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"environment",
"ui",
"azure",
"aspire publish"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-container-apps",
"vs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Pipeline activity reporter API"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Flexible deployments](#local-first-production-ready)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10913,
"title": "Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context)",
"url": "https://github.com/dotnet/aspire/discussions/10913",
"category": "Q&A",
"author": "sultanaalyami",
"created_at": "2025-08-11T21:23:14Z",
"updated_at": "2025-08-11T21:40:59Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context). Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-telemetry",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"azure-container-apps",
"area-templates",
"documentation",
"azure",
"area-dashboard",
"area-deployment",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"test",
"db"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Cost-aware guidance for .NET Aspire apps on Azure (ISV Succe...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10913:\n- **Discussion**: [Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context)](https://github.com/dotnet/aspire/discussions/10913)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context)\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Code-centric control](#define-your-stack-in-code), Define your stack in code\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #10913 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10910,
"title": "Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context)",
"url": "https://github.com/dotnet/aspire/discussions/10910",
"category": "Q&A",
"author": "sultanaalyami",
"created_at": "2025-08-11T16:43:11Z",
"updated_at": "2025-08-11T21:41:29Z",
"state": "closed",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 10913,
"duplicate_reason": "Title similarity: 100%, Keyword overlap: 3%, Topic overlap: 0%",
"plain_text_analysis": "User is seeking guidance about Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context). Technologies involved: azure. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"azure",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui",
"azure"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Cost-aware guidance for .NET Aspire apps on Azure (ISV Succe...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10910:\n- **Discussion**: [Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context)](https://github.com/dotnet/aspire/discussions/10910)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Cost-aware guidance for .NET Aspire apps on Azure (ISV Success context)\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #10910 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13849,
13790,
13694,
13675,
13670,
13629,
13484,
13204,
12509
]
},
{
"discussion_number": 10826,
"title": "EF Core migration stuck after adding WithEndpointProxySupport(false)",
"url": "https://github.com/dotnet/aspire/discussions/10826",
"category": "Q&A",
"author": "mrmyroll2",
"created_at": "2025-08-04T06:35:22Z",
"updated_at": "2025-08-08T02:19:04Z",
"state": "closed",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about EF Core migration stuck after adding WithEndpointProxySupport(false). Technologies involved: postgres, entityframework. Topic relates to database.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"help wanted",
"area-tooling",
"entityframework",
"postgres",
"area-service-discovery"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "database",
"subtopics": [
"database",
"endpoint",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres",
"entityframework"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Aspire",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about database is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Aspire"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13694,
13329,
13227,
13069,
12906,
11212,
10431,
9554,
9373,
9231
]
},
{
"discussion_number": 10819,
"title": "Aspire 9.4, CommunicationServices and removed AzureBicepResource.KnownParameters.PrincipalId?",
"url": "https://github.com/dotnet/aspire/discussions/10819",
"category": "Q&A",
"author": "AndiRudi",
"created_at": "2025-08-03T07:08:29Z",
"updated_at": "2025-08-09T13:59:07Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire 9.4, CommunicationServices and removed AzureBicepResource.KnownParameters. This may indicate a potential issue or bug. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-templates",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"environment",
"ui",
"db",
"auth"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs",
"Combining approaches",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire 9.4, CommunicationServices and removed AzureBicepReso...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10819:\n- **Discussion**: [Aspire 9.4, CommunicationServices and removed AzureBicepResource.KnownParameters.PrincipalId?](https://github.com/dotnet/aspire/discussions/10819)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire 9.4, CommunicationServices and removed AzureBicepResource.KnownParameters.PrincipalId?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs, Combining approaches, [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #10819 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance",
"See the 'Combining approaches' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs",
"Section: Combining approaches"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10765,
"title": "How do I change the Environment Name in my Azure Functions project?",
"url": "https://github.com/dotnet/aspire/discussions/10765",
"category": "Q&A",
"author": "AwkEng",
"created_at": "2025-07-30T22:41:03Z",
"updated_at": "2025-08-20T10:36:26Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to change the environment name in my azure functions project?. Technologies involved: azure, azure-functions. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"azure-functions",
"azure",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"settings",
"ui",
"azure"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-functions"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Azure Functions resource",
"Optional wiring examples",
"Environment variables",
"Configure development certificate trust per resource",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How do I change the Environment Name in my Azure Functions p...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10765:\n- **Discussion**: [How do I change the Environment Name in my Azure Functions project?](https://github.com/dotnet/aspire/discussions/10765)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How do I change the Environment Name in my Azure Functions project?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add Azure Functions resource, Optional wiring examples, Environment variables\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #10765 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Azure Functions resource' section for guidance",
"See the 'Optional wiring examples' section for guidance",
"See the 'Environment variables' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Azure Functions resource",
"Section: Optional wiring examples"
],
"detailed_response": "## Deploying Aspire to Azure Container Apps\n\n### Solution\n\nUse `azd` (Azure Developer CLI) for seamless deployment:\n\n### Step-by-Step Guide\n\n```bash\n# Initialize azd in your project\nazd init\n\n# Deploy to Azure\nazd up\n\n# For production, provision first\nazd provision\nazd deploy\n```\n\n### Code Example (AppHost Configuration)\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithExternalHttpEndpoints(); // Exposes publicly\n\n// Add Azure resources\nvar storage = builder.AddAzureStorage(\"storage\")\n .RunAsEmulator(); // Local dev only\n\nbuilder.Build().Run();\n```\n\n### Source Code Reference\n\nAzure provisioning: `src/Aspire.Hosting.Azure/Provisioning/`\nContainer Apps manifest: `src/Aspire.Hosting.Azure.ContainerApps/`\n\n### Infrastructure Configuration\n\n```csharp\n// Custom Azure configuration\nbuilder.AddAzureContainerApps(\"aca\")\n .ConfigureInfrastructure(infra =>\n {\n var env = infra.GetProvisionableResources()\n .OfType<ContainerAppEnvironment>()\n .Single();\n env.Properties.ZoneRedundant = true;\n });\n```\n\n### Common Pitfalls\n\n- **Secrets**: Use Azure Key Vault for production secrets\n- **Scaling**: Configure min/max replicas in production\n- **Networking**: Consider VNet integration for private resources\n\n### Additional Resources\n\n- Azure Container Apps documentation\n- azd templates for Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13227,
13204,
12484,
12338
]
},
{
"discussion_number": 10682,
"title": "Aspire and App Configuration and Sentinel values",
"url": "https://github.com/dotnet/aspire/discussions/10682",
"category": "Q&A",
"author": "rrussell0",
"created_at": "2025-07-26T03:40:42Z",
"updated_at": "2025-08-25T16:49:29Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire and App Configuration and Sentinel values. This may indicate a potential issue or bug. Technologies involved: azure, azure-keyvault. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"azure",
"good first issue",
"area-tooling",
"area-cli",
"azure-keyvault",
"area-service-discovery",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"stack_trace"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"console",
"test",
"endpoint",
"azure"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "basic",
"technologies_mentioned": [
"azure",
"azure-keyvault"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire and App Configuration and Sentinel values",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10682:\n- **Discussion**: [Aspire and App Configuration and Sentinel values](https://github.com/dotnet/aspire/discussions/10682)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire and App Configuration and Sentinel values\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Define your stack in code\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #10682 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13227,
13204,
12484,
12338
]
},
{
"discussion_number": 10503,
"title": "Working with Existing Resources and Multiple Subscriptions in Azure",
"url": "https://github.com/dotnet/aspire/discussions/10503",
"category": "Q&A",
"author": "NapalmCodes",
"created_at": "2025-07-17T17:34:27Z",
"updated_at": "2025-07-18T19:13:19Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Working with Existing Resources and Multiple Subscriptions in Azure. This may indicate a potential issue or bug. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"good first issue",
"area-tooling",
"area-cli",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"environment",
"ui",
"port",
"azure"
],
"is_question": true,
"question_type": "how-to",
"complexity": "basic",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10455,
"title": "Aspire Specify NodeJs version",
"url": "https://github.com/dotnet/aspire/discussions/10455",
"category": "Q&A",
"author": "vnc4567",
"created_at": "2025-07-16T10:39:20Z",
"updated_at": "2025-07-16T10:39:21Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire Specify NodeJs version. This may indicate a potential issue or bug. Technologies involved: nodejs. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"area-tooling",
"nodejs"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"ui",
"run",
"node"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"nodejs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire Specify NodeJs version",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10455:\n- **Discussion**: [Aspire Specify NodeJs version](https://github.com/dotnet/aspire/discussions/10455)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire Specify NodeJs version\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #10455 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13790,
13670,
13484,
12509,
12227,
11970,
11212,
10910,
9828
]
},
{
"discussion_number": 10431,
"title": "Fixed port assignment and persistent container networking with .NET Aspire and Podman",
"url": "https://github.com/dotnet/aspire/discussions/10431",
"category": "Q&A",
"author": "jroellinger",
"created_at": "2025-07-15T16:55:35Z",
"updated_at": "2025-08-21T06:18:43Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Fixed port assignment and persistent container networking with .NET Aspire and P. This may indicate a potential issue or bug. Technologies involved: postgres. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-orchestrator",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"postgres",
"area-service-discovery",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue",
"problem"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"test",
"database"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Custom container names",
"Configure a persistent container"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Fixed port assignment and persistent container networking wi...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10431:\n- **Discussion**: [Fixed port assignment and persistent container networking with .NET Aspire and Podman](https://github.com/dotnet/aspire/discussions/10431)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Fixed port assignment and persistent container networking with .NET Aspire and Podman\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Custom container names, Configure a persistent container\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #10431 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Custom container names' section for guidance",
"See the 'Configure a persistent container' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Custom container names",
"Section: Configure a persistent container"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 10418,
"title": "Do we need appsettings.Development.json in the AppHost project?",
"url": "https://github.com/dotnet/aspire/discussions/10418",
"category": "Q&A",
"author": "jrunestone",
"created_at": "2025-07-15T10:41:01Z",
"updated_at": "2025-07-15T10:41:02Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Do we need appsettings.Development.json in the AppHost project?. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"settings",
"development"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Configure development certificate trust per resource",
"Free and open source"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Do we need appsettings.Development.json in the AppHost proje...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10418:\n- **Discussion**: [Do we need appsettings.Development.json in the AppHost project?](https://github.com/dotnet/aspire/discussions/10418)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Do we need appsettings.Development.json in the AppHost project?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Configure development certificate trust per resource, Free and open source\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #10418 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Configure development certificate trust per resource' section for guidance",
"See the 'Free and open source' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Configure development certificate trust per resource",
"Section: Free and open source"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10375,
9544
]
},
{
"discussion_number": 10417,
"title": "Does the DOTNET_ASPIRE_CONTAINER_RUNTIME disable container runtime info checks?",
"url": "https://github.com/dotnet/aspire/discussions/10417",
"category": "Q&A",
"author": "kostya9",
"created_at": "2025-07-15T10:23:29Z",
"updated_at": "2025-07-15T12:29:00Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 12204,
"duplicate_reason": "Title similarity: 45%, Keyword overlap: 5%, Topic overlap: 75%",
"plain_text_analysis": "User is seeking guidance about Does the DOTNET_ASPIRE_CONTAINER_RUNTIME disable container runtime info checks?. This appears to report an error or unexpected behavior. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator"
],
"suggested_labels": [
"area-orchestrator",
"area-app-model",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"issue",
"stack trace",
"problem",
"stack_trace",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"docker",
"environment",
"ui",
"test",
"port"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Flexible deployments](#local-first-production-ready)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10375,
"title": "Can I programmatically reorder projects in Aspire Dashboard?",
"url": "https://github.com/dotnet/aspire/discussions/10375",
"category": "Q&A",
"author": "sharpzilla",
"created_at": "2025-07-14T04:58:02Z",
"updated_at": "2025-07-14T23:22:58Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 12561,
"duplicate_reason": "Title similarity: 41%, Keyword overlap: 9%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Can I programmatically reorder projects in Aspire Dashboard?. Topic relates to configuration.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"good first issue",
"documentation",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"dashboard",
"port"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Can I programmatically reorder projects in Aspire Dashboard?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10375:\n- **Discussion**: [Can I programmatically reorder projects in Aspire Dashboard?](https://github.com/dotnet/aspire/discussions/10375)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Can I programmatically reorder projects in Aspire Dashboard?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #10375 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
9544
]
},
{
"discussion_number": 10276,
"title": "Multi-Repository Setup with .NET Aspire: Best Practices for Enterprise Constraints",
"url": "https://github.com/dotnet/aspire/discussions/10276",
"category": "Q&A",
"author": "mmassari",
"created_at": "2025-07-07T07:36:57Z",
"updated_at": "2025-07-24T11:58:33Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Multi-Repository Setup with .NET Aspire: Best Practices for Enterprise Constrain. This may indicate a potential issue or bug. Technologies involved: kubernetes, azure, azure-keyvault. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment",
"area-cli",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-cli",
"azure-keyvault",
"area-templates",
"kubernetes",
"azure-servicebus",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"fails",
"issue",
"problem"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"db",
"entra"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"kubernetes",
"azure",
"azure-keyvault",
"azure-servicebus"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Multi-Repository Setup with .NET Aspire: Best Practices for ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10276:\n- **Discussion**: [Multi-Repository Setup with .NET Aspire: Best Practices for Enterprise Constraints](https://github.com/dotnet/aspire/discussions/10276)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Multi-Repository Setup with .NET Aspire: Best Practices for Enterprise Constraints\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Code-centric control](#define-your-stack-in-code), Define your stack in code\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #10276 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10113,
"title": "Aspire and Azure Functions... how do I get the function authentication keys?",
"url": "https://github.com/dotnet/aspire/discussions/10113",
"category": "Q&A",
"author": "cgdietz",
"created_at": "2025-06-28T18:38:29Z",
"updated_at": "2025-07-01T14:42:22Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to aspire and azure functions... get the function authentication keys?. Technologies involved: azure, azure-functions. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-cli"
],
"suggested_labels": [
"azure",
"help wanted",
"area-cli",
"azure-functions"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"auth",
"port",
"azure"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-functions"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire and Azure Functions... how do I get the function auth...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10113:\n- **Discussion**: [Aspire and Azure Functions... how do I get the function authentication keys?](https://github.com/dotnet/aspire/discussions/10113)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire and Azure Functions... how do I get the function authentication keys?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #10113 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Aspire"
],
"detailed_response": "## Deploying Aspire to Azure Container Apps\n\n### Solution\n\nUse `azd` (Azure Developer CLI) for seamless deployment:\n\n### Step-by-Step Guide\n\n```bash\n# Initialize azd in your project\nazd init\n\n# Deploy to Azure\nazd up\n\n# For production, provision first\nazd provision\nazd deploy\n```\n\n### Code Example (AppHost Configuration)\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithExternalHttpEndpoints(); // Exposes publicly\n\n// Add Azure resources\nvar storage = builder.AddAzureStorage(\"storage\")\n .RunAsEmulator(); // Local dev only\n\nbuilder.Build().Run();\n```\n\n### Source Code Reference\n\nAzure provisioning: `src/Aspire.Hosting.Azure/Provisioning/`\nContainer Apps manifest: `src/Aspire.Hosting.Azure.ContainerApps/`\n\n### Infrastructure Configuration\n\n```csharp\n// Custom Azure configuration\nbuilder.AddAzureContainerApps(\"aca\")\n .ConfigureInfrastructure(infra =>\n {\n var env = infra.GetProvisionableResources()\n .OfType<ContainerAppEnvironment>()\n .Single();\n env.Properties.ZoneRedundant = true;\n });\n```\n\n### Common Pitfalls\n\n- **Secrets**: Use Azure Key Vault for production secrets\n- **Scaling**: Configure min/max replicas in production\n- **Networking**: Consider VNet integration for private resources\n\n### Additional Resources\n\n- Azure Container Apps documentation\n- azd templates for Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10068,
"title": "Is there a way to have a resource wait for a particular log message to appear in another resource's output?",
"url": "https://github.com/dotnet/aspire/discussions/10068",
"category": "Q&A",
"author": "baynezy",
"created_at": "2025-06-26T15:25:16Z",
"updated_at": "2025-06-26T15:25:16Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is there a way to have a resource wait for a particular log message to appear in. This appears to report an error or unexpected behavior. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-telemetry"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"area-deployment",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"fails",
"problem"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"environment",
"ui",
"message",
"local"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Custom resources",
"[Code-centric control](#define-your-stack-in-code)",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Is there a way to have a resource wait for a particular log ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #10068:\n- **Discussion**: [Is there a way to have a resource wait for a particular log message to appear in another resource's output?](https://github.com/dotnet/aspire/discussions/10068)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Is there a way to have a resource wait for a particular log message to appear in another resource's output?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Custom resources, [Code-centric control](#define-your-stack-in-code), [Flexible deployments](#local-first-production-ready)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #10068 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Custom resources' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Custom resources",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10043,
"title": "How to use Aspire Dashboard with pull-based logs and metrics",
"url": "https://github.com/dotnet/aspire/discussions/10043",
"category": "Q&A",
"author": "flibustier7seas",
"created_at": "2025-06-25T10:23:51Z",
"updated_at": "2025-06-25T10:23:52Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to use aspire dashboard with pull-based logs and metrics. Technologies involved: kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-deployment",
"area-service-discovery",
"area-telemetry",
"area-tooling"
],
"suggested_labels": [
"help wanted",
"area-tooling",
"kubernetes",
"documentation",
"area-service-discovery",
"area-dashboard",
"area-deployment",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"kubernetes",
"dashboard",
"logging",
"endpoint",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"kubernetes"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Health checks configuration",
"Environment variables",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Logging"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Health checks configuration' section for guidance",
"See the 'Environment variables' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Health checks configuration",
"Section: Environment variables"
],
"detailed_response": "## Configuring Prometheus with Aspire\n\n### Solution\n\nUse `WithContainerFiles` to dynamically generate Prometheus configuration with resolved endpoints:\n\n### Code Example\n\n```csharp\nvar prometheus = builder.AddContainer(\"prometheus\", \"prom/prometheus\")\n .WithHttpEndpoint(targetPort: 9090);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithHttpEndpoint(name: \"metrics\", port: 9090);\n\nprometheus.WithReference(api.GetEndpoint(\"metrics\"));\n\nprometheus.WithContainerFiles(\"/etc/prometheus\", async (ctx, ct) =>\n{\n var apiEndpoint = api.GetEndpoint(\"metrics\");\n \n var config = $\"\"\"\n global:\n scrape_interval: 15s\n \n scrape_configs:\n - job_name: 'api'\n metrics_path: '/metrics'\n static_configs:\n - targets: ['host.docker.internal:{apiEndpoint.Property(EndpointProperty.TargetPort)}']\n \"\"\";\n \n return [new ContainerFile { \n Name = \"prometheus.yml\", \n Contents = config \n }];\n});\n```\n\n### Source Code Reference\n\nContainer file generation: `src/Aspire.Hosting/Containers/ContainerResourceBuilderExtensions.cs`\nEndpoint resolution: `src/Aspire.Hosting/ApplicationModel/EndpointReference.cs`\n\n### Step-by-Step Guide\n\n1. **Add Prometheus container**: `AddContainer(\"prometheus\", \"prom/prometheus\")`\n2. **Create metrics endpoints**: `WithHttpEndpoint(name: \"metrics\", ...)`\n3. **Reference endpoints**: Use `WithReference` for networking\n4. **Generate config**: Use `WithContainerFiles` callback\n5. **Use endpoint properties**: Access `Port` or `Property(EndpointProperty.TargetPort)`\n\n### Common Pitfalls\n\n- **Callback timing**: Endpoint resolution happens at build time\n- **Container networking**: Use correct hostname (host.docker.internal vs container name)\n- **File permissions**: Set proper `UnixFileMode` for config files\n\n### Additional Resources\n\n- Aspire Dashboard for built-in metrics visualization\n- OpenTelemetry Prometheus exporter for .NET\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 10010,
"title": "Failing tests when adding an Authorization header",
"url": "https://github.com/dotnet/aspire/discussions/10010",
"category": "Q&A",
"author": "lopezbertoni",
"created_at": "2025-06-23T21:11:05Z",
"updated_at": "2025-06-29T20:50:16Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Failing tests when adding an Authorization header. This may indicate a potential issue or bug. Topic relates to testing.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-integrations",
"area-service-discovery"
],
"suggested_labels": [
"area-service-discovery",
"good first issue",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"failing",
"bug"
],
"severity": "medium",
"topic": "testing",
"subtopics": [
"test",
"auth",
"endpoint",
"debug",
"integration"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Modular and extensible](#explore-integrations)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about testing is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Modular and extensible](#explore-integrations)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
5681
]
},
{
"discussion_number": 9970,
"title": "What additional configuration is needed to run the initial Build your first .NET Aspire solution tutorial using Podman?",
"url": "https://github.com/dotnet/aspire/discussions/9970",
"category": "Q&A",
"author": "jcbeck37",
"created_at": "2025-06-20T17:32:48Z",
"updated_at": "2025-06-22T18:22:19Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about What additional configuration is needed to run the initial Build your first .NET. This appears to report an error or unexpected behavior. Technologies involved: redis. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-templates"
],
"suggested_labels": [
"good first issue",
"area-dashboard",
"area-templates",
"redis"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"fails",
"failed",
"error_code"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"docker",
"config",
"console",
"redis",
"message"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "basic",
"technologies_mentioned": [
"redis"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] What additional configuration is needed to run the initial B...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9970:\n- **Discussion**: [What additional configuration is needed to run the initial Build your first .NET Aspire solution tutorial using Podman?](https://github.com/dotnet/aspire/discussions/9970)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: What additional configuration is needed to run the initial Build your first .NET Aspire solution tutorial using Podman?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Define your stack in code\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9970 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Define your stack in code"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 9899,
"title": "Running Aspire based E2E Tests in Gitlab CI/CD",
"url": "https://github.com/dotnet/aspire/discussions/9899",
"category": "Q&A",
"author": "stefannikolei",
"created_at": "2025-06-16T12:41:42Z",
"updated_at": "2025-08-02T10:29:19Z",
"state": "open",
"comments_count": 4,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Running Aspire based E2E Tests in Gitlab CI/CD. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"test",
"https",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Running Aspire based E2E Tests in Gitlab CI/CD",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9899:\n- **Discussion**: [Running Aspire based E2E Tests in Gitlab CI/CD](https://github.com/dotnet/aspire/discussions/9899)\n- **Category**: Q&A\n- **Comments**: 4\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Running Aspire based E2E Tests in Gitlab CI/CD\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 4) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9899 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9896,
"title": "Wrong CosmosDB port when running API tests on top of Aspire",
"url": "https://github.com/dotnet/aspire/discussions/9896",
"category": "Q&A",
"author": "dilyandimitrov",
"created_at": "2025-06-16T10:48:40Z",
"updated_at": "2025-06-17T09:54:42Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Wrong CosmosDB port when running API tests on top of Aspire. This may indicate a potential issue or bug. Technologies involved: azure, azure-cosmosdb. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"azure",
"azure-cosmosdb",
"area-tooling",
"area-cli",
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"failed",
"bug",
"wrong"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"test",
"database"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-cosmosdb"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Aspire",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Aspire"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9888,
"title": "Can I generate Dockerfile for a project when publishing as docker-compose?",
"url": "https://github.com/dotnet/aspire/discussions/9888",
"category": "Q&A",
"author": "branets-dasha",
"created_at": "2025-06-14T16:58:11Z",
"updated_at": "2025-06-21T11:42:15Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Can I generate Dockerfile for a project when publishing as docker-compose?. Technologies involved: docker-compose. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-cli"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-cli",
"docker-compose",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"publish",
"config",
"ui",
"database",
"message"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"docker-compose"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Can I generate Dockerfile for a project when publishing as d...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9888:\n- **Discussion**: [Can I generate Dockerfile for a project when publishing as docker-compose?](https://github.com/dotnet/aspire/discussions/9888)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Can I generate Dockerfile for a project when publishing as docker-compose?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: See also, Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9888 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: Define your stack in code"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9829,
"title": "Cosmos DB & Azure Functions differences",
"url": "https://github.com/dotnet/aspire/discussions/9829",
"category": "Q&A",
"author": "VistianOpenSource",
"created_at": "2025-06-11T14:20:27Z",
"updated_at": "2025-10-30T09:56:19Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Cosmos DB & Azure Functions differences. This appears to report an error or unexpected behavior. Technologies involved: azure, azure-functions, azure-cosmosdb. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"azure",
"azure-cosmosdb",
"good first issue",
"area-tooling",
"azure-functions",
"area-service-discovery"
],
"is_potential_issue": true,
"issue_indicators": [
"exception"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"container",
"database",
"https",
"azure"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "basic",
"technologies_mentioned": [
"azure",
"azure-functions",
"azure-cosmosdb"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Cosmos DB & Azure Functions differences",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9829:\n- **Discussion**: [Cosmos DB & Azure Functions differences](https://github.com/dotnet/aspire/discussions/9829)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Cosmos DB & Azure Functions differences\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9829 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Aspire"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9828,
"title": "How should I send CTRL-R to a process when using aspire run --watch or dotnet watch?",
"url": "https://github.com/dotnet/aspire/discussions/9828",
"category": "Q&A",
"author": "willdean",
"created_at": "2025-06-11T11:44:10Z",
"updated_at": "2025-06-18T18:42:47Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to how should i send ctrl-r to a process when using aspire run --watch or dotnet wa. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-cli"
],
"suggested_labels": [
"area-dashboard",
"help wanted",
"area-cli"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard",
"run",
"aspire run"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How should I send CTRL-R to a process when using aspire run ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9828:\n- **Discussion**: [How should I send CTRL-R to a process when using aspire run --watch or dotnet watch?](https://github.com/dotnet/aspire/discussions/9828)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How should I send CTRL-R to a process when using aspire run --watch or dotnet watch?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #9828 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9444,
9420
]
},
{
"discussion_number": 9738,
"title": "Enable Redis AOF via Aspire .AddRedis",
"url": "https://github.com/dotnet/aspire/discussions/9738",
"category": "Q&A",
"author": "MatzeG",
"created_at": "2025-06-06T09:44:04Z",
"updated_at": "2025-06-09T08:14:42Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Enable Redis AOF via Aspire .AddRedis. This may indicate a potential issue or bug. Technologies involved: redis. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"area-integrations",
"redis"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"container",
"environment",
"ui",
"redis",
"run"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": [
"redis"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Garnet resource with persistence",
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Enable Redis AOF via Aspire .AddRedis",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9738:\n- **Discussion**: [Enable Redis AOF via Aspire .AddRedis](https://github.com/dotnet/aspire/discussions/9738)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Enable Redis AOF via Aspire .AddRedis\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add Garnet resource with persistence, \u2014 AppHost.cs\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9738 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Garnet resource with persistence' section for guidance",
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Garnet resource with persistence",
"Section: \u2014 AppHost.cs"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 9571,
"title": "Native Azure Functions with .Net Aspire.",
"url": "https://github.com/dotnet/aspire/discussions/9571",
"category": "Q&A",
"author": "ricoprzybylski",
"created_at": "2025-05-29T19:32:59Z",
"updated_at": "2025-06-02T17:40:45Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Native Azure Functions with .Net Aspire.. Technologies involved: azure, azure-functions. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"azure-functions",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"db",
"message",
"port"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-functions"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Azure Functions resource",
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Azure Functions resource' section for guidance",
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Azure Functions resource",
"Section: Environment variables"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9554,
"title": "Issue with applying EF Core migrations at design time",
"url": "https://github.com/dotnet/aspire/discussions/9554",
"category": "Q&A",
"author": "bancroftway",
"created_at": "2025-05-28T15:02:52Z",
"updated_at": "2025-06-02T23:50:24Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Issue with applying EF Core migrations at design time. This may indicate a potential issue or bug. Technologies involved: postgres, blazor-wasm, entityframework. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-orchestrator",
"area-deployment",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"area-tooling",
"entityframework",
"postgres",
"area-cli",
"blazor-wasm",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"bug",
"issue",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"docker",
"config",
"dashboard",
"test",
"database"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"blazor-wasm",
"entityframework"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Configure a persistent container",
"Pass build arguments"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Issue with applying EF Core migrations at design time",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9554:\n- **Discussion**: [Issue with applying EF Core migrations at design time](https://github.com/dotnet/aspire/discussions/9554)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Issue with applying EF Core migrations at design time\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Configure a persistent container, Pass build arguments\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9554 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Configure a persistent container' section for guidance",
"See the 'Pass build arguments' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Configure a persistent container",
"Section: Pass build arguments"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 9544,
"title": "How to export generated credentials and ports to external applications",
"url": "https://github.com/dotnet/aspire/discussions/9544",
"category": "Q&A",
"author": "pfeigl",
"created_at": "2025-05-28T08:10:04Z",
"updated_at": "2025-05-28T08:10:05Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to export generated credentials and ports to external applications. Technologies involved: sqlserver, rabbitmq, kafka. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"help wanted",
"rabbitmq",
"kafka",
"area-tooling",
"area-service-discovery"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"sql",
"rabbitmq",
"port",
"development"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"sqlserver",
"rabbitmq",
"kafka"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"Free and open source"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the 'Free and open source' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
13022,
12983,
12484,
12338,
12114,
11885,
11212,
10765
]
},
{
"discussion_number": 9510,
"title": "Debugging `Aspire.Hosting.Dcp.dcpctrl.ContainerReconciler` could not open the image ID file",
"url": "https://github.com/dotnet/aspire/discussions/9510",
"category": "Q&A",
"author": "baynezy",
"created_at": "2025-05-26T08:50:15Z",
"updated_at": "2025-06-26T14:11:42Z",
"state": "closed",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Debugging `Aspire.Hosting.Dcp.dcpctrl.ContainerReconciler` could not open the im. This may indicate a potential issue or bug. Technologies involved: docker-compose. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-service-discovery",
"area-telemetry",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"area-tooling",
"docker-compose",
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"failed",
"bug",
"issue"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"docker",
"environment",
"dashboard",
"test",
"endpoint"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"docker-compose"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Debugging `Aspire.Hosting.Dcp.dcpctrl.ContainerReconciler` c...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9510:\n- **Discussion**: [Debugging `Aspire.Hosting.Dcp.dcpctrl.ContainerReconciler` could not open the image ID file](https://github.com/dotnet/aspire/discussions/9510)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Debugging `Aspire.Hosting.Dcp.dcpctrl.ContainerReconciler` could not open the image ID file\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #9510 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9452,
"title": "Azure DevOps - Integration Tests failing",
"url": "https://github.com/dotnet/aspire/discussions/9452",
"category": "Q&A",
"author": "lopezbertoni",
"created_at": "2025-05-21T20:39:41Z",
"updated_at": "2025-06-23T21:06:46Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Azure DevOps - Integration Tests failing. This may indicate a potential issue or bug. Technologies involved: sqlserver, azure. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-orchestrator",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"sqlserver",
"azure",
"area-tooling",
"area-cli",
"area-service-discovery",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"fails",
"failed",
"failing",
"issue",
"stack trace",
"stack_trace",
"exception_type"
],
"severity": "high",
"topic": "configuration",
"subtopics": [
"config",
"ui",
"test",
"database",
"message"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"sqlserver",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Project resource type"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Azure DevOps - Integration Tests failing",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9452:\n- **Discussion**: [Azure DevOps - Integration Tests failing](https://github.com/dotnet/aspire/discussions/9452)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Azure DevOps - Integration Tests failing\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Project resource type\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #9452 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Project resource type' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Project resource type"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13227,
13204,
13022,
12484
]
},
{
"discussion_number": 9444,
"title": "How to display URL in the dashboard for customResource with aspire 9.3",
"url": "https://github.com/dotnet/aspire/discussions/9444",
"category": "Q&A",
"author": "malain",
"created_at": "2025-05-21T08:30:25Z",
"updated_at": "2025-05-21T09:23:24Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to display url in the dashboard for customresource with aspire 9.3. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard",
"endpoint",
"custom resource"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Custom resources",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Custom resources' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Custom resources"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9420
]
},
{
"discussion_number": 9420,
"title": "Group multiple types of resources under a parent",
"url": "https://github.com/dotnet/aspire/discussions/9420",
"category": "Q&A",
"author": "Kralizek",
"created_at": "2025-05-20T14:35:16Z",
"updated_at": "2025-08-26T07:44:45Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Group multiple types of resources under a parent. Technologies involved: azure-storage. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"azure-storage",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard",
"database",
"port",
"development",
"integration"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": [
"azure-storage"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire",
"Free and open source",
"[Modular and extensible](#explore-integrations)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13849,
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828
]
},
{
"discussion_number": 9388,
"title": "IDataProtectionProvider setup support in Aspire",
"url": "https://github.com/dotnet/aspire/discussions/9388",
"category": "Q&A",
"author": "berezovskyi",
"created_at": "2025-05-19T12:32:34Z",
"updated_at": "2025-05-19T15:07:52Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 11427,
"duplicate_reason": "Title similarity: 48%, Keyword overlap: 3%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about IDataProtectionProvider setup support in Aspire. This may indicate a potential issue or bug. Technologies involved: azure. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"azure",
"area-app-model",
"area-tooling",
"good first issue"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"port",
"azure"
],
"is_question": true,
"question_type": "how-to",
"complexity": "basic",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] IDataProtectionProvider setup support in Aspire",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9388:\n- **Discussion**: [IDataProtectionProvider setup support in Aspire](https://github.com/dotnet/aspire/discussions/9388)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: IDataProtectionProvider setup support in Aspire\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Define your stack in code\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #9388 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
]
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13227,
13204,
12484,
12338
]
},
{
"discussion_number": 9374,
"title": "Deleted",
"url": "https://github.com/dotnet/aspire/discussions/9374",
"category": "Q&A",
"author": "RedEye-Developers",
"created_at": "2025-05-17T15:05:38Z",
"updated_at": "2025-05-17T15:06:41Z",
"state": "closed",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Deleted. Topic relates to general.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "general",
"subtopics": [],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Deleted",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9374:\n- **Discussion**: [Deleted](https://github.com/dotnet/aspire/discussions/9374)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Deleted\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of general in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"general"
],
"priority": "high",
"rationale": "Discussion #9374 reveals documentation gap for general"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about general may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
12518,
11660,
11382,
9355,
7536
]
},
{
"discussion_number": 9373,
"title": "Test passes only if Aspire is also running on the side.",
"url": "https://github.com/dotnet/aspire/discussions/9373",
"category": "Q&A",
"author": "Kralizek",
"created_at": "2025-05-17T12:19:52Z",
"updated_at": "2025-05-17T14:15:42Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Test passes only if Aspire is also running on the side.. Technologies involved: postgres, nodejs. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"postgres",
"area-cli",
"nodejs",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"environment",
"ui",
"test",
"database"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"nodejs"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Test passes only if Aspire is also running on the side.",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9373:\n- **Discussion**: [Test passes only if Aspire is also running on the side.](https://github.com/dotnet/aspire/discussions/9373)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Test passes only if Aspire is also running on the side.\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #9373 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13484,
13329,
13227
]
},
{
"discussion_number": 9355,
"title": "deleted",
"url": "https://github.com/dotnet/aspire/discussions/9355",
"category": "Q&A",
"author": "RedEye-Developers",
"created_at": "2025-05-16T13:42:00Z",
"updated_at": "2025-05-16T14:21:39Z",
"state": "closed",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 9374,
"duplicate_reason": "Title similarity: 100%, Keyword overlap: 100%, Topic overlap: 0%",
"plain_text_analysis": "User is seeking guidance about deleted. Topic relates to general.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "general",
"subtopics": [],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] deleted",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9355:\n- **Discussion**: [deleted](https://github.com/dotnet/aspire/discussions/9355)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: deleted\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of general in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"general"
],
"priority": "high",
"rationale": "Discussion #9355 reveals documentation gap for general"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about general may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
12518,
11660,
11382,
9374,
7536
]
},
{
"discussion_number": 9343,
"title": "Questions around deploying to existing resources",
"url": "https://github.com/dotnet/aspire/discussions/9343",
"category": "Q&A",
"author": "NMRS-TWalker",
"created_at": "2025-05-15T22:19:07Z",
"updated_at": "2025-05-15T22:19:07Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Questions around deploying to existing resources. Technologies involved: blazor-wasm. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"blazor-wasm",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"https",
"run",
"container"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": [
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9328,
"title": "Can i use Ms Garnet with Orleans 9.2 instead of Redis under aspire 9.2",
"url": "https://github.com/dotnet/aspire/discussions/9328",
"category": "Q&A",
"author": "curiousBuroman",
"created_at": "2025-05-15T13:19:55Z",
"updated_at": "2025-05-26T08:21:08Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Can i use Ms Garnet with Orleans 9.2 instead of Redis under aspire 9.2. This may indicate a potential issue or bug. Technologies involved: redis, orleans. Topic relates to dashboard.",
"analysis": {
"issue_type": "performance",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"orleans",
"area-tooling",
"area-cli",
"area-dashboard",
"redis",
"perf"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"exception_type"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"ui",
"redis",
"https",
"f5",
"iresource"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"redis",
"orleans"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Garnet resource",
"Add an Orleans resource",
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Can i use Ms Garnet with Orleans 9.2 instead of Redis under ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9328:\n- **Discussion**: [Can i use Ms Garnet with Orleans 9.2 instead of Redis under aspire 9.2](https://github.com/dotnet/aspire/discussions/9328)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Can i use Ms Garnet with Orleans 9.2 instead of Redis under aspire 9.2\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add Garnet resource, Add an Orleans resource, \u2014 AppHost.cs\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #9328 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Garnet resource' section for guidance",
"See the 'Add an Orleans resource' section for guidance",
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Garnet resource",
"Section: Add an Orleans resource"
]
},
"related_discussions": [
13790,
13694,
13675,
13670,
13484,
13227,
12509,
12227,
11970,
11212
]
},
{
"discussion_number": 9406,
"title": "Logging with scopes",
"url": "https://github.com/dotnet/aspire/discussions/9406",
"category": "Q&A",
"author": "migoldfinger",
"created_at": "2025-05-15T00:39:01Z",
"updated_at": "2025-05-19T23:43:53Z",
"state": "open",
"comments_count": 4,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Logging with scopes. This appears to report an error or unexpected behavior. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-telemetry"
],
"suggested_labels": [
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"bug",
"issue"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"console",
"logging"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Logging"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Logging with scopes",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9406:\n- **Discussion**: [Logging with scopes](https://github.com/dotnet/aspire/discussions/9406)\n- **Category**: Q&A\n- **Comments**: 4\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Logging with scopes\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Logging\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 4) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #9406 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Logging' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Logging"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 9231,
"title": "What is the reason behind choosing DbContext Pooling for all database components?",
"url": "https://github.com/dotnet/aspire/discussions/9231",
"category": "Q&A",
"author": "sa-es-ir",
"created_at": "2025-05-11T10:16:08Z",
"updated_at": "2025-05-15T22:35:24Z",
"state": "closed",
"comments_count": 5,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about What is the reason behind choosing DbContext Pooling for all database components. This may indicate a potential issue or bug. Technologies involved: postgres, sqlserver, mysql. Topic relates to configuration.",
"analysis": {
"issue_type": "performance",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"entityframework",
"postgres",
"mysql",
"area-dashboard",
"area-integrations",
"perf"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"ui",
"database"
],
"is_question": true,
"question_type": "concept",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"sqlserver",
"mysql",
"entityframework"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 Program.cs",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 Program.cs' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 Program.cs",
"Section: Define your stack in code"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13694,
13329,
13227,
13069,
13022,
12906,
12484,
12338,
12114
]
},
{
"discussion_number": 9203,
"title": "Expose a range of container ports",
"url": "https://github.com/dotnet/aspire/discussions/9203",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-05-09T16:42:19Z",
"updated_at": "2025-05-12T14:05:15Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 11427,
"duplicate_reason": "Title similarity: 60%, Keyword overlap: 3%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Expose a range of container ports. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"area-deployment",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"publish",
"ui",
"port",
"run",
"container"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Signature pattern"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Expose a range of container ports",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9203:\n- **Discussion**: [Expose a range of container ports](https://github.com/dotnet/aspire/discussions/9203)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Expose a range of container ports\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Signature pattern\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9203 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Signature pattern' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Signature pattern"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9202,
"title": "Same container and host port with multiple protocols",
"url": "https://github.com/dotnet/aspire/discussions/9202",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-05-09T16:39:56Z",
"updated_at": "2025-05-09T16:39:57Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 11427,
"duplicate_reason": "Title similarity: 47%, Keyword overlap: 2%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Same container and host port with multiple protocols. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-service-discovery",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"publish",
"ui",
"endpoint",
"run",
"container"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Signature pattern",
"Customize resource URLs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Same container and host port with multiple protocols",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9202:\n- **Discussion**: [Same container and host port with multiple protocols](https://github.com/dotnet/aspire/discussions/9202)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Same container and host port with multiple protocols\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Signature pattern, Customize resource URLs\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #9202 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Signature pattern' section for guidance",
"See the 'Customize resource URLs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Signature pattern",
"Section: Customize resource URLs"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9055,
"title": "Need to expose the PrimaryEndpoint.Port from AzurePostgresFlexibleServerResource as Environment Variable to another service",
"url": "https://github.com/dotnet/aspire/discussions/9055",
"category": "Q&A",
"author": "anemitoff",
"created_at": "2025-05-01T13:46:54Z",
"updated_at": "2025-05-03T19:53:58Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Need to expose the PrimaryEndpoint.Port from AzurePostgresFlexibleServerResource. Technologies involved: postgres, azure. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"azure",
"area-tooling",
"postgres",
"area-service-discovery"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"environment",
"postgres",
"endpoint",
"azure"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Flexible deployments](#local-first-production-ready)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Need to expose the PrimaryEndpoint.Port from AzurePostgresFl...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9055:\n- **Discussion**: [Need to expose the PrimaryEndpoint.Port from AzurePostgresFlexibleServerResource as Environment Variable to another service](https://github.com/dotnet/aspire/discussions/9055)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Need to expose the PrimaryEndpoint.Port from AzurePostgresFlexibleServerResource as Environment Variable to another service\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Flexible deployments](#local-first-production-ready)\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #9055 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Flexible deployments](#local-first-production-ready)"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13329,
13227,
13204,
13069
]
},
{
"discussion_number": 9002,
"title": "Generate custom target",
"url": "https://github.com/dotnet/aspire/discussions/9002",
"category": "Q&A",
"author": "alefranz",
"created_at": "2025-04-28T16:41:53Z",
"updated_at": "2025-05-04T02:25:06Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Generate custom target. Topic relates to configuration.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"good first issue",
"documentation",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"ui",
"port",
"integration"
],
"is_question": true,
"question_type": "how-to",
"complexity": "basic",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs",
"Environment variables",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Modular and extensible](#explore-integrations)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Generate custom target",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9002:\n- **Discussion**: [Generate custom target](https://github.com/dotnet/aspire/discussions/9002)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Generate custom target\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs, Environment variables, Define your stack in code\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #9002 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance",
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs",
"Section: Environment variables"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 8989,
"title": "PgAdmin and MongoExpress Containers Not Visible on Azure Deployment (Aspire Hosting)",
"url": "https://github.com/dotnet/aspire/discussions/8989",
"category": "Q&A",
"author": "man-jadeja",
"created_at": "2025-04-28T04:10:04Z",
"updated_at": "2025-05-03T20:06:16Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about PgAdmin and MongoExpress Containers Not Visible on Azure Deployment (Aspire Host. Technologies involved: postgres, mongodb, azure. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"postgres",
"mongodb",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"dashboard",
"database",
"https"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"mongodb",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Pass build arguments",
"Configure a persistent container",
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Pass build arguments' section for guidance",
"See the 'Configure a persistent container' section for guidance",
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Pass build arguments",
"Section: Configure a persistent container"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 8987,
"title": "Aspire Dashboard Version Mismatch on Azure - Showing 9.0.0-dev Instead of 9.2.0!",
"url": "https://github.com/dotnet/aspire/discussions/8987",
"category": "Q&A",
"author": "man-jadeja",
"created_at": "2025-04-28T03:57:54Z",
"updated_at": "2025-04-28T04:35:25Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to aspire dashboard version mismatch on azure - showing 9.0.0-dev instead of 9.2.0!. This may indicate a potential issue or bug. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-deployment"
],
"suggested_labels": [
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"dashboard",
"https",
"local"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: Define your stack in code"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8937,
"title": "How to get raw IP addresses for .NET Aspire containers to assign them to dependencies before the dependencies start, and resolve DNS queries from external .NET projects",
"url": "https://github.com/dotnet/aspire/discussions/8937",
"category": "Q&A",
"author": "121GWJolt",
"created_at": "2025-04-23T21:24:52Z",
"updated_at": "2025-05-05T00:52:58Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to get raw ip addresses for .net aspire containers to assign them to dependencies b. This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"area-tooling",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"bug"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"test",
"endpoint"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Aspire",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Aspire"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8891,
"title": "How to specify extensions when referencing Azure Postgres Flexible Server?",
"url": "https://github.com/dotnet/aspire/discussions/8891",
"category": "Q&A",
"author": "godefroi",
"created_at": "2025-04-20T23:05:21Z",
"updated_at": "2025-04-20T23:05:22Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to specify extensions when referencing azure postgres flexible server?. This may indicate a potential issue or bug. Technologies involved: postgres, azure. Topic relates to database.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-tooling"
],
"suggested_labels": [
"azure",
"area-tooling",
"postgres"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "database",
"subtopics": [
"sql",
"https",
"azure",
"extension"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres",
"azure"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to specify extensions when referencing Azure Postgres Fl...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8891:\n- **Discussion**: [How to specify extensions when referencing Azure Postgres Flexible Server?](https://github.com/dotnet/aspire/discussions/8891)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to specify extensions when referencing Azure Postgres Flexible Server?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of database in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"database"
],
"priority": "high",
"rationale": "Discussion #8891 reveals documentation gap for database"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about database may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13694,
13675,
13629,
13329,
13227,
13204,
13069,
12906
]
},
{
"discussion_number": 8851,
"title": "how do I override configuration for integration tests using DistributedApplicationFactory?",
"url": "https://github.com/dotnet/aspire/discussions/8851",
"category": "Q&A",
"author": "chalcolith",
"created_at": "2025-04-17T15:46:01Z",
"updated_at": "2025-07-14T12:20:52Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to override configuration for integration tests using distributedapplicationfactory. This may indicate a potential issue or bug. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-service-discovery",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"wrong"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"dashboard",
"test",
"database",
"endpoint"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] how do I override configuration for integration tests using ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8851:\n- **Discussion**: [how do I override configuration for integration tests using DistributedApplicationFactory?](https://github.com/dotnet/aspire/discussions/8851)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: how do I override configuration for integration tests using DistributedApplicationFactory?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "high",
"rationale": "Discussion #8851 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 8849,
"title": "Is there a way to set values on a Kubernetes deployment before it is written?",
"url": "https://github.com/dotnet/aspire/discussions/8849",
"category": "Q&A",
"author": "erikhermansson79",
"created_at": "2025-04-17T13:16:43Z",
"updated_at": "2025-04-28T14:35:23Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is there a way to set values on a Kubernetes deployment before it is written?. Technologies involved: kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-deployment",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"kubernetes",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"test"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": [
"kubernetes"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Is there a way to set values on a Kubernetes deployment befo...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8849:\n- **Discussion**: [Is there a way to set values on a Kubernetes deployment before it is written?](https://github.com/dotnet/aspire/discussions/8849)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Is there a way to set values on a Kubernetes deployment before it is written?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8849 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8783,
"title": "Is there any way to clear the resource + instanceid list on stand alone Aspire dashboard?",
"url": "https://github.com/dotnet/aspire/discussions/8783",
"category": "Q&A",
"author": "dodyg",
"created_at": "2025-04-15T13:09:57Z",
"updated_at": "2025-04-15T13:45:19Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is there any way to clear the resource + instanceid list on stand alone Aspire d. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-telemetry"
],
"suggested_labels": [
"help wanted",
"area-app-model",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard",
"otel",
"https"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Is there any way to clear the resource + instanceid list on ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8783:\n- **Discussion**: [Is there any way to clear the resource + instanceid list on stand alone Aspire dashboard?](https://github.com/dotnet/aspire/discussions/8783)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Is there any way to clear the resource + instanceid list on stand alone Aspire dashboard?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #8783 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 8763,
"title": "NuGet error when restoring locally",
"url": "https://github.com/dotnet/aspire/discussions/8763",
"category": "Q&A",
"author": "smirkingsquiggly",
"created_at": "2025-04-14T06:52:50Z",
"updated_at": "2025-04-25T15:40:27Z",
"state": "closed",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about NuGet error when restoring locally. This appears to report an error or unexpected behavior. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"ui",
"port",
"local"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 8733,
"title": "Configure ASPNETCORE_URLS for Blazor Wasm",
"url": "https://github.com/dotnet/aspire/discussions/8733",
"category": "Q&A",
"author": "smirkingsquiggly",
"created_at": "2025-04-11T12:15:18Z",
"updated_at": "2025-04-11T12:15:19Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Configure ASPNETCORE_URLS for Blazor Wasm. Technologies involved: blazor-wasm. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"area-cli",
"blazor-wasm",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"ui",
"identity",
"endpoint",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Custom resources"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Configure ASPNETCORE_URLS for Blazor Wasm",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8733:\n- **Discussion**: [Configure ASPNETCORE_URLS for Blazor Wasm](https://github.com/dotnet/aspire/discussions/8733)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Configure ASPNETCORE_URLS for Blazor Wasm\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Custom resources\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #8733 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Custom resources' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Custom resources"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13694,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418
]
},
{
"discussion_number": 8669,
"title": "Auto-generated resource group tags",
"url": "https://github.com/dotnet/aspire/discussions/8669",
"category": "Q&A",
"author": "BramDevlaminck-Skyline",
"created_at": "2025-04-09T07:45:32Z",
"updated_at": "2025-04-09T07:45:33Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Auto-generated resource group tags. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-tooling",
"area-azd"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-azd",
"area-tooling",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"bicep"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Auto-generated resource group tags",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8669:\n- **Discussion**: [Auto-generated resource group tags](https://github.com/dotnet/aspire/discussions/8669)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Auto-generated resource group tags\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8669 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8628,
"title": "Is there a way to have a bridge network for persistent containers?",
"url": "https://github.com/dotnet/aspire/discussions/8628",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-04-08T10:40:29Z",
"updated_at": "2025-06-06T03:22:02Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is there a way to have a bridge network for persistent containers?. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"environment",
"ui"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Aspire",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Is there a way to have a bridge network for persistent conta...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8628:\n- **Discussion**: [Is there a way to have a bridge network for persistent containers?](https://github.com/dotnet/aspire/discussions/8628)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Is there a way to have a bridge network for persistent containers?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Aspire, [Flexible deployments](#local-first-production-ready), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8628 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Aspire' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Aspire",
"Section: [Flexible deployments](#local-first-production-ready)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8594,
"title": "Kafka behaving differently depending on whether its run with ctrl+f5 or DistributedApplicationTestingBuilder",
"url": "https://github.com/dotnet/aspire/discussions/8594",
"category": "Q&A",
"author": "Kylemiller995",
"created_at": "2025-04-07T16:18:12Z",
"updated_at": "2025-04-07T16:19:55Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Kafka behaving differently depending on whether its run with ctrl+f5 or Distribu. This may indicate a potential issue or bug. Technologies involved: kafka. Topic relates to deployment.",
"analysis": {
"issue_type": "security",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"kafka",
"area-tooling",
"area-cli",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"security \ud83d\udd10",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"failed",
"doesn't work"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"test",
"kafka"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"kafka"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Kafka behaving differently depending on whether its run with...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8594:\n- **Discussion**: [Kafka behaving differently depending on whether its run with ctrl+f5 or DistributedApplicationTestingBuilder](https://github.com/dotnet/aspire/discussions/8594)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Kafka behaving differently depending on whether its run with ctrl+f5 or DistributedApplicationTestingBuilder\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #8594 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Configuring Prometheus with Aspire\n\n### Solution\n\nUse `WithContainerFiles` to dynamically generate Prometheus configuration with resolved endpoints:\n\n### Code Example\n\n```csharp\nvar prometheus = builder.AddContainer(\"prometheus\", \"prom/prometheus\")\n .WithHttpEndpoint(targetPort: 9090);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithHttpEndpoint(name: \"metrics\", port: 9090);\n\nprometheus.WithReference(api.GetEndpoint(\"metrics\"));\n\nprometheus.WithContainerFiles(\"/etc/prometheus\", async (ctx, ct) =>\n{\n var apiEndpoint = api.GetEndpoint(\"metrics\");\n \n var config = $\"\"\"\n global:\n scrape_interval: 15s\n \n scrape_configs:\n - job_name: 'api'\n metrics_path: '/metrics'\n static_configs:\n - targets: ['host.docker.internal:{apiEndpoint.Property(EndpointProperty.TargetPort)}']\n \"\"\";\n \n return [new ContainerFile { \n Name = \"prometheus.yml\", \n Contents = config \n }];\n});\n```\n\n### Source Code Reference\n\nContainer file generation: `src/Aspire.Hosting/Containers/ContainerResourceBuilderExtensions.cs`\nEndpoint resolution: `src/Aspire.Hosting/ApplicationModel/EndpointReference.cs`\n\n### Step-by-Step Guide\n\n1. **Add Prometheus container**: `AddContainer(\"prometheus\", \"prom/prometheus\")`\n2. **Create metrics endpoints**: `WithHttpEndpoint(name: \"metrics\", ...)`\n3. **Reference endpoints**: Use `WithReference` for networking\n4. **Generate config**: Use `WithContainerFiles` callback\n5. **Use endpoint properties**: Access `Port` or `Property(EndpointProperty.TargetPort)`\n\n### Common Pitfalls\n\n- **Callback timing**: Endpoint resolution happens at build time\n- **Container networking**: Use correct hostname (host.docker.internal vs container name)\n- **File permissions**: Set proper `UnixFileMode` for config files\n\n### Additional Resources\n\n- Aspire Dashboard for built-in metrics visualization\n- OpenTelemetry Prometheus exporter for .NET\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8583,
"title": "Having trouble getting an Azure Storage Queue trigger function working in Aspire",
"url": "https://github.com/dotnet/aspire/discussions/8583",
"category": "Q&A",
"author": "mip1983",
"created_at": "2025-04-07T10:24:35Z",
"updated_at": "2025-04-29T08:50:04Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Having trouble getting an Azure Storage Queue trigger function working in Aspire. This may indicate a potential issue or bug. Technologies involved: azure, azure-functions, azure-storage. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"azure",
"good first issue",
"area-tooling",
"azure-functions",
"area-cli",
"azure-storage",
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"exception_type"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"console",
"message",
"logging",
"auth"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "basic",
"technologies_mentioned": [
"azure",
"azure-functions",
"azure-storage"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Azure Functions resource"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Having trouble getting an Azure Storage Queue trigger functi...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8583:\n- **Discussion**: [Having trouble getting an Azure Storage Queue trigger function working in Aspire](https://github.com/dotnet/aspire/discussions/8583)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Having trouble getting an Azure Storage Queue trigger function working in Aspire\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add Azure Functions resource\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #8583 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Azure Functions resource' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Azure Functions resource"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13227,
13204,
12484,
12338
]
},
{
"discussion_number": 8438,
"title": "Is it possible to configure unique key policy for cosmos container in apphost?",
"url": "https://github.com/dotnet/aspire/discussions/8438",
"category": "Q&A",
"author": "primozstu",
"created_at": "2025-03-31T10:50:25Z",
"updated_at": "2025-06-15T16:33:05Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is it possible to configure unique key policy for cosmos container in apphost?. Technologies involved: azure-cosmosdb. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"azure-cosmosdb",
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"config",
"db",
"port"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure-cosmosdb"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Aspire",
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Aspire"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8418,
"title": "{ in interpolated string break ReferenceExpression parser",
"url": "https://github.com/dotnet/aspire/discussions/8418",
"category": "Q&A",
"author": "scrocquesel",
"created_at": "2025-03-30T13:22:52Z",
"updated_at": "2025-04-27T05:34:40Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about { in interpolated string break ReferenceExpression parser. This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"area-tooling"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"fails",
"failed",
"bug",
"issue",
"stack_trace",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"container",
"environment",
"ui",
"keycloak",
"endpoint"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Custom resources"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] { in interpolated string break ReferenceExpression parser",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8418:\n- **Discussion**: [{ in interpolated string break ReferenceExpression parser](https://github.com/dotnet/aspire/discussions/8418)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: { in interpolated string break ReferenceExpression parser\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Custom resources\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8418 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Custom resources' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Custom resources"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8288,
"title": "How to modify the container registry?",
"url": "https://github.com/dotnet/aspire/discussions/8288",
"category": "Q&A",
"author": "Varorbc",
"created_at": "2025-03-25T12:28:13Z",
"updated_at": "2025-04-28T12:58:08Z",
"state": "closed",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to modify the container registry?. This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"docker",
"container"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to modify the container registry?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8288:\n- **Discussion**: [How to modify the container registry?](https://github.com/dotnet/aspire/discussions/8288)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to modify the container registry?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8288 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Aspire"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8278,
"title": "SqlServer container rebuilt every run using WithDockerfile(..) and .WithLifetime(ContainerLifetime.Persistent)",
"url": "https://github.com/dotnet/aspire/discussions/8278",
"category": "Q&A",
"author": "MiniGuinea",
"created_at": "2025-03-25T01:48:33Z",
"updated_at": "2025-03-25T02:46:14Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about SqlServer container rebuilt every run using WithDockerfile(..) and .WithLifetime. This may indicate a potential issue or bug. Technologies involved: sqlserver. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"test",
"database",
"health check"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"sqlserver"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Project resource type",
"Custom container names",
"Handle data migration",
"Configure a persistent container"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Project resource type' section for guidance",
"See the 'Custom container names' section for guidance",
"See the 'Handle data migration' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Project resource type",
"Section: Custom container names"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8277,
"title": "Configuring Standalone Aspire Dashboard Behind a Proxy with docker compose",
"url": "https://github.com/dotnet/aspire/discussions/8277",
"category": "Q&A",
"author": "chertby",
"created_at": "2025-03-24T23:04:50Z",
"updated_at": "2025-05-02T19:11:54Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Configuring Standalone Aspire Dashboard Behind a Proxy with docker compose. Technologies involved: docker-compose. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-deployment"
],
"suggested_labels": [
"area-dashboard",
"area-deployment",
"help wanted",
"docker-compose"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"dashboard",
"proxy",
"docker"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"docker-compose"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: Environment variables"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8257,
"title": "MigrationWorker scale to 0",
"url": "https://github.com/dotnet/aspire/discussions/8257",
"category": "Q&A",
"author": "huberttrueselftrueme",
"created_at": "2025-03-22T12:12:15Z",
"updated_at": "2025-03-22T12:12:16Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about MigrationWorker scale to 0. This may indicate a potential issue or bug. Technologies involved: postgres, azure, azure-storage. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-cli",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"postgres",
"area-cli",
"area-templates",
"azure-servicebus",
"azure-storage",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"issue",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"dashboard",
"database",
"servicebus"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"azure",
"azure-storage",
"azure-servicebus"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] MigrationWorker scale to 0",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8257:\n- **Discussion**: [MigrationWorker scale to 0](https://github.com/dotnet/aspire/discussions/8257)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: MigrationWorker scale to 0\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #8257 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 8256,
"title": "External non-HTTP(s) endpoints are not supported",
"url": "https://github.com/dotnet/aspire/discussions/8256",
"category": "Q&A",
"author": "AndiRudi",
"created_at": "2025-03-22T09:46:07Z",
"updated_at": "2025-03-26T11:34:33Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about External non-HTTP(s) endpoints are not supported. This appears to report an error or unexpected behavior. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-service-discovery",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"error_code"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"endpoint",
"local"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8187,
"title": "Why are database explorer resource names prefixed by the first resource that adds them?",
"url": "https://github.com/dotnet/aspire/discussions/8187",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-03-19T20:27:48Z",
"updated_at": "2025-03-21T18:32:07Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Why are database explorer resource names prefixed by the first resource that add. Technologies involved: redis, mongodb, docker-compose. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"mongodb",
"docker-compose",
"area-dashboard",
"redis"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"ui",
"database"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"redis",
"mongodb",
"docker-compose"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"Aspire",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the 'Aspire' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: Aspire"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 8178,
"title": "Support for kubernetes CRDs and CRs",
"url": "https://github.com/dotnet/aspire/discussions/8178",
"category": "Q&A",
"author": "jegadeesanponnusamy",
"created_at": "2025-03-19T16:26:28Z",
"updated_at": "2025-03-19T16:26:29Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Support for kubernetes CRDs and CRs. Technologies involved: kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-deployment",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"kubernetes",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"environment",
"port",
"local",
"custom resource"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"kubernetes"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Custom resources",
"[Code-centric control](#define-your-stack-in-code)",
"[Flexible deployments](#local-first-production-ready)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Support for kubernetes CRDs and CRs",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8178:\n- **Discussion**: [Support for kubernetes CRDs and CRs](https://github.com/dotnet/aspire/discussions/8178)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Support for kubernetes CRDs and CRs\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Custom resources, [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8178 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Custom resources' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Custom resources"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8175,
"title": "Dapr Getting started: Setting up Service with Grpc and Http/1",
"url": "https://github.com/dotnet/aspire/discussions/8175",
"category": "Q&A",
"author": "bobo-byte",
"created_at": "2025-03-19T12:50:22Z",
"updated_at": "2025-03-19T12:50:23Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Dapr Getting started: Setting up Service with Grpc and Http/1. This appears to report an error or unexpected behavior. Technologies involved: dapr. Topic relates to deployment.",
"analysis": {
"issue_type": "security",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"dapr",
"area-app-model",
"area-tooling",
"area-cli",
"area-service-discovery",
"area-dashboard",
"security \ud83d\udd10"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"failed",
"error_code",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"test",
"auth"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"dapr"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Use Dapr client"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Dapr Getting started: Setting up Service with Grpc and Http/...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8175:\n- **Discussion**: [Dapr Getting started: Setting up Service with Grpc and Http/1](https://github.com/dotnet/aspire/discussions/8175)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Dapr Getting started: Setting up Service with Grpc and Http/1\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Use Dapr client\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8175 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Use Dapr client' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Use Dapr client"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8141,
"title": "How to get access from client side to container images",
"url": "https://github.com/dotnet/aspire/discussions/8141",
"category": "Q&A",
"author": "axies20",
"created_at": "2025-03-18T16:08:43Z",
"updated_at": "2025-03-21T23:58:50Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to get access from client side to container images. This may indicate a potential issue or bug. Technologies involved: blazor-wasm. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-cli",
"blazor-wasm",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"stack_trace",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"container",
"environment",
"ui",
"test",
"endpoint"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to get access from client side to container images",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8141:\n- **Discussion**: [How to get access from client side to container images](https://github.com/dotnet/aspire/discussions/8141)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to get access from client side to container images\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #8141 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8118,
"title": "Aspire with MongoDB and EFCore",
"url": "https://github.com/dotnet/aspire/discussions/8118",
"category": "Q&A",
"author": "JohnnyDevCraft",
"created_at": "2025-03-17T18:58:57Z",
"updated_at": "2025-04-15T09:14:06Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire with MongoDB and EFCore. This may indicate a potential issue or bug. Technologies involved: redis, mongodb, entityframework. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"entityframework",
"area-cli",
"mongodb",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"redis"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"ui",
"database",
"message",
"run",
"extension"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"redis",
"mongodb",
"entityframework"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add MongoDB client"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire with MongoDB and EFCore",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8118:\n- **Discussion**: [Aspire with MongoDB and EFCore](https://github.com/dotnet/aspire/discussions/8118)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire with MongoDB and EFCore\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add MongoDB client\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #8118 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Add MongoDB client' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add MongoDB client"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13790,
13694,
13675,
13670,
13484,
13227,
12509,
12227,
11970,
11212
]
},
{
"discussion_number": 8074,
"title": "Is it possible to start a resource with run time information from another resource?",
"url": "https://github.com/dotnet/aspire/discussions/8074",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-03-14T11:42:42Z",
"updated_at": "2025-03-14T14:41:44Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is it possible to start a resource with run time information from another resour. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"area-cli",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui",
"identity",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Built-in resources and lifecycle",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Built-in resources and lifecycle' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: Built-in resources and lifecycle"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 8058,
"title": "Running Standalone Aspire Dashboard With ASPNETCORE_PATHBASE",
"url": "https://github.com/dotnet/aspire/discussions/8058",
"category": "Q&A",
"author": "jakenuts",
"created_at": "2025-03-13T18:19:16Z",
"updated_at": "2025-04-01T21:22:21Z",
"state": "closed",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Running Standalone Aspire Dashboard With ASPNETCORE_PATHBASE. This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-tooling"
],
"suggested_labels": [
"area-dashboard",
"area-tooling"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"docker",
"config",
"dashboard",
"url",
"run"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Define your stack in code",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 8054,
"title": "Keycloak Postgres Aspire networking issues",
"url": "https://github.com/dotnet/aspire/discussions/8054",
"category": "Q&A",
"author": "sdukehart-omnesoft",
"created_at": "2025-03-13T13:06:24Z",
"updated_at": "2025-03-19T16:27:16Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Keycloak Postgres Aspire networking issues. This may indicate a potential issue or bug. Technologies involved: postgres, azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-tooling",
"postgres",
"area-service-discovery",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"issue",
"exception_type"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"container",
"config",
"dashboard",
"database",
"keycloak"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Custom resources"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Keycloak Postgres Aspire networking issues",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8054:\n- **Discussion**: [Keycloak Postgres Aspire networking issues](https://github.com/dotnet/aspire/discussions/8054)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Keycloak Postgres Aspire networking issues\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Custom resources\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #8054 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Custom resources' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Custom resources"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 8036,
"title": "Is there a way to have a visible console window?",
"url": "https://github.com/dotnet/aspire/discussions/8036",
"category": "Q&A",
"author": "delinx32",
"created_at": "2025-03-12T13:05:47Z",
"updated_at": "2025-06-18T07:16:14Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is there a way to have a visible console window?. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"console",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Is there a way to have a visible console window?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8036:\n- **Discussion**: [Is there a way to have a visible console window?](https://github.com/dotnet/aspire/discussions/8036)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Is there a way to have a visible console window?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #8036 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 8002,
"title": "Is there a way to log the resolved URL when using service discovery?",
"url": "https://github.com/dotnet/aspire/discussions/8002",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-03-11T17:30:30Z",
"updated_at": "2025-03-11T17:30:31Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is there a way to log the resolved URL when using service discovery?. This appears to report an error or unexpected behavior. Topic relates to networking.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-service-discovery",
"area-telemetry"
],
"suggested_labels": [
"area-service-discovery",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error"
],
"severity": "medium",
"topic": "networking",
"subtopics": [
"https"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Is there a way to log the resolved URL when using service di...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #8002:\n- **Discussion**: [Is there a way to log the resolved URL when using service discovery?](https://github.com/dotnet/aspire/discussions/8002)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Is there a way to log the resolved URL when using service discovery?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of networking in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"networking"
],
"priority": "high",
"rationale": "Discussion #8002 reveals documentation gap for networking"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about networking may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
9885,
6031,
5766,
5091
]
},
{
"discussion_number": 7786,
"title": "Any way for getting the container ID that the resource is running?",
"url": "https://github.com/dotnet/aspire/discussions/7786",
"category": "Q&A",
"author": "aalho",
"created_at": "2025-02-26T11:00:18Z",
"updated_at": "2025-02-26T11:00:18Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Any way for getting the container ID that the resource is running?. Technologies involved: sqlserver, azure, azure-storage. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"help wanted",
"azure-storage",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"publish",
"environment",
"dashboard",
"test",
"database"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"sqlserver",
"azure",
"azure-storage"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Any way for getting the container ID that the resource is ru...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7786:\n- **Discussion**: [Any way for getting the container ID that the resource is running?](https://github.com/dotnet/aspire/discussions/7786)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Any way for getting the container ID that the resource is running?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Flexible deployments](#local-first-production-ready), [Observability from the start](#opentelemetry-developer-dashboard), Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #7786 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Flexible deployments](#local-first-production-ready)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7638,
"title": "After adding aspire project, Failing to deploy sql database project due to MSBuild Exception",
"url": "https://github.com/dotnet/aspire/discussions/7638",
"category": "Q&A",
"author": "Abdul23061989",
"created_at": "2025-02-16T13:14:01Z",
"updated_at": "2025-02-16T13:15:12Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about After adding aspire project, Failing to deploy sql database project due to MSBui. This appears to report an error or unexpected behavior. Technologies involved: sqlserver. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment",
"area-telemetry"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"area-dashboard",
"area-integrations",
"area-deployment",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"failing",
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"dashboard",
"database",
"https",
"run"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"sqlserver"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Project resource type",
"Add SQL project",
"Configure a persistent container"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Project resource type' section for guidance",
"See the 'Add SQL project' section for guidance",
"See the 'Configure a persistent container' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Project resource type",
"Section: Add SQL project"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7605,
"title": "Passing command line args to a console application",
"url": "https://github.com/dotnet/aspire/discussions/7605",
"category": "Q&A",
"author": "rob-king-volpara",
"created_at": "2025-02-13T21:00:35Z",
"updated_at": "2025-04-27T20:38:14Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Passing command line args to a console application. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-cli"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"help wanted",
"area-cli"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"parameter",
"console",
"database",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Optional wiring examples",
"Aspire",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Optional wiring examples' section for guidance",
"See the 'Aspire' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Optional wiring examples",
"Section: Aspire"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 7564,
"title": "REACT VS project template",
"url": "https://github.com/dotnet/aspire/discussions/7564",
"category": "Q&A",
"author": "martycook",
"created_at": "2025-02-12T15:25:21Z",
"updated_at": "2025-02-12T15:25:22Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about REACT VS project template. This may indicate a potential issue or bug. Technologies involved: nodejs, vs, vs-code. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-cli",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"good first issue",
"area-tooling",
"area-cli",
"nodejs",
"area-templates",
"vs",
"area-dashboard",
"vs-code"
],
"is_potential_issue": true,
"issue_indicators": [
"bug",
"doesn't work",
"issue"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"ui",
"port",
"debug",
"react"
],
"is_question": true,
"question_type": "how-to",
"complexity": "basic",
"technologies_mentioned": [
"nodejs",
"vs",
"vs-code"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] REACT VS project template",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7564:\n- **Discussion**: [REACT VS project template](https://github.com/dotnet/aspire/discussions/7564)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: REACT VS project template\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #7564 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13790,
13670,
13484,
12561,
12509,
12227,
11970,
11212,
10927
]
},
{
"discussion_number": 7541,
"title": "Half of the project is covered with errors. Are there any ideas how to fix it?",
"url": "https://github.com/dotnet/aspire/discussions/7541",
"category": "Q&A",
"author": "Zombach",
"created_at": "2025-02-11T22:02:08Z",
"updated_at": "2025-02-11T22:25:38Z",
"state": "closed",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to half of the project is covered with errors. are there any ideas fix it?. This appears to report an error or unexpected behavior. Technologies involved: azure-storage, vs. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-tooling"
],
"suggested_labels": [
"area-dashboard",
"area-tooling",
"azure-storage",
"vs"
],
"is_potential_issue": true,
"issue_indicators": [
"error"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"ui",
"test",
"https",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure-storage",
"vs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Half of the project is covered with errors. Are there any id...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7541:\n- **Discussion**: [Half of the project is covered with errors. Are there any ideas how to fix it?](https://github.com/dotnet/aspire/discussions/7541)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Half of the project is covered with errors. Are there any ideas how to fix it?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #7541 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13849,
13790,
13670,
13484,
12561,
12509,
12227,
11970,
11212,
10927
]
},
{
"discussion_number": 7536,
"title": "Aspire template VS2022 broken",
"url": "https://github.com/dotnet/aspire/discussions/7536",
"category": "Q&A",
"author": "ngruson",
"created_at": "2025-02-11T16:32:36Z",
"updated_at": "2025-02-11T16:39:27Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire template VS2022 broken. This appears to report an error or unexpected behavior. Technologies involved: vs. Topic relates to general.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-templates",
"vs"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"broken"
],
"severity": "medium",
"topic": "general",
"subtopics": [],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"vs"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire template VS2022 broken",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7536:\n- **Discussion**: [Aspire template VS2022 broken](https://github.com/dotnet/aspire/discussions/7536)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire template VS2022 broken\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of general in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"general"
],
"priority": "high",
"rationale": "Discussion #7536 reveals documentation gap for general"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about general may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
12561,
12518,
11660,
11382,
11212,
10927,
9374,
9355,
7564,
7541
]
},
{
"discussion_number": 9886,
"title": "Help with configure ServiceBus and MassTransit",
"url": "https://github.com/dotnet/aspire/discussions/9886",
"category": "Q&A",
"author": "huberttrueselftrueme",
"created_at": "2025-02-06T08:52:59Z",
"updated_at": "2025-06-14T06:11:36Z",
"state": "open",
"comments_count": 7,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Help with configure ServiceBus and MassTransit. This may indicate a potential issue or bug. Technologies involved: azure, azure-servicebus. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery",
"area-cli"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-cli",
"azure-servicebus",
"area-service-discovery",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"crash"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"servicebus",
"endpoint"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-servicebus"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Service Bus client",
"Environment variables"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Help with configure ServiceBus and MassTransit",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9886:\n- **Discussion**: [Help with configure ServiceBus and MassTransit](https://github.com/dotnet/aspire/discussions/9886)\n- **Category**: Q&A\n- **Comments**: 7\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Help with configure ServiceBus and MassTransit\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Add Service Bus client, Environment variables\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 7) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #9886 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Service Bus client' section for guidance",
"See the 'Environment variables' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Service Bus client",
"Section: Environment variables"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7413,
"title": "Protobuf Exception when starting",
"url": "https://github.com/dotnet/aspire/discussions/7413",
"category": "Q&A",
"author": "obiwanjacobi",
"created_at": "2025-02-05T12:28:42Z",
"updated_at": "2025-02-07T00:54:12Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 8763,
"duplicate_reason": "Title similarity: 48%, Keyword overlap: 2%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Protobuf Exception when starting. This appears to report an error or unexpected behavior. Topic relates to dashboard.",
"analysis": {
"issue_type": "performance",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-telemetry",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-dashboard",
"area-telemetry",
"perf"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"unexpected",
"stack_trace",
"exception_type"
],
"severity": "high",
"topic": "dashboard",
"subtopics": [
"dashboard",
"db",
"message",
"telemetry",
"port"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Protobuf Exception when starting",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7413:\n- **Discussion**: [Protobuf Exception when starting](https://github.com/dotnet/aspire/discussions/7413)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Protobuf Exception when starting\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #7413 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 7400,
"title": "How to setup dotnet-monitor?",
"url": "https://github.com/dotnet/aspire/discussions/7400",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-02-04T09:36:38Z",
"updated_at": "2025-02-08T21:03:45Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to setup dotnet-monitor?. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-telemetry"
],
"suggested_labels": [
"help wanted",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Aspire",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to setup dotnet-monitor?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7400:\n- **Discussion**: [How to setup dotnet-monitor?](https://github.com/dotnet/aspire/discussions/7400)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to setup dotnet-monitor?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Aspire, [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #7400 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Aspire' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Aspire",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7310,
"title": "Non Localhost Endpoints for Multi-Tenancy Support",
"url": "https://github.com/dotnet/aspire/discussions/7310",
"category": "Q&A",
"author": "rburnham-def",
"created_at": "2025-01-29T05:21:01Z",
"updated_at": "2025-01-29T05:25:38Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 12484,
"duplicate_reason": "Title similarity: 46%, Keyword overlap: 4%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Non Localhost Endpoints for Multi-Tenancy Support. This may indicate a potential issue or bug. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-service-discovery",
"area-cli"
],
"suggested_labels": [
"area-service-discovery",
"area-cli"
],
"is_potential_issue": true,
"issue_indicators": [
"problem"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"db",
"endpoint",
"local"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 7295,
"title": "NodeJs Npm app persistent",
"url": "https://github.com/dotnet/aspire/discussions/7295",
"category": "Q&A",
"author": "kvloover",
"created_at": "2025-01-28T07:56:21Z",
"updated_at": "2025-01-28T09:36:52Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about NodeJs Npm app persistent. Technologies involved: nodejs. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-cli"
],
"suggested_labels": [
"area-dashboard",
"help wanted",
"area-cli",
"nodejs"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"ui",
"run",
"node"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"nodejs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Aspire",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Aspire' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Aspire",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13484,
13329,
13204
]
},
{
"discussion_number": 7273,
"title": "How Do I Pass Secrets into the Azure DevOps YAML Pipeline with Deploying via azd?",
"url": "https://github.com/dotnet/aspire/discussions/7273",
"category": "Q&A",
"author": "essenbee2",
"created_at": "2025-01-27T16:59:20Z",
"updated_at": "2025-01-28T14:18:19Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to pass secrets into the azure devops yaml pipeline with deploying via azd?. This appears to report an error or unexpected behavior. Technologies involved: redis, azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery",
"area-cli",
"area-templates",
"area-azd"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-azd",
"area-cli",
"area-templates",
"area-service-discovery",
"area-dashboard",
"area-deployment",
"redis"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"failed",
"issue",
"error_code"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"deploy",
"parameter",
"ui",
"redis",
"logging"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"redis",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How Do I Pass Secrets into the Azure DevOps YAML Pipeline wi...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7273:\n- **Discussion**: [How Do I Pass Secrets into the Azure DevOps YAML Pipeline with Deploying via azd?](https://github.com/dotnet/aspire/discussions/7273)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How Do I Pass Secrets into the Azure DevOps YAML Pipeline with Deploying via azd?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #7273 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 7264,
"title": "Aspire 9.0 - Different networking behaviour for Run and DistributedApplicationTestingBuilder",
"url": "https://github.com/dotnet/aspire/discussions/7264",
"category": "Q&A",
"author": "ggmueller",
"created_at": "2025-01-27T14:51:17Z",
"updated_at": "2025-01-29T22:49:44Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 8594,
"duplicate_reason": "Title similarity: 63%, Keyword overlap: 4%, Topic overlap: 75%",
"plain_text_analysis": "User is seeking guidance about Aspire 9.0 - Different networking behaviour for Run and DistributedApplicationTe. Technologies involved: sqlserver. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"sqlserver",
"help wanted",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"config",
"ui",
"test",
"sql"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": [
"sqlserver"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7170,
"title": "Is it possible to have the same container port exposed as TCP and UDP?",
"url": "https://github.com/dotnet/aspire/discussions/7170",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2025-01-20T15:59:06Z",
"updated_at": "2025-02-20T18:14:06Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is it possible to have the same container port exposed as TCP and UDP?. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"port",
"run",
"container"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7140,
"title": "Deploy to different environments",
"url": "https://github.com/dotnet/aspire/discussions/7140",
"category": "Q&A",
"author": "mlankamp",
"created_at": "2025-01-17T14:17:53Z",
"updated_at": "2025-05-09T06:00:48Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Deploy to different environments. Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-deployment"
],
"suggested_labels": [
"help wanted",
"azure-container-apps",
"documentation",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"environment",
"ui",
"https",
"azure"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Deploy to different environments",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7140:\n- **Discussion**: [Deploy to different environments](https://github.com/dotnet/aspire/discussions/7140)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Deploy to different environments\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Flexible deployments](#local-first-production-ready), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #7140 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Flexible deployments](#local-first-production-ready)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7119,
"title": "Integration tests with Aspire on CI runner",
"url": "https://github.com/dotnet/aspire/discussions/7119",
"category": "Q&A",
"author": "Kralizek",
"created_at": "2025-01-15T15:22:54Z",
"updated_at": "2025-07-20T07:36:35Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Integration tests with Aspire on CI runner. Technologies involved: docker-compose. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"docker-compose",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"console",
"test",
"run",
"integration"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"docker-compose"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"[Code-centric control](#define-your-stack-in-code)",
"[Modular and extensible](#explore-integrations)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Integration tests with Aspire on CI runner",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7119:\n- **Discussion**: [Integration tests with Aspire on CI runner](https://github.com/dotnet/aspire/discussions/7119)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Integration tests with Aspire on CI runner\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: See also, [Code-centric control](#define-your-stack-in-code), [Modular and extensible](#explore-integrations)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #7119 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Modular and extensible](#explore-integrations)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 7070,
"title": "The SDK 'Microsoft.DotNet.Arcade.Sdk' specified could not be found.",
"url": "https://github.com/dotnet/aspire/discussions/7070",
"category": "Q&A",
"author": "ngruson",
"created_at": "2025-01-11T16:37:32Z",
"updated_at": "2025-01-11T17:22:56Z",
"state": "closed",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about The SDK 'Microsoft.DotNet.Arcade.Sdk' specified could not be found.. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] The SDK 'Microsoft.DotNet.Arcade.Sdk' specified could not be...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7070:\n- **Discussion**: [The SDK 'Microsoft.DotNet.Arcade.Sdk' specified could not be found.](https://github.com/dotnet/aspire/discussions/7070)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: The SDK 'Microsoft.DotNet.Arcade.Sdk' specified could not be found.\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #7070 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 7036,
"title": "Aspire Integration tests & code coverage collection",
"url": "https://github.com/dotnet/aspire/discussions/7036",
"category": "Q&A",
"author": "ealeykin",
"created_at": "2025-01-07T21:42:29Z",
"updated_at": "2025-04-02T13:41:43Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 9452,
"duplicate_reason": "Title similarity: 55%, Keyword overlap: 4%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Aspire Integration tests & code coverage collection. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"area-integrations",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"ui",
"test",
"port",
"integration"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Modular and extensible](#explore-integrations)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 7035,
"title": "Aspire and Microsoft identity platform's IDownstreamApi integration",
"url": "https://github.com/dotnet/aspire/discussions/7035",
"category": "Q&A",
"author": "Meir017",
"created_at": "2025-01-07T19:56:41Z",
"updated_at": "2025-12-23T21:43:03Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire and Microsoft identity platform's IDownstreamApi integration. Technologies involved: azure, azure-storage. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"area-cli",
"azure-storage",
"azure",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"console",
"identity",
"https",
"local"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-storage"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Define your stack in code",
"Built-in resources and lifecycle"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire and Microsoft identity platform's IDownstreamApi inte...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7035:\n- **Discussion**: [Aspire and Microsoft identity platform's IDownstreamApi integration](https://github.com/dotnet/aspire/discussions/7035)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire and Microsoft identity platform's IDownstreamApi integration\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Define your stack in code, Built-in resources and lifecycle\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #7035 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Define your stack in code' section for guidance",
"See the 'Built-in resources and lifecycle' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Define your stack in code",
"Section: Built-in resources and lifecycle"
],
"detailed_response": "## Deploying Aspire to Azure Container Apps\n\n### Solution\n\nUse `azd` (Azure Developer CLI) for seamless deployment:\n\n### Step-by-Step Guide\n\n```bash\n# Initialize azd in your project\nazd init\n\n# Deploy to Azure\nazd up\n\n# For production, provision first\nazd provision\nazd deploy\n```\n\n### Code Example (AppHost Configuration)\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithExternalHttpEndpoints(); // Exposes publicly\n\n// Add Azure resources\nvar storage = builder.AddAzureStorage(\"storage\")\n .RunAsEmulator(); // Local dev only\n\nbuilder.Build().Run();\n```\n\n### Source Code Reference\n\nAzure provisioning: `src/Aspire.Hosting.Azure/Provisioning/`\nContainer Apps manifest: `src/Aspire.Hosting.Azure.ContainerApps/`\n\n### Infrastructure Configuration\n\n```csharp\n// Custom Azure configuration\nbuilder.AddAzureContainerApps(\"aca\")\n .ConfigureInfrastructure(infra =>\n {\n var env = infra.GetProvisionableResources()\n .OfType<ContainerAppEnvironment>()\n .Single();\n env.Properties.ZoneRedundant = true;\n });\n```\n\n### Common Pitfalls\n\n- **Secrets**: Use Azure Key Vault for production secrets\n- **Scaling**: Configure min/max replicas in production\n- **Networking**: Consider VNet integration for private resources\n\n### Additional Resources\n\n- Azure Container Apps documentation\n- azd templates for Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13227,
13204,
12484,
12338
]
},
{
"discussion_number": 7007,
"title": "Using the AzureKeyVault created by azd up",
"url": "https://github.com/dotnet/aspire/discussions/7007",
"category": "Q&A",
"author": "nalper-omnesoft",
"created_at": "2025-01-01T16:49:13Z",
"updated_at": "2025-04-27T06:51:19Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Using the AzureKeyVault created by azd up. Technologies involved: postgres, azure, azure-keyvault. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery",
"area-cli",
"area-azd"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"azure",
"area-azd",
"postgres",
"area-cli",
"azure-keyvault",
"area-service-discovery",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"test",
"database"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres",
"azure",
"azure-keyvault"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Using the AzureKeyVault created by azd up",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7007:\n- **Discussion**: [Using the AzureKeyVault created by azd up](https://github.com/dotnet/aspire/discussions/7007)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Using the AzureKeyVault created by azd up\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #7007 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 6981,
"title": "How to debug/attach vscode to the browser that Aspire launches?",
"url": "https://github.com/dotnet/aspire/discussions/6981",
"category": "Q&A",
"author": "toddsmith-adsk",
"created_at": "2024-12-22T17:48:17Z",
"updated_at": "2024-12-22T17:48:18Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to debug/attach vscode to the browser that aspire launches?. This may indicate a potential issue or bug. Technologies involved: nodejs, vs-code. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-cli",
"nodejs",
"area-service-discovery",
"area-dashboard",
"vs-code"
],
"is_potential_issue": true,
"issue_indicators": [
"bug"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"settings",
"dashboard",
"message",
"endpoint",
"local"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"nodejs",
"vs-code"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Configure development certificate trust per resource",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Configure development certificate trust per resource' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Configure development certificate trust per resource"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13809,
13484,
13227,
12484,
12338,
12114,
11885,
11212,
10765
]
},
{
"discussion_number": 6960,
"title": "How to run Aspire dashboard in private azure container apps environment?",
"url": "https://github.com/dotnet/aspire/discussions/6960",
"category": "Q&A",
"author": "JasonRodman",
"created_at": "2024-12-17T16:30:54Z",
"updated_at": "2025-08-28T05:38:59Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to run aspire dashboard in private azure container apps environment?. This may indicate a potential issue or bug. Technologies involved: kubernetes, azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-tooling",
"area-cli",
"azure-container-apps",
"kubernetes",
"area-service-discovery",
"area-dashboard",
"area-deployment",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"fails",
"doesn't work"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"dashboard",
"telemetry",
"auth"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"kubernetes",
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to run Aspire dashboard in private azure container apps ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6960:\n- **Discussion**: [How to run Aspire dashboard in private azure container apps environment?](https://github.com/dotnet/aspire/discussions/6960)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to run Aspire dashboard in private azure container apps environment?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Code-centric control](#define-your-stack-in-code), Define your stack in code\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6960 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6932,
"title": "Should StackExchangeRedisInstrumentationOptions be public ?",
"url": "https://github.com/dotnet/aspire/discussions/6932",
"category": "Q&A",
"author": "alefcarlos",
"created_at": "2024-12-11T21:22:00Z",
"updated_at": "2024-12-12T16:57:56Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Should StackExchangeRedisInstrumentationOptions be public ?. Technologies involved: redis. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"help wanted",
"area-app-model",
"redis"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"redis"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"redis"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Should StackExchangeRedisInstrumentationOptions be public ?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6932:\n- **Discussion**: [Should StackExchangeRedisInstrumentationOptions be public ?](https://github.com/dotnet/aspire/discussions/6932)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Should StackExchangeRedisInstrumentationOptions be public ?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Define your stack in code\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #6932 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Define your stack in code"
]
},
"related_discussions": [
13809,
13694,
13675,
13227,
12484,
12338,
12114,
11885,
11212,
10765
]
},
{
"discussion_number": 6930,
"title": "Not able to fetch OpenTelemetry environment variables in React app & facing CORS issue on OTEL_EXPORTER_OTLP_ENDPOINT",
"url": "https://github.com/dotnet/aspire/discussions/6930",
"category": "Q&A",
"author": "waqarahmed0340",
"created_at": "2024-12-11T15:33:58Z",
"updated_at": "2024-12-11T15:33:59Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Not able to fetch OpenTelemetry environment variables in React app & facing CORS. This may indicate a potential issue or bug. Technologies involved: nodejs. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"good first issue",
"area-tooling",
"area-cli",
"nodejs",
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"dashboard",
"telemetry",
"endpoint",
"local"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": [
"nodejs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13809,
13484,
13227,
12484,
12338,
12114,
11885,
11212,
10765
]
},
{
"discussion_number": 6927,
"title": "Can i deploy aspire to an azure web app?",
"url": "https://github.com/dotnet/aspire/discussions/6927",
"category": "Q&A",
"author": "Hana-fubuki",
"created_at": "2024-12-11T03:08:31Z",
"updated_at": "2024-12-11T03:08:31Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 9343,
"duplicate_reason": "Title similarity: 41%, Keyword overlap: 4%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Can i deploy aspire to an azure web app?. This may indicate a potential issue or bug. Technologies involved: azure, azure-container-apps, azure-functions. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-deployment",
"area-tooling"
],
"suggested_labels": [
"area-tooling",
"azure-functions",
"azure-container-apps",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"https",
"azure",
"container"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-container-apps",
"azure-functions"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Can i deploy aspire to an azure web app?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6927:\n- **Discussion**: [Can i deploy aspire to an azure web app?](https://github.com/dotnet/aspire/discussions/6927)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Can i deploy aspire to an azure web app?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard), Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6927 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6924,
"title": "Containers created with `AddContainer(..).WithLifetime(..)`",
"url": "https://github.com/dotnet/aspire/discussions/6924",
"category": "Q&A",
"author": "raffaeler",
"created_at": "2024-12-10T11:51:28Z",
"updated_at": "2025-01-21T08:53:55Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Containers created with `AddContainer(..).WithLifetime(..)`. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"config",
"dashboard",
"db",
"endpoint"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Configure a persistent container"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Containers created with `AddContainer(..).WithLifetime(..)`",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6924:\n- **Discussion**: [Containers created with `AddContainer(..).WithLifetime(..)`](https://github.com/dotnet/aspire/discussions/6924)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Containers created with `AddContainer(..).WithLifetime(..)`\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Configure a persistent container\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6924 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Configure a persistent container' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Configure a persistent container"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6899,
"title": "MAUI projects in Aspire",
"url": "https://github.com/dotnet/aspire/discussions/6899",
"category": "Q&A",
"author": "BuildFactoryDk",
"created_at": "2024-12-08T15:58:59Z",
"updated_at": "2024-12-08T15:59:00Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about MAUI projects in Aspire. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-tooling"
],
"suggested_labels": [
"area-dashboard",
"area-tooling",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui",
"https"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] MAUI projects in Aspire",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6899:\n- **Discussion**: [MAUI projects in Aspire](https://github.com/dotnet/aspire/discussions/6899)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: MAUI projects in Aspire\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #6899 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 7116,
"title": "Service discovery / host name resolution does not work",
"url": "https://github.com/dotnet/aspire/discussions/7116",
"category": "Q&A",
"author": "Lyra1337",
"created_at": "2024-12-04T23:41:12Z",
"updated_at": "2025-01-15T08:24:45Z",
"state": "open",
"comments_count": 8,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 9452,
"duplicate_reason": "Title similarity: 40%, Keyword overlap: 3%, Topic overlap: 67%",
"plain_text_analysis": "User is seeking guidance about Service discovery / host name resolution does not work. This may indicate a potential issue or bug. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-cli"
],
"suggested_labels": [
"area-service-discovery",
"area-app-model",
"area-dashboard",
"area-cli"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"issue",
"stack trace",
"problem",
"stack_trace",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"container",
"ui",
"test",
"message",
"endpoint"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Service discovery / host name resolution does not work",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #7116:\n- **Discussion**: [Service discovery / host name resolution does not work](https://github.com/dotnet/aspire/discussions/7116)\n- **Category**: Q&A\n- **Comments**: 8\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Service discovery / host name resolution does not work\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 8) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #7116 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6861,
"title": "How to inject TestClock or add TestAuthenticatonHandler for Api when testing with .net aspire.",
"url": "https://github.com/dotnet/aspire/discussions/6861",
"category": "Q&A",
"author": "huberttrueselftrueme",
"created_at": "2024-12-04T12:09:04Z",
"updated_at": "2024-12-04T12:12:08Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to inject testclock or add testauthenticatonhandler for api when testing with .net . Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"area-tooling",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"config",
"ui",
"test",
"auth"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Connection properties",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to inject TestClock or add TestAuthenticatonHandler for ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6861:\n- **Discussion**: [How to inject TestClock or add TestAuthenticatonHandler for Api when testing with .net aspire.](https://github.com/dotnet/aspire/discussions/6861)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to inject TestClock or add TestAuthenticatonHandler for Api when testing with .net aspire.\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Connection properties, Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6861 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Connection properties' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Connection properties",
"Section: Aspire"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6853,
"title": "What is the correct way to memory profile a specific service within Aspire",
"url": "https://github.com/dotnet/aspire/discussions/6853",
"category": "Q&A",
"author": "AlexNik4",
"created_at": "2024-12-02T00:40:03Z",
"updated_at": "2024-12-02T00:40:04Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about What is the correct way to memory profile a specific service within Aspire. This may indicate a potential issue or bug. Technologies involved: vs. Topic relates to dashboard.",
"analysis": {
"issue_type": "performance",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"area-tooling",
"vs",
"area-service-discovery",
"area-dashboard",
"perf"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"dashboard",
"port",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"vs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] What is the correct way to memory profile a specific service...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6853:\n- **Discussion**: [What is the correct way to memory profile a specific service within Aspire](https://github.com/dotnet/aspire/discussions/6853)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: What is the correct way to memory profile a specific service within Aspire\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #6853 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13790,
13670,
13484,
12561,
12509,
12227,
11970,
11212,
10927,
10910
]
},
{
"discussion_number": 6816,
"title": "Queries with Aspire Redis + RedisInsight + SignalR",
"url": "https://github.com/dotnet/aspire/discussions/6816",
"category": "Q&A",
"author": "mip1983",
"created_at": "2024-11-26T19:35:23Z",
"updated_at": "2025-07-23T14:36:18Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Queries with Aspire Redis + RedisInsight + SignalR. This may indicate a potential issue or bug. Technologies involved: redis, azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment",
"area-cli",
"area-azd"
],
"suggested_labels": [
"area-app-model",
"area-azd",
"area-cli",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment",
"redis"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"dashboard",
"redis",
"message"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"redis",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Queries with Aspire Redis + RedisInsight + SignalR",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6816:\n- **Discussion**: [Queries with Aspire Redis + RedisInsight + SignalR](https://github.com/dotnet/aspire/discussions/6816)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Queries with Aspire Redis + RedisInsight + SignalR\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6816 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 6769,
"title": "Deploy Blazor WASM with aspire and apir8",
"url": "https://github.com/dotnet/aspire/discussions/6769",
"category": "Q&A",
"author": "JarneVk",
"created_at": "2024-11-22T19:21:19Z",
"updated_at": "2024-11-22T19:21:20Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 9571,
"duplicate_reason": "Title similarity: 48%, Keyword overlap: 6%, Topic overlap: 67%",
"plain_text_analysis": "User is seeking guidance about Deploy Blazor WASM with aspire and apir8. This appears to report an error or unexpected behavior. Technologies involved: kubernetes, blazor-wasm. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-deployment"
],
"suggested_labels": [
"area-dashboard",
"kubernetes",
"area-deployment",
"blazor-wasm"
],
"is_potential_issue": true,
"issue_indicators": [
"error"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"port",
"docker"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"kubernetes",
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Deploy Blazor WASM with aspire and apir8",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6769:\n- **Discussion**: [Deploy Blazor WASM with aspire and apir8](https://github.com/dotnet/aspire/discussions/6769)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Deploy Blazor WASM with aspire and apir8\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6769 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6755,
"title": "Is there a way to customize the name shown in the dashboard?",
"url": "https://github.com/dotnet/aspire/discussions/6755",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2024-11-21T09:52:04Z",
"updated_at": "2024-11-22T09:01:18Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to is there a way to customize the name shown in the dashboard?. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Is there a way to customize the name shown in the dashboard?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6755:\n- **Discussion**: [Is there a way to customize the name shown in the dashboard?](https://github.com/dotnet/aspire/discussions/6755)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Is there a way to customize the name shown in the dashboard?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #6755 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 6748,
"title": "We are trying to run dotnet publish on our integration-test project to run artifact on other \"machine\", but get no output",
"url": "https://github.com/dotnet/aspire/discussions/6748",
"category": "Q&A",
"author": "ThomasCronholm",
"created_at": "2024-11-21T01:15:04Z",
"updated_at": "2024-11-25T21:14:31Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about We are trying to run dotnet publish on our integration-test project to run artif. This may indicate a potential issue or bug. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"issue",
"exception_type"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"publish",
"ui",
"test",
"run",
"azure"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] We are trying to run dotnet publish on our integration-test ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6748:\n- **Discussion**: [We are trying to run dotnet publish on our integration-test project to run artifact on other \"machine\", but get no output](https://github.com/dotnet/aspire/discussions/6748)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: We are trying to run dotnet publish on our integration-test project to run artifact on other \"machine\", but get no output\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6748 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6744,
"title": "How to get console output from web project when using DistributedApplicationTestingBuilder?",
"url": "https://github.com/dotnet/aspire/discussions/6744",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2024-11-20T15:36:37Z",
"updated_at": "2024-11-21T09:49:19Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to get console output from web project when using distributedapplicationtestingbuil. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-telemetry"
],
"suggested_labels": [
"help wanted",
"area-app-model",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"console",
"test",
"run",
"distributed"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to get console output from web project when using Distri...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6744:\n- **Discussion**: [How to get console output from web project when using DistributedApplicationTestingBuilder?](https://github.com/dotnet/aspire/discussions/6744)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to get console output from web project when using DistributedApplicationTestingBuilder?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #6744 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 6742,
"title": "When using DistributedApplicationTestingBuilder, how to force configuration on the app host?",
"url": "https://github.com/dotnet/aspire/discussions/6742",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2024-11-20T12:37:03Z",
"updated_at": "2024-11-20T13:00:35Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 6744,
"duplicate_reason": "Title similarity: 52%, Keyword overlap: 5%, Topic overlap: 67%",
"plain_text_analysis": "User is asking how to when using distributedapplicationtestingbuilder, force configuration on the app . Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"ui",
"test",
"distributed"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] When using DistributedApplicationTestingBuilder, how to forc...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6742:\n- **Discussion**: [When using DistributedApplicationTestingBuilder, how to force configuration on the app host?](https://github.com/dotnet/aspire/discussions/6742)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: When using DistributedApplicationTestingBuilder, how to force configuration on the app host?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #6742 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Define your stack in code"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 6734,
"title": "Integration testing with Aspire",
"url": "https://github.com/dotnet/aspire/discussions/6734",
"category": "Q&A",
"author": "Dazfl",
"created_at": "2024-11-19T11:40:21Z",
"updated_at": "2024-12-30T23:06:28Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 7119,
"duplicate_reason": "Title similarity: 77%, Keyword overlap: 9%, Topic overlap: 50%",
"plain_text_analysis": "User is seeking guidance about Integration testing with Aspire. This may indicate a potential issue or bug. Technologies involved: sqlserver, docker-compose. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"good first issue",
"docker-compose",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": true,
"issue_indicators": [
"bug"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"docker",
"ui",
"test",
"database",
"debug"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "basic",
"technologies_mentioned": [
"sqlserver",
"docker-compose"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"See also",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'See also' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: See also",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6731,
"title": "Deploy to Digital Ocean",
"url": "https://github.com/dotnet/aspire/discussions/6731",
"category": "Q&A",
"author": "dajma00",
"created_at": "2024-11-19T07:56:17Z",
"updated_at": "2025-04-27T06:41:09Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Deploy to Digital Ocean. Technologies involved: blazor-wasm. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"blazor-wasm",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"test",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Deploy to Digital Ocean",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6731:\n- **Discussion**: [Deploy to Digital Ocean](https://github.com/dotnet/aspire/discussions/6731)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Deploy to Digital Ocean\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6731 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6717,
"title": "How to deploy aspire app using azd in a particular VNET",
"url": "https://github.com/dotnet/aspire/discussions/6717",
"category": "Q&A",
"author": "faisalriazz",
"created_at": "2024-11-18T17:54:09Z",
"updated_at": "2025-11-03T13:03:19Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to deploy aspire app using azd in a particular vnet. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-deployment",
"area-azd"
],
"suggested_labels": [
"area-azd",
"area-deployment",
"help wanted",
"azure"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"azd"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to deploy aspire app using azd in a particular VNET",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6717:\n- **Discussion**: [How to deploy aspire app using azd in a particular VNET](https://github.com/dotnet/aspire/discussions/6717)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to deploy aspire app using azd in a particular VNET\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6717 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6706,
"title": "Keycloak Aspire, password parameter is not working.",
"url": "https://github.com/dotnet/aspire/discussions/6706",
"category": "Q&A",
"author": "fdonnet",
"created_at": "2024-11-18T09:21:40Z",
"updated_at": "2024-11-18T09:22:11Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Keycloak Aspire, password parameter is not working.. The user reports something not working as expected. Technologies involved: postgres, rabbitmq. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"postgres",
"rabbitmq"
],
"is_potential_issue": true,
"issue_indicators": [
"not working"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"parameter",
"ui",
"test",
"postgres",
"rabbitmq"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"postgres",
"rabbitmq"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Keycloak Aspire, password parameter is not working.",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6706:\n- **Discussion**: [Keycloak Aspire, password parameter is not working.](https://github.com/dotnet/aspire/discussions/6706)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Keycloak Aspire, password parameter is not working.\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #6706 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13694,
13329,
13227,
13069,
12983,
12906,
12484,
12338,
12114
]
},
{
"discussion_number": 6653,
"title": "How to pass SqlServerResource host and port to projects and containers",
"url": "https://github.com/dotnet/aspire/discussions/6653",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2024-11-13T10:20:36Z",
"updated_at": "2024-11-14T16:48:39Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 9544,
"duplicate_reason": "Title similarity: 49%, Keyword overlap: 6%, Topic overlap: 100%",
"plain_text_analysis": "User is asking how to pass sqlserverresource host and port to projects and containers. Technologies involved: sqlserver. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"help wanted",
"good first issue",
"documentation",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"ui",
"db",
"port"
],
"is_question": true,
"question_type": "how-to",
"complexity": "basic",
"technologies_mentioned": [
"sqlserver"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Aspire",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Aspire"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 9885,
"title": "AspNetCore.HealthChecks is heavily used but no longer maintained",
"url": "https://github.com/dotnet/aspire/discussions/9885",
"category": "Q&A",
"author": "pregress",
"created_at": "2024-11-13T05:36:40Z",
"updated_at": "2025-11-14T07:59:58Z",
"state": "open",
"comments_count": 4,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about AspNetCore.HealthChecks is heavily used but no longer maintained. This may indicate a potential issue or bug. Topic relates to networking.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "networking",
"subtopics": [
"https"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] AspNetCore.HealthChecks is heavily used but no longer mainta...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #9885:\n- **Discussion**: [AspNetCore.HealthChecks is heavily used but no longer maintained](https://github.com/dotnet/aspire/discussions/9885)\n- **Category**: Q&A\n- **Comments**: 4\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: AspNetCore.HealthChecks is heavily used but no longer maintained\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of networking in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 4) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"networking"
],
"priority": "high",
"rationale": "Discussion #9885 reveals documentation gap for networking"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about networking may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
8002,
6031,
5766,
5091
]
},
{
"discussion_number": 6638,
"title": "Conditional content for certain deployments",
"url": "https://github.com/dotnet/aspire/discussions/6638",
"category": "Q&A",
"author": "dahlsailrunner",
"created_at": "2024-11-09T13:11:21Z",
"updated_at": "2024-11-09T13:11:22Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Conditional content for certain deployments. This may indicate a potential issue or bug. Technologies involved: postgres, azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment",
"area-service-discovery",
"area-tooling",
"area-azd"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-azd",
"area-tooling",
"postgres",
"azure-container-apps",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"test",
"database"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"postgres",
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Conditional content for certain deployments",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6638:\n- **Discussion**: [Conditional content for certain deployments](https://github.com/dotnet/aspire/discussions/6638)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Conditional content for certain deployments\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #6638 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13227,
13204
]
},
{
"discussion_number": 6634,
"title": "How to specify SKU using `PublishAsAzureSqlDatabase`?",
"url": "https://github.com/dotnet/aspire/discussions/6634",
"category": "Q&A",
"author": "tomasherceg",
"created_at": "2024-11-08T11:33:42Z",
"updated_at": "2024-11-08T11:33:43Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 13911,
"duplicate_reason": "Title similarity: 47%, Keyword overlap: 0%, Topic overlap: 100%",
"plain_text_analysis": "User is asking how to specify sku using `publishasazuresqldatabase`?. Technologies involved: sqlserver, azure. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"help wanted",
"good first issue",
"documentation",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"database",
"azure"
],
"is_question": true,
"question_type": "how-to",
"complexity": "basic",
"technologies_mentioned": [
"sqlserver",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Project resource type",
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to specify SKU using `PublishAsAzureSqlDatabase`?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6634:\n- **Discussion**: [How to specify SKU using `PublishAsAzureSqlDatabase`?](https://github.com/dotnet/aspire/discussions/6634)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to specify SKU using `PublishAsAzureSqlDatabase`?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Project resource type, [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6634 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Project resource type' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Project resource type",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6590,
"title": "Is it possible to configure projects to run in Linux containers in the inner-loop when developing on Windows?",
"url": "https://github.com/dotnet/aspire/discussions/6590",
"category": "Q&A",
"author": "dmi-harlow",
"created_at": "2024-11-02T02:19:32Z",
"updated_at": "2025-01-09T16:53:41Z",
"state": "closed",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Is it possible to configure projects to run in Linux containers in the inner-loo. This may indicate a potential issue or bug. Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model",
"area-integrations",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"azure-container-apps",
"azure",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"test",
"port",
"local"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6578,
"title": "Aspire RabbitMQ Deploy to container app configuration \"rabbitmq Cookie file /var/lib/rabbitmq/.erlang.cookie must be accessible by owner only container\"",
"url": "https://github.com/dotnet/aspire/discussions/6578",
"category": "Q&A",
"author": "davide-podda",
"created_at": "2024-10-31T17:03:45Z",
"updated_at": "2024-10-31T19:26:04Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire RabbitMQ Deploy to container app configuration \"rabbitmq Cookie file /var. This appears to report an error or unexpected behavior. Technologies involved: rabbitmq, azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-azd"
],
"suggested_labels": [
"area-app-model",
"rabbitmq",
"area-azd",
"azure-container-apps",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"rabbitmq",
"azd"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"rabbitmq",
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"\u2014 AppHost.cs",
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire RabbitMQ Deploy to container app configuration \"rabbi...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6578:\n- **Discussion**: [Aspire RabbitMQ Deploy to container app configuration \"rabbitmq Cookie file /var/lib/rabbitmq/.erlang.cookie must be accessible by owner only container\"](https://github.com/dotnet/aspire/discussions/6578)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire RabbitMQ Deploy to container app configuration \"rabbitmq Cookie file /var/lib/rabbitmq/.erlang.cookie must be accessible by owner only container\"\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: \u2014 AppHost.cs, [Code-centric control](#define-your-stack-in-code), Define your stack in code\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6578 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '\u2014 AppHost.cs' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: \u2014 AppHost.cs",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6567,
"title": "App host running projects and docker images",
"url": "https://github.com/dotnet/aspire/discussions/6567",
"category": "Q&A",
"author": "allensiho",
"created_at": "2024-10-31T05:25:58Z",
"updated_at": "2025-06-20T15:47:06Z",
"state": "open",
"comments_count": 11,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about App host running projects and docker images. This may indicate a potential issue or bug. Technologies involved: sqlserver, kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"area-tooling",
"kubernetes",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"problem"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"kubernetes",
"ui",
"sql",
"local",
"container"
],
"is_question": true,
"question_type": "concept",
"complexity": "advanced",
"technologies_mentioned": [
"sqlserver",
"kubernetes"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] App host running projects and docker images",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6567:\n- **Discussion**: [App host running projects and docker images](https://github.com/dotnet/aspire/discussions/6567)\n- **Category**: Q&A\n- **Comments**: 11\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: App host running projects and docker images\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Flexible deployments](#local-first-production-ready), [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 11) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #6567 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Flexible deployments](#local-first-production-ready)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6511,
"title": "Best practices regarding configuring open telemetry in ServiceDefaults when using multiple projects with different meters.",
"url": "https://github.com/dotnet/aspire/discussions/6511",
"category": "Q&A",
"author": "Expecho",
"created_at": "2024-10-27T10:39:35Z",
"updated_at": "2024-10-30T14:40:11Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Best practices regarding configuring open telemetry in ServiceDefaults when usin. Topic relates to configuration.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-app-model",
"area-telemetry",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"good first issue",
"area-tooling",
"documentation",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"telemetry",
"port",
"servicedefaults"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Health checks",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Health checks' section for guidance",
"See the 'Define your stack in code' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Health checks"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 6486,
"title": "SQL Server Container doesn't run entrypoint.sh on Azure",
"url": "https://github.com/dotnet/aspire/discussions/6486",
"category": "Q&A",
"author": "Boggin",
"created_at": "2024-10-24T16:17:02Z",
"updated_at": "2024-11-03T15:31:20Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about SQL Server Container doesn't run entrypoint.sh on Azure. Technologies involved: sqlserver, azure. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment"
],
"suggested_labels": [
"area-app-model",
"sqlserver",
"help wanted",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"database",
"local"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"sqlserver",
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Project resource type"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] SQL Server Container doesn't run entrypoint.sh on Azure",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6486:\n- **Discussion**: [SQL Server Container doesn't run entrypoint.sh on Azure](https://github.com/dotnet/aspire/discussions/6486)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: SQL Server Container doesn't run entrypoint.sh on Azure\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Project resource type\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #6486 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Project resource type' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Project resource type"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6430,
"title": "How do you configure OIDC for the dashboard using the starter template?",
"url": "https://github.com/dotnet/aspire/discussions/6430",
"category": "Q&A",
"author": "los93sol",
"created_at": "2024-10-22T17:22:08Z",
"updated_at": "2024-10-23T22:39:49Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to how do you configure oidc for the dashboard using the starter template?. Topic relates to configuration.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-templates"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-templates",
"documentation",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"dashboard",
"oidc"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How do you configure OIDC for the dashboard using the starte...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6430:\n- **Discussion**: [How do you configure OIDC for the dashboard using the starter template?](https://github.com/dotnet/aspire/discussions/6430)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How do you configure OIDC for the dashboard using the starter template?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #6430 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Define your stack in code",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 6374,
"title": "Run Aspire Dashboard as a Windows Service",
"url": "https://github.com/dotnet/aspire/discussions/6374",
"category": "Q&A",
"author": "SamuelMMLopes",
"created_at": "2024-10-18T09:47:50Z",
"updated_at": "2024-10-18T09:47:51Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Run Aspire Dashboard as a Windows Service. Topic relates to dashboard.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"dashboard",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Run Aspire Dashboard as a Windows Service",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6374:\n- **Discussion**: [Run Aspire Dashboard as a Windows Service](https://github.com/dotnet/aspire/discussions/6374)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Run Aspire Dashboard as a Windows Service\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #6374 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 6188,
"title": "OTEL signals missing in Dashboard from ASP.NET Core application hosted in container",
"url": "https://github.com/dotnet/aspire/discussions/6188",
"category": "Q&A",
"author": "Kralizek",
"created_at": "2024-10-08T15:06:55Z",
"updated_at": "2024-10-08T15:06:56Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about OTEL signals missing in Dashboard from ASP.NET Core application hosted in contai. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"area-cli",
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"config",
"dashboard",
"message",
"telemetry"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] OTEL signals missing in Dashboard from ASP.NET Core applicat...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6188:\n- **Discussion**: [OTEL signals missing in Dashboard from ASP.NET Core application hosted in container](https://github.com/dotnet/aspire/discussions/6188)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: OTEL signals missing in Dashboard from ASP.NET Core application hosted in container\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #6188 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Configuring Prometheus with Aspire\n\n### Solution\n\nUse `WithContainerFiles` to dynamically generate Prometheus configuration with resolved endpoints:\n\n### Code Example\n\n```csharp\nvar prometheus = builder.AddContainer(\"prometheus\", \"prom/prometheus\")\n .WithHttpEndpoint(targetPort: 9090);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithHttpEndpoint(name: \"metrics\", port: 9090);\n\nprometheus.WithReference(api.GetEndpoint(\"metrics\"));\n\nprometheus.WithContainerFiles(\"/etc/prometheus\", async (ctx, ct) =>\n{\n var apiEndpoint = api.GetEndpoint(\"metrics\");\n \n var config = $\"\"\"\n global:\n scrape_interval: 15s\n \n scrape_configs:\n - job_name: 'api'\n metrics_path: '/metrics'\n static_configs:\n - targets: ['host.docker.internal:{apiEndpoint.Property(EndpointProperty.TargetPort)}']\n \"\"\";\n \n return [new ContainerFile { \n Name = \"prometheus.yml\", \n Contents = config \n }];\n});\n```\n\n### Source Code Reference\n\nContainer file generation: `src/Aspire.Hosting/Containers/ContainerResourceBuilderExtensions.cs`\nEndpoint resolution: `src/Aspire.Hosting/ApplicationModel/EndpointReference.cs`\n\n### Step-by-Step Guide\n\n1. **Add Prometheus container**: `AddContainer(\"prometheus\", \"prom/prometheus\")`\n2. **Create metrics endpoints**: `WithHttpEndpoint(name: \"metrics\", ...)`\n3. **Reference endpoints**: Use `WithReference` for networking\n4. **Generate config**: Use `WithContainerFiles` callback\n5. **Use endpoint properties**: Access `Port` or `Property(EndpointProperty.TargetPort)`\n\n### Common Pitfalls\n\n- **Callback timing**: Endpoint resolution happens at build time\n- **Container networking**: Use correct hostname (host.docker.internal vs container name)\n- **File permissions**: Set proper `UnixFileMode` for config files\n\n### Additional Resources\n\n- Aspire Dashboard for built-in metrics visualization\n- OpenTelemetry Prometheus exporter for .NET\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6048,
"title": "Container service discovery",
"url": "https://github.com/dotnet/aspire/discussions/6048",
"category": "Q&A",
"author": "SalomonHenke",
"created_at": "2024-10-01T07:56:07Z",
"updated_at": "2025-02-04T09:44:57Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 10976,
"duplicate_reason": "Title similarity: 44%, Keyword overlap: 5%, Topic overlap: 75%",
"plain_text_analysis": "User is seeking guidance about Container service discovery. Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-service-discovery",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"azure",
"area-tooling",
"area-cli",
"azure-container-apps",
"documentation",
"area-service-discovery",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"test",
"database",
"endpoint"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Container service discovery",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6048:\n- **Discussion**: [Container service discovery](https://github.com/dotnet/aspire/discussions/6048)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Container service discovery\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #6048 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 6031,
"title": "ServiceDiscovery: Explain Scheme selection when resolving HTTP(S) endpoints",
"url": "https://github.com/dotnet/aspire/discussions/6031",
"category": "Q&A",
"author": "cloudfy",
"created_at": "2024-09-30T17:54:36Z",
"updated_at": "2024-10-23T12:04:04Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about ServiceDiscovery: Explain Scheme selection when resolving HTTP(S) endpoints. Topic relates to networking.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"help wanted",
"good first issue",
"area-tooling",
"documentation",
"area-service-discovery"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "networking",
"subtopics": [
"endpoint"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] ServiceDiscovery: Explain Scheme selection when resolving HT...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #6031:\n- **Discussion**: [ServiceDiscovery: Explain Scheme selection when resolving HTTP(S) endpoints](https://github.com/dotnet/aspire/discussions/6031)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: ServiceDiscovery: Explain Scheme selection when resolving HTTP(S) endpoints\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables\n\n## Needed Content\n\n- Clear explanation of networking in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"networking"
],
"priority": "medium",
"rationale": "Discussion #6031 reveals documentation gap for networking"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about networking is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
8002,
9885,
5766,
5091
]
},
{
"discussion_number": 6015,
"title": "How to create custom commands",
"url": "https://github.com/dotnet/aspire/discussions/6015",
"category": "Q&A",
"author": "KennethHoff",
"created_at": "2024-09-30T06:45:59Z",
"updated_at": "2025-04-02T13:47:57Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to create custom commands. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"environment",
"ui"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Flexible deployments](#local-first-production-ready)"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 5895,
"title": "Azurite EventGrid Emulation",
"url": "https://github.com/dotnet/aspire/discussions/5895",
"category": "Q&A",
"author": "swissarmykirpan",
"created_at": "2024-09-24T16:35:43Z",
"updated_at": "2025-04-27T06:34:53Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Azurite EventGrid Emulation. This may indicate a potential issue or bug. Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-deployment",
"area-telemetry"
],
"suggested_labels": [
"azure",
"area-deployment",
"area-telemetry",
"azure-container-apps"
],
"is_potential_issue": true,
"issue_indicators": [
"issue",
"problem"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"publish",
"test",
"aca"
],
"is_question": true,
"question_type": "feature-request",
"complexity": "intermediate",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Azurite EventGrid Emulation",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5895:\n- **Discussion**: [Azurite EventGrid Emulation](https://github.com/dotnet/aspire/discussions/5895)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Azurite EventGrid Emulation\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #5895 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5887,
"title": "How to automate `az acr login` when using a container in ACR?",
"url": "https://github.com/dotnet/aspire/discussions/5887",
"category": "Q&A",
"author": "Kralizek",
"created_at": "2024-09-24T11:04:02Z",
"updated_at": "2024-09-24T11:04:03Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to automate `az acr login` when using a container in acr?. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"f5"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to automate `az acr login` when using a container in ACR...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5887:\n- **Discussion**: [How to automate `az acr login` when using a container in ACR?](https://github.com/dotnet/aspire/discussions/5887)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to automate `az acr login` when using a container in ACR?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #5887 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Aspire"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5875,
"title": "How to get azure environment name when deploying?",
"url": "https://github.com/dotnet/aspire/discussions/5875",
"category": "Q&A",
"author": "RamType0",
"created_at": "2024-09-24T04:59:46Z",
"updated_at": "2024-09-25T02:37:04Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to get azure environment name when deploying?. This appears to report an error or unexpected behavior. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment"
],
"suggested_labels": [
"azure",
"area-app-model",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"exception_type"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"run",
"azure"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: Define your stack in code"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5822,
"title": "Has anyone gotten errors debugging Aspire in VS Code on Mac after upgrading to Sequoia?",
"url": "https://github.com/dotnet/aspire/discussions/5822",
"category": "Q&A",
"author": "jeffa00",
"created_at": "2024-09-21T18:49:34Z",
"updated_at": "2024-09-30T18:35:40Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Has anyone gotten errors debugging Aspire in VS Code on Mac after upgrading to S. This appears to report an error or unexpected behavior. Technologies involved: vs, vs-code. Topic relates to local-dev.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"vs-code",
"vs"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"bug",
"issue"
],
"severity": "medium",
"topic": "local-dev",
"subtopics": [
"debug",
"extension",
"remote"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"vs",
"vs-code"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Has anyone gotten errors debugging Aspire in VS Code on Mac ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5822:\n- **Discussion**: [Has anyone gotten errors debugging Aspire in VS Code on Mac after upgrading to Sequoia?](https://github.com/dotnet/aspire/discussions/5822)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Has anyone gotten errors debugging Aspire in VS Code on Mac after upgrading to Sequoia?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of local-dev in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"local-dev"
],
"priority": "medium",
"rationale": "Discussion #5822 reveals documentation gap for local-dev"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about local-dev is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
12561,
12354,
11212,
10927,
7564,
7541,
7536,
6981,
6853,
5580
]
},
{
"discussion_number": 5797,
"title": "How to specify EnvironmentName when deploying to Azure Container App?",
"url": "https://github.com/dotnet/aspire/discussions/5797",
"category": "Q&A",
"author": "RamType0",
"created_at": "2024-09-20T03:33:35Z",
"updated_at": "2025-02-08T22:15:20Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 9343,
"duplicate_reason": "Title similarity: 43%, Keyword overlap: 6%, Topic overlap: 100%",
"plain_text_analysis": "User is asking how to specify environmentname when deploying to azure container app?. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-deployment"
],
"suggested_labels": [
"azure",
"area-app-model",
"area-deployment",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"settings",
"local",
"azure",
"container"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"Configure development certificate trust per resource",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Configure development certificate trust per resource' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: Configure development certificate trust per resource"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5766,
"title": "How to get the LogAnalyticsWorkspaceId",
"url": "https://github.com/dotnet/aspire/discussions/5766",
"category": "Q&A",
"author": "BartNetJS",
"created_at": "2024-09-18T13:34:15Z",
"updated_at": "2024-09-18T13:34:16Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to get the loganalyticsworkspaceid. Topic relates to networking.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-orchestrator"
],
"suggested_labels": [
"area-orchestrator",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "networking",
"subtopics": [
"https"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Resource lifecycle"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to get the LogAnalyticsWorkspaceId",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5766:\n- **Discussion**: [How to get the LogAnalyticsWorkspaceId](https://github.com/dotnet/aspire/discussions/5766)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to get the LogAnalyticsWorkspaceId\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Resource lifecycle\n\n## Needed Content\n\n- Clear explanation of networking in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"networking"
],
"priority": "medium",
"rationale": "Discussion #5766 reveals documentation gap for networking"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about networking is covered in the Aspire documentation.",
"key_points": [
"See the 'Resource lifecycle' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Resource lifecycle"
]
},
"related_discussions": [
8002,
9885,
6031,
5091
]
},
{
"discussion_number": 5710,
"title": "Using Aspire for a Blazor web app - some questions",
"url": "https://github.com/dotnet/aspire/discussions/5710",
"category": "Q&A",
"author": "DavidThielen",
"created_at": "2024-09-13T19:02:35Z",
"updated_at": "2024-09-13T19:02:36Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Using Aspire for a Blazor web app - some questions. Technologies involved: azure, python, blazor-wasm. Topic relates to dashboard.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-integrations",
"area-tooling"
],
"suggested_labels": [
"help wanted",
"good first issue",
"area-tooling",
"blazor-wasm",
"python",
"documentation",
"azure",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "dashboard",
"subtopics": [
"ui",
"url",
"azure",
"python"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": [
"azure",
"python",
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Polyglot, multilanguage support"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Using Aspire for a Blazor web app - some questions",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5710:\n- **Discussion**: [Using Aspire for a Blazor web app - some questions](https://github.com/dotnet/aspire/discussions/5710)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Using Aspire for a Blazor web app - some questions\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard), Polyglot, multilanguage support\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #5710 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Polyglot, multilanguage support' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)",
"Section: Polyglot, multilanguage support"
],
"detailed_response": "## Deploying Aspire to Azure Container Apps\n\n### Solution\n\nUse `azd` (Azure Developer CLI) for seamless deployment:\n\n### Step-by-Step Guide\n\n```bash\n# Initialize azd in your project\nazd init\n\n# Deploy to Azure\nazd up\n\n# For production, provision first\nazd provision\nazd deploy\n```\n\n### Code Example (AppHost Configuration)\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithExternalHttpEndpoints(); // Exposes publicly\n\n// Add Azure resources\nvar storage = builder.AddAzureStorage(\"storage\")\n .RunAsEmulator(); // Local dev only\n\nbuilder.Build().Run();\n```\n\n### Source Code Reference\n\nAzure provisioning: `src/Aspire.Hosting.Azure/Provisioning/`\nContainer Apps manifest: `src/Aspire.Hosting.Azure.ContainerApps/`\n\n### Infrastructure Configuration\n\n```csharp\n// Custom Azure configuration\nbuilder.AddAzureContainerApps(\"aca\")\n .ConfigureInfrastructure(infra =>\n {\n var env = infra.GetProvisionableResources()\n .OfType<ContainerAppEnvironment>()\n .Single();\n env.Properties.ZoneRedundant = true;\n });\n```\n\n### Common Pitfalls\n\n- **Secrets**: Use Azure Key Vault for production secrets\n- **Scaling**: Configure min/max replicas in production\n- **Networking**: Consider VNet integration for private resources\n\n### Additional Resources\n\n- Azure Container Apps documentation\n- azd templates for Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13790,
13694,
13675,
13670,
13629,
13484,
13204,
12509
]
},
{
"discussion_number": 5704,
"title": "How to hide a custom resource?",
"url": "https://github.com/dotnet/aspire/discussions/5704",
"category": "Q&A",
"author": "Kralizek",
"created_at": "2024-09-13T10:41:52Z",
"updated_at": "2025-11-17T21:17:27Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to hide a custom resource?. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"area-cli",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"config",
"dashboard",
"database",
"auth"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to hide a custom resource?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5704:\n- **Discussion**: [How to hide a custom resource?](https://github.com/dotnet/aspire/discussions/5704)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to hide a custom resource?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #5704 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## PostgreSQL Configuration with Aspire\n\n### Solution\n\nUse the PostgreSQL integration with proper configuration:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\n// Add PostgreSQL with persistent data\nvar postgres = builder.AddPostgres(\"postgres\")\n .WithDataVolume(\"postgres-data\")\n .WithPgAdmin();\n\n// Add a database\nvar db = postgres.AddDatabase(\"mydb\");\n\n// Reference from your API\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithReference(db)\n .WaitFor(db);\n```\n\n### Source Code Reference\n\nPostgreSQL hosting: `src/Aspire.Hosting.PostgreSQL/PostgresBuilderExtensions.cs`\nConnection handling: `src/Aspire.Hosting.PostgreSQL/PostgresDatabaseResource.cs`\n\n### Step-by-Step Guide\n\n1. **Add NuGet package**: `Aspire.Hosting.PostgreSQL`\n2. **Configure in AppHost**: `AddPostgres().AddDatabase()`\n3. **Add client package**: `Aspire.Npgsql` or `Aspire.Npgsql.EntityFrameworkCore.PostgreSQL`\n4. **Register in service**: `builder.AddNpgsqlDataSource(\"mydb\")`\n\n### Common Pitfalls\n\n- **Password handling**: Passwords are auto-generated; use parameters for custom\n- **Migrations**: Run after WaitFor to ensure DB is ready\n- **Data persistence**: Use WithDataVolume for persistent storage\n\n### Additional Resources\n\n- Aspire.Npgsql documentation\n- Entity Framework Core with Aspire\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5681,
"title": "Aspire test app creating temp files",
"url": "https://github.com/dotnet/aspire/discussions/5681",
"category": "Q&A",
"author": "haldiggs",
"created_at": "2024-09-11T16:02:19Z",
"updated_at": "2024-09-12T01:47:55Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire test app creating temp files. This may indicate a potential issue or bug. Topic relates to testing.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-app-model"
],
"suggested_labels": [
"area-app-model"
],
"is_potential_issue": true,
"issue_indicators": [
"issue"
],
"severity": "medium",
"topic": "testing",
"subtopics": [
"test",
"port"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire test app creating temp files",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5681:\n- **Discussion**: [Aspire test app creating temp files](https://github.com/dotnet/aspire/discussions/5681)\n- **Category**: Q&A\n- **Comments**: 2\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire test app creating temp files\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables\n\n## Needed Content\n\n- Clear explanation of testing in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 2) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"testing"
],
"priority": "medium",
"rationale": "Discussion #5681 reveals documentation gap for testing"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about testing is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables"
]
},
"related_discussions": [
10010
]
},
{
"discussion_number": 5582,
"title": "Aspire Authorization: Microsoft Entra External ID",
"url": "https://github.com/dotnet/aspire/discussions/5582",
"category": "Q&A",
"author": "aitrailblazer",
"created_at": "2024-09-07T04:15:01Z",
"updated_at": "2024-09-09T22:08:37Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 10010,
"duplicate_reason": "Title similarity: 45%, Keyword overlap: 4%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Aspire Authorization: Microsoft Entra External ID. This may indicate a potential issue or bug. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"azure",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"exception",
"bug",
"doesn't work",
"not working",
"issue"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"container",
"browser",
"message",
"auth",
"port"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire Authorization: Microsoft Entra External ID",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5582:\n- **Discussion**: [Aspire Authorization: Microsoft Entra External ID](https://github.com/dotnet/aspire/discussions/5582)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire Authorization: Microsoft Entra External ID\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #5582 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: Aspire"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5562,
"title": "Run multiple instances of same application on demand",
"url": "https://github.com/dotnet/aspire/discussions/5562",
"category": "Q&A",
"author": "antonholovko-cloud",
"created_at": "2024-09-05T21:34:27Z",
"updated_at": "2024-09-07T18:53:39Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 7605,
"duplicate_reason": "Title similarity: 47%, Keyword overlap: 6%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Run multiple instances of same application on demand. Topic relates to configuration.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"good first issue",
"area-dashboard",
"help wanted",
"documentation"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"parameter",
"console",
"run"
],
"is_question": true,
"question_type": "general",
"complexity": "basic",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Run multiple instances of same application on demand",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5562:\n- **Discussion**: [Run multiple instances of same application on demand](https://github.com/dotnet/aspire/discussions/5562)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Run multiple instances of same application on demand\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #5562 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 5543,
"title": "Trouble uploading files via web project to apiservice in .net aspire starter app template",
"url": "https://github.com/dotnet/aspire/discussions/5543",
"category": "Q&A",
"author": "markat1",
"created_at": "2024-09-04T21:46:42Z",
"updated_at": "2024-09-06T16:54:19Z",
"state": "closed",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 6853,
"duplicate_reason": "Title similarity: 42%, Keyword overlap: 2%, Topic overlap: 100%",
"plain_text_analysis": "User is seeking guidance about Trouble uploading files via web project to apiservice in .net aspire starter app. This may indicate a potential issue or bug. Technologies involved: blazor-wasm. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-cli",
"area-templates",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"area-cli",
"blazor-wasm",
"area-templates",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"issue"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"environment",
"ui",
"test",
"db",
"message"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "intermediate",
"technologies_mentioned": [
"blazor-wasm"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Flexible deployments](#local-first-production-ready)"
]
},
"related_discussions": [
13809,
13694,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418
]
},
{
"discussion_number": 5468,
"title": "How to configure AppHost for integration tests?",
"url": "https://github.com/dotnet/aspire/discussions/5468",
"category": "Q&A",
"author": "impworks",
"created_at": "2024-08-28T09:52:24Z",
"updated_at": "2025-01-14T09:00:23Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 6744,
"duplicate_reason": "Title similarity: 46%, Keyword overlap: 4%, Topic overlap: 67%",
"plain_text_analysis": "User is asking how to configure apphost for integration tests?. Technologies involved: postgres. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"postgres",
"area-dashboard",
"area-integrations"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"console",
"test",
"database",
"local"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"postgres"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to configure AppHost for integration tests?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5468:\n- **Discussion**: [How to configure AppHost for integration tests?](https://github.com/dotnet/aspire/discussions/5468)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to configure AppHost for integration tests?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "high",
"rationale": "Discussion #5468 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
13809,
13694,
13329,
13227,
13069,
12906,
12484,
12338,
12114,
11885
]
},
{
"discussion_number": 5291,
"title": "Aspire with Multiple Projects",
"url": "https://github.com/dotnet/aspire/discussions/5291",
"category": "Q&A",
"author": "QuentinSims",
"created_at": "2024-08-14T15:14:46Z",
"updated_at": "2024-08-14T15:14:47Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire with Multiple Projects. This may indicate a potential issue or bug. Topic relates to dashboard.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-telemetry",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-dashboard",
"area-tooling",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue"
],
"severity": "medium",
"topic": "dashboard",
"subtopics": [
"ui",
"db",
"metrics",
"local",
"distributed"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire with Multiple Projects",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5291:\n- **Discussion**: [Aspire with Multiple Projects](https://github.com/dotnet/aspire/discussions/5291)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire with Multiple Projects\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of dashboard in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"dashboard"
],
"priority": "medium",
"rationale": "Discussion #5291 reveals documentation gap for dashboard"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about dashboard is covered in the Aspire documentation.",
"key_points": [
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Configuring Prometheus with Aspire\n\n### Solution\n\nUse `WithContainerFiles` to dynamically generate Prometheus configuration with resolved endpoints:\n\n### Code Example\n\n```csharp\nvar prometheus = builder.AddContainer(\"prometheus\", \"prom/prometheus\")\n .WithHttpEndpoint(targetPort: 9090);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithHttpEndpoint(name: \"metrics\", port: 9090);\n\nprometheus.WithReference(api.GetEndpoint(\"metrics\"));\n\nprometheus.WithContainerFiles(\"/etc/prometheus\", async (ctx, ct) =>\n{\n var apiEndpoint = api.GetEndpoint(\"metrics\");\n \n var config = $\"\"\"\n global:\n scrape_interval: 15s\n \n scrape_configs:\n - job_name: 'api'\n metrics_path: '/metrics'\n static_configs:\n - targets: ['host.docker.internal:{apiEndpoint.Property(EndpointProperty.TargetPort)}']\n \"\"\";\n \n return [new ContainerFile { \n Name = \"prometheus.yml\", \n Contents = config \n }];\n});\n```\n\n### Source Code Reference\n\nContainer file generation: `src/Aspire.Hosting/Containers/ContainerResourceBuilderExtensions.cs`\nEndpoint resolution: `src/Aspire.Hosting/ApplicationModel/EndpointReference.cs`\n\n### Step-by-Step Guide\n\n1. **Add Prometheus container**: `AddContainer(\"prometheus\", \"prom/prometheus\")`\n2. **Create metrics endpoints**: `WithHttpEndpoint(name: \"metrics\", ...)`\n3. **Reference endpoints**: Use `WithReference` for networking\n4. **Generate config**: Use `WithContainerFiles` callback\n5. **Use endpoint properties**: Access `Port` or `Property(EndpointProperty.TargetPort)`\n\n### Common Pitfalls\n\n- **Callback timing**: Endpoint resolution happens at build time\n- **Container networking**: Use correct hostname (host.docker.internal vs container name)\n- **File permissions**: Set proper `UnixFileMode` for config files\n\n### Additional Resources\n\n- Aspire Dashboard for built-in metrics visualization\n- OpenTelemetry Prometheus exporter for .NET\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13790,
13670,
13484,
12509,
12227,
11970,
10910,
10455,
9828,
9444
]
},
{
"discussion_number": 5260,
"title": "Getting started with Aspire & Aspirate: No Dockerfile components selected.",
"url": "https://github.com/dotnet/aspire/discussions/5260",
"category": "Q&A",
"author": "cataggar",
"created_at": "2024-08-12T02:43:10Z",
"updated_at": "2025-04-27T06:42:53Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Getting started with Aspire & Aspirate: No Dockerfile components selected.. This may indicate a potential issue or bug. Technologies involved: azure, azure-storage. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment",
"area-templates"
],
"suggested_labels": [
"area-app-model",
"area-templates",
"azure-storage",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"test",
"db"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-storage"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Getting started with Aspire & Aspirate: No Dockerfile compon...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5260:\n- **Discussion**: [Getting started with Aspire & Aspirate: No Dockerfile components selected.](https://github.com/dotnet/aspire/discussions/5260)\n- **Category**: Q&A\n- **Comments**: 3\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Getting started with Aspire & Aspirate: No Dockerfile components selected.\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 3) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #5260 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5580,
"title": "Executable Azure Function not correctly load environments",
"url": "https://github.com/dotnet/aspire/discussions/5580",
"category": "Q&A",
"author": "petrkasnal",
"created_at": "2024-08-09T22:29:44Z",
"updated_at": "2024-09-07T07:46:29Z",
"state": "open",
"comments_count": 3,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Executable Azure Function not correctly load environments. This may indicate a potential issue or bug. Technologies involved: azure, azure-functions, azure-storage. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-service-discovery",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"azure",
"area-tooling",
"azure-functions",
"nodejs",
"azure-storage",
"vs",
"area-service-discovery",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"bug",
"issue",
"problem"
],
"severity": "high",
"topic": "configuration",
"subtopics": [
"config",
"ui",
"test",
"port",
"local"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-functions",
"azure-storage",
"nodejs",
"vs"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Azure Functions resource",
"Host external executables in Aspire",
"\u2014 AppHost.cs"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Azure Functions resource' section for guidance",
"See the 'Host external executables in Aspire' section for guidance",
"See the '\u2014 AppHost.cs' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Azure Functions resource",
"Section: Host external executables in Aspire"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13849,
13809,
13694,
13675,
13629,
13484,
13227,
13204,
12561
]
},
{
"discussion_number": 5211,
"title": "What is the best way to use Serilog and ELK stack in .NET Aspire?",
"url": "https://github.com/dotnet/aspire/discussions/5211",
"category": "Q&A",
"author": "MarcinKruszynski",
"created_at": "2024-08-07T05:47:11Z",
"updated_at": "2025-04-27T06:26:11Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about What is the best way to use Serilog and ELK stack in .NET Aspire?. Technologies involved: kafka, kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-integrations",
"area-deployment",
"area-service-discovery",
"area-telemetry",
"area-cli"
],
"suggested_labels": [
"help wanted",
"kafka",
"area-cli",
"kubernetes",
"documentation",
"area-service-discovery",
"area-dashboard",
"area-integrations",
"area-deployment",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"test",
"kafka",
"logging"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"kafka",
"kubernetes"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Environment variables",
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Logging"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] What is the best way to use Serilog and ELK stack in .NET As...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5211:\n- **Discussion**: [What is the best way to use Serilog and ELK stack in .NET Aspire?](https://github.com/dotnet/aspire/discussions/5211)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: What is the best way to use Serilog and ELK stack in .NET Aspire?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Environment variables, [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #5211 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Environment variables' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Environment variables",
"Section: [Code-centric control](#define-your-stack-in-code)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 5091,
"title": "Trace with unknown extra GET/POST requests",
"url": "https://github.com/dotnet/aspire/discussions/5091",
"category": "Q&A",
"author": "rogerwes",
"created_at": "2024-07-26T14:42:02Z",
"updated_at": "2024-07-26T20:16:13Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Trace with unknown extra GET/POST requests. Topic relates to networking.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-telemetry"
],
"suggested_labels": [
"help wanted",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "networking",
"subtopics": [
"https"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Trace with unknown extra GET/POST requests",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #5091:\n- **Discussion**: [Trace with unknown extra GET/POST requests](https://github.com/dotnet/aspire/discussions/5091)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Trace with unknown extra GET/POST requests\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of networking in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"networking"
],
"priority": "high",
"rationale": "Discussion #5091 reveals documentation gap for networking"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about networking may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
8002,
9885,
6031,
5766
]
},
{
"discussion_number": 5067,
"title": "How to specify APP_API_TOKEN dapr env variable",
"url": "https://github.com/dotnet/aspire/discussions/5067",
"category": "Q&A",
"author": "mzj",
"created_at": "2024-07-24T23:38:24Z",
"updated_at": "2025-08-02T02:30:54Z",
"state": "closed",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to specify app_api_token dapr env variable. Technologies involved: dapr. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"dapr",
"area-dashboard"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"environment",
"ui",
"local"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": [
"dapr"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Add Dapr sidecar",
"Environment variables",
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Add Dapr sidecar' section for guidance",
"See the 'Environment variables' section for guidance",
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Add Dapr sidecar",
"Section: Environment variables"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 4980,
"title": "How can i build a dcoker image of my custom changes to Aspire dashboard",
"url": "https://github.com/dotnet/aspire/discussions/4980",
"category": "Q&A",
"author": "dagdynamik",
"created_at": "2024-07-19T10:33:07Z",
"updated_at": "2024-07-19T11:33:35Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to build a dcoker image of my custom changes to aspire dashboard. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard"
],
"suggested_labels": [
"area-dashboard",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"docker",
"environment",
"dashboard",
"run"
],
"is_question": true,
"question_type": "how-to",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Flexible deployments](#local-first-production-ready)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How can i build a dcoker image of my custom changes to Aspir...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4980:\n- **Discussion**: [How can i build a dcoker image of my custom changes to Aspire dashboard](https://github.com/dotnet/aspire/discussions/4980)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How can i build a dcoker image of my custom changes to Aspire dashboard\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Flexible deployments](#local-first-production-ready), [Observability from the start](#opentelemetry-developer-dashboard), [Code-centric control](#define-your-stack-in-code)\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #4980 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Flexible deployments](#local-first-production-ready)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Flexible deployments](#local-first-production-ready)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 4964,
"title": "How to mutate the Snapshot State of a ProjectResource?",
"url": "https://github.com/dotnet/aspire/discussions/4964",
"category": "Q&A",
"author": "wertzui",
"created_at": "2024-07-18T14:27:03Z",
"updated_at": "2024-07-26T07:52:25Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to mutate the snapshot state of a projectresource?. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-deployment",
"area-service-discovery"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"help wanted",
"area-service-discovery",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"publish",
"dashboard",
"endpoint",
"run",
"iresource"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Resource lifecycle",
"Environment variables",
"Custom resources",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"[Code-centric control](#define-your-stack-in-code)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to mutate the Snapshot State of a ProjectResource?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4964:\n- **Discussion**: [How to mutate the Snapshot State of a ProjectResource?](https://github.com/dotnet/aspire/discussions/4964)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to mutate the Snapshot State of a ProjectResource?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Resource lifecycle, Environment variables, Custom resources\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #4964 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Resource lifecycle' section for guidance",
"See the 'Environment variables' section for guidance",
"See the 'Custom resources' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Resource lifecycle",
"Section: Environment variables"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 4963,
"title": "How to use health checks and probes",
"url": "https://github.com/dotnet/aspire/discussions/4963",
"category": "Q&A",
"author": "mip1983",
"created_at": "2024-07-18T13:44:53Z",
"updated_at": "2024-07-18T13:44:53Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is asking how to use health checks and probes. Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-deployment",
"area-service-discovery"
],
"suggested_labels": [
"help wanted",
"azure",
"azure-container-apps",
"documentation",
"area-service-discovery",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"container",
"config",
"interface",
"health check",
"endpoint"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Health checks",
"Environment variables",
"Aspire",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to use health checks and probes",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4963:\n- **Discussion**: [How to use health checks and probes](https://github.com/dotnet/aspire/discussions/4963)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to use health checks and probes\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Health checks, Environment variables, Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #4963 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the 'Health checks' section for guidance",
"See the 'Environment variables' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Health checks",
"Section: Environment variables"
],
"detailed_response": "## Service Discovery in Aspire\n\n### Solution\n\nAspire handles service discovery automatically through `WithReference`:\n\n### Code Example\n\n```csharp\nvar builder = DistributedApplication.CreateBuilder(args);\n\nvar api = builder.AddProject<Projects.Api>(\"api\");\n\nvar frontend = builder.AddProject<Projects.Frontend>(\"frontend\")\n .WithReference(api); // Automatically configures service discovery\n```\n\n### Source Code Reference\n\nService discovery is implemented in:\n- `src/Aspire.Hosting/Dcp/DcpHost.cs`\n- `src/Aspire.ServiceDefaults/Extensions.cs`\n\n### How It Works\n\n1. `WithReference` creates environment variables with connection info\n2. Service Defaults configure HttpClient to resolve service names\n3. DNS-based discovery resolves `http://api` to the actual endpoint\n\n### Environment Variables\n\nWhen you call `WithReference(api)`, these are set:\n- `services__api__https__0` = actual HTTPS endpoint\n- `services__api__http__0` = actual HTTP endpoint\n\n### Step-by-Step Guide\n\n1. **Add ServiceDefaults**: Include Aspire.ServiceDefaults NuGet\n2. **Configure services**: Call `builder.AddServiceDefaults()` in each project\n3. **Reference services**: Use `WithReference` in AppHost\n4. **Use HttpClient**: Inject typed clients with service names\n\n### Common Pitfalls\n\n- **Missing ServiceDefaults**: Each project needs AddServiceDefaults()\n- **Direct URLs**: Don't hardcode ports; use service names\n- **Container networking**: Containers use different DNS resolution\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 4962,
"title": "Dependency encapsulation",
"url": "https://github.com/dotnet/aspire/discussions/4962",
"category": "Q&A",
"author": "robmccrady",
"created_at": "2024-07-18T13:21:42Z",
"updated_at": "2024-07-18T13:21:43Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Dependency encapsulation. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-deployment",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-tooling",
"azure",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"ui",
"database",
"entra",
"azure"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire",
"Example"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Dependency encapsulation",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4962:\n- **Discussion**: [Dependency encapsulation](https://github.com/dotnet/aspire/discussions/4962)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Dependency encapsulation\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Code-centric control](#define-your-stack-in-code), [Observability from the start](#opentelemetry-developer-dashboard), Aspire\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "medium",
"rationale": "Discussion #4962 reveals documentation gap for deployment"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Aspire' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 4852,
"title": "Aspire not anymore in VS available as template",
"url": "https://github.com/dotnet/aspire/discussions/4852",
"category": "Q&A",
"author": "SvenVandenbrande",
"created_at": "2024-07-11T05:22:16Z",
"updated_at": "2024-07-18T11:12:17Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Aspire not anymore in VS available as template. This appears to report an error or unexpected behavior. Topic relates to database.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-templates"
],
"suggested_labels": [
"area-templates"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue"
],
"severity": "medium",
"topic": "database",
"subtopics": [
"db",
"https"
],
"is_question": true,
"question_type": "concept",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Aspire not anymore in VS available as template",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4852:\n- **Discussion**: [Aspire not anymore in VS available as template](https://github.com/dotnet/aspire/discussions/4852)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Aspire not anymore in VS available as template\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of database in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"database"
],
"priority": "high",
"rationale": "Discussion #4852 reveals documentation gap for database"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about database may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
10826,
8891
]
},
{
"discussion_number": 4842,
"title": "Send traces/metrics using OTLP from .net 4.8 apps to the dashboard?",
"url": "https://github.com/dotnet/aspire/discussions/4842",
"category": "Q&A",
"author": "gentledepp",
"created_at": "2024-07-10T08:03:37Z",
"updated_at": "2024-12-23T08:22:34Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Send traces/metrics using OTLP from .net 4.8 apps to the dashboard?. Topic relates to configuration.",
"analysis": {
"issue_type": "documentation-gap",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-orchestrator",
"area-service-discovery",
"area-telemetry",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"help wanted",
"area-tooling",
"area-cli",
"documentation",
"area-service-discovery",
"area-dashboard",
"area-telemetry"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"config",
"dashboard",
"db",
"telemetry",
"endpoint"
],
"is_question": true,
"question_type": "general",
"complexity": "intermediate",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Send traces/metrics using OTLP from .net 4.8 apps to the das...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4842:\n- **Discussion**: [Send traces/metrics using OTLP from .net 4.8 apps to the dashboard?](https://github.com/dotnet/aspire/discussions/4842)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Send traces/metrics using OTLP from .net 4.8 apps to the dashboard?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "high",
"rationale": "Discussion #4842 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
],
"detailed_response": "## Configuring Prometheus with Aspire\n\n### Solution\n\nUse `WithContainerFiles` to dynamically generate Prometheus configuration with resolved endpoints:\n\n### Code Example\n\n```csharp\nvar prometheus = builder.AddContainer(\"prometheus\", \"prom/prometheus\")\n .WithHttpEndpoint(targetPort: 9090);\n\nvar api = builder.AddProject<Projects.Api>(\"api\")\n .WithHttpEndpoint(name: \"metrics\", port: 9090);\n\nprometheus.WithReference(api.GetEndpoint(\"metrics\"));\n\nprometheus.WithContainerFiles(\"/etc/prometheus\", async (ctx, ct) =>\n{\n var apiEndpoint = api.GetEndpoint(\"metrics\");\n \n var config = $\"\"\"\n global:\n scrape_interval: 15s\n \n scrape_configs:\n - job_name: 'api'\n metrics_path: '/metrics'\n static_configs:\n - targets: ['host.docker.internal:{apiEndpoint.Property(EndpointProperty.TargetPort)}']\n \"\"\";\n \n return [new ContainerFile { \n Name = \"prometheus.yml\", \n Contents = config \n }];\n});\n```\n\n### Source Code Reference\n\nContainer file generation: `src/Aspire.Hosting/Containers/ContainerResourceBuilderExtensions.cs`\nEndpoint resolution: `src/Aspire.Hosting/ApplicationModel/EndpointReference.cs`\n\n### Step-by-Step Guide\n\n1. **Add Prometheus container**: `AddContainer(\"prometheus\", \"prom/prometheus\")`\n2. **Create metrics endpoints**: `WithHttpEndpoint(name: \"metrics\", ...)`\n3. **Reference endpoints**: Use `WithReference` for networking\n4. **Generate config**: Use `WithContainerFiles` callback\n5. **Use endpoint properties**: Access `Port` or `Property(EndpointProperty.TargetPort)`\n\n### Common Pitfalls\n\n- **Callback timing**: Endpoint resolution happens at build time\n- **Container networking**: Use correct hostname (host.docker.internal vs container name)\n- **File permissions**: Set proper `UnixFileMode` for config files\n\n### Additional Resources\n\n- Aspire Dashboard for built-in metrics visualization\n- OpenTelemetry Prometheus exporter for .NET\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 4831,
"title": "How to configure http-autoscaler in AppHost code?",
"url": "https://github.com/dotnet/aspire/discussions/4831",
"category": "Q&A",
"author": "bitbound",
"created_at": "2024-07-09T23:31:05Z",
"updated_at": "2025-06-18T11:47:43Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 6717,
"duplicate_reason": "Title similarity: 46%, Keyword overlap: 3%, Topic overlap: 100%",
"plain_text_analysis": "User is asking how to configure http-autoscaler in apphost code?. Technologies involved: azure, azure-container-apps. Topic relates to deployment.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-deployment",
"area-templates",
"area-azd"
],
"suggested_labels": [
"area-app-model",
"help wanted",
"area-azd",
"azure-container-apps",
"area-templates",
"azure",
"area-dashboard",
"area-deployment"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "deployment",
"subtopics": [
"deploy",
"config",
"ui",
"azure",
"container"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"azure",
"azure-container-apps"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Aspire"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": false,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: Define your stack in code"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 4826,
"title": "Dashboard login is no longer working",
"url": "https://github.com/dotnet/aspire/discussions/4826",
"category": "Q&A",
"author": "samimejri",
"created_at": "2024-07-09T20:30:18Z",
"updated_at": "2024-07-18T12:59:48Z",
"state": "open",
"comments_count": 2,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Dashboard login is no longer working. This appears to report an error or unexpected behavior. Technologies involved: azure. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-deployment",
"area-telemetry",
"area-templates"
],
"suggested_labels": [
"good first issue",
"area-templates",
"azure",
"area-dashboard",
"area-deployment",
"area-telemetry"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"issue",
"wrong"
],
"severity": "medium",
"topic": "deployment",
"subtopics": [
"deploy",
"dashboard",
"development",
"azure"
],
"is_question": true,
"question_type": "troubleshooting",
"complexity": "basic",
"technologies_mentioned": [
"azure"
]
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Code-centric control](#define-your-stack-in-code)",
"[Observability from the start](#opentelemetry-developer-dashboard)",
"Free and open source"
],
"doc_excerpts": [],
"documentation_complete": true,
"documentation_quality": "complete",
"needs_improvement": false
},
"documentation_issue": {
"should_create": false,
"repository": "",
"title": "",
"body": "",
"labels": [],
"priority": "",
"rationale": ""
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment is covered in the Aspire documentation.",
"key_points": [
"See the '[Code-centric control](#define-your-stack-in-code)' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance",
"See the 'Free and open source' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: [Code-centric control](#define-your-stack-in-code)",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
],
"detailed_response": "## Debugging Aspire Publish and Deploy Commands\n\nTo debug `aspire publish` or `aspire deploy` operations:\n\n### Solution\n\nEnable verbose logging and capture binlog files:\n\n```bash\n# Verbose output\naspire publish --verbosity detailed\n\n# Generate binlog for MSBuild analysis\naspire publish -- /bl:aspire-publish.binlog\n\n# Debug with environment variables\nASPIRE_LOG_LEVEL=Debug aspire publish\n```\n\n### Source Code Reference\n\nThe publish/deploy logic is implemented in the Aspire CLI:\n- `src/Aspire.Cli/Commands/PublishCommand.cs`\n- `src/Aspire.Cli/Publishing/Publisher.cs`\n\n### Step-by-Step Guide\n\n1. **Enable verbose logging**: Add `--verbosity detailed` flag\n2. **Capture MSBuild logs**: Use `/bl:filename.binlog` parameter\n3. **Set debug environment**: `ASPIRE_LOG_LEVEL=Debug`\n4. **Examine output**: Check the generated manifest/bicep files\n5. **Use binlog viewer**: Open .binlog files with MSBuild Structured Log Viewer\n\n### Common Pitfalls\n\n- **Missing Docker**: Ensure Docker/Podman is running\n- **Authentication**: Check Azure/container registry credentials\n- **Manifest issues**: Validate AppHost configuration\n\n### Additional Resources\n\n- Aspire CLI documentation\n- MSBuild Structured Log Viewer: https://msbuildlog.com/\n",
"code_examples": true,
"source_references": true
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 4814,
"title": "How to run Aspire inside a .NET SDK container?",
"url": "https://github.com/dotnet/aspire/discussions/4814",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2024-07-08T19:01:26Z",
"updated_at": "2024-07-09T14:47:02Z",
"state": "open",
"comments_count": 1,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 12204,
"duplicate_reason": "Title similarity: 76%, Keyword overlap: 6%, Topic overlap: 43%",
"plain_text_analysis": "User is asking how to run aspire inside a .net sdk container?. This may indicate a potential issue or bug. Technologies involved: mongodb, kubernetes. Topic relates to deployment.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model",
"area-integrations",
"area-orchestrator",
"area-deployment",
"area-cli",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-orchestrator",
"area-tooling",
"area-cli",
"mongodb",
"kubernetes",
"area-dashboard",
"area-integrations",
"area-deployment"
],
"is_potential_issue": true,
"issue_indicators": [
"error",
"exception",
"failed",
"bug",
"stack trace",
"stack_trace",
"error_code",
"exception_type"
],
"severity": "high",
"topic": "deployment",
"subtopics": [
"kubernetes",
"config",
"ui",
"test",
"database"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": [
"mongodb",
"kubernetes"
]
},
"documentation_check": {
"answered_in_docs": false,
"relevant_sections": [],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "missing",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to run Aspire inside a .NET SDK container?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4814:\n- **Discussion**: [How to run Aspire inside a .NET SDK container?](https://github.com/dotnet/aspire/discussions/4814)\n- **Category**: Q&A\n- **Comments**: 1\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to run Aspire inside a .NET SDK container?\n\n## Current State\n\nNo specific documentation exists for this topic.\n\nRelevant sections found: None found\n\n## Needed Content\n\n- Clear explanation of deployment in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**HIGH** - Based on community interest (comments: 1) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"deployment"
],
"priority": "high",
"rationale": "Discussion #4814 reveals documentation gap for deployment"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about deployment may need team input or further investigation.",
"key_points": [
"Check the Aspire samples repository for similar scenarios",
"Review existing issues/discussions for workarounds",
"Consider opening an issue if this is a feature gap"
],
"references": [
"https://github.com/dotnet/aspire-samples",
"https://github.com/dotnet/aspire/issues"
]
},
"related_discussions": [
13976,
13911,
13849,
13707,
13694,
13675,
13629,
13329,
13204,
13069
]
},
{
"discussion_number": 4806,
"title": "How to have the host load its configuration file when using DistributedApplicationTestingBuilder?",
"url": "https://github.com/dotnet/aspire/discussions/4806",
"category": "Q&A",
"author": "paulomorgado",
"created_at": "2024-07-08T13:32:09Z",
"updated_at": "2024-07-08T13:32:10Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": true,
"duplicate_of": 6744,
"duplicate_reason": "Title similarity: 69%, Keyword overlap: 8%, Topic overlap: 100%",
"plain_text_analysis": "User is asking how to have the host load its configuration file when using distributedapplicationtesti. This may indicate a potential issue or bug. Topic relates to configuration.",
"analysis": {
"issue_type": "bug-report",
"affected_components": [
"area-dashboard",
"area-app-model"
],
"suggested_labels": [
"area-app-model",
"area-dashboard"
],
"is_potential_issue": true,
"issue_indicators": [
"fails"
],
"severity": "medium",
"topic": "configuration",
"subtopics": [
"config",
"ui",
"test",
"distributed"
],
"is_question": true,
"question_type": "how-to",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"Define your stack in code",
"[Observability from the start](#opentelemetry-developer-dashboard)"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] How to have the host load its configuration file when using ...",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4806:\n- **Discussion**: [How to have the host load its configuration file when using DistributedApplicationTestingBuilder?](https://github.com/dotnet/aspire/discussions/4806)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: How to have the host load its configuration file when using DistributedApplicationTestingBuilder?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: Define your stack in code, [Observability from the start](#opentelemetry-developer-dashboard)\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #4806 reveals documentation gap for configuration"
},
"source_analysis": {
"required": true,
"files_examined": [],
"findings": ""
},
"suggested_answer": {
"should_answer": true,
"summary": "This question about configuration is covered in the Aspire documentation.",
"key_points": [
"See the 'Define your stack in code' section for guidance",
"See the '[Observability from the start](#opentelemetry-developer-dashboard)' section for guidance"
],
"references": [
"https://aspire.dev/docs/",
"Section: Define your stack in code",
"Section: [Observability from the start](#opentelemetry-developer-dashboard)"
]
},
"related_discussions": [
13809,
13227,
12484,
12338,
12114,
11885,
10765,
10682,
10418,
10375
]
},
{
"discussion_number": 4800,
"title": "Are Aspire Just for development environment purpose?",
"url": "https://github.com/dotnet/aspire/discussions/4800",
"category": "Q&A",
"author": "GeeSuth",
"created_at": "2024-07-06T19:43:20Z",
"updated_at": "2024-07-06T19:43:21Z",
"state": "open",
"comments_count": 0,
"has_answer": false,
"answer_chosen_at": null,
"is_duplicate": false,
"duplicate_of": null,
"duplicate_reason": "",
"plain_text_analysis": "User is seeking guidance about Are Aspire Just for development environment purpose?. Topic relates to configuration.",
"analysis": {
"issue_type": "question",
"affected_components": [
"area-app-model",
"area-tooling"
],
"suggested_labels": [
"area-app-model",
"area-tooling",
"help wanted"
],
"is_potential_issue": false,
"issue_indicators": [],
"severity": null,
"topic": "configuration",
"subtopics": [
"environment",
"https",
"development"
],
"is_question": true,
"question_type": "general",
"complexity": "advanced",
"technologies_mentioned": []
},
"documentation_check": {
"answered_in_docs": true,
"relevant_sections": [
"[Flexible deployments](#local-first-production-ready)",
"Free and open source"
],
"doc_excerpts": [],
"documentation_complete": false,
"documentation_quality": "partial",
"needs_improvement": true
},
"documentation_issue": {
"should_create": true,
"repository": "microsoft/aspire.dev",
"title": "[Documentation Gap] Are Aspire Just for development environment purpose?",
"body": "## Context\n\nThis documentation gap was identified from GitHub Discussion #4800:\n- **Discussion**: [Are Aspire Just for development environment purpose?](https://github.com/dotnet/aspire/discussions/4800)\n- **Category**: Q&A\n- **Comments**: 0\n- **Has Answer**: No\n\n## Question/Topic\n\nUsers are asking about: Are Aspire Just for development environment purpose?\n\n## Current State\n\nDocumentation partially covers this topic but lacks specific guidance or examples.\n\nRelevant sections found: [Flexible deployments](#local-first-production-ready), Free and open source\n\n## Needed Content\n\n- Clear explanation of configuration in this context\n- Step-by-step guide or code examples\n- Common pitfalls and troubleshooting tips\n- Best practices and recommendations\n\n## Priority\n\n**MEDIUM** - Based on community interest (comments: 0) and documentation coverage.\n",
"labels": [
"documentation",
"content-gap",
"configuration"
],
"priority": "medium",
"rationale": "Discussion #4800 reveals documentation gap for configuration"
},
"source_analysis": {
"required": false,
"fi
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment