Этот репозиторий больше не поддерживается, вместо этого, пожалуйста, перейдите на AzCollection.

azure.azure_preview_modules

Эта роль является самой полной и включает в себя все последние модули Azure. Обновления и исправления ошибок выполняются более оперативно, чем в официальных релизах Ansible.

Если вы используете Ansible для развертывания ресурсов Azure, настоятельно рекомендуется установить эту роль.

Предварительные требования

Использование этой плейбука предполагает, что вы уже настроили окружение Ansible для Azure. Для получения подробной информации смотрите учебник Ansible Начало работы с Azure или Установите и настройте Ansible.

Установка

1. Установите роль.

$ ansible-galaxy install azure.azure_preview_modules

2. Обновите необходимые для новых модулей Azure Python SDK.

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

или

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

Несколько причин для установки Python SDK перечислены здесь.

• В роль добавлен новый модуль для нового ресурса Azure, который еще не включен в существующие релизы Ansible. Необходимый SDK для этого нового ресурса нужно установить.

• Более новые версии SDK могут внести изменения в API. Здесь должна быть установлена конкретная рабочая версия.

Необходимые SDK указаны в файле ~/files/requirements-azure.txt. Файл requirements-azure.txt можно найти в установленной папке роли, которая обычно находится в папке ~/.ansible/roles/files.

Сложная часть — это место установки, которое должно совпадать с расположением уже установленных Azure Python SDK. Если вы получаете ошибку при выполнении вышеприведенной команды, внимательно прочтите следующую часть, чтобы дважды проверить место установки.

Например, в Ubuntu уже установленные SDK могут находиться в папках, таких как /home/<ваше-имя-пользователя>/.local/lib/python2.7/site-packages или /usr/local/lib/python2.7/dist-packages. Первая — это пользовательская папка, а вторая — системная папка, для доступа к которой требуются права sudo. Это зависит от того, как вы установили ansible. Вкратце, вы должны установить SDK тем же способом, каким установили ansible, чтобы SDK находились в одной и той же папке site-packages.

На macOS уже установленные SDK могут находиться в папках, таких как /Users/<ваше-имя-пользователя>/Library/Python/2.7/lib/python/site-packages или /Library/Python/2.7/site-packages. Как и в Ubuntu, первая — это пользовательская папка, а вторая — системная папка.

Один из способов определить правильный путь site-packages — это проверить детали существующих пакетов, например, azure-mgmt-storage, запустив следующую команду.

$ pip show azure-mgmt-storage

Вы можете получить вывод, подобный следующему.

ваше-имя-пользователя@ansible:~$ pip show azure-mgmt-storage
Name: azure-mgmt-storage
Version: 1.5.0
Summary: Библиотека управления хранилищем Microsoft Azure для Python
Home-page: https://github.com/Azure/azure-sdk-for-python
Author: Microsoft Corporation
Author-email: [email protected]
License: MIT License
Location: /home/<ваше-имя-пользователя>/.local/lib/python2.7/site-packages
Requires: azure-common, azure-mgmt-nspkg, msrestazure

Из вышеуказанной информации вы можете узнать, что SDK установлены в папке пользовательских site-packages и использовать pip install для установки перечисленных пакетов. Если SDK установлены в системном пути, используйте sudo pip install, чтобы установить перечисленные пакеты.

Переменные роли

Нет.

Зависимости

Нет зависимостей от других ролей.

Пример плейбука

- hosts: localhost
  roles:
    - { role: azure.azure_preview_modules }
  tasks:
  - name: создать учетную запись хранения
    azure_rm_storageaccount:
      resource_group: имя_группы_ресурсов
      name: имя_хранилища
      account_type: Standard_LRS

Лицензия

MIT