Ansible チートシート

Ansible は、Python ベースで開発された新しい運用自動化ツールです。多くの運用ツール（puppet、cfengine、chef、func、fabric）の利点を組み合わせており、システムのバッチ構成、プログラムのバッチデプロイ、コマンドのバッチ実行などの機能を実現しています。

はじめに

ホストとグループ (Hosts and Groups)

$ sudo mkdir /etc/ansible
$ sudo vim /etc/ansible/hosts

[example]
192.0.2.101
192.0.2.102

Playbook の実行

$ ansible-playbook playbook.yml

タスク (Tasks)

- hosts: all
  user: root
  sudo: no
  vars:
    aaa: bbb
  tasks:
    - ...
  handlers:
    - ...

インクルード (Includes)

tasks:
  - include: db.yml
handlers:
  - include: db.yml user=timmy

トリガー (Triggers)

handlers:
  - name: start apache2
    action: service name=apache2 state=started

tasks:
  - name: install apache
    action: apt pkg=apache2 state=latest
    notify:
      - start apache2

変数 (Variables)

- host: lol
  vars_files:
    - vars.yml
  vars:
    project_root: /etc/xyz
  tasks:
    - name: Create the SSH directory.
      file: state=directory path=${project_root}/home/.ssh/
      only_if: "$vm == 0"

ロール (Roles)

- host: xxx
  roles:
    - db
    - { role:ruby, sudo_user:$user }
    - web

# 内容:
# roles/db/tasks/*.yml
# roles/db/handlers/*.yml

エラー処理

- name: my task
  command: ...
  register: result
  failed_when: "'FAILED' in result.stderr"

  ignore_errors: yes

  changed_when: "result.rc != 2"

環境変数

vars:
  local_home: "{{ lookup('env','HOME') }}"