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

• ansible version >= 2.9

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

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

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

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

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

GNU General Public License v3.0

See LICENSE to see the full text.