このリポジトリはもはやメンテナンスされていません。代わりに、AzCollectionをご覧ください。

azure.azure_preview_modules

このロールは最も完全で、最新のAzureモジュールをすべて含んでいます。更新やバグ修正は、公式のAnsibleリリースよりも迅速に行われます。

Azureリソースのプロビジョニング目的でAnsibleを使用する場合は、このロールをインストールすることを強くお勧めします。

前提条件

このプレイブックロールを使用するには、すでにAzure用のAnsible環境を設定している必要があります。詳細については、Ansibleのチュートリアル「Azureの始め方」(Getting Started with Azure) または「Ansibleのインストールと設定」(Install and configure Ansible)を参照してください。

インストール

1. ロールをインストールします。

$ ansible-galaxy install azure.azure_preview_modules

2. 新しいAzureモジュールに必要な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をインストールする理由はいくつかあります。

• 新しいモジュールがロールに追加され、このモジュールはまだ既存のAnsibleリリースには含まれていない新しいAzureリソース用です。この新しいリソースに対応するSDKをインストールする必要があります。

• 新しいバージョンのSDKは、APIの変更が発生する可能性があります。特定の動作バージョンをここにインストールする必要があります。

必要なSDKは、* ~/files/requirements-azure.txt * ファイルにリストされています。requirements-azure.txtファイルは、インストールされたロールフォルダーにあり、通常は ~/.ansible/roles/files フォルダーにあります。

注意すべき点は、インストール場所が既存のAzure Python SDKがインストールされている場所と同じである必要があることです。上記のコマンドを実行する際にエラーが発生した場合は、インストール場所を再確認してください。

例えば、Ubuntuでは、既存のSDKが /home/<your-user-name>/.local/lib/python2.7/site-packages または /usr/local/lib/python2.7/dist-packages のようなフォルダーにあることがあります。前者はユーザーフォルダーで、後者はシステムフォルダーで、sudoアクセスが必要です。これは、ansibleをどのようにインストールしたかによります。要するに、SDKをansibleと同じ方法でインストールする必要があります。

macOSの場合、既存のSDKは /Users/<your-user-name>/Library/Python/2.7/lib/python/site-packages または /Library/Python/2.7/site-packages のようなフォルダーにあることがあります。Ubuntuと同様に、前者はユーザーフォルダーで、後者はシステムフォルダーです。

正しい site-packages パスを特定する方法の1つは、以下のコマンドを実行して既存パッケージ（例えば azure-mgmt-storage）の詳細を確認することです。

$ pip show azure-mgmt-storage

次のような出力が得られます。

your-user-name@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/<your-user-name>/.local/lib/python2.7/site-packages
Requires: azure-common, azure-mgmt-nspkg, msrestazure

この情報から、SDKがユーザーの site-packages フォルダーにインストールされていることがわかります。もしSDKがシステムパスにインストールされている場合は、sudo pip installでパッケージをインストールします。

ロール変数

特になし。

依存関係

他のロールに依存はありません。

例プレイブック

- hosts: localhost
  roles:
    - { role: azure.azure_preview_modules }
  tasks:
  - name: ストレージアカウントを作成
    azure_rm_storageaccount:
      resource_group: resourcegroupname
      name: storagename
      account_type: Standard_LRS

ライセンス

MIT