skills.rest
Hexalith
HexalithOFFICIAL
Explore all skills by this author →
WebsiteGitHub

aspire-deployment

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

Updated Mar 1, 2026
Search Tags:#ci/cd#deployment#aws#azure#kubernetes#docker compose#aspire
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill aspire-deployment-hexalith
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: aspire-deployment
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/aspire-deployment
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill aspire-deployment-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deploying a .NET Aspire application requires choosing a target platform, wiring the correct hosting integration into the AppHost, resolving parameters and secrets, and running the right publish/deploy/destroy commands. This Skill routes all of that through the Aspire CLI and AppHost model instead of ad-hoc cloud tooling, preventing misconfigured deployments and unmanaged cloud resources. ## Core Features & Use Cases - Target-aware deployment routing: Detects Aspire AppHosts (C# or TypeScript) and routes deployment work to Docker Compose, Kubernetes, Azure Container Apps, Azure App Service, Azure Kubernetes Service (AKS), or AWS references. - Full deployment lifecycle: Covers orientation, target selection, AppHost code changes, preflight checks, artifact preview with aspire publish, deployment with aspire deploy, and teardown with aspire destroy. - CI/CD automation guidance: Provides GitHub Actions workflow patterns for validating, publishing, and deploying Aspire apps with OIDC Azure login and parameter/secret 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, preflights subscription and parameters, previews steps, and runs aspire deploy. ## Quick Start Ask the assistant to deploy your Aspire application to your chosen 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 WithExternalHttpEndpoints, then run aspire deploy. Configure Azure__SubscriptionId, Azure__Location, and Azure__ResourceGroup before deploying.

How do I generate Docker Compose files from an Aspire AppHost?▼

Add the Docker hosting integration with aspire add docker, add a Docker Compose environment resource, then run aspire publish. Output includes docker-compose.yaml and .env placeholder files under the aspire-output directory.

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

aspire publish generates deployment artifacts such as Compose files, 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, most targets support TypeScript AppHosts with equivalent APIs such as addAzureContainerAppEnvironment and addKubernetesEnvironment. AWS deployment is currently C#-only, and some compute-environment assignment APIs should be verified in docs before use.

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 secrets such as GitHub Actions environment secrets. Never print secret values in logs.

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

Run aspire destroy with the target environment name to execute the AppHost deployment target's destroy pipeline. Confirm the subscription, resource group, or cluster context first, and use --yes only after teardown intent is explicit.

Related Skills

Explore More Software Engineering Skills→
FabienDehopreFabienDehopre

aspireify

Wire Aspire AppHost skeletons into connected local development resource graphs.

Community
Advanced
HexalithHexalith

aspire-monitoring

Inspects Aspire application logs, traces, metrics, and resource state via the Aspire CLI.

Official
Intermediate
MarcelMichauMarcelMichau
1

aspire-deployment

Orchestrate Aspire AppHost deployment workflows across Docker Compose, Kubernetes, Azure, and AWS.

Community
Advanced
christian-deleonchristian-deleon

helm

Create and manage Helm charts for Kubernetes deployments.

Community
Advanced