[rsync]permission/ユーザ/グループを変更しながら同期する

概要

rsyncコマンド(manページへのリンク)の

• --chmodオプション
  • 同期先のパーミッションを設定する
• --chownオプション
  • 同期先のユーザ・グループを設定する

の挙動のクセで詰まったので、備忘録として残します。

想定ケース

• リモートIPアドレス：remote_IP の端末に
• ユーザ：remote_user でSSH接続して
• リモート端末のディレクトリ：/remote_dir 配下のファイル・ディレクトリすべてを、
• ローカル端末のディレクトリ：/local_dir へ同期する

remote_dirの構成

remote_dir 
|-- aaa.file
|-- fuga_dir
|   `-- bbb.file
`-- hoge_dir
    `-- ccc.file

local_dirの構成

• 配下にディレクトリ・ファイルなし。
• パーミッション：rwxr-xr-x
• 所有者：before_user
• グループ：before_group

local_dir 
0 directories, 0 files

コマンドと実行結果

対象ディレクトリの指定方法によって、3通りの結果がある

1. 末尾に**「/」なし**
   ⇒対象ディレクトリを丸ごと同期
2. 末尾に**「/」あり**
   ⇒対象ディレクトリより下の階層を同期、同期先ディレクトリのパーミッション・ユーザ・グループ上書き
3. 末尾に**「/*」あり**
   ⇒対象ディレクトリより下の階層を同期、同期先ディレクトリのパーミッション・ユーザ・グループ上書き

1.末尾に「/」なし

• remote_dirがそのままlocal_dir直下に同期される
• remote_dirも含めて、同期されたファイル・ディレクトリのパーミッション・ユーザ・グループが
  --chmod,--chownで指定したもので設定される
• local_dirのパーミッション・ユーザ・グループは実行前と変化なし

[実行コマンド]
rsync -pogr \
--chmod=D775,F664 \
--chown=after_user:after_group \
-e "ssh -p 22" remote_user@source_IP:/remote_dir local_dir

[実行結果]
local_dir              //rwxr-xr-x before_user:before_group
`-- remote-dir         //rwxrwxr-x after_user:after_group
    |-- aaa.file       //rwxrwxr-x after_user:after_group
    |-- fuga_dir       //rwxrwxr-x after_user:after_group
    |   `-- bbb.file   //rwxrwxr-x after_user:after_group
    `-- hoge_dir       //rwxrwxr-x after_user:after_group
        `-- ccc.file 　//rwxrwxr-x after_user:after_group

2.末尾に「/」あり

• remote_dir より下にあるファイル・ディレクトリ がlocal_dir直下に同期される
• 同期されたファイル・ディレクトリと、local_dirのパーミッション・ユーザ・グループが
  --chmod,--chownで指定したもので設定される

[実行コマンド]
rsync -pogr \
--chmod=D775,F664 \
--chown=after_user:after_group \
-e "ssh -p 22" remote_user@source_IP:/remote_dir/ local_dir

[実行結果]
local_dir            //rwxrwxr-x after_user:after_group
  |-- aaa.file       //rwxrwxr-x after_user:after_group
  |-- fuga_dir       //rwxrwxr-x after_user:after_group
  |   `-- bbb.file   //rwxrwxr-x after_user:after_group
  `-- hoge_dir       //rwxrwxr-x after_user:after_group
      `-- ccc.file 　//rwxrwxr-x after_user:after_group

3.末尾に「/*」あり

末尾に「/」のみだと、local_dirのパーミッション等が上書きされてしまう。
これを回避するには、「/*」を対象ディレクトリ指定に追加する。

• remote_dirより下にあるファイル・ディレクトリがlocal_dir直下に同期される
• 同期されたファイル・ディレクトリのパーミッション・ユーザ・グループが
  --chmod,--chownで指定したもので設定される
• local_dirのパーミッション・ユーザ・グループは実行前と変化なし

[実行コマンド]
rsync -pogr \
--chmod=D775,F664 \
--chown=after_user:after_group \
-e "ssh -p 22" remote_user@source_IP:/remote_dir/* local_dir

[実行結果]
local_dir            //rwxr-xr-x before_user:before_group
  |-- aaa.file       //rwxrwxr-x after_user:after_group
  |-- fuga_dir       //rwxrwxr-x after_user:after_group
  |   `-- bbb.file   //rwxrwxr-x after_user:after_group
  `-- hoge_dir       //rwxrwxr-x after_user:after_group
      `-- ccc.file 　//rwxrwxr-x after_user:after_group

まとめ

rsyncコマンドは対象ディレクトリ指定で大きく挙動が変わるので、
気を付けましょう……