1# AZCLI Validation
2 
3Validation steps for Azure CLI deployments.
4 
5## Prerequisites
6 
7- `./infra/main.bicep` exists
8- Docker available (if containerized)
9 
10## Validation Steps
11 
12- [ ] 1. Azure CLI Installation
13- [ ] 2. Authentication
14- [ ] 3. Bicep Compilation
15- [ ] 4. Template Validation
16- [ ] 5. What-If Preview
17- [ ] 6. Docker Build (if containerized)
18- [ ] 7. Azure Policy Validation
19 
20## Validation Details
21 
22### 1. Azure CLI Installation
23 
24Verify Azure CLI is installed:
25 
26```bash
27az version
28```
29 
30**If not installed:**
31```
32mcp_azure_mcp_extension_cli_install(cli-type: "az")
33```
34 
35### 2. Authentication
36 
37```bash
38az account show
39```
40 
41**If not logged in:**
42```bash
43az login
44```
45 
46**Set subscription:**
47```bash
48az account set --subscription <subscription-id>
49```
50 
51### 3. Bicep Compilation
52 
53```bash
54az bicep build --file ./infra/main.bicep
55```
56 
57### 4. Template Validation
58 
59```bash
60# Subscription scope
61az deployment sub validate \
62  --location <location> \
63  --template-file ./infra/main.bicep \
64  --parameters ./infra/main.parameters.json
65 
66# Resource group scope
67az deployment group validate \
68  --resource-group <rg-name> \
69  --template-file ./infra/main.bicep \
70  --parameters ./infra/main.parameters.json
71```
72 
73### 5. What-If Preview
74 
75```bash
76# Subscription scope
77az deployment sub what-if \
78  --location <location> \
79  --template-file ./infra/main.bicep \
80  --parameters ./infra/main.parameters.json
81 
82# Resource group scope
83az deployment group what-if \
84  --resource-group <rg-name> \
85  --template-file ./infra/main.bicep \
86  --parameters ./infra/main.parameters.json
87```
88 
89### 6. Docker Build (if containerized)
90 
91**Before building**, validate the Docker build context:
92 
931. Read the `Dockerfile` in `./src/<service>`
942. If the Dockerfile contains `npm ci`, verify `package-lock.json` exists in the same directory
953. If `package-lock.json` is missing, generate it:
96 
97```bash
98cd ./src/<service>
99npm install --package-lock-only
100```
101 
102**Then build:**
103 
104```bash
105docker build -t <image>:test ./src/<service>
106```
107 
108### 7. Azure Policy Validation
109 
110See [Policy Validation Guide](../../policy-validation.md) for instructions on retrieving and validating Azure policies for your subscription.
111 
112## References
113 
114- [Error handling](./errors.md)
115 
116## Next
117 
118All checks pass → **azure-deploy**
119