Provided by: lxc_6.0.4-4ubuntu1_amd64 
NAME
lxc-copy - 既存のコンテナのコピー
SYNOPSIS
lxc-copy {-n, --name name} [-P, --lxcpath path] {-N, --newname newname} [-p, --newpath newpath] [-B,
--backingstorage backingstorage] [-s, --snapshot] [-a, --allowrunning] [-K, --keepname] [-D,
--keepdata] [-M, --keepmac] [-L, --fssize size [unit]] [-- hook arguments]
lxc-copy {-n, --name name} [-P, --lxcpath path] [-N, --newname newname] [-p, --newpath newpath] {-e,
--ephemeral} [-B, --backingstorage backingstorage] [-s, --snapshot] [-K, --keepname] [-D,
--keepdata] [-M, --keepmac] [-L, --fssize size [unit]] [-- hook arguments]
lxc-copy {-n, --name name} [-P, --lxcpath path] [-N, --newname newname] [-p, --newpath newpath] {-e,
--ephemeral} [-B, --backingstorage backingstorage] [-s, --snapshot] [-a, --allowrunning] [-t,
--tmpfs] [-K, --keepname] [-M, --keepmac] [-- hook arguments]
lxc-copy {-n, --name name} [-P, --lxcpath path] {-N, --newname newname} [-p, --newpath newpath] {-R,
--rename}
説明
lxc-copy は、すでに存在するコンテナのコピーを作成します。オプションを指定することで、作成後にそのコピーを
起動できます (コピーは一時的なコピーまたは永続的なコピーのどちらも可能です)。 このコマンドは lxc-clone と
lxc-start-ephemeral の置き換えのコマンドです。
lxc-copy は、既存のコンテナのコピーを作成します。 コピーは元のコンテナの完全なクローンにできます。この場
合、単にコンテナのルートファイルシステムのすべてが、新しいコンテナにコピーされます。 また、スナップショッ
トを取得することも可能です。すなわち、元のコンテナの小さなコピーオンライトのコピーにするということで
す。この場合、コピーで指定するバッキングストレージがスナップショットをサポートしている必要があります。 ス
ナップショットをサポートしているバッキングストレージは、現時点では btrfs、lvm (lvm デバイスはスナップ
ショットのスナップショットはサポートしていません)、overlay、zfs です。
コピー先のバッキングストレージは、元のコンテナと同じタイプになるでしょう。ただし、ディレクトリバックエン
ドのコンテナのスナップショットは overlay で取得できますので例外です。
-e オプションを指定した場合は、元のコンテナの一時的なスナップショットを作成し、起動します。一時的なコンテ
ナの場合、設定ファイルに lxc.ephemeral = 1 がセットされ、シャットダウン後に削除されます。 -e と -D を同時
に指定すると、元のコンテナの一時的ではないスナップショットを作成し、起動します。 -t オプションを指定し
て、一時的なコンテナを tmpfs 上に置くことができます。 注意: tmpfs 上に置いた一時的なコ�\x83\xB3テナをリ
ブートすると、コンテナに対して行ったすべての変更は失われます!
-e を指定した場合で、-N でコンテナの名前を指定しない場合は、スナップショットの名前はランダムで命名されま
す。
-e で作成し、起動したコンテナは、コンテナ独自のマウントを行えます。現時点では bind、overlay という 2 つの
タイプのマウントがサポートされています。 マウントタイプは -m オプションのサブオプションとして指定しま
す。この指定はカンマ区切りで複数回指定できます。 overlay マウントの場合は、現時点では -m
overlay=/src:/dest のように指定します。マウント先の dest を指定しない場合は、dest は src と同じになりま
す。 読み込み専用の bind マウントは -m bind=/src:/dest:ro のように指定します。読み書き可能な bind マウン
トは -m bind=/src:/dest:rw のように指定します。bind マウントのデフォルトは読み書き可能ですので、読み書き
可能なマウントを行う場合は省略できます。マウント先の dest を指定しない場合は、dest は src と同じになりま
す。 複数のマウントを行う場合の例を示すと、-m bind=/src1:/dest1:ro,bind=/src2:ro,overlay=/src3:/dest3 の
ようになります。
-m オプションで指定するマウント、オプション、指定フォーマットは変更される可能性があります。
オプション
-N,--newname newname
コピー先のコンテナの名前。
-p,--newpath newpath
コピー先のパス。
-R,--rename
元のコンテナをリネームします。
-s,--snapshot
元のコンテナのスナップショットを作成します。コピー先のバッキングストレージがスナップショットをサ
ポートしている必要があります。現時点では btrfs、lvm、overlay、zfs が対象となります。
-a,--allowrunning
実行中のコンテナのスナップショットを作成します。 これは、使用しているファイルシステムやアプリケー
ションによっては、データの破損や欠損を引き起こす可能性があります。 注意して使用してください。
-F,--foreground
スナップショットしたコンテナをフォアグラウンドで起動します。スナップショットしたコンテナのコンソー
ルは現在の tty にアタッチされます。(このオプションは -e と同時の場合のみ指定できます。)
-d, --daemon
スナップショットしたコンテナをデーモンで起動します (一時的なコンテナではこのモードがデフォルトで
す)。 コンテナは tty を持ちませんので、エラーが発生しても何も表示されません。エラーをチェックする
にはログファイルを使います。(このオプションは -e と同時の場合のみ指定できます。)
-m, --mount mounttype
スナップショットするコンテナで行うマウントを指定します。マウントタイプは {bind, overlay} のどれか
で指定します。例えば -m bind=/src:/dest:ro,overlay=/src:/dest のようになります。(このオプションは
-e と同時の場合のみ指定できます。)
-t, --tmpfs
このオプションを指定すると、一時的なコンテナを tmpfs 上に置きます。 注意: tmpfs 上に置かれた一時的
なコンテナをリブートすると、コンテナに対して行ったすべての変更が失われます。 このフラグは -e オプ
ションを指定して作成した一時的なコンテナに対してのみ有効です。一時的なスナップショットを作成する元
のコンテナは、ディレクトリバックエンド上に存在しなければなりません。
-B, --backingstorage backingstorage
コピー先コンテナのバッキングストレージのタイプを指定します。ここで 'backingstorage' は
'btrfs'、'dir'、'lvm'、'loop'、'overlay'、'zfs' のどれかです。
-L, --fssize size [unit]
'lvm' ファイルシステムのサイズを指定します。
-K, --keepname
このオプションを指定すると、元のコンテナのホスト名をコピー先でもそのまま使います。
-D, --keepdata
-e オプションと同時にこのオプションを使うと、一時的でないコンテナを作成し、起動します。
-M, --keepmac
このオプションを指定すると、元のコンテナの MAC アドレスをコピー先でもそのまま使います。
コピー時のフック
コピーされるコンテナに 1 つ以上の lxc.hook.clone の指定が存在する場合、指定されたフックは新しいコンテナに
対して呼ばれます。 クローンフックに渡される最初の 3 つの引数は、コンテナ名、セクション ('lxc')、フックタ
イプ ('clone') となります。 lxc-copy に渡される追加の引数は、フックプログラムに渡される引数の 4 番目以降
となります。 LXC_ROOTFS_MOUNT 環境変数には、コンテナの root ファイルシステムがマウントされるパスが与えら
れます。 設定ファイルのパス名は LXC_CONFIG_FILE に、新しいコンテナ名は LXC_NAME、古いコンテナ名は
LXC_SRC_NAME に、rootfs のあるパスまたはデバイスは LXC_ROOTFS_PATH に保存されます。
共通オプション
ここで紹介するオプションは lxc コマンドの大部分で共通のものです。
-?, -h, --help
通常より長い使い方のメッセージを表示します。
--usage
使い方を表示します。
-q, --quiet
出力を抑制します。
-P, --lxcpath=PATH
デフォルトと別のコンテナパスを使用します。デフォルトは /var/lib/lxc です。
-o, --logfile=FILE
追加のログを FILE に出力します。デフォルトは出力しません。
-l, --logpriority=LEVEL
ログの優先度を LEVEL に設定します。デフォルトの優先度は ERROR です。以下の値を設定可能です: FATAL,
ALERT, CRIT, WARN, ERROR, NOTICE, INFO, DEBUG, TRACE。
このオプションは追加のログファイルへのイベントログの優先度の設定である事に注意してください。stderr
への ERROR イベントのログには影響しません。
-n, --name=NAME
NAME という名前でコンテナを識別します。コンテナ識別子のフォーマットは英数字の文字列です。
--rcfile=FILE
コンテナの仮想化、隔離機能の設定のための設定ファイルを指定します。
(lxc-create 経由で) 前もってコンテナが作られた際の設定ファイルが既にあった場合でも、このオプション
が指定された場合は、指定した設定ファイルが使用されます。
--version
バージョン番号を表示します。
SEE ALSO
lxc(7), lxc-create(1), lxc-copy(1), lxc-destroy(1), lxc-start(1), lxc-stop(1), lxc-execute(1), lxc-
console(1), lxc-monitor(1), lxc-wait(1), lxc-cgroup(1), lxc-ls(1), lxc-info(1), lxc-freeze(1), lxc-
unfreeze(1), lxc-attach(1), lxc.conf(5)
2025-06-09 lxc-copy(1)