azure.azure_modules

このロールには、AnsibleリポジトリのdevelブランチからのAzureモジュールの最新の変更点やバグ修正が含まれています。Ansibleの次のリリースを待てない場合は、このロールをインストールするのが良い選択です。

前提条件

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

インストール

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

$ ansible-galaxy install azure.azure_modules

2. 新しいAzureモジュールに必要なAzure Python SDKをアップグレードします。

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

    または

$ sudo pip install -r ~/.ansible/roles/azure.azure_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/<あなたのユーザー名>/.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

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

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/<あなたのユーザー名>/.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_modules }
  tasks:
  - name: ストレージアカウントを作成する
    azure_rm_storageaccount:
      resource_group: resourcegroupname
      name: storagename
      account_type: Standard_LRS

ライセンス

MIT