Ansibleのcopy・fileモジュールでファイル管理を自動化する方法｜バックアップ・権限設定・シンボリックリンクの実践パターン

この記事のポイント

・copyモジュールはコントロールノードのファイルをリモートサーバーへ冪等に配布する
・backup: yesを指定すると上書き前に元ファイルが自動でバックアップされる
・fileモジュールはstate: directory/link/absentでディレクトリ・リンク・削除を冪等管理できる
・fetchモジュールでリモートの設定ファイルをコントロールノードへ一括回収できる

# files/postfix/main.cf を複数サーバーの /etc/postfix/main.cf へ配布
- name: postfix main.cf を配布する
  copy:
    src: files/postfix/main.cf
    dest: /etc/postfix/main.cf
    owner: root
    group: root
    mode: '0644'

$ ansible-playbook -i hosts.yaml site.yml

TASK [postfix main.cf を配布する] ****
changed: [192.168.10.11]
changed: [192.168.10.12]
ok: [192.168.10.13]   # すでに同じ内容のため変更なし

PLAY RECAP *****
192.168.10.11   : ok=2  changed=1  unreachable=0  failed=0
192.168.10.12   : ok=2  changed=1  unreachable=0  failed=0
192.168.10.13   : ok=1  changed=0  unreachable=0  failed=0

- name: httpd.conf を配布する（上書き前に自動バックアップ）
  copy:
    src: files/apache/httpd.conf
    dest: /etc/httpd/conf/httpd.conf
    owner: root
    group: root
    mode: '0644'
    backup: yes

# バックアップ後の確認
$ ls -la /etc/httpd/conf/
-rw-r--r-- 1 root root 11764  8月 10 09:15 httpd.conf
-rw-r--r-- 1 root root 11502  8月  8 14:30 httpd.conf.68494.2026-08-10@09:15:22~

# スラッシュなし: conf/ ディレクトリごと dest 配下にコピーされる
# 結果: /etc/nginx/conf/nginx.conf のような形になる
src: files/nginx/conf
dest: /etc/nginx/

# スラッシュあり: conf/ の中身だけ dest に展開される
# 結果: /etc/nginx/nginx.conf のような形になる
src: files/nginx/conf/
dest: /etc/nginx/

# 既存ファイルのパーミッションと所有者を設定する
- name: /var/log/app のパーミッションを設定する
  file:
    path: /var/log/app/access.log
    owner: nginx
    group: nginx
    mode: '0640'

# アプリケーションのログディレクトリを作成する
- name: ログディレクトリを作成する
  file:
    path: /var/log/myapp
    state: directory
    owner: appuser
    group: appuser
    mode: '0755'

# 配布前にディレクトリを先に作成するパターン（依存関係が明確になる）
- name: nginx設定ディレクトリを用意する
  file:
    path: /etc/nginx/conf.d
    state: directory
    owner: root
    group: root
    mode: '0755'

- name: nginx仮想ホスト設定を配布する
  copy:
    src: files/nginx/vhost.conf
    dest: /etc/nginx/conf.d/vhost.conf
    owner: root
    group: root
    mode: '0644'

# /etc/nginx/sites-enabled/default -> /etc/nginx/sites-available/default
- name: Nginx仮想ホストを有効化する（シンボリックリンク）
  file:
    src: /etc/nginx/sites-available/default
    dest: /etc/nginx/sites-enabled/default
    state: link
    owner: root
    group: root

# 不要な設定ファイルを削除する
- name: デフォルトのNginx設定を無効化する
  file:
    path: /etc/nginx/sites-enabled/default
    state: absent

# 古いバックアップファイルを削除する
- name: 旧バージョンの設定ファイルを除去する
  file:
    path: /etc/httpd/conf/httpd.conf.old
    state: absent

# リモートの /etc/nginx/nginx.conf をコントロールノードへ回収する（デフォルト）
# 保存先: ./backup/192.168.10.11/etc/nginx/nginx.conf
- name: Nginx設定を回収する
  fetch:
    src: /etc/nginx/nginx.conf
    dest: ./backup/
    flat: no   # デフォルト: ホスト名ディレクトリ配下に保存される

# flat: yes の場合
# 保存先: ./backup/nginx.conf（ホスト名ディレクトリは作成されない）
# 複数ホストから回収すると上書きされるため注意
- name: Nginx設定を回収する（flat形式）
  fetch:
    src: /etc/nginx/nginx.conf
    dest: ./backup/nginx.conf
    flat: yes

# 全Webサーバーから現在の設定を一括回収してバックアップする
- name: 本番Webサーバーの設定を回収する
  fetch:
    src: /etc/httpd/conf/httpd.conf
    dest: ./backup/{{ inventory_hostname }}/httpd.conf
    flat: yes

$ ansible-playbook -i hosts.yaml fetch_configs.yml

TASK [本番Webサーバーの設定を回収する] *****
changed: [web01.example.internal]
changed: [web02.example.internal]
changed: [web03.example.internal]

# 回収後のディレクトリ構造
$ tree backup/
backup/
├── web01.example.internal
│   └── httpd.conf
├── web02.example.internal
│   └── httpd.conf
└── web03.example.internal
    └── httpd.conf

---
- name: Postfix設定の配布と権限設定
  hosts: mail_servers
  become: yes

  tasks:
    # 1. 配布前のバックアップ
    - name: 現在のmain.cfを回収する
      fetch:
        src: /etc/postfix/main.cf
        dest: ./backup/{{ inventory_hostname }}/main.cf
        flat: yes

    # 2. 設定ファイルを配布（上書き前に自動バックアップ）
    - name: main.cf を配布する
      copy:
        src: files/postfix/main.cf
        dest: /etc/postfix/main.cf
        owner: root
        group: postfix
        mode: '0640'
        backup: yes
      notify: postfix を再起動する

    # 3. キューディレクトリのパーミッション確認
    - name: Postfixキューディレクトリの権限を設定する
      file:
        path: /var/spool/postfix
        state: directory
        owner: root
        group: postfix
        mode: '0755'

  handlers:
    - name: postfix を再起動する
      service:
        name: postfix
        state: restarted

$ ansible-playbook -i hosts.yaml postfix_deploy.yml --diff

TASK [main.cf を配布する] *****
--- before: /etc/postfix/main.cf
+++ after: /home/ansible/.ansible/tmp/ansible-tmp-.../main.cf
@@ -71,6 +71,7 @@
 myhostname = mail.example.internal
+mynetworks = 192.168.10.0/24

changed: [mail01.example.internal]

RUNNING HANDLER [postfix を再起動する] *****
changed: [mail01.example.internal]

PLAY RECAP *****
mail01.example.internal : ok=4  changed=2  unreachable=0  failed=0

fatal: [192.168.10.11]: FAILED! => {
    "msg": "Destination /etc/nginx/nginx.conf not writable"
}

# Playbook全体にbecome: yesを付ける
- name: Nginx設定配布
  hosts: web
  become: yes   # これを追加
  tasks:
    - name: nginx.conf を配布する
      copy:
        src: files/nginx/nginx.conf
        dest: /etc/nginx/nginx.conf
        owner: root
        group: root
        mode: '0644'

# スラッシュなし: files/conf ディレクトリ自体が /etc/nginx/conf として作成される
# 結果: /etc/nginx/conf/nginx.conf
- copy:
    src: files/conf
    dest: /etc/nginx/

# スラッシュあり: files/conf/ の中身が /etc/nginx/ 配下に展開される
# 結果: /etc/nginx/nginx.conf
- copy:
    src: files/conf/
    dest: /etc/nginx/

# 本番適用前のdry-run確認
$ ansible-playbook -i hosts.yaml site.yml --check --diff