rsyncで効率的なファイル同期

Linux・CLI・DevOpsカテゴリを表すパンダのイラスト Linux・CLI・DevOps
2025.10.06

本記事はGeminiの出力をプロンプト工学で整理した業務ドラフト（未検証）です。

rsyncによる効率的なファイル同期とDevOps自動化

rsyncは、差分転送アルゴリズムにより効率的なファイル同期を実現するコマンドです。本記事では、DevOpsの観点から、rsyncを用いた安全で冪等な自動化スクリプトの作成、systemd連携、および監視・通知の実現方法を解説します。

要件と前提

本実装では、以下の要件と前提を置きます。

要件: * ソースサーバーからターゲットサーバーへ、特定のディレクトリを定期的に同期します。 * 同期は冪等であり、エラー発生時には管理者へ通知します。 * 自動化はsystemdのtimerを用いて行います。 * セキュリティを考慮し、最小権限の原則に基づきます。

前提: * Linux環境が稼働しているサーバー（ソース、ターゲット）が存在します。 * 両サーバーに rsync, ssh, jq, curl がインストールされています。 * ソースサーバーからターゲットサーバーへのSSH鍵認証（パスワードなし）が設定済みです。鍵は~/.ssh/id_rsyncなどの専用の鍵を使用し、権限は0600に設定済みです。 * 通知用のWebhook URL（例: Slack, Mattermost, Teamsなど）が利用可能です。 * 同期元パス: /srv/data/source * 同期先パス: /srv/data/destination （ターゲットサーバー上） * 同期実行ユーザー: syncuser （ソースサーバー上）

実装

同期スクリプト (sync_data.sh)

冪等性を確保し、安全なスクリプトを作成します。set -euo pipefail でエラー時に即座に終了し、パイプライン内のエラーも捕捉します。trap で一時ディレクトリを確実にクリーンアップします。

#!/bin/bash
# sync_data.sh: rsyncを用いたファイル同期スクリプト

# 安全なBashスクリプトのための設定
set -euo pipefail

# 一時ディレクトリの作成とクリーンアップ
TMP_DIR=$(mktemp -d)
trap 'rm -rf "$TMP_DIR"' EXIT

# 設定変数
SOURCE_DIR="/srv/data/source/" # 末尾の/はディレクトリ内容を同期することを示す
REMOTE_USER="syncuser"
REMOTE_HOST="target.example.com" # ターゲットサーバーのFQDNまたはIP
REMOTE_DEST_DIR="/srv/data/destination/"
SSH_KEY_PATH="/home/syncuser/.ssh/id_rsync" # syncuserのホームディレクトリに配置
WEBHOOK_URL="https://your.notification.service/webhook_url" # 環境変数などで設定することを推奨

# ロギング関数
log_message() {
    local level="$1"
    local message="$2"
    printf "[%s] [%s] %s\n" "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" "$level" "$message" >&2
}

# エラー通知関数 (jqとcurlを使用)
send_notification() {
    local message="$1"
    local timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
    local hostname=$(hostname)
    local payload=$(jq -n \
        --arg msg "$message" \
        --arg ts "$timestamp" \
        --arg host "$hostname" \
        '{
            "text": "rsync同期エラー発生: \($msg)",
            "attachments": [
                {
                    "color": "danger",
                    "fields": [
                        {"title": "Host", "value": "\($host)", "short": true},
                        {"title": "Timestamp", "value": "\($ts)", "short": true},
                        {"title": "Details", "value": "\($msg)", "short": false}
                    ]
                }
            ]
        }')

    log_message "INFO" "Sending error notification..."
    # curl で通知を送信 (TLS検証、再試行、タイムアウト設定)
    curl -X POST -H "Content-Type: application/json" \
         --data "$payload" "$WEBHOOK_URL" \
         --max-time 10 --connect-timeout 5 \
         --retry 3 --retry-delay 2 --retry-max-time 15 \
         --fail --silent --show-error --tlsv1.2
    if [ $? -ne 0 ]; then
        log_message "ERROR" "Failed to send notification via curl."
    else
        log_message "INFO" "Notification sent successfully."
    fi
}

# メイン処理
log_message "INFO" "Starting rsync synchronization from $SOURCE_DIR to $REMOTE_HOST:$REMOTE_DEST_DIR"

# rsyncコマンドの実行
# -a: アーカイブモード (パーミッション、タイムスタンプ、シンボリックリンクなどを保持)
# -v: 詳細出力
# -z: 圧縮転送
# --delete: ソースにないファイルを同期先から削除 (冪等性確保に重要)
# --checksum: ファイル内容の変更もチェック (より厳密な冪等性、パフォーマンス影響あり)
# -e "ssh ...": SSH経由での接続と専用鍵の指定
# --log-file-format='%t %o %i %n%L' --log-file="$TMP_DIR/rsync.log" : ロギングを詳細化したい場合に検討
if rsync -avz --delete --checksum \
          -e "ssh -i $SSH_KEY_PATH -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null" \
          "$SOURCE_DIR" "${REMOTE_USER}@${REMOTE_HOST}:${REMOTE_DEST_DIR}" 2>"$TMP_DIR/rsync_error.log"; then
    log_message "INFO" "Rsync synchronization completed successfully."
else
    RSYNC_EXIT_CODE=$?
    ERROR_OUTPUT=$(cat "$TMP_DIR/rsync_error.log")
    ERROR_MESSAGE="Rsync failed with exit code $RSYNC_EXIT_CODE. Details: $ERROR_OUTPUT"
    log_message "ERROR" "$ERROR_MESSAGE"
    send_notification "$ERROR_MESSAGE"
    exit 1
fi

exit 0

root権限の扱いと権限分離

スクリプトはsyncuserで実行します。同期元/srv/data/sourceはこのユーザーが読み取り可能、同期先/srv/data/destinationはリモートのsyncuserが書き込み可能である必要があります。rsyncはターゲットユーザーの権限でファイルを作成するため、sudoの使用は最小限に抑え、可能であれば不要とします。必要な場合、sudoersファイルで特定のrsyncコマンドのみNOPASSWDで許可するなど、厳格なポリシーを設定します。

同期フロー

graph TD
    A["sync_data.sh実行"] --> B{"一時ディレクトリ/トラップ設定"};
    B --> C["rsyncコマンド構築"];
    C --> D{"rsync実行"};
    D --|成功|--> E["同期完了ログ"];
    D --|失敗 (rsync終了コード != 0)|--> F["エラーハンドリング"];
    F --> G["エラーログ出力"];
    G --> H["通知ペイロード構築 (jq)"];
    H --> I["Webhook送信 (curl)"];
    E --> J["スクリプト終了"];
    I --> J;

検証

スクリプトの動作確認は、まず手動で実行して行います。 1. スクリプトの配置と権限設定: 

mkdir -p /opt/rsync_scripts
    cp sync_data.sh /opt/rsync_scripts/
    chmod +x /opt/rsync_scripts/sync_data.sh
    chown syncuser:syncuser /opt/rsync_scripts/sync_data.sh
    chown -R syncuser:syncuser /home/syncuser/.ssh # SSH鍵の所有者と権限確認
    chmod 600 /home/syncuser/.ssh/id_rsync

  1. 手動実行: syncuserに切り替えて実行します。

    sudo -u syncuser /opt/rsync_scripts/sync_data.sh
    • 同期元にファイルを作成・変更し、rsyncが正しく差分を検出するか確認します。
    • 同期元からファイルを削除し、--deleteオプションが正しく動作し、同期先からファイルが削除されるか確認します。
    • WEBHOOK_URLを一時的に無効なURLに設定して、通知エラーがログに出るか確認します。
    • リモートホストのSSHサービスを停止するなどして、rsyncの失敗と通知の挙動を確認します。

運用

systemd Unit/Timerの設定

スクリプトを定期的に実行するために、systemdのサービスユニットとタイマーユニットを設定します。

  1. Service Unit (/etc/systemd/system/rsync_sync.service):

    [Unit]
Description=Rsync Data Synchronization Service
Documentation=man:rsync(1)
Requires=network-online.target
After=network-online.target

[Service]
Type=oneshot
User=syncuser
WorkingDirectory=/opt/rsync_scripts
ExecStart=/opt/rsync_scripts/sync_data.sh
StandardOutput=journal
StandardError=journal
# スクリプトが長時間実行される可能性がある場合、TimeoutStartSecを調整
# TimeoutStartSec=300
# OnFailure=slack-notify@%n.service などでより高度な通知も可能
# Environment=WEBHOOK_URL=https://your.notification.service/webhook_url # ここで環境変数を設定することも可能

[Install]
WantedBy=multi-user.target
    • User=syncuserでスクリプトがsyncuser権限で実行されることを保証します。
    • StandardOutput=journalとStandardError=journalにより、スクリプトの標準出力と標準エラー出力がsystemdジャーナルに記録されます。

  2. Timer Unit (/etc/systemd/system/rsync_sync.timer):

    [Unit]
Description=Run rsync data synchronization every 15 minutes

[Timer]
OnCalendar=*:0/15:00 # 15分ごとに実行
Persistent=true     # サーバー再起動時に前回起動していなかった時刻分を即時実行
# RandomSec=300     # 複数サーバーで同時起動を避けるためにランダムな遅延を加える

[Install]
WantedBy=timers.target
    • OnCalendar=*:0/15:00 は「毎時0分、15分、30分、45分」に実行することを意味します。必要に応じて頻度を調整します。

  3. systemdの設定と起動:

    sudo systemctl daemon-reload # 設定ファイルの再読み込み
sudo systemctl enable rsync_sync.timer # タイマーの有効化
sudo systemctl start rsync_sync.timer # タイマーの起動

    • タイマーの起動状況を確認します:

      systemctl list-timers | grep rsync_sync

    • 実行ログを確認します:

      journalctl -u rsync_sync.service

ログ監視とアラート

journalctlでログを定期的に確認するだけでなく、ログ収集エージェント（Fluentd, Logstashなど）を導入し、特定のエラーパターン（”ERROR”, “failed”など）を検知した場合にアラートを発する仕組みを構築することが大切です。

セキュリティと権限管理

  • SSH鍵: id_rsyncは専用の鍵とし、rsync実行ユーザーのみが読み取れるようにchmod 600を設定します。パスフレーズなしの鍵を使用する場合は、セキュリティリスクを理解し、サーバーへのアクセス制限（IPホワイトリストなど）を強化します。
  • ファイルパス: syncuserがSOURCE_DIRへの読み取り権限、リモートのsyncuserがREMOTE_DEST_DIRへの書き込み権限を持つようにします。

トラブルシュート

  • rsyncエラーコード: rsyncコマンドは様々な終了コードを返します（例: 11=I/Oエラー、12=メモリ不足、23=部分転送）。スクリプトのエラーメッセージを元に、これらのコードを man rsync で確認します。
  • systemdログ: journalctl -u rsync_sync.service --since "1 hour ago" で最新の実行ログを確認します。
  • SSH接続問題:
    • SSH鍵のパスと権限が正しいか (ssh -i /path/to/key user@host)。
    • リモートホストのSSHデーモンが稼働しているか。
    • ファイアウォールでSSHポート(22/tcp)がブロックされていないか。
    • ~/.ssh/known_hosts にリモートホストの公開鍵が登録されているか（スクリプトではStrictHostKeyChecking=noで回避していますが、運用ではUserKnownHostsFileを指定することを推奨します）。
  • ディスク容量不足: 同期元または同期先のディスク容量が不足していないか確認します。
  • 権限問題: rsync実行ユーザーがファイルやディレクトリにアクセスする権限が不足している可能性があります。ls -lやstatコマンドで権限を確認し、必要に応じてchmod, chownで修正します。

まとめ

rsyncは、差分同期と豊富なオプションにより、DevOpsにおける効率的かつ冪等なファイル同期を実現する強力なツールです。本記事で示した安全なBashスクリプト、systemdによる自動化、jqとcurlを用いた通知、そして厳格な権限管理は、信頼性の高いシステム運用の基盤となります。これらのベストプラクティスを適用することで、システム障害のリスクを低減し、運用効率を向上させることが可能です。

文書情報

記事タイトル
rsyncで効率的なファイル同期
作成日
更新日
Source URL
https://papanda925.com/?p=3355

ライセンス: 本記事のうち、当サイトが権利を有する本文・自作図表は、特記なき限り CC BY 4.0 で利用できます。生成AIを活用して作成・編集した内容を含みます。コードについて、別途ライセンス表示またはリンク先GitHubリポジトリのライセンスがある場合は、その条件を優先します。引用・第三者資料・画像・商標等は本ライセンスの対象外です。 利用ポリシー

タイトルとURLをコピーしました