azure-deployment-preflight

Validate Bicep syntax, what-if changes, and RBAC before Azure deployment.

1|Updated Jan 30, 2023
One-click install
npx skills add https://github.com/ncksol/ravebot --skill azure-deployment-preflight-ncksol
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-deployment-preflight
Source: https://github.com/ncksol/ravebot/tree/main/.github/skills/azure-deployment-preflight
Command: npx skills add https://github.com/ncksol/ravebot --skill azure-deployment-preflight-ncksol

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Azure deployment validation challenges often lead to surprises during rollout, including syntax errors, misconfigurations, and insufficient permissions. This skill provides a structured preflight workflow to surface issues early, enabling safer deployments.

Core Features & Use Cases

  • Detects whether the project uses an azd-based workflow or standalone Bicep and routes to the appropriate what-if validation.
  • Validates Bicep syntax with the Bicep CLI and aggregates errors for a complete preflight report.
  • Executes what-if analysis using azd preview or az deployment what-if, depending on project type and scope.
  • Generates a comprehensive preflight-report.md in the project root that summarizes results, issues, and recommended actions.
  • Includes robust error handling and fallback logic, continuing validation to provide a complete risk assessment even when some steps fail.

Quick Start

Run a preflight validation on your Bicep project to preview changes and verify permissions before deployment.

Frequently Asked Questions about azure-deployment-preflight

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

FAQPage Schema
How do I validate Bicep syntax and run what-if analysis before deploying to Azure?

An Azure deployment preflight validates Bicep syntax and runs what-if analysis to surface misconfigurations and permission issues early. It generates a preflight-report.md summarizing risks, enabling safer deployments before execution.

Can I use az deployment what-if for standalone Bicep projects without an azd workflow?

Yes, az deployment what-if works for standalone Bicep projects. The preflight process detects whether your project uses an azd-based workflow or standalone Bicep and routes to the appropriate what-if validation command accordingly.

What Azure scopes are supported for preflight RBAC checks during Bicep deployments?

Preflight RBAC checks support resource-group, subscription, management group, and tenant scopes. This ensures you have sufficient permissions across the targeted Azure scope before executing your Bicep deployment.

Do I need Azure CLI and Bicep CLI installed to run Azure deployment preflight validations?

Yes, running Azure deployment preflight validations requires Azure CLI (az), Azure Developer CLI (azd), and Bicep CLI. You also need access to a target Azure subscription to execute the what-if analysis and RBAC checks.

What happens if one step fails during the Azure what-if preflight workflow?

The preflight workflow includes robust error handling and fallback logic. If one step fails, validation continues to provide a complete risk assessment, aggregating errors into a comprehensive preflight report for your review.

What is the best way to preview Azure infrastructure changes before executing a rollout?

The best way to preview Azure infrastructure changes is a preflight workflow that performs what-if analysis. This process identifies syntax errors and misconfigurations early, outputting a preflight-report.md with recommended actions.