Este repositorio ya no se mantiene, en su lugar, por favor dirígete a AzCollection.

azure.azure_preview_modules

Este rol es el más completo e incluye todos los últimos módulos de Azure. Las actualizaciones y correcciones de errores se realizan de manera más oportuna que las versiones oficiales de Ansible.

Si utilizas Ansible para la provisión de recursos de Azure, se te recomienda encarecidamente instalar este rol.

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 Comenzando con Azure o Instalar y configurar Ansible.

Instalación

1. Instala el rol.

   $ ansible-galaxy install azure.azure_preview_modules
   

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

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

       o

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

   Hay varias razones para instalar los SDKs de Python que se enumeran aquí.

   • Se ha añadido un nuevo módulo al rol y este módulo es para un nuevo recurso de Azure, que 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 recientes de los SDKs pueden introducir cambios importantes en la API. Se debe instalar una versión específica que funcione aquí.

   Los SDKs requeridos están listados en el ~/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 delicada es la ubicación de instalación, que debe ser la misma donde están instalados los SDKs de Python de Azure existentes. Si encuentras algún error al ejecutar el comando anterior, por favor lee la siguiente parte con atención para verificar 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 hayas 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 verificar 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
   Nombre: azure-mgmt-storage
   Versión: 1.5.0
   Resumen: Biblioteca de cliente de gestión de almacenamiento de Microsoft Azure para Python
   Página de inicio: https://github.com/Azure/azure-sdk-for-python
   Autor: Microsoft Corporation
   Correo del autor: [email protected]
   Licencia: Licencia MIT
   Ubicación: /home/<tu-nombre-de-usuario>/.local/lib/python2.7/site-packages
   Requiere: azure-common, azure-mgmt-nspkg, msrestazure
   

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

Variables del rol

Ninguna.

Dependencias

No hay dependencias de otros roles.

Ejemplo de Playbook

- hosts: localhost
  roles:
    - { role: azure.azure_preview_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