1# AZCLI Recipe
2 
3Azure CLI workflow for imperative Azure deployments.
4 
5## When to Use
6 
7- Existing az scripts in project
8- Need imperative control over deployment
9- Custom deployment pipelines
10- AKS deployments
11- Direct resource manipulation
12 
13## Before Generation
14 
15**REQUIRED: Research best practices before generating any files.**
16 
17| Artifact | Research Action |
18|----------|-----------------|
19| Bicep files | Call `mcp_bicep_get_bicep_best_practices` |
20| Bicep modules | Call `mcp_bicep_list_avm_metadata` and follow [AVM module order](../azd/iac-rules.md#avm-module-selection-order-mandatory) |
21| Azure CLI commands | Call `activate_azure_cli_management_tools` |
22| Azure best practices | Call `mcp_azure_mcp_get_azure_bestpractices` |
23 
24## Generation Steps
25 
26### 1. Generate Infrastructure (Bicep)
27 
28Create Bicep templates in `./infra/`.
29 
30**Structure:**
31```
32infra/
33├── main.bicep
34├── main.parameters.json
35└── modules/
36    └── *.bicep
37```
38 
39### 2. Generate Deployment Scripts
40 
41Create deployment scripts for provisioning.
42 
43→ [scripts.md](scripts.md)
44 
45### 3. Generate Dockerfiles (if containerized)
46 
47Manual Dockerfile creation required.
48 
49## Output Checklist
50 
51| Artifact | Path |
52|----------|------|
53| Main Bicep | `./infra/main.bicep` |
54| Parameters | `./infra/main.parameters.json` |
55| Modules | `./infra/modules/*.bicep` |
56| Deploy script | `./scripts/deploy.sh` or `deploy.ps1` |
57| Dockerfiles | `src/<service>/Dockerfile` |
58 
59## Deployment Commands
60 
61See [commands.md](commands.md) for common patterns.
62 
63## Naming Convention
64 
65Resources: `{prefix}{token}{instance}`
66- Alphanumeric only, no special characters
67- Prefix ≤3 chars (e.g., `kv` for Key Vault)
68- Token = 5 char random string
69- Total ≤32 characters
70 
71## References
72 
73- [Deployment Commands](commands.md)
74- [Deployment Scripts](scripts.md)
75 
76## Next
77 
78→ Update `.azure/deployment-plan.md` → **azure-validate**
79