sakura-internet/sacloud-ansible-inventory

Ansible dynamic inventory for sakura cloud

Ansible dynamic inventory for sakura cloud

動作条件

• Python 3
• usacloud

インストール

実行に必要なファイルは sacloud_inventory.py の1つなので、ファイルを単にダウンロードすることでも可能です。

$ git init # まだ行っていない場合
$ git submodule add https://github.com/sakura-internet/sacloud-ansible-inventory.git

インスタンスオプション

インスタンス説明文にJSON文字列を指定することで、細かな挙動を制御することが出来ます。

{
  "sacloud_inventory": {
    "hostname_type": "nic1_ip",
    "host_vers": {
      "sample-key": "sample-value"
    }
  }
}

.sacloud_inventory.hostname_type

ansible_host 変数に利用される項目を制御します。 ドメイン名・任意のNICに設定されるIPアドレスを設定することが出来ます。

設定値	説明
instance_name	デフォルト挙動です。コントロールパネルで指定されたインスタンスの名前を使用します。インスタンスの名前にドメイン名を利用している場合に使用します。
nic0_ip	1個目のNIC(eth0)にコントロールパネルで指定されたIPアドレスを使用します。共有グローバルアドレスが利用できる際は、そのIPアドレスを指定します。
nicN_ip	2個目以降のNICのIPアドレスを指定する際は、Nを数字に置き換えてください。

.sacloud_inventory.host_vers

Ansibleで利用する追加のホストの変数を指定します。

環境変数

SACLOUD_INVENTORY_FILTER_TAGS

初期状態では、 __with_sacloud_inventory タグが付与されたインスタンスのみ結果に出力されます。 カンマ区切りで環境変数を設定することで、フィルタを上書きすることが出来ます。

# タグ__with_sacloud_inventoryとcluster1が付いているインスタンスのみを対象にする
SACLOUD_INVENTORY_FILTER_TAGS=__with_sacloud_inventory,cluster1 ./sacloud_inventory.py

sacloud-ansible-inventory's Issues

複数ゾーン対応について

現時点では1つのゾーン内のVMを対象になりますが、複数ゾーンの対応を検討して頂けないでしょうか。
複数ゾーン対応により、さくらのクラウドを複数ゾーンにサーバを契約しているユーザがAnsibleを使った同時デプロイが可能となるため利用したいユーザは多いように感じました。

具体的な対応策ですが、usacloud server read, usacloud server listコマンドの後ろに--zone=all追加する形になると考えております。