azure.azure_modules

Ce rôle inclut les dernières modifications et corrections de bogues pour les modules Azure à partir de la branche devel du dépôt Ansible. Si vous ne pouvez pas attendre la prochaine version d'Ansible, l'installation de ce rôle est un bon choix.

Prérequis

L'utilisation de ce rôle de playbook suppose que vous avez déjà configuré un environnement Ansible pour Azure. Pour plus de détails, veuillez consulter le tutoriel Ansible Introduction à Azure ou Installer et configurer Ansible.

Installation

1. Installez le rôle.

$ ansible-galaxy install azure.azure_modules

2. Mettez à jour les SDK Python Azure requis par les nouveaux modules Azure.

$ pip install -r ~/.ansible/roles/azure.azure_modules/files/requirements-azure.txt

    ou

$ sudo pip install -r ~/.ansible/roles/azure.azure_modules/files/requirements-azure.txt

Plusieurs raisons pour installer les SDK Python sont listées ici.

• Un nouveau module a été ajouté au rôle, et ce module concerne une nouvelle ressource Azure qui n'est pas encore incluse dans les versions existantes d'Ansible. Le SDK correspondant pour cette nouvelle ressource doit être installé.

• Des versions plus récentes des SDK peuvent introduire des changements API majeurs. Une version spécifique qui fonctionne doit être installée ici.

Les SDK requis sont listés dans le fichier ~/files/requirements-azure.txt. Le fichier requirements-azure.txt peut être trouvé dans le dossier du rôle installé, qui se trouve généralement dans le dossier ~/.ansible/roles/files.

La partie délicate est l'emplacement d'installation, qui doit être le même que celui où les SDK Python Azure existants sont installés. Si vous rencontrez une erreur lors de l'exécution de la commande ci-dessus, veuillez lire attentivement la partie ci-dessous pour vérifier l'emplacement d'installation.

Prenons Ubuntu comme exemple, les SDK existants peuvent être situés dans des dossiers comme /home/<votre-nom-utilisateur>/.local/lib/python2.7/site-packages ou /usr/local/lib/python2.7/dist-packages. Le premier est un dossier utilisateur et le second est un dossier système, ce qui nécessite un accès sudo. Cela dépend de la manière dont vous avez installé ansible. En résumé, vous devriez installer les SDK de la même manière que vous avez installé ansible afin que les SDK soient dans le même dossier site-packages.

Sur macOS, les SDK existants peuvent être situés dans des dossiers comme /Users/<votre-nom-utilisateur>/Library/Python/2.7/lib/python/site-packages ou /Library/Python/2.7/site-packages. Comme sur Ubuntu, le premier est un dossier utilisateur et le second est un dossier système.

Une façon de déterminer le bon chemin site-packages est de vérifier les détails des packages existants, comme azure-mgmt-storage, en exécutant la commande ci-dessous :

$ pip show azure-mgmt-storage

Vous pouvez obtenir une sortie comme ci-dessous.

votre-nom-utilisateur@ansible:~$ pip show azure-mgmt-storage
Nom: azure-mgmt-storage
Version: 1.5.0
Résumé: Bibliothèque de gestion de stockage Microsoft Azure pour Python
Page d'accueil: https://github.com/Azure/azure-sdk-for-python
Auteur: Microsoft Corporation
Email de l'auteur: [email protected]
Licence: Licence MIT
Emplacement: /home/<votre-nom-utilisateur>/.local/lib/python2.7/site-packages
Requiert: azure-common, azure-mgmt-nspkg, msrestazure

À partir de ces informations, vous pouvez comprendre que les SDK sont installés dans le dossier site-packages de l'utilisateur et utiliser pip install pour installer les packages listés. Si les SDK sont installés dans le chemin système, utilisez sudo pip install pour installer les packages listés.

Variables de rôle

Aucune.

Dépendances

Aucune dépendance sur d'autres rôles.

Exemple de playbook

- hôtes: localhost
  rôles:
    - { rôle: azure.azure_modules }
  tâches:
  - nom: créer un compte de stockage
    azure_rm_storageaccount:
      resource_group: nomdelagroupe
      name: nomdustockage
      account_type: Standard_LRS

Licence

MIT