Zelfstudie: Dynamische inventarissen van uw Azure-resources configureren met Ansible

Artikel
14/08/2024

Belangrijk

Ansible 2.8 (of hoger) is vereist om de voorbeeldplaybooks in dit artikel uit te voeren.

De functie voor dynamische ansible-inventaris verwijdert de last van het onderhouden van statische inventarisbestanden.

In deze zelfstudie gebruikt u de invoegtoepassing voor dynamische voorraad van Azure om uw Ansible-inventaris te vullen.

In dit artikel leert u het volgende:

Configureer twee virtuele machines testen.
Tags toevoegen aan virtuele Azure-machines
Een dynamische voorraad genereren
Voorwaardelijke en sleutelgroepen gebruiken om groepslidmaatschappen te vullen
Playbooks uitvoeren op groepen in de dynamische inventaris

Vereisten

Azure-abonnement: als u nog geen abonnement op Azure hebt, maakt u een gratis Azure-account aan voordat u begint.

Azure-service-principal: maak een service-principal, noteer de volgende waarden: appId, displayName, wachtwoord en tenant.

Ansible installeren: Voer een van de volgende opties uit:
- Ansible installeren en configureren op een virtuele Linux-machine
- Configureer Azure Cloud Shell en maak een virtuele machine met Ansible als u geen toegang hebt tot een virtuele Linux-machine.

Virtuele Azure-machines maken

Meld u aan bij het Azure-portaal.
Open Cloud Shell.
Maak een Azure-resourcegroep om de virtuele machines voor deze zelfstudie in op te slaan.

Belangrijk

De Azure-resourcegroep die u in deze stap u maakt, moet een naam hebben die volledig uit kleine letters bestaat. Anders mislukt het genereren van de dynamische voorraad.
- Azure-CLI
- Azure PowerShell
Azure CLI
```
az group create --resource-group ansible-inventory-test-rg --location eastus
```
Azure PowerShell
```
New-AzResourceGroup -Name ansible-inventory-test-rg -Location eastus
```

Maak twee virtuele Linux-machines in Azure met een van de volgende technieken:

Ansible-playbook - Het artikel, Een eenvoudige virtuele Linux-machine maken in Azure met Ansible en een eenvoudige virtuele Windows-machine maken in Azure met Ansible laat zien hoe u een virtuele machine maakt op basis van een Ansible-playbook.

Azure CLI: voer elk van de volgende opdrachten in de Cloud Shell uit om de twee virtuele machines te maken:

Azure-CLI
Azure PowerShell

Azure CLI

az vm create \
--resource-group ansible-inventory-test-rg \
--name win-vm \
--image MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest \
--admin-username azureuser \
--admin-password <password>

az vm create \
--resource-group ansible-inventory-test-rg \
--name linux-vm \
--image Ubuntu2204 \
--admin-username azureuser \
--admin-password <password>

Azure PowerShell

$adminUsername = "azureuser"
$adminPassword = ConvertTo-SecureString <password> -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($adminUsername, $adminPassword);

New-AzVM `
-ResourceGroupName ansible-inventory-test-rg `
-Location eastus `
-Image MicrosoftWindowsServer:WindowsServer:2019-Datacenter:latest `
-Name win-vm `
-OpenPorts 3389 `
-Credential $credential

New-AzVM `
-ResourceGroupName ansible-inventory-test-rg `
-Location eastus `
-Image Ubuntu2204 `
-Name linux-vm `
-OpenPorts 22 `
-Credential $credential

Vervang het <password> wachtwoord.

Toepassingsroltags toevoegen

Tags worden gebruikt om Azure-resources te organiseren en te categoriseren. Door de Azure-VM's een toepassingsrol toe te wijzen, kunt u de tags gebruiken als groepsnamen in de dynamische azure-inventaris.

Voer de volgende opdrachten uit om de VM-tags bij te werken:

Azure-CLI
Azure PowerShell

Azure CLI

az vm update \
--resource-group ansible-inventory-test-rg \
--name linux-vm \
--set tags.applicationRole='message-broker' 

az vm update \
--resource-group ansible-inventory-test-rg \
--name win-vm \
--set tags.applicationRole='web-server'

Azure PowerShell

Get-AzVM -Name win-vm -ResourceGroupName ansible-inventory-test-rg-pwsh | Update-AzVM -Tag @{"applicationRole"="web-server"}

Get-AzVM -Name linux-vm -ResourceGroupName ansible-inventory-test-rg-pwsh | Update-AzVM -Tag @{"applicationRole"="message-broker"}

Meer informatie over strategieën voor Azure-tags vindt u in Uw tagstrategie definiëren.

Een dynamische voorraad genereren

Ansible biedt een invoegtoepassing voor dynamische voorraad van Azure.

De volgende stappen helpen u bij het gebruik van de invoegtoepassing:

Een dynamische inventaris maken met de naam myazure_rm.yml

yml
```
plugin: azure_rm
include_vm_resource_groups:
  - ansible-inventory-test-rg
auth_source: auto
```
Sleutelpunt:
- Ansible gebruikt de naam en extensie van het inventarisbestand om te bepalen welke inventarisinvoegtoepassing moet worden gebruikt. Als u de invoegtoepassing dynamische voorraad van Azure wilt gebruiken, moet het bestand eindigen met azure_rm en een extensie hebben van ofyamlyml.
Voer de volgende opdracht uit om een query uit te voeren op de VM's in de resourcegroep:

Bash
```
ansible-inventory -i myazure_rm.yml --graph
```
Wanneer u de opdracht uitvoert, ziet u resultaten die vergelijkbaar zijn met de volgende uitvoer:

Output
```
@all:
  |--@ungrouped:
  |  |--linux-vm_cdb4
  |  |--win-vm_3211
```

Beide VM's behoren tot de ungrouped groep. Dit is een onderliggend element van de all groep in de Ansible-inventaris.

Sleutelpunt:

De invoegtoepassing voor dynamische voorraad van Azure retourneert standaard wereldwijd unieke namen. Daarom kunnen de namen van de VM's extra tekens bevatten. U kunt dat gedrag uitschakelen door deze toe te voegen aan plain_host_names: yes de dynamische inventaris.

Azure VM-hostvars zoeken

Voer de volgende opdracht uit om alle hostvars:

Bash

ansible-inventory -i myazure_rm.yml --list

Output

{
    "_meta": {
        "hostvars": {
            "linux-vm_cdb4": {
                "ansible_host": "52.188.118.79",
                "availability_zone": null,
                "computer_name": "linux-vm",
                "default_inventory_hostname": "linux-vm_cdb4",
                "id": "/subscriptions/<subscriptionid>/resourceGroups/ansible-inventory-test-rg/providers/Microsoft.Compute/virtualMachines/linux-vm",
                "image": {
                    "offer": "0001-com-ubuntu-server-jammy",
                    "publisher": "Canonical",
                    "sku": "22_04-lts-gen2",
                    "version": "latest"
                },
                ...,
                "tags": {
                    "applicationRole": "message-broker"
                },
                ...
            },
            "win-vm_3211": {
                "ansible_host": "52.188.112.110",
                "availability_zone": null,
                "computer_name": "win-vm",
                "default_inventory_hostname": "win-vm_3211",
                "id": "/subscriptions/<subscriptionid>/resourceGroups/ansible-inventory-test-rg/providers/Microsoft.Compute/virtualMachines/win-vm",
                "image": {
                    "offer": "WindowsServer",
                    "publisher": "MicrosoftWindowsServer",
                    "sku": "2019-Datacenter",
                    "version": "latest"
                },
                ...
                "tags": {
                    "applicationRole": "web-server"
                },
                ...
            }
        }
    },
    ...
    }
}

Door informatie op te halen uit Azure, wordt de dynamische inventaris ingevuld hostvars voor elke Virtuele Azure-machine. Deze hostvars zijn vervolgens om de lidmaatschappen van de VM-groep binnen de Ansible-inventaris te bepalen.

Groepslidmaatschap toewijzen met conditional_groups

Elke voorwaardelijke groep bestaat uit twee delen. De naam van de groep en de voorwaarde voor het toevoegen van een lid aan de groep.

Gebruik de eigenschap image.offer om een voorwaardelijk groepslidmaatschap te maken voor de linux-vm.

Open de myazure_rm.yml dynamische inventaris en voeg het volgende conditional_grouptoe:

yml

plugin: azure_rm
include_vm_resource_groups:
  - ansible-inventory-test-rg
auth_source: auto
conditional_groups:
  linux: "'ubuntu' in image.offer"
  windows: "'WindowsServer' in image.offer"

Voer de ansible-inventory opdracht uit met de --graph optie:

Bash

ansible-inventory -i myazure_rm.yml --graph

Output

@all:
  |--@linux:
  |  |--linux-vm_cdb4
  |--@ungrouped:
  |--@windows:
  |  |--win-vm_3211

In de uitvoer ziet u dat de VM's niet meer aan de ungrouped groep zijn gekoppeld. In plaats daarvan wordt elke VIRTUELE machine toegewezen aan een nieuwe groep die is gemaakt door de dynamische inventaris.

Sleutelpunt:

Met voorwaardelijke groepen kunt u specifieke groepen binnen uw inventaris een naam geven en deze vullen met behulp van hostvars.

Groepslidmaatschap toewijzen met keyed_groups

Sleutelgroepen wijzen groepslidmaatschap op dezelfde manier toe als voorwaardelijke groepen, maar wanneer u een sleutelgroep gebruikt, wordt de groepsnaam ook dynamisch ingevuld.

Voeg de volgende keyed_group toe aan de myazure_rm.yml dynamische inventaris:

yml

plugin: azure_rm
include_vm_resource_groups:
  - ansible-inventory-test-rg
auth_source: auto
conditional_groups:
  linux: "'ubuntu' in image.offer"
  windows: "'WindowsServer' in image.offer"
keyed_groups:
 - key: tags.applicationRole

Voer de ansible-inventory opdracht uit met de --graph optie:

Bash

ansible-inventory -i myazure_rm.yml --graph

Output

@all:
  |--@_message_broker:
  |  |--linux-vm_cdb4
  |--@_web_server:
  |  |--win-vm_3211
  |--@linux:
  |  |--linux-vm_cdb4
  |--@ungrouped:
  |--@windows:
  |  |--win-vm_3211

In de uitvoer ziet u nog twee groepen _message_broker en _web_server. Met behulp van een sleutelgroep vult de applicationRole tag de groepsnamen en groepslidmaatschappen in.

Sleutelpunt:

Sleutelgroepen bevatten standaard een scheidingsteken. Als u het scheidingsteken wilt verwijderen, voegt u deze toe separator: "" onder de sleuteleigenschap.

Playbooks uitvoeren met groepsnaampatronen

Gebruik de groepen die door de dynamische inventaris zijn gemaakt om subgroepen te targeten.

Maak een playbook win_ping.yml met de volgende inhoud:

yml

---
- hosts: windows
  gather_facts: false

  vars_prompt:
    - name: username
      prompt: "Enter local username"
      private: false
    - name: password
      prompt: "Enter password"

  vars:
    ansible_user: "{{ username }}"
    ansible_password: "{{ password }}"
    ansible_connection: winrm
    ansible_winrm_transport: ntlm
    ansible_winrm_server_cert_validation: ignore

  tasks:
    - name: run win_ping
      win_ping:

Voer het win_ping.yml playbook uit.

Bash

ansible-playbook win_ping.yml -i myazure_rm.yml

Wanneer u hierom wordt gevraagd, voert u de username en password voor de Virtuele Azure Windows-machine in.

Output

Enter local username: azureuser
Enter password:

PLAY [windows] **************************************************************************************************************************************

TASK [run win_ping] *********************************************************************************************************************************
ok: [win-vm_3211]

PLAY RECAP ******************************************************************************************************************************************
win-vm_3211                : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Belangrijk

Als u de fout winrm or requests is not installed: No module named 'winrm'krijgt, installeert u pywinrm met de volgende opdracht: pip install "pywinrm>=0.3.0"

Maak een tweede playbook met de naam ping.yml met de volgende inhoud:

yml

---
- hosts: all
  gather_facts: false

  vars_prompt:
    - name: username
      prompt: "Enter ssh user"
    - name: password
      prompt: "Enter password for ssh user"

  vars:
    ansible_user: "{{ username }}"
    ansible_password: "{{ password }}"
    ansible_ssh_common_args: '-o StrictHostKeyChecking=no'

  tasks:
    - name: run ping
      ping:

Voer het ping.yml playbook uit.

Bash

ansible-playbook ping.yml -i myazure_rm.yml

Wanneer u hierom wordt gevraagd, voert u de username en password voor de Virtuele Linux-machine van Azure in.

Output

Enter ssh username: azureuser
Enter password for ssh user:

PLAY [linux] *******************************************************************************************************

TASK [run ping] ****************************************************************************************************
ok: [linux-vm_cdb4]

PLAY RECAP *********************************************************************************************************
linux-vm_cdb4              : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Voer az group delete uit om de resourcegroep te verwijderen. Alle resources in de resourcegroep worden verwijderd.

Azure CLI
```
az group delete --name <resource_group>
```
Controleer of de resourcegroep is verwijderd met behulp van az group show.

Azure CLI
```
az group show --name <resource_group>
```

Voer Remove-AzResourceGroup uit om de resourcegroep te verwijderen. Alle resources in de resourcegroep worden verwijderd.

Azure PowerShell
```
Remove-AzResourceGroup -Name <resource_group>
```
Controleer of de resourcegroep is verwijderd met behulp van Get-AzResourceGroup.

Azure PowerShell
```
Get-AzResourceGroup -Name <resource_group>
```

Volgende stappen

Quickstart: Virtuele Linux-machines in Azure configureren met Ansible

Aanvullende resources

Documentatie

Een virtuele Linux-machine maken in Azure met Ansible

Meer informatie over het maken van een virtuele Linux-machine in Azure met behulp van Ansible
Virtuele Linux-machines in Azure beheren met Ansible

Meer informatie over het beheren van een virtuele Linux-machine in Azure met ansible
Quickstart: Een Azure-service-principal maken voor Ansible

In deze quickstart leert u hoe u een Azure-service-principal maakt voor verificatie bij Azure.
Aan de slag- Ansible configureren op een Azure-VM

Meer informatie over het installeren en configureren van Ansible op een Azure-VM voor het beheren van Azure-resources.
Een virtuele Windows-machine maken in Azure met Ansible

Meer informatie over het maken van een virtuele Windows-machine in Azure met behulp van Ansible.
Ansible gebruiken met Azure

Inleiding tot het gebruik van Ansible voor het automatiseren van cloudinrichting, configuratiebeheer en toepassingsimplementaties.
Zelfstudie: Virtuele-machineschaalsets configureren in Azure met behulp van Ansible

Meer informatie over het gebruik van Ansible voor het maken en configureren van virtuele-machineschaalsets in Azure
Zelfstudie: Een VM of virtuele-machineschaalset maken vanuit de galerie met gedeelde installatiekopieën van Azure met behulp van Ansible

Meer informatie over het gebruik van Ansible voor het maken van vm's of virtuele-machineschaalsets op basis van een gegeneraliseerde installatiekopieën in De galerie met gedeelde installatiekopieën.

Training

Module

Virtuele machines beheren met de Azure CLI - Training

Informatie over het gebruik van de platformoverschrijdende Azure CLI om andere beheertaken die betrekking hebben op virtuele machines in Azure te maken, starten, stoppen en uit te voeren.

Certificering

Microsoft Gecertificeerd: Azure Beheerder Medewerker - Certifications

Demonstreer belangrijke vaardigheden voor het configureren, beheren, beveiligen en beheren van belangrijke professionele functies in Microsoft Azure.

Share via

Zelfstudie: Dynamische inventarissen van uw Azure-resources configureren met Ansible

Vereisten

Virtuele Azure-machines maken

Toepassingsroltags toevoegen

Een dynamische voorraad genereren

Azure VM-hostvars zoeken

Groepslidmaatschap toewijzen met conditional_groups

Groepslidmaatschap toewijzen met keyed_groups

Playbooks uitvoeren met groepsnaampatronen

Resources opschonen

Volgende stappen

Feedback

Aanvullende resources