azure

Overview

This collection provides a series of Ansible modules and plugins for interacting with the Azure.

Detected project types: Ansible role, Ansible collection.

At a glance

• Default branch: dev
• Visibility: public
• Size: 2.4 MB
• Created: 2026-04-27
• Last updated: 2026-04-27
• Stars / Forks / Open issues: 0 / 0 / 0
• License: GPL-3.0

Languages

Language	Bytes	Share
Python	3,357,309 bytes	99.8%
Shell	8,165 bytes	0.2%

Repository structure

• meta/
• plugins/
• tests/
• .gitignore (118 B)
• azure-pipelines.yml (923 B)
• CHANGELOG.md (27,318 B)
• CONTRIBUTING.md (4,046 B)
• CredScanSuppressions.json (470 B)
• galaxy.yml (2,424 B)
• LICENSE (35,148 B)
• pr-pipelines.yml (8,529 B)
• README.md (2,829 B)
• release-pipelines.yml (600 B)
• requirements-azure.txt (1,291 B)
• sanity-requirements-azure.txt (89 B)
• shippable.yml (644 B)

Getting started

Clone the repository:

git clone https://forgejo.deployview.com/ssa/azure.git
cd azure

Installation

ansible-galaxy install -r requirements.yml
ansible-playbook playbook.yml

Usage

Include this role/collection in a playbook and run with ansible-playbook. See defaults/main.yml (if present) for configurable variables.

Original README

The content below is preserved from the previous README. Headings have been demoted so they don't compete with the new top-level sections.

Ansible collection for Azure

This collection provides a series of Ansible modules and plugins for interacting with the Azure.

Documentation of individual modules is available in the Ansible docs site

Requirements

• ansible version >= 2.9

Installation

To install Azure dependencies:

pip install -r requirements-azure.txt

To install Azure collection hosted in Galaxy:

ansible-galaxy collection install azure.azcollection

To upgrade to the latest version of Azure collection:

ansible-galaxy collection install azure.azcollection --force

Usage

Playbooks

To use a module from Azure collection, please reference the full namespace, collection name, and modules name that you want to use:

---
- name: Using Azure collection
  hosts: localhost
  tasks:
    - azure.azcollection.azure_rm_storageaccount:
        resource_group: myResourceGroup
        name: myStorageAccount
        account_type: Standard_LRS

Or you can add full namepsace and collecton name in the collections element:

---
- name: Using Azure collection
  hosts: localhost
  collections:
    - azure.azcollection
  tasks:
    - azure_rm_storageaccount:
        resource_group: myResourceGroup
        name: myStorageAccount
        account_type: Standard_LRS

Roles

For existing Ansible roles, please also reference the full namespace, collection name, and modules name which used in tasks instead of just modules name.

Plugins

To use a pluign from Azure collection, please reference the full namespace, collection name, and plugins name that you want to use:

plugin: azure.azcollection.azure_rm
    include_vm_resource_groups:
    - ansible-inventory-test-rg
    auth_source: auto

Contributing

There are many ways in which you can participate in the project, for example:

• Submit bugs and feature requests, and help us verify as they are checked in
• Review source code changes
• Review the documentation and make pull requests for anything from typos to new content
• If you are interested in fixing issues and contributing directly to the code base, please see the CONTRIBUTING document

License

GNU General Public License v3.0

See LICENSE to see the full text.

Contributing

Contributions are welcome. The typical workflow is:

1. Open an issue describing the change you'd like to make.
2. Fork the repository (or create a feature branch if you have write access).
3. Commit your changes with clear, descriptive messages.
4. Open a pull request against the dev branch.

Please follow the existing code style and include tests or reproduction steps where relevant.

License

This project is licensed under the GPL-3.0 license. See the LICENSE file for the full text.

Repository

• Browse: https://forgejo.deployview.com/ssa/azure
• Clone (HTTPS): https://forgejo.deployview.com/ssa/azure.git
• Clone (SSH): ssh://git@forgejo.deployview.com:30143/ssa/azure.git

---

This README was generated automatically based on repository metadata, contents, and any prior README content. Edit any section above to add project-specific detail.