azure-deploy

Execute validated Azure deployments using azd and infrastructure steps.

Updated Dec 20, 2023
One-click install
npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill azure-deploy-thiago-cruz-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-deploy
Source: https://github.com/Thiago-Cruz-eng/Hibrygame/tree/main/.claude/skills/azure-deploy
Command: npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill azure-deploy-thiago-cruz-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the friction and common failures of deploying an already-prepared Azure application by enforcing a validated, recipe-driven deployment workflow with verification and guarded prerequisites.

Core Features & Use Cases

  • Validated deployment gating: Ensures .azure/plan.md exists and contains a populated validation proof with status Validated, and requires that azure-validate ran successfully before any deployment commands execute.
  • Deployment execution for prepared projects: Runs deployment operations for apps that already have azure.yaml plus infrastructure files, including flows like run azd up, run azd deploy, and Terraform/Bicep-backed deployment steps coordinated by a recipe.
  • Safety and recovery rails: Requires completion of the Pre-Deploy Checklist, references global rules for destructive actions, and includes structured post-deploy steps (e.g., SQL managed identity configuration and EF migrations when applicable), plus recipe-specific error handling and verification.

Quick Start

Tell the assistant to deploy your prepared Azure app by running azd up from your existing project after confirming you have completed azure-prepare and azure-validate.

Frequently Asked Questions about azure-deploy

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

FAQPage Schema
How do I deploy an already-prepared Azure app using azd?

To deploy an Azure app with azd, you need an existing `azure.yaml` and `.azure/` infrastructure plan, then execute commands like `azd up` or `azd deploy`. This workflow coordinates Terraform or Bicep steps under a validated recipe to push your updates.

What prerequisites are needed before running azd deploy for my application?

Before running `azd deploy`, your project requires a `.azure/plan.md` file with a populated validation proof marked as `Validated`. You must also complete the pre-deploy checklist and successfully run the `azure-validate` step to ensure gating compliance.

Can I run EF Core migrations and SQL managed identity configuration during an Azure deployment?

Yes, structured post-deploy steps include applying EF Core migrations and configuring SQL managed identity when applicable. These tasks execute automatically after the main infrastructure and application deployment steps finish successfully.

Why does my Azure deployment fail if the plan validation status is missing?

Azure deployment fails without a `Validated` status because the workflow enforces validated deployment gating. This safety rail ensures `azure-validate` ran successfully and the `.azure/plan.md` proof exists, preventing destructive actions on unverified infrastructure.

Does this Azure deployment workflow support both Terraform and Bicep infrastructure files?

Yes, the deployment execution supports apps with existing infrastructure files backed by either Terraform or Bicep. The workflow coordinates these deployment steps through a recipe-driven process after validating your `.azure/plan.md`.

What's the best way to ship updates to an Azure app without manual infrastructure provisioning?

The best way to ship updates is using a recipe-driven `azd up` deployment workflow. It coordinates infrastructure and application deployment steps automatically, provided your `.azure/plan.md` is validated and the pre-deploy checklist is complete.