Document container registry resource configuration

[Copilot]

Aspire 13.1 introduced ContainerRegistryResource for explicit container registry configuration but only documented it in the what's-new page. Users need comprehensive guidance for generic registries, Azure integration, and pipeline workflows.

Changes

• New documentation page: /app-host/container-registry/

  • Generic registry support (DockerHub, GHCR, Harbor, private registries)
  • Azure Container Registry explicit configuration patterns
  • Authentication and credential management
  • Pipeline integration with aspire do push
  • Multi-registry deployment examples

• Navigation updates

  • Added page to AppHost sidebar section in docs.topics.ts
  • Added cross-reference link from what's-new page

Example Usage

var builder = DistributedApplication.CreateBuilder(args);

// Generic registry
var registry = builder.AddContainerRegistry("myregistry", "registry.example.com");

var api = builder.AddProject<Projects.Api>("api")
    .WithContainerRegistry(registry);

// Azure Container Registry with explicit configuration
var acr = builder.AddAzureContainerAppEnvironment("myenv");

var web = builder.AddProject<Projects.Web>("web")
    .WithContainerRegistry(acr);

Preview

Documentation covers all deployment scenarios with working examples:

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/CommunityToolkit/Aspire
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node ./scripts/update-github-stats.js (http block)
• https://api.github.com/repos/dotnet/aspire
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node ./scripts/update-github-stats.js (http block)
• https://api.github.com/repos/dotnet/aspire-samples
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node ./scripts/update-github-stats.js (http block)
• https://api.github.com/repos/microsoft/aspire.dev
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node ./scripts/update-github-stats.js (http block)
• https://api.github.com/repos/microsoft/dcp
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node ./scripts/update-github-stats.js (http block)
• telemetry.astro.build
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js build (dns block)
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js dev git (dns block)
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.bin/../astro/astro.js dev sh de/n�� ������������ %H /home/REDACTED/work/aspire.dev/aspire.dev/src/frontend/node_modules/.cache/lunariabash (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[What's New Analysis] Document container registry resource</issue_title>
<issue_description>## Summary

Aspire 13.1 introduced ContainerRegistryResource for general-purpose container registries beyond Azure Container Registry. Only documented in what's-new.

What's Missing

Core API

var builder = DistributedApplication.CreateBuilder(args);

// Add a generic container registry
var registry = builder.AddContainerRegistry("myregistry", "registry.example.com");

var api = builder.AddProject<Projects.Api>("api")
    .WithContainerRegistry(registry);

Pipeline Integration

$ aspire do push
# Builds images and pushes to configured registry

Azure Container Apps Explicit Registry

// Explicit ACR configuration (13.1)
var acr = builder.AddAzureContainerAppEnvironment("myenv");

var api = builder.AddProject<Projects.Api>("api")
    .WithContainerRegistry(acr);

Suggested Content

1. Generic container registries - DockerHub, Harbor, etc.
2. Azure Container Registry - explicit vs implicit provisioning
3. aspire do push - pipeline step for image pushing
4. Authentication - registry credentials configuration
5. Examples - DockerHub, private registry, ACR

Why It Matters

Container registry configuration was implicit before. Users need to understand the new explicit model.</issue_description>

<agent_instructions>Please have a look at this https://aspire.dev/whats-new/aspire-13-1/#-integration-updates and work on this issue.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes [What's New Analysis] Document container registry resource #341

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.