azure-deployment-preflight
Performs comprehensive preflight validation of Bicep deployments to Azure, including template syntax validation, what-if analysis, and permission checks. Use this skill before any deployment to Azure to preview changes, identify potential issues, and ensure the deployment will succeed. Activate when users mention deploying to Azure, validating Bicep files, checking deployment permissions, previewing infrastructure changes, running what-if, or preparing for azd provision.
Security Assessment
Detected risks:
About azure-deployment-preflight
The azure-deployment-preflight skill provides a robust preflight validation process for Bicep deployments to Azure, helping users ensure that their infrastructure deployments are error-free and successful. By running this skill before deployment, it checks for potential issues such as template syntax errors, permission deficiencies, and infrastructure changes, allowing users to address them before executing the actual deployment. This skill serves as a crucial safety net for developers, DevOps teams, and any Azure users working with Bicep templates who want to guarantee that their deployment will run smoothly.
Key features of the azure-deployment-preflight skill include syntax validation for Bicep files, a what-if analysis for previewing the infrastructure changes before they occur, and a set of permission checks to verify whether the user has the necessary access rights for deployment. The skill works with both Azure CLI and Azure Developer CLI workflows, adapting to the user's environment and project setup. Additionally, it supports auto-detection of Bicep parameter files and recommends appropriate deployment validation levels based on the project's scope.
This skill is ideal for users who are about to deploy infrastructure to Azure, particularly those working with Bicep templates and looking to ensure that their configurations are correct and their permissions are sufficient. It is also useful for previewing changes before executing them, which helps identify potential issues early in the process. Whether you're preparing for deployment with Azure CLI or Azure Developer CLI, this skill can save time and avoid deployment failures by providing a comprehensive pre-deployment validation process.
FAQ
When should I use the azure-deployment-preflight skill?
You should use the azure-deployment-preflight skill before deploying infrastructure to Azure, when preparing or reviewing Bicep files, or when you want to preview the changes a deployment will make. It's also helpful to verify permissions before running commands like `azd up`, `azd provision`, or `az deployment`.
Does this skill work with both Azure CLI and Azure Developer CLI?
Yes, the skill supports both Azure CLI (`az`) and Azure Developer CLI (`azd`) workflows, automatically adapting to the environment based on the presence of an `azure.yaml` file in the project.
What happens if I don't have Bicep CLI installed?
If Bicep CLI is not installed, the skill will note this issue in the final report but will continue with Step 3 (Azure will validate syntax during the what-if analysis).
What if my deployment has permission issues during the validation process?
If permission errors occur during the validation process, you can retry the validation with the `--validation-level` set to `NotExisting`. This allows you to bypass potential permission issues that might be affecting the validation, such as RBAC issues.
Can the azure-deployment-preflight skill handle parameter files automatically?
Yes, the skill automatically detects Bicep parameter files by searching for matching filenames such as `<filename>.bicepparam` or `<filename>.parameters.json` in the project directories. It can also look for general parameter files like `parameters.json` or `parameters/<env>.json`.
Install azure-deployment-preflight
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
github/awesome-copilot