Ansibleで始める構成管理|実務入門ガイド

インフラストラクチャの構成管理は、サーバー台数が増えるにつれて手作業では対応できなくなる課題です。本記事では、構成管理ツール「Ansible」の基本から実務運用までを、ネットワークエンジニア視点で解説いたします。本記事を読むことで、複数サーバーの一括設定・定期メンテナンス・障害復旧の自動化を実現できるようになる可能性があります。読了時間の目安：8～10分

目次

• Ansibleとは何か
• インストール・セットアップ
• 基本的な実行フロー
• よく使うモジュール
• 実務運用のコツ
• まとめ

Ansibleとは何か

Ansibleは、Red Hat社が開発・提供するオープンソースの構成管理ツール（IaC：Infrastructure as Code）です。エージェントレスアーキテクチャ（サーバー側にエージェントソフトウェアをインストール不要）で知られており、SSHを通じたシンプルな方式で複数のサーバーに対して統一した設定を適用できるとされています。

構成管理ツールの役割は、以下の3点に集約されます：

他の構成管理ツールとの比較

Ansibleがよく比較される同種ツールにはPuppet・Chef・SaltStackなどがあります。これらと比べてAnsibleには以下の特徴があるとされています：

• エージェントレス：サーバーに専用ソフトウェア不要でSSH経由で動作
• YAML形式で直感的：プログラミング経験が浅い人でも習得しやすい
• 学習曲線が緩い：数日で基本的な運用が可能な可能性があります
• インストール・セットアップが簡単：管理サーバーにAnsibleをインストールするだけで開始可能

ただしPuppetやChefの方が大規模インフラ向けの高度な機能を備えているとされており、規模・要件に応じた選定が重要です。

インストール・セットアップ

管理サーバーへのインストール

Ansibleを実行する管理サーバー（通常、自分が作業するPC、またはオンプレミスのJumpサーバー）にAnsibleをインストールします。以下は一般的な環境でのインストール手順です。

■ macOS（Homebrewを使用）

brew install ansible

■ Ubuntu/Debian（aptを使用）

sudo apt update
sudo apt install ansible

■ CentOS/RHEL（yumを使用）

sudo yum install ansible

インストール後、バージョン確認を行い動作確認をします：

ansible --version

SSH鍵の設定

Ansibleはサーバーとの通信にSSHを使用するため、対象サーバーへのSSH鍵ベース認証が必須です。未設定の場合は、以下の手順で設定してください。

■ 管理サーバーでSSH鍵を生成

ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_ansible

■ 公開鍵を対象サーバーに転送

ssh-copy-id -i ~/.ssh/id_ansible.pub user@target-server

このセットアップにより、管理サーバーから対象サーバーへパスワード入力なしでSSHログインできる環境が整備されます。

インベントリファイルの作成

インベントリファイルは、Ansibleが管理対象のサーバー一覧と接続情報を定義するファイルです。通常、inventory.iniまたはinventory.ymlという名前で保存されます。

■ INI形式での例

[webservers]
web01.example.com ansible_user=deploy ansible_key_file=~/.ssh/id_ansible
web02.example.com ansible_user=deploy ansible_key_file=~/.ssh/id_ansible

[databases]
db01.example.com ansible_user=deploy ansible_key_file=~/.ssh/id_ansible
db02.example.com ansible_user=deploy ansible_key_file=~/.ssh/id_ansible

[all:vars]
ansible_python_interpreter=/usr/bin/python3

この記述により、Ansibleは[webservers]グループ・[databases]グループなど、役割ごとにサーバーを分類して管理できるようになるとされています。

基本的な実行フロー

アドホックコマンドの実行

Ansibleで最も簡単な実行方式がアドホックコマンドです。Playbookを作成せず、その場で単一のコマンドやモジュールを実行できます。

■ 全サーバーの稼働状況確認

ansible all -i inventory.ini -m ping

■ WebサーバーグループにUnixdate コマンドを実行

ansible webservers -i inventory.ini -m shell -a 'date'

■ 特定のサーバーのディスク使用量を確認

ansible web01.example.com -i inventory.ini -m shell -a 'df -h'

アドホックコマンドは緊急時の確認・軽微な実行に適しており、定期実行や複数ステップの設定にはPlaybook方式を使用するとされています。

Playbookの作成と実行

複数のステップ・複数のモジュールを組み合わせた処理は、Playbookという設定ファイル（YAML形式）で定義します。

■ シンプルなPlaybook例（Webサーバー群にnginxをインストール）

---
- hosts: webservers
  become: yes
  tasks:
    - name: アップデート
      apt:
        update_cache: yes
      when: ansible_os_family == "Debian"
    
    - name: nginxをインストール
      apt:
        name: nginx
        state: present
      when: ansible_os_family == "Debian"
    
    - name: nginxを起動
      service:
        name: nginx
        state: started
        enabled: yes

このPlaybookの実行コマンドは以下の通りです：

ansible-playbook -i inventory.ini nginx_install.yml

YAMLフォーマットはインデント（スペース）が重要で、タブ文字を使用するとエラーになるため注意が必要です。

実行前の検証（Dry-Run）

本番環境で意図しない設定変更を避けるため、実行前に–checkオプション（ドライラン）で検証することが推奨されています：

ansible-playbook -i inventory.ini nginx_install.yml --check

このコマンドは実際には変更を加えず、実行するはずの処理内容をシミュレートして表示します。

よく使うモジュール

パッケージ管理系モジュール

Ansibleの標準モジュールの中でも、パッケージのインストール・更新は最頻出の処理です。

■ apt（Debian/Ubuntu向け）

- name: Apache2をインストール
  apt:
    name: apache2
    state: present
    update_cache: yes

■ yum（CentOS/RHEL向け）

- name: Apache2をインストール
  yum:
    name: httpd
    state: present

■ dnf（CentOS 8以降・RHEL 8以降向け）

- name: Apache2をインストール
  dnf:
    name: httpd
    state: present

ファイル・ディレクトリ管理…

サーバー側のファイル・ディレクトリ作成・削除・権限変更も頻出です。

■ file（ファイル・ディレクトリ操作）

- name: ディレクトリを作成
  file:
    path: /opt/myapp
    state: directory
    owner: deploy
    group: deploy
    mode: '0755'

- name: ファイルを削除
  file:
    path: /tmp/oldfile.txt
    state: absent

■ copy（管理サーバーからファイルをコピー）

- name: 設定ファイルをコピー
  copy:
    src: /local/path/nginx.conf
    dest: /etc/nginx/nginx.conf
    owner: root
    group: root
    mode: '0644'

■ template（Jinja2テンプレートから設定ファイルを生成）

- name: 動的な設定ファイルを生成
  template:
    src: /local/path/app.conf.j2
    dest: /etc/app/app.conf
    owner: root
    group: root
    mode: '0644'

サービス・プロセス管理モジ…

サービスの起動・停止・再起動・自動起動設定を制御します：

- name: nginxを起動・有効化
  service:
    name: nginx
    state: started
    enabled: yes

- name: nginxをリスタート
  service:
    name: nginx
    state: restarted

state の値の意味：started（起動）/ stopped（停止）/ restarted（再起動）/ reloaded（リロード）

実務運用のコツ

エラーハンドリングと条件分岐

本番環境では予期しないエラーが発生する可能性があります。Playbookに条件分岐やエラー対応を組み込むことで、堅牢な自動化を実現できるとされています。

■ when句による条件付き実行

- name: CentOS系でのみ実行
  yum:
    name: httpd
    state: present
  when: ansible_os_family == "RedHat"

- name: メモリが2GB以上の場合のみ実行
  debug:
    msg: "十分なメモリがあります"
  when: ansible_memtotal_mb >= 2048

■ ignore_errors によるエラーの許容

- name: 不要なファイルを削除（失敗していても続行）
  file:
    path: /tmp/oldfile.txt
    state: absent
  ignore_errors: yes

■ failed_when による カスタム失敗判定

- name: ディスク使用率を確認
  shell: df -h / | awk 'NR==2 {print $5}' | sed 's/%//'
  register: disk_usage
  failed_when: disk_usage.stdout | int >= 90

ロール（Role）による再…

複数のPlaybookで共通の設定を繰り返すのは保守性に課題があります。こうした場合、ロール機能を使うと、設定をモジュール化・再利用可能にできるとされています。

ロールの標準的なディレクトリ構造は以下の通りです：

roles/
  webserver/
    tasks/
      main.yml
    handlers/
      main.yml
    files/
      nginx.conf
    templates/
      index.html.j2
    vars/
      main.yml

このロールを呼び出すPlaybookは以下のようにシンプルになります：

---
- hosts: webservers
  become: yes
  roles:
    - webserver

ログ・監査・実行履歴の管理

本番環境では、どのサーバーにどんな変更が加わったか、いつ実行されたかを記録することが重要です。以下の実施が推奨されています：

• 実行ログの保存：-vvvオプションで詳細ログを取得し、ファイルに保存
• Playbook版管理：GitなどのVCSでPlaybookをバージョン管理し、変更履歴を追跡
• サーバー状態の検証：実行後にansible-inventoryで実際の状態を確認
• 段階的なロールアウト：本番全体に適用する前に、テスト環境・ステージング環境で検証

大規模環境での並列実行と実…

数十～数百台のサーバーを管理する場合、デフォルト設定では実行に多くの時間を要するとされています。以下の最適化が可能です：

■ 並列実行数の制御（ansible.cfg）

[defaults]
forks = 50

■ Playbook実行時の並列数指定

ansible-playbook -i inventory.ini playbook.yml -f 50

ただし、並列数を増やしすぎると管理サーバーの負荷が高まるため、環境に応じた調整が必要な可能性があります。

セキュリティ上の注意点

Ansibleを本番環境で運用する際は、以下のセキュリティ対策が重要とされています：

まとめ

Ansibleは、エージェントレスで習得しやすい構成管理ツールであり、小規模な環境から大規模インフラまで幅広く対応できるとされています。本記事で解説した以下の要点を押さえることで、実務運用が可能になる可能性があります：

• インベントリとSSH鍵を適切に設定すれば、セットアップは数分で完了
• アドホックコマンドとPlaybookを使い分けることで、効率的な運用が実現可能
• パッケージ管理・ファイル操作・サービス制御といった基本モジュールを組み合わせれば、ほとんどのシステム設定に対応できる
• 条件分岐・ロール・並列実行などの高度な機能により、本番環境での大規模自動化が可能
• セキュリティ対策（鍵保護・Vault・監査ログ）を実装することが、安全な運用につながる

初期段階ではアドホックコマンドとシンプルなPlaybookから始め、運用を通じて徐々に機能を活用していくアプローチが推奨されています。ネットワークエンジニア視点では、Ansibleの正確性と追跡可能性により、従来の手作業での設定ミスを大幅に削減できる可能性があります。

Ansibleの公式ドキュメントは https://docs.ansible.com/ で常に最新情報が提供されていますので、本記事で触れていない高度な機能や新機能については、公式情報で確認することをお勧めいたします。