1# Bicep Deploy Recipe
2 
3Deploy to Azure using Bicep templates directly.
4 
5## Prerequisites
6 
7- `az` CLI installed with Bicep extension
8- `.azure/deployment-plan.md` exists with status `Validated`
9- Bicep templates exist in `infra/`
10- **Subscription and location confirmed** → See [Pre-Deploy Checklist](../../pre-deploy-checklist.md)
11 
12## Workflow
13 
14| Step | Task | Command |
15|------|------|---------|
16| 1 | **[Pre-deploy checklist](../../pre-deploy-checklist.md)** | Confirm subscription/location with user |
17| 2 | Build (optional) | `az bicep build --file main.bicep` |
18| 3 | Deploy | `az deployment sub create` |
19| 4 | Verify | `az resource list` |
20| 5 | **Report** | Present deployed endpoint URLs to the user — see [Verification](verify.md) |
21 
22## Deployment Commands
23 
24### Subscription-Level Deployment
25 
26```bash
27az deployment sub create \
28  --location eastus2 \
29  --template-file ./infra/main.bicep \
30  --parameters ./infra/main.parameters.json
31```
32 
33### Resource Group Deployment
34 
35```bash
36az deployment group create \
37  --resource-group rg-myapp-dev \
38  --template-file ./infra/main.bicep \
39  --parameters ./infra/main.parameters.json
40```
41 
42### With Inline Parameters
43 
44```bash
45az deployment sub create \
46  --location eastus2 \
47  --template-file ./infra/main.bicep \
48  --parameters environmentName=dev location=eastus2
49```
50 
51### What-If (Preview Changes)
52 
53```bash
54az deployment sub what-if \
55  --location eastus2 \
56  --template-file ./infra/main.bicep \
57  --parameters environmentName=dev
58```
59 
60## Get Deployment Outputs
61 
62```bash
63az deployment sub show \
64  --name main \
65  --query properties.outputs
66```
67 
68## References
69 
70- [Verification steps](./verify.md)
71- [Error handling](./errors.md)
72 
73## MCP Tools
74 
75| Tool | Purpose |
76|------|---------|
77| `mcp_bicep_get_bicep_best_practices` | Best practices |
78| `mcp_bicep_get_az_resource_type_schema` | Resource schemas |
79| `mcp_bicep_list_avm_metadata` | Azure Verified Modules |
80 
81## AVM Verification Before Deploy
82 
83Before running deployment commands, verify generated templates followed AVM-first module selection:
84 
851. AVM Bicep Pattern Modules (prefer AVM+AZD patterns)
862. AVM Bicep Resource Modules
873. AVM Bicep Utility Modules
88 
89If no AVM+AZD pattern module is available, fallback must remain within AVM modules (resource -> utility).
90 
91## Cleanup (DESTRUCTIVE)
92 
93```bash
94az group delete --name <rg-name> --yes
95```
96 
97⚠️ Permanently deletes ALL resources in the group.
98