azure.azure_modules

Este rol incluye los últimos cambios y correcciones de errores para los módulos de Azure de la rama devel del repositorio de Ansible. Si no puedes esperar a la próxima versión de Ansible, instalar este rol es una buena opción.

Requisitos previos

El uso de este rol de playbook asume que ya has configurado un entorno de Ansible para Azure. Para más detalles, por favor consulta el tutorial de Ansible Introducción a Azure o Instalar y configurar Ansible.

Instalación

1. Instala el rol.

$ ansible-galaxy install azure.azure_modules

2. Actualiza los SDKs de Python de Azure requeridos por los nuevos módulos de Azure.

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

    o

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

Hay varias razones para instalar SDKs de Python:

• Se ha agregado un nuevo módulo al rol que es para un nuevo recurso de Azure, el cual aún no está incluido en las versiones existentes de Ansible. Se necesita instalar el SDK correspondiente para este nuevo recurso.

• Las versiones más nuevas de los SDKs pueden introducir cambios incompatibles en la API. Se debe instalar una versión específica que funcione.

Los SDKs requeridos están listados en el archivo ~/files/requirements-azure.txt. El archivo requirements-azure.txt se puede encontrar en la carpeta del rol instalado, que generalmente está en la carpeta ~/.ansible/roles/files.

La parte complicada es la ubicación de instalación, que tiene que ser la misma donde se han instalado los SDKs de Python de Azure existentes. Si encuentras algún error al ejecutar el comando anterior, por favor lee cuidadosamente la parte a continuación para verificar de nuevo la ubicación de instalación.

Tomando Ubuntu como ejemplo, los SDKs existentes pueden estar ubicados en carpetas como /home/<tu-nombre-de-usuario>/.local/lib/python2.7/site-packages o /usr/local/lib/python2.7/dist-packages. La primera es una carpeta de usuario y la segunda es una carpeta del sistema, que requiere acceso sudo. Esto depende de cómo has instalado ansible. En resumen, deberías instalar los SDKs de la misma manera que instalaste ansible, para que los SDKs estén en la misma carpeta site-packages.

En macOS, los SDKs existentes pueden estar ubicados en carpetas como /Users/<tu-nombre-de-usuario>/Library/Python/2.7/lib/python/site-packages o /Library/Python/2.7/site-packages. Al igual que en Ubuntu, la primera es una carpeta de usuario y la segunda es una carpeta del sistema.

Una forma de averiguar la ruta correcta de site-packages es revisar los detalles de los paquetes existentes, por ejemplo, azure-mgmt-storage, ejecutando el siguiente comando:

$ pip show azure-mgmt-storage

Puedes obtener una salida como la siguiente.

tu-nombre-de-usuario@ansible:~$ pip show azure-mgmt-storage
Name: azure-mgmt-storage
Version: 1.5.0
Summary: Microsoft Azure Storage Management Client Library for Python
Home-page: https://github.com/Azure/azure-sdk-for-python
Author: Microsoft Corporation
Author-email: [email protected]
License: MIT License
Location: /home/<tu-nombre-de-usuario>/.local/lib/python2.7/site-packages
Requires: azure-common, azure-mgmt-nspkg, msrestazure

De esta información puedes aprender que los SDKs están instalados en la carpeta site-packages de usuario y usar pip install para instalar los paquetes listados. Si los SDKs están instalados en una ruta del sistema, usa sudo pip install para instalar los paquetes listados.

Variables del rol

Ninguna.

Dependencias

No hay dependencias en otros roles.

Ejemplo de Playbook

- hosts: localhost
  roles:
    - { role: azure.azure_modules }
  tasks:
  - name: crear cuenta de almacenamiento
    azure_rm_storageaccount:
      resource_group: nombre_del_grupo_de_recursos
      name: nombre_del_almacenamiento
      account_type: Standard_LRS

Licencia

MIT