1# {vm-name} — Bicep
2 
3Deploys a single Linux VM with VNet, subnet, NSG (SSH allow), public IP, and NIC.
4 
5## Prerequisites
6- Azure CLI (`az login`)
7- An existing resource group
8- SSH public key at `~/.ssh/id_rsa.pub`
9 
10## Quickstart
11 
12```bash
13az deployment group what-if \
14  --resource-group {resourceGroup} \
15  --template-file main.bicep \
16  --parameters vmName={vmName} adminUsername={adminUsername} adminPublicKey="$(cat ~/.ssh/id_rsa.pub)"
17 
18az deployment group create \
19  --resource-group {resourceGroup} \
20  --template-file main.bicep \
21  --parameters vmName={vmName} adminUsername={adminUsername} adminPublicKey="$(cat ~/.ssh/id_rsa.pub)"
22```
23 
24## Parameters
25 
26| Name | Required | Default | Notes |
27|---|---|---|---|
28| `vmName` | * | — | VM resource name |
29| `adminUsername` | * | — | Linux admin user |
30| `adminPublicKey` | * | — | Contents of `id_rsa.pub` (secure) |
31| `location` | | resourceGroup location | Azure region |
32| `vmSize` | | `Standard_D2s_v5` | Verify availability with `compute_vm_list-skus` |
33| `osDiskSizeGb` | | `30` | |
34| `osDiskType` | | `Premium_LRS` | |
35| `zone` | | `''` | `1`/`2`/`3`, or empty for regional |
36| `tags` | | `{}` | |
37 
38## Outputs
39- `vmId` — full ARM resource ID
40- `publicIpAddress` — connect with `ssh {adminUsername}@{publicIpAddress}`
41 
42## VMSS variant
43Swap `Microsoft.Compute/virtualMachines` for `Microsoft.Compute/virtualMachineScaleSets@2024-07-01`, add `sku: { name: vmSize, capacity: instanceCount }`, `properties.orchestrationMode: 'Flexible'`, and move `osProfile`/`storageProfile`/`networkProfile` inside `properties.virtualMachineProfile`.
44 
45## Cleanup
46```bash
47az group delete --name {resourceGroup} --yes --no-wait
48```
49