Inventory Plugin

README.md

@@ -62,6 +62,8 @@ For existing Ansible roles, please also reference the full namespace, collection
 
 ## Resource Supported
 
+### Modules
+
 - azure_rm_deployment - Create or destroy Azure Resource Manager template deployments
 - azure_rm_dnsrecordset - Create, delete and update DNS record sets and records
 - azure_rm_dnsrecordset_facts - Get DNS Record Set facts
@@ -81,6 +83,10 @@ For existing Ansible roles, please also reference the full namespace, collection
 - azure_rm_virtualnetwork - Manage Azure virtual networks
 - azure_rm_virtualnetwork_facts - Get virtual network facts
 
+### Plugins
+
+- azure_rm - Azure Resource Manager inventory plugin. Documentation [here](https://docs.ansible.com/ansible/latest/plugins/inventory/azure_rm.html) 
+
 ## Contributing
 
 There are many ways in which you can participate in the project, for example:

tests/integration/targets/inventory_azure/aliases

@@ -0,0 +1,2 @@
+cloud/azure
+shippable/azure/group1

tests/integration/targets/inventory_azure/playbooks/create_inventory_config.yml

@@ -0,0 +1,11 @@
+---
+- hosts: localhost
+  connection: local
+  gather_facts: no
+  vars:
+    template_name: "../templates/{{ template | default('basic.yml') }}"
+  tasks:
+    - name: write inventory config file
+      copy:
+        dest: ../test.azure_rm.yml
+        content: "{{ lookup('template', template_name) }}"

tests/integration/targets/inventory_azure/playbooks/empty_inventory_config.yml

@@ -0,0 +1,9 @@
+---
+- hosts: localhost
+  connection: local
+  gather_facts: no
+  tasks:
+    - name: write inventory config file
+      copy:
+        dest: ../test.azure_rm.yml
+        content: ""

tests/integration/targets/inventory_azure/playbooks/setup.yml

@@ -0,0 +1,27 @@
+---
+- include_vars:
+    file: vars.yml
+
+- name: SETUP | Create storage account
+  azure_rm_storageaccount:
+    resource_group: "{{ resource_group }}"
+    name: "{{ storage_account }}"
+    account_type: Standard_LRS
+
+- name: SETUP | Create availability set
+  azure_rm_availabilityset:
+    name: "{{ availability_set }}"
+    resource_group: "{{ resource_group }}"
+
+- name: SETUP | Create virtual network
+  azure_rm_virtualnetwork:
+    resource_group: "{{ resource_group }}"
+    name: "{{ network_name }}"
+    address_prefixes: "{{ network }}"
+
+- name: SETUP | Create subnet
+  azure_rm_subnet:
+    resource_group: "{{ resource_group }}"
+    name: "{{ subnet_name }}"
+    address_prefix: "{{ subnet }}"
+    virtual_network: "{{ network_name }}"

tests/integration/targets/inventory_azure/playbooks/teardown.yml

@@ -0,0 +1,26 @@
+---
+- name: Destroy subnet
+  azure_rm_subnet:
+    resource_group: "{{ resource_group }}"
+    virtual_network: "{{ network_name }}"
+    name: "{{ subnet_name }}"
+    state: absent
+
+- name: Destroy virtual network
+  azure_rm_virtualnetwork:
+    resource_group: "{{ resource_group }}"
+    name: "{{ network_name }}"
+    state: absent
+
+- name: Destroy availability set
+  azure_rm_availabilityset:
+    resource_group: "{{ resource_group }}"
+    name: "{{ availability_set }}"
+    state: absent
+
+- name: Destroy storage account
+  azure_rm_storageaccount:
+    resource_group: "{{ resource_group }}"
+    name: "{{ storage_account }}"
+    force_delete_nonempty: yes
+    state: absent

tests/integration/targets/inventory_azure/playbooks/test_inventory.yml

@@ -0,0 +1,39 @@
+---
+- hosts: localhost
+  connection: local
+  gather_facts: no
+  tasks:
+  - name: setup
+    include_tasks: setup.yml
+
+  - name: Create minimal VM with defaults
+    azure_rm_virtualmachine:
+      resource_group: "{{ resource_group }}"
+      name: "{{ vm_name }}"
+      admin_username: "testuser"
+      admin_password: "Pass123$$$abx!"
+      vm_size: Standard_B1ms
+      virtual_network: "{{ network_name }}"
+      image:
+        offer: UbuntuServer
+        publisher: Canonical
+        sku: 16.04-LTS
+        version: latest
+    register: vm_output
+
+  - meta: refresh_inventory
+
+  - name: Test Inventory 
+    assert:
+      that:
+        - vm_name in hostvars
+
+  - name: Delete VM
+    azure_rm_virtualmachine:
+      resource_group: "{{ resource_group }}"
+      name: "{{ vm_name }}"
+      remove_on_absent: all_autocreated
+      state: absent
+
+  - name: teardown
+    include_tasks: teardown.yml

tests/integration/targets/inventory_azure/playbooks/vars.yml

@@ -0,0 +1,14 @@
+---
+uid: "{{ (resource_group ~ inventory_hostname) | hash('md5') | truncate(18, True, '') }}"
+uid_short: "{{ (resource_group ~ inventory_hostname) | hash('md5') | truncate(10, True, '') }}"
+
+storage_account: "{{ 'stor' ~ uid }}"
+availability_set: "{{ 'avbs' ~ uid_short }}"
+vm_name: "{{ 'vm' ~ uid_short }}"
+network_name: "{{ 'vnet' ~ uid_short }}"
+subnet_name: "{{ 'snet' ~ uid_short }}"
+security_group: "{{ 'sg' ~ uid_short }}"
+public_ip_name: "{{ 'ip' ~ uid_short }}"
+interface_name: "{{ 'int' ~ uid_short }}"
+network: 10.42.0.0/24
+subnet: 10.42.0.0/28

tests/integration/targets/inventory_azure/runme.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+set -eux
+
+# ensure test config is empty
+ansible-playbook playbooks/empty_inventory_config.yml "$@"
+
+export ANSIBLE_INVENTORY=test.azure_rm.yml
+
+# generate inventory config and test using it
+ansible-playbook playbooks/create_inventory_config.yml "$@"
+ansible-playbook playbooks/test_inventory.yml "$@"
+
+#ansible-inventory -i test.azure_rm.yml --list -vvv --playbook-dir=./
+
+# cleanup inventory config
+ansible-playbook playbooks/empty_inventory_config.yml "$@"

tests/integration/targets/inventory_azure/templates/basic.yml

@@ -0,0 +1,3 @@
+---
+plugin: azure_rm
+plain_host_names: yes