skilld
All skills
microsoft avatar

/azure-validate

@e0a67fd
by microsoftmicrosoft/skills3.1k stars
351

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure (Bicep or Terraform), RBAC role assignments, managed identity permissions, and prerequisites before deploying. WHEN: validate my app, check deployment readiness, run preflight checks, verify configuration, check if ready to deploy, validate azure.yaml, validate Bicep, test before deploying, troubleshoot deployment errors, validate Azure Functions, validate function app, validate serverless deployment, verify RBAC roles, check role assignments, review managed identity permissions, what-if analysis, validate Container Apps deployment.

Ask your Agent

Use this Skill: https://skilld.dev/gh/microsoft/skills/azure-validate

This session only. Nothing lands on disk.

referencesrecipesazderrors.md

≈681 tokens on demand. Your agent reads this file only when SKILL.md points to it.

AZD Validation Errors

Pre-Deployment Errors

These errors can be caught before running azd up:

Error Cause Resolution
Please run 'az login' Not authenticated az login or azd auth login
No environment selected Missing azd environment azd env select <name> or azd env new <name> --no-prompt
no default response for prompt 'Enter a unique environment name' No azd environment created, or missing -e flag Run azd env new <name> --no-prompt OR use azd init --from-code -e <name> --no-prompt with the -e flag
no default response for prompt 'Enter a value for the 'environmentName' Environment variables not set Run azd env set AZURE_ENV_NAME <name>
Service not found Service name mismatch Check service name in azure.yaml
Invalid azure.yaml YAML syntax error Fix YAML syntax
Project path does not exist Wrong service project path Fix service project path in azure.yaml
Cannot connect to Docker daemon Docker not running Start Docker Desktop
npm ci fails with missing: package-lock.json Dockerfile uses npm ci but package-lock.json not in build context Run npm install --package-lock-only in the service directory before building
Could not find a part of the path 'infra\main.bicep' Missing infrastructure files Generate infra/ folder before azd up
Invalid resource group location '<loc>'. The Resource group already exists in location '<other>' RG exists in different region Check RG location first with az group show, use that region or new env name
expecting only '1' resource tagged with 'azd-service-name: web', but found '2' Multiple resources with same tag in the same RG Delete duplicate or rename service

Static Web App Errors

Error Cause Fix
language 'html' is not supported Invalid language value Omit language for pure static sites
language 'static' is not supported Invalid language value Omit language for pure static sites
dist folder not found Wrong dist path or missing build Check dist is relative to project; add language: js if build needed
LocationNotAvailableForResourceType SWA not in region See Region Availability for valid regions

SWA Path Validation

Before deployment, verify:

  1. project path exists and contains source files
  2. For framework apps: language: js is set
  3. dist is relative to project (not project root)
  4. Bicep has azd-service-name tag matching service name

Debug

azd <command> --debug

Source: SKILL.md on GitHub

Third-party checks

1 warning15d4 checks · Risk SAFE
  • Gen Agent Trust Hub15d

    This skill provides a structured workflow for validating Azure deployments, covering Bicep, Terraform, and Azure Developer CLI (AZD) projects. It uses several helper scripts to automate configuration checks and infrastructure validation. The skill includes security considerations such as the execution of system commands and the processing of project source files, which are used within its intended validation scope.

  • Socket15d

    No alerts

  • Snyk15d

    Risk: LOW · No issues

  • Runlayer7mo

    14/14 files flagged

Provenance

Signed by skilld at e0a67fd. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 20 hours ago.

Activeupdated 2 months ago

Capability

metadata
{
  "author": "Microsoft",
  "version": "1.2.2"
}

Topics

README badge

README badge for microsoft/skills/azure-validate