Ansible

このチートシートで確認できること

Ansible は、複数サーバーへ同じ設定を安全に反映するための構成管理ツールです。このページでは、初学者が最初に使うコマンド、Playbook の基本形、inventory、変数、ロール、Vault を確認できます。

まず覚える順番は、ansible all -m ping で接続確認し、ansible-playbook --check --diff で変更内容を確認し、問題なければ Playbook を実行する流れです。

基本コマンド

Playbook 基本構造

---
- name: Configure web servers
  hosts: web
  become: true
  vars:
    http_port: 80

  tasks:
    - name: Install nginx
      apt:
        name: nginx
        state: present

    - name: Start nginx
      service:
        name: nginx
        state: started
        enabled: true

よく使うモジュール

- name: Copy nginx config
  copy:
    src: nginx.conf
    dest: /etc/nginx/nginx.conf
    owner: root
    group: root
    mode: '0644'
  notify: Restart nginx

handlers:
  - name: Restart nginx
    service:
      name: nginx
      state: restarted

Inventory ファイル

INI 形式

[web]
web1.example.com
web2.example.com

[db]
db1.example.com

[production:children]
web
db

[production:vars]
ansible_user=deploy
ansible_port=22

YAML 形式

all:
  children:
    web:
      hosts:
        web1.example.com:
        web2.example.com:
    db:
      hosts:
        db1.example.com:
  vars:
    ansible_user: deploy

変数の優先順位（高→低）

条件分岐とループ

- name: Install packages
  apt:
    name: "{{ item }}"
    state: present
  loop:
    - nginx
    - git
    - vim

- name: Configure firewall on CentOS
  firewalld:
    service: http
    state: enabled
  when: ansible_os_family == "RedHat"

ロール構造

Ansible 2.x のロールディレクトリ標準構造（公式: https://docs.ansible.com/ansible/latest/playbook_guide/playbooks_reuse_roles.html）:

roles/
 webserver/
 tasks/
 main.yml # タスク本体
 handlers/
 main.yml # ハンドラ
 templates/
 nginx.conf.j2 # テンプレート
 files/
 index.html # 静的ファイル
 vars/
 main.yml # 変数
 defaults/
 main.yml # デフォルト変数
 meta/
 main.yml # 依存関係

Playbook からロールを呼び出す

- hosts: web
  roles:
    - webserver
    - firewall

テンプレート（Jinja2）

# nginx.conf.j2
server {
 listen {{ http_port }};
 server_name {{ ansible_hostname }};

 {% for location in locations %}
 location {{ location.path }} {
 proxy_pass {{ location.backend }};
 }
 {% endfor %}
}

- name: Deploy nginx config
  template:
    src: nginx.conf.j2
    dest: /etc/nginx/nginx.conf

Vault（暗号化）

# secrets.yml (暗号化)
db_password: "YOUR_DB_PASSWORD"
api_key: "YOUR_API_KEY"

タグ

- name: Install packages
  apt:
    name: nginx
  tags:
    - install
    - packages

- name: Start nginx
  service:
    name: nginx
    state: started
  tags:
    - start

まとめ

Ansible では、まず ping、--check、--diff、--limit を使えるようにすると安全に始められます。Playbook は YAML のインデントが意味を持つため、コピーした例でも必ず構造を確認してください。

本番環境では、対象ホスト、変数、Vault パスワード、実行タグを確認してから実行します。

参考リソース

• Ansible Documentation - 公式ドキュメント
• Ansible Galaxy - ロール・コレクションのレジストリ
• Ansible Module Index - モジュール一覧
• Best Practices - 公式ベストプラクティス

関連記事

• Terraform チートシート - Infrastructure as Code のリファレンス
• Linux 基礎 - サーバー管理の基礎知識

×

PR

×

PR