Prerequisites

GitHub Account

To contribute, you need a GitHub account. If you are a Microsoft employee, your account must be linked to your corporate identity and you must be a member of the Azure organization.

Module Owner Access (Microsoft FTEs only)

Note

This step is only required if you are (or are becoming) a Terraform module owner. External contributors and one-off contributors do not need this access.

Access for Terraform module owners is granted via the Azure Verified Modules (AVM) Module Contributors Entra access package. Request access here:

Azure Verified Modules (AVM) Module Contributors — Access Package

Once approved, you will be added to the azure-verified-modules-module-contributors Entra group, which is the source of truth for who is authorized to own and approve changes on AVM Terraform module repositories.

Tip

Until your access request is approved, you can continue to contribute by using JIT elevation and by raising PRs that are approved by an existing module owner.

Required Tooling

Tip

Avm.Authoring supports Windows, Linux, and macOS. Use PowerShell 7.4 or later on every platform.

Git

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

PowerShell 7.4 or later
Avm.Authoring
```
Install-PSResource Avm.Authoring
Import-Module Avm.Authoring
avm doctor
```
Install-Module Avm.Authoring -Scope CurrentUser remains available for environments that use PowerShellGet v2. Run avm update to upgrade an existing installation. The module downloads, verifies, and caches its managed tools, including Terraform, on demand. Run avm doctor --install to preload every supported tool. Docker and Podman are not required.
Azure CLI
Visual Studio Code