この記事のポイント

・Ansibleはエージェント不要でSSH経由だけでサーバーを自動設定できる
・Inventoryで対象サーバーを定義し、Playbookで手順を宣言的に書く
・べき等性（何度実行しても同じ結果）がAnsibleの最大の強み
・セミナーLP（ansible.linuxmaster.jp）で実機ハンズオンを体験できる

# /etc/ansible/hosts または任意の場所に置く
# 例: inventory.ini

[webservers]
web01.example.com
web02.example.com
192.168.1.101

[dbservers]
db01.example.com
192.168.1.201

[all:vars]
ansible_user=ec2-user
ansible_ssh_private_key_file=~/.ssh/my_key.pem

# install_apache.yml の例
---
- name: Apacheのインストールと起動
  hosts: webservers        # Inventoryのグループ名
  become: yes              # sudo権限を使う

  tasks:
    - name: Apacheをインストールする
      ansible.builtin.dnf:
        name: httpd
        state: present     # インストール済み状態にせよ

    - name: Apacheを起動して自動起動を有効にする
      ansible.builtin.service:
        name: httpd
        state: started
        enabled: yes

    - name: firewalldでhttpを許可する
      ansible.builtin.firewalld:
        service: http
        permanent: yes
        state: enabled
        immediate: yes

# RHEL 9 / AlmaLinux 9 の場合
$ sudo dnf install -y epel-release
$ sudo dnf install -y ansible

# Ubuntu 22.04 / 24.04 の場合
$ sudo apt update
$ sudo apt install -y ansible

# バージョン確認
$ ansible --version
ansible [core 2.16.x]
  config file = /etc/ansible/ansible.cfg
  python version = 3.11.x

# 自分のPCで鍵ペアを生成（すでにある場合はスキップ）
$ ssh-keygen -t ed25519 -C "ansible-key"

# 対象サーバーへ公開鍵をコピー
$ ssh-copy-id -i ~/.ssh/id_ed25519.pub user@192.168.1.101

# 接続確認
$ ssh user@192.168.1.101 "hostname"
web01

# inventory.ini を作成
$ cat inventory.ini
[webservers]
192.168.1.101 ansible_user=ec2-user

[dbservers]
192.168.1.201 ansible_user=ec2-user

# Ansibleのpingモジュールで疎通確認
$ ansible -i inventory.ini webservers -m ping
192.168.1.101 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

# install_apache.yml を実行
$ ansible-playbook -i inventory.ini install_apache.yml

PLAY [Apacheのインストールと起動] *****

TASK [Gathering Facts] ****
ok: [192.168.1.101]

TASK [Apacheをインストールする] ****
changed: [192.168.1.101]

TASK [Apacheを起動して自動起動を有効にする] ****
changed: [192.168.1.101]

TASK [firewalldでhttpを許可する] ****
changed: [192.168.1.101]

PLAY RECAP *****
192.168.1.101  : ok=4  changed=3  unreachable=0  failed=0

Ansible実機ハンズオンはこちら

「実際に手を動かして覚えたい」方には、Linux Master Pro Seminarのハンズオン講座がおすすめです。
Ansible PlaybookをゼロからRHEL環境で書き、複数サーバーへ自動適用する体験ができます。
＞＞ Ansibleハンズオン講座の詳細を見る

---
- name: Webサーバーのセットアップ
  hosts: webservers
  become: yes
  vars:
    http_port: 80
    document_root: /var/www/html
    app_user: webadmin

  tasks:
    - name: アプリユーザーを作成する
      ansible.builtin.user:
        name: "{{ app_user }}"
        state: present

    - name: ドキュメントルートのディレクトリを作成する
      ansible.builtin.file:
        path: "{{ document_root }}"
        state: directory
        owner: "{{ app_user }}"
        mode: '0755'

  tasks:
    - name: httpd.confを配置する
      ansible.builtin.template:
        src: httpd.conf.j2
        dest: /etc/httpd/conf/httpd.conf
      notify: Restart Apache    # 変更があった時だけハンドラーを呼ぶ

  handlers:
    - name: Restart Apache
      ansible.builtin.service:
        name: httpd
        state: restarted

# ansible-galaxy コマンドでRoleの雛形を生成
$ ansible-galaxy role init roles/webserver

roles/webserver/
├── tasks/
│   └── main.yml      # タスク定義
├── handlers/
│   └── main.yml      # ハンドラー定義
├── vars/
│   └── main.yml      # 変数定義
├── templates/
│   └── httpd.conf.j2 # Jinja2テンプレート
└── defaults/
    └── main.yml      # デフォルト変数

# 対処: SSHの詳細ログで原因を特定する
$ ssh -vvv user@192.168.1.101

# ansible側でも詳細モードで確認
$ ansible -i inventory.ini webservers -m ping -vvv

# 対処1: 実行時にsudoパスワードを渡す
$ ansible-playbook -i inventory.ini playbook.yml --ask-become-pass

# 対処2: 対象サーバーのsudoersをパスワードなしに設定（推奨）
# /etc/sudoers に以下を追記（visudoで編集）
ansible_user ALL=(ALL) NOPASSWD:ALL

# 手動SSH接続で確認する（Ansibleの問題かSSHの問題かを切り分ける）
$ ssh -p 22 user@192.168.1.101

# 非標準ポートを使っている場合はInventoryに指定
[webservers]
192.168.1.101 ansible_port=2222 ansible_user=ec2-user

# コントロールノードにlibselinuxのPythonバインディングを入れる
$ sudo dnf install -y python3-libselinux