nchosts

ニフティクラウドの API からさまざまな形式 (hosts, ssh_config, shell alias 等) のサーバー一覧情報を生成します。
複数のアカウントにまたがり大量のサーバーを運用しているような場合に便利です。

Usage

まず、アカウント情報が書かれた設定ファイル accounts.json を作成します。 (安全に利用するため閲覧権限のみ付与した API キーを利用しましょう。)

$ cat accounts.json
{
   "accounts": [
    {
      "nifty_id": "ABC00001.readonly",
      "access_key_id": "LLLLLLLLLLLLLLLLLLLL",
      "secret_access_key": "MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM",
    },
    {
      "nifty_id": "ABC00002.readonly",
      "access_key_id": "NNNNNNNNNNNNNNNNNNNN",
      "secret_access_key": "OOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO",
    }
  ]
}

上記 accounts.json を引数に nchosts collect コマンドを実行します。

$ nchosts collect -c accounts.json -o instances.json

accounts.json に書かれたアカウント情報を元に、各アカウントの全リージョン分のサーバー一覧情報が取得されます。 取得された情報は -o (--output) オプションに指定したファイル (instances.json) へ書き込まれます。

この instances.json を利用してさまざまな形式のサーバー一覧情報を生成することができます。

$ nchosts generate -i instances.json -f hosts >> /etc/hosts
$ nchosts generate -i instances.json -f ssh_config >> ~/.ssh/config
$ nchosts generate -i instances.json -f aliases >> ~/.bashrc

自分で書いた erubis 形式のテンプレートファイルを利用することもできます。 テンプレートの中では instances というローカル変数 (配列) でサーバー情報の一覧を参照できます。

$ nchosts generate -i instances.json -t template.erb > myhosts.txt

Installation

Add this line to your application's Gemfile:

gem 'nchosts'

And then execute:

$ bundle

Or install it yourself as:

$ gem install nchosts

Contributing

1. Fork it ( https://github.com/[my-github-username]/nchosts/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request