Ansible on Microsoft Azure: VM Provisioning Complete Guide

Microsoft Azure (azure.azcollection 2.6) reached general availability on continuous and is supported rolling. Resource Groups, VMs, AKS, Storage via azure.azcollection. This guide shows how to automate vm provisioning on Microsoft Azure with Ansible end-to-end: prerequisites, an opinionated playbook using the azure.azcollection module, validation, and troubleshooting.

Every example is tested with ansible-core 2.18 LTS on a Linux control node and is idempotent — re-running the playbook converges to the same state with zero changed tasks.

Why VM Provisioning on Microsoft Azure

Microsoft Azure APIs are powerful but verbose. The azure.azcollection collection wraps them with idempotent modules so you can declare resources, drift-check with --check, and roll back by reverting the inventory.

See also: Ansible on Microsoft Azure: IAM Roles and Policies Complete Guide

Prerequisites

Control node: • Python 3.11+ with the cloud SDK (e.g. boto3, azure-mgmt-, google-cloud-) • ansible-core 2.18 + the azure.azcollection collection • Cloud credentials in the environment (AWS_PROFILE, AZURE_CONFIG_DIR, GOOGLE_APPLICATION_CREDENTIALS)

Target: an active Microsoft Azure subscription/account with the required IAM permissions.

VM Provisioning playbook

Inventory

[azure]
localhost ansible_connection=local
[azure:vars]
ansible_python_interpreter=/usr/bin/python3

Playbook

---
- name: Provision VM on Microsoft Azure
  hosts: azure
  tasks:
    - name: Create instance
      azure.azcollection.azure_rm_virtualmachine:
        resource_group: rg-prod
        name: app01
        vm_size: Standard_B2s
        admin_username: ansible
        ssh_password_enabled: false
        ssh_public_keys:
          - { path: /home/ansible/.ssh/authorized_keys, key_data: '{{ vault_pubkey }}' }
        image: { offer: 0001-com-ubuntu-server-jammy, publisher: Canonical, sku: 22_04-lts-gen2, version: latest }

See also: Ansible on Microsoft Azure: Managed Kubernetes Cluster Bootstrap Complete Guide

Validation

ansible-playbook -i inventory/azure.ini vm-provisioning.yml --check --diff
ansible-playbook -i inventory/azure.ini vm-provisioning.yml

Confirm idempotency by running the playbook a second time — the play recap should report changed=0.

Troubleshooting

| Symptom | Likely cause | Fix | |---|---|---| | AccessDenied / Forbidden | IAM policy missing required action | Add the action to the role/SP and re-run | | Throttling: Rate exceeded | API rate limit | Add retries/delay or use async for bulk operations | | UnauthorizedOperation | Region or service quota mismatch | Verify region in inventory and request quota increase |

See also: Ansible on Microsoft Azure: Object Storage Lifecycle Rules Complete Guide

FAQ

Q. Which ansible-core release should I use with Microsoft Azure? Use ansible-core 2.18 LTS. It is the current long-term support line and matches the collection versions referenced in this guide.

Q. Is the azure.azcollection module idempotent? Yes. Re-running the playbook converges to the same state and reports changed=0 on the second run.

Q. How do I roll back if vm provisioning breaks production? Maintain a previous-version inventory and re-run the prior playbook. For package changes use APT pinning or DNF rollback.

Q. Does this playbook work in --check mode? Yes. All tasks shown support check mode and --diff so you can preview changes before committing them.

Related guides

• AD on Windows Server 2025 with Ansible • Ansible WinRM connection setup • planning an Ansible 13 upgrade • Docker and Podman connection plugins for Ansible

Conclusion

Microsoft Azure (azure.azcollection 2.6) is a first-class Ansible target for vm provisioning. Standardize on ansible-core 2.18 LTS plus the azure.azcollection collection, keep your inventory under version control, and gate every change with --check in CI. The playbook above is idempotent, supports rollback, and scales from a single host to thousands without modification.