Aspirate automates the generation, building, and deployment of manifests for .NET Aspire AppHost projects with integrated secrets management.
Handle deployments of .NET Aspire AppHost Projects
This tool is designed for developers and DevOps engineers working with .NET Aspire AppHost projects who need to streamline deployment manifest creation and container builds. It simplifies managing Kubernetes or Docker Compose deployments while securely handling secrets encryption and application to clusters.
The secrets file (aspirate-secrets.json) is encrypted and safe to commit, but losing the password means secrets cannot be recovered without regeneration. Secret management cannot be disabled on existing manifests without regenerating them. The tool supports both Kubernetes and Docker Compose deployments, but secret management is disabled for Compose output.
Run `dotnet tool install -g aspirate` to install Aspirate as a global .NET tool
Add the `--prerelease` flag to install the latest preview version if neededaspirate generate
Generates deployment manifests in the AppHost/aspirate-output directory, builds projects, and pushes containers to the registry by default.
aspirate generate --output-format compose
Generates a slim docker-compose deployment instead of Kubernetes manifests; disables secret support.
aspirate generate --skip-build
Generates manifests without building the projects.
aspirate build
Builds all projects defined in the aspire manifest file and pushes containers to the registry, with an interactive selection menu.
aspirate build --aspire-manifest <path>
Overrides the default manifest file path with a specified manifest file for building.
aspirate apply
Decrypts secrets and applies both secrets and manifests to the target cluster.
aspirate generate / apply (with password prompt)
Prompts for a password to encrypt or decrypt secrets stored in aspirate-secrets.json.
--disable-secrets
Flag to disable secret management functionality during commands; requires regenerating manifests to remove secrets.