はじめてAnsibleを使う人が知っておきたい7つのモジュール

こんにちは。makiです。
先月札幌で開催したPHP Matsuri 2013 では、Ansibleについて LT 発表してきました。
発表スライドはSlideshareにおいてあります。

Ansibleとは

• 構成管理ツール(Chefã‚„Puppet等と同じ)
• playbookという脚本ファイル(Chefでいうrecipe)にやりたいことをyaml形式で書いて実行するだけ
• 別にVagrantとの関係が必須じゃない

• vagrant provisionよりもansible-playbookを単体実行のほうが便利なことも多い

READMEには設計思想としてこのように書かれています。

• とってもシンプルなセットアップ
• デフォルトで超速くて並列処理ができる
• サーバーもデーモンもいらない。sshdだけ
• クライアントのboxに追加で必要なものなどない
• どんな言語でもモジュールを書くことができる
• スクリプト作成のために用意されたステキなapi
• rootユーザでなくても使える
• とっても簡単な設定管理で利用できるよ

難しいことは何もなく、我々がやることはyaml形式の設定ファイルを書いて実行するだけです。
今回は、120以上ある標準モジュールの中から、特によく使うものを７つ厳選してご紹介します。

command

shell コマンドを実行したい場合に使用。 <, >, | を使用する場合は、shell の方を使う。

例:

- command: /usr/bin/make_database.sh arg1 arg2 creates=/path/to/database

file

ファイル、シンボリックリンク、ディレクトリの属性設定・削除を行う
copy,template,assembleモジュールが同様のパラメータを指定可能

例:

- file: path=/etc/foo.conf owner=foo group=foo mode=0644
- file: src=/file/to/link/to dest=/path/to/symlink owner=foo group=foo state=link

copy

ローカル端末のfilesディレクトリにあるsrcのファイルを リモートのdestにコピーする

例:

copy: src=/srv/myfiles/foo.conf dest=/etc/foo.conf owner=foo group=foo mode=0644

template

• ローカル端末のtemplatesディレクトリにあるsrcのファイルをテンプレートとして、リモートのdestにファイルを生成する
• テンプレートエンジンとしてjinja2 が使われている
• varsで指定した値を挿入することが可能
• {{ user_name }} もしくは ${{user_name}} の形式

例:

- template: src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644

get_url

http経由でファイルをダウンロードする場合に使用する

例:

- get_url: url=http://example.com/path/file.conf dest=/etc/foo.conf mode=0440

git

git clone の処理を行う

例:

- git: repo=ssh://[email protected]/mylogin/hello.git dest=/home/mylogin/hello

yum

yumコマンドを利用してパッケージをインストールする

例:

- yum: name=tree state=present
- yum: name=vim state=latest

※Debian系(Debian/Ubuntu)の場合はaptモジュールが用意されている

まとめ

Ansibleが初めての方でもこれだけ覚えれば最初のステップクリアと言って良いでしょう。
公式ドキュメントには他にも多くの便利なモジュールが掲載されています。
今回紹介したモジュールに慣れてきたら、一度ドキュメントを読むと良いと思います。
Ansible Modules
最後にAnsibleについて学ぶ際に参考にしたサイトを紹介します。

• 構成管理ツール Ansible について – apatheia.info
• ansibleを使ってみる — そこはかとなく書くよん。

Yaml形式の記述はルールが単純なので、2つ3つタスクを書いてみるとすぐに慣れると思います。
Chef の Recipe（Ruby） に挫折してしまった方も、もう一度挑戦してみませんか？