1# az CLI adapter
2 
3Fast, portable, scriptable. Works anywhere `az` is installed and logged in.
4 
5## VM template
6 
7```bash
8#!/usr/bin/env bash
9set -euo pipefail
10 
11# {plan-card-summary}
12 
13az group create --name "{resourceGroup}" --location "{location}"
14 
15az vm create \
16  --resource-group "{resourceGroup}" \
17  --name "{vmName}" \
18  --location "{location}" \
19  --image "{image}" \
20  --size "{vmSize}" \
21  --admin-username "{adminUsername}" \
22  --ssh-key-values @{sshKeyPath} \
23  --vnet-name "{vnetName}" \
24  --subnet "{subnetName}" \
25  --nsg "{nsgName}" \
26  --public-ip-address "{publicIpName}" \
27  --zone {zone} \
28  --os-disk-size-gb {osDiskSizeGb} \
29  --storage-sku {osDiskType} \
30  --tags {tagsKv}
31```
32 
33## VMSS template
34 
35Replace `az vm create` with `az vmss create`, swap `--size` for `--vm-sku`, add `--instance-count {n}`, `--orchestration-mode Flexible`, `--upgrade-policy-mode Manual|Automatic|Rolling`.
36 
37## Filled example — dev Linux VM in eastus
38 
39```bash
40#!/usr/bin/env bash
41set -euo pipefail
42 
43# dev-vm | eastus | Ubuntu2404 | Standard_D2s_v5 | new VNet | est. $70/mo
44 
45az group create --name dev-vm-rg --location eastus
46 
47az vm create \
48  --resource-group dev-vm-rg \
49  --name dev-vm \
50  --location eastus \
51  --image Ubuntu2404 \
52  --size Standard_D2s_v5 \
53  --admin-username azureuser \
54  --ssh-key-values @~/.ssh/id_rsa.pub \
55  --vnet-name dev-vm-vnet \
56  --subnet default \
57  --nsg dev-vm-nsg \
58  --public-ip-address dev-vm-ip \
59  --os-disk-size-gb 30 \
60  --storage-sku Premium_LRS \
61  --tags env=dev owner=team-name
62```
63 
64## Notes
65- Windows VMs: swap `--ssh-key-values @...` for `--admin-password '{password}'`.
66- Linux: prefer SSH keys (`~/.ssh/id_rsa.pub` or `~/.ssh/id_ed25519.pub`). Never paste private keys.
67- `--zone` is optional; omit the flag entirely (don't pass empty) for regional VMs.
68- `--tags` uses space-separated `k=v` pairs.
69- Pre-check quota: `compute_vm_check-quota` (or `az vm list-usage --location {location} -o table`).
70