azure-deploy
Execute Azure deployments for ALREADY-PREPARED applications that have existing .azure/deployment-plan.md and infrastructure files. DO NOT use this skill when the user asks to CREATE a new application — use azure-prepare instead. This skill runs azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. Requires .azure/deployment-plan.md from azure-prepare and validated status from azure-validate. WHEN: "run azd up", "run azd deploy", "execute deployment", "push
Security Assessment
Detected risks:
About azure-deploy
The azure-deploy skill is designed to execute deployments for applications that have already been prepared using the azure-prepare skill. It ensures that only validated deployment plans are executed, mitigating risks associated with incomplete or unverified infrastructure. By leveraging this skill, users can safely push updates, run deployment commands, and ship applications to production environments without manually handling Azure CLI commands or Terraform scripts. The skill enforces a strict workflow to prevent errors, ensuring that the deployment plan exists and has been validated before proceeding.
Key features of azure-deploy include automated execution of azd up, azd deploy, terraform apply, and az deployment commands with built-in error recovery. The skill verifies that the deployment plan status is marked as `Validated` and requires completion of a pre-deploy checklist to guarantee readiness. It also respects safety rules, such as requiring explicit user approval for destructive actions and limiting its scope strictly to deployment execution. Additionally, it supports deployment of applications that include pre-configured API Management (APIM) gateways or AI governance policies, but does not generate infrastructure or scaffold new projects.
This skill is primarily intended for cloud engineers, DevOps professionals, and developers who manage ongoing Azure applications and need a reliable, repeatable deployment process. Typical use cases include pushing updates to production, deploying changes to pre-existing infrastructure, or running deployment pipelines for applications with complex dependencies. Users seeking to create new applications or infrastructure should use azure-prepare first, followed by azure-validate, before invoking azure-deploy, ensuring a controlled and successful deployment workflow.
FAQ
Can I use azure-deploy to create a new application from scratch?
No. azure-deploy only works with applications that have already been prepared using azure-prepare. For creating new applications or infrastructure, you should use azure-prepare first.
What prerequisites are required before running azure-deploy?
You must have an existing .azure/deployment-plan.md file created by azure-prepare, and the deployment plan must be validated using azure-validate with status `Validated`.
Which commands does azure-deploy execute?
The skill runs azd up, azd deploy, terraform apply, and az deployment commands, all through an error recovery and verification pipeline.
Can I skip validation or manually mark the plan as validated?
No. Skipping validation or manually changing the status is forbidden. Only azure-validate can set the plan status to `Validated` after proper checks.
Does azure-deploy handle APIM gateway creation?
No. It only deploys applications with pre-existing APIM or AI gateway infrastructure. For creating or modifying these resources, use azure-prepare or the azure-aigateway skill.
All Files
41 filesInstall azure-deploy
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
microsoft/azure-skills