aspire-deployment

Deploy Aspire AppHost applications to Docker Compose, Kubernetes, Azure, or AWS using the Aspire CLI.

25|4|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/thangchung/agent-engineering-experiment --skill aspire-deployment-thangchung
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aspire-deployment
Source: https://github.com/thangchung/agent-engineering-experiment/tree/main/agentgateway-entraid-obo/.claude/skills/aspire-deployment
Command: npx skills add https://github.com/thangchung/agent-engineering-experiment --skill aspire-deployment-thangchung

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deploying a distributed Aspire application requires choosing a target platform, wiring the right hosting integration into the AppHost, resolving parameters and secrets, and running the correct publish/deploy/destroy pipeline. This Skill routes all deployment work through the Aspire AppHost model instead of ad-hoc Docker, Kubernetes, Azure, or AWS workflows, preventing misconfigured targets and unmanaged cloud resources. ## Core Features & Use Cases - Target-aware deployment routing: Detects Aspire AppHosts (C# or TypeScript) and routes to Docker Compose, Kubernetes, Azure Container Apps, Azure App Service, Azure Kubernetes Service (AKS), or AWS references based on the user's chosen or detected target. - Full deployment lifecycle: Covers preflight checks, parameter and secret inventory, aspire publish artifact preview, aspire deploy, and guarded aspire destroy teardown with confirmation requirements. - CI/CD automation guidance: Provides GitHub Actions workflow patterns for validating, publishing, and deploying Aspire apps with OIDC Azure login, registry auth, and Parameters__* environment variable mapping. - Use Case: A developer asks to deploy their Aspire app to Azure Container Apps. The Skill detects the AppHost, runs aspire add azure-appcontainers, adds the environment resource, previews steps with aspire deploy --list-steps, then deploys with the correct subscription, location, and resource group settings. ## Quick Start Ask the assistant to deploy your Aspire app to a specific target, for example: deploy this Aspire app to Azure Container Apps.

Frequently Asked Questions about aspire-deployment

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an Aspire app to Azure Container Apps?▼

Run `aspire add azure-appcontainers`, add an Azure Container Apps environment resource to the AppHost, mark public resources with the external HTTP endpoints API, then run `aspire deploy`. Configure Azure__SubscriptionId, Azure__Location, and Azure__ResourceGroup before deploying.

How do I deploy an Aspire app to Kubernetes?▼

Run `aspire add kubernetes`, add a Kubernetes environment resource, and configure a container registry since Kubernetes has no local-registry fallback. Use `aspire publish` to generate Helm charts or `aspire deploy` to install them into the cluster pointed to by your current kubectl context.

What is the difference between aspire publish and aspire deploy?▼

`aspire publish` generates deployment artifacts such as docker-compose.yaml, Helm charts, or CDK output for review or handoff. `aspire deploy` resolves parameters and applies the deployment directly from the AppHost model; it does not consume a previously published output directory.

Does Aspire deployment support TypeScript AppHosts?▼

Yes, Docker Compose, Kubernetes, and Azure targets support TypeScript AppHosts with language-specific APIs like `addDockerComposeEnvironment`. AWS deployment is currently C#-only through the preview AWS Aspire integrations.

How do I pass secrets to aspire deploy in CI/CD?▼

Map AppHost parameters to environment variables using the `Parameters__name` convention, replacing dashes with underscores, and source values from CI secret stores such as GitHub Actions secrets. Run with `--non-interactive` so the pipeline does not stall on prompts.

How do I tear down resources created by aspire deploy?▼

Run `aspire destroy --environment <name>` to execute the target's destroy pipeline for the selected AppHost and environment. Confirm the subscription, cluster context, and destructive intent first; use `--yes` only when teardown intent is explicit.