README

• azure.yaml exists in project root
• Infrastructure files exist:
  • For Bicep: ./infra/ contains Bicep files
  • For Terraform: ./infra/ contains .tf files and azure.yaml has infra.provider: terraform

Validation Steps

• Not done: 1. AZD Installation
• Not done: 2. Schema Validation
• Not done: 3. Environment Setup
• Not done: 4. Authentication Check
• Not done: 5. Subscription/Location Check
• Not done: 6. Aspire Pre-Provisioning Checks
• Not done: 7. Provision Preview
• Not done: 8. Build Verification
• Not done: 9. Docker Build Context Validation
• Not done: 10. Package Validation
• Not done: 11. Azure Policy Validation
• Not done: 12. Aspire Post-Provisioning Checks

Validation Details

1. AZD Installation

Verify AZD is installed:

If not installed:

2. Schema Validation

Validate azure.yaml against official schema:

3. Environment Setup

Verify AZD environment exists and is configured. See Environment Setup for detailed steps.

4. Authentication Check

If not logged in:

5. Subscription/Location Check

Check environment values:

If AZURE_SUBSCRIPTION_ID or AZURE_LOCATION not set:

Use Azure MCP tools to list subscriptions:

Use Azure MCP tools to list resource groups (check for conflicts):

Prompt user to confirm subscription and location before continuing.

Refer to the region availability reference to select a region supported by all services in this template:

• Region availability

6. Aspire Pre-Provisioning Checks

If this is a .NET Aspire project (detected by *.AppHost.csproj or Aspire.Hosting package reference), run the Pre-Provisioning checks in Aspire Validation before continuing. If not Aspire, skip this step.

7. Provision Preview

Validate IaC is ready (must complete without error):

💡 Note: This works for both Bicep and Terraform. azd will automatically detect the provider from azure.yaml and run the appropriate validation (bicep build or terraform plan).

If azd provision --preview fails with unsupported resource type:

⛔ Stop deployment immediately. Do NOT attempt to fix or work around the error.

This error means the Aspire AppHost contains custom resource types that have no Azure deployment target (e.g., HealthChecksUI, custom child resources, or local-only integrations). These resources are intentionally designed for local development tooling and cannot be meaningfully deployed to Azure.

Required actions:

1. ⛔ Do NOT modify source code to suppress the error (e.g., do not add .ExcludeFromManifest()).
2. ⛔ Do NOT proceed with azd provision or azd deploy.
3. ✅ Inform the user: “This application contains custom Aspire resource types (unsupported resource type: <type-name>) that cannot be deployed to Azure. The application is designed for local development only.”
4. ✅ Record a blocker: “Deployment blocked — AppHost contains unsupported resource types with no Azure deployment target.”

⚠️ Adding .ExcludeFromManifest() to suppress the error may allow provisioning to proceed, but the resulting deployment will not represent the application’s actual functionality and is not a valid deployment.

8. Build Verification

Build the project and verify there are no errors. If the build fails, fix the issues and re-build until it succeeds. Do NOT proceed to packaging or deployment with build errors.

9. Docker Build Context Validation

If any service in azure.yaml uses a Dockerfile (check the service’s project path from azure.yaml for a Dockerfile), validate the build context before packaging:

1. Read each service’s Dockerfile
2. If the Dockerfile contains npm ci, verify package-lock.json exists in the same directory
3. If package-lock.json is missing, generate it in the service’s project path directory before proceeding:

⚠️ Warning: npm ci will fail during Docker build if package-lock.json is missing. This check prevents Docker build failures during azd package and azd up.

10. Package Validation

Confirm all services package successfully:

11. Azure Policy Validation

See Policy Validation Guide for instructions on retrieving and validating Azure policies for your subscription.

12. Aspire Post-Provisioning Checks

If this is a .NET Aspire project, run the Post-Provisioning checks in Aspire Validation before proceeding to deployment. If not Aspire, skip this step.

References

• Environment Setup
• Aspire Validation
• Error Handling

Next

All checks pass → azure-deploy