'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-clone 1 "Sat Apr 29 06:45:43 UTC 2017" "" ""
.SH NAME
lxc-clone \- 既存のコンテナからの新しいコンテナのクローン 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-clone\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-s ] [-K ] [-M ] [-H ] [-B \fIbackingstore\fR] [-L \fIfssize\fR] [-p \fIlxcpath\fR] [-P \fInewlxcpath\fR] {-o \fIorig\fR} {-n \fInew\fR} [-- hook arguments]
'in \n(.iu-\nxu
.ad b
'hy
'nh
.fi
.ad l
\fBlxc-clone\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-s ] [-K ] [-M ] [-H ] [-B \fIbackingstore\fR] [-L \fIfssize\fR] [-p \fIlxcpath\fR] [-P \fInewlxcpath\fR] {orig} {new} [-- hook arguments]
'in \n(.iu-\nxu
.ad b
'hy
.SH 説明
\fBlxc-clone\fR は、新しいコンテナを既に存在するコンテナのクローンとして作製します。
クローンは 2 つのタイプをサポートします: コピーとスナップショットです。
コピータイプのクローンは元のコンテナから新しいコンテナへ root ファイルシステムをコピーします。
スナップショットファイルシステムは、バッキングストアのスナップショット機能を使い、元のコンテナの非常に小さな copy-on-write でのスナップショットを作製します。
スナップショットでのクローンは、新しいコンテナのバッキングストアとしてスナップショット機能のサポートが必要になります。
現時点では、このようなバッキングストアとしては aufs, btrfs, lvm, overlayfs, zfs のみをサポートします。
LVM デバイスはスナップショットのスナップショットはサポートしていません。
.PP
新しいコンテナのバッキングストアは、オーバーレイタイプのコンテナを除いては元のコンテナのタイプと同じになります。
ディレクトリバックエンドのコンテナのスナップショットを aufs もしくは overlayfs で作成することは可能です。
例えば、overlayfs の場合は \fI-B overlayfs\fR という引数を使って指定することが可能です。
.PP
元のコンテナと新しいコンテナの名前は、全てのオプションの後に順番に与えることも、\fI-o\fR と \fI-n\fR オプションを使ってそれぞれ指定することも可能です。
.SH オプション
.TP 
\*(T<\fB\-s, \-\-snapshot\fR\*(T> 
新しいコンテナの rootfs は、オリジナルの LVM か btrfs のスナップショットになります。
.TP 
\*(T<\fB\-K, \-\-keepname\fR\*(T> 
(root ファイルシステム内では) コンテナのホスト名を変更しません。
.TP 
\*(T<\fB\-M, \-\-keepmac\fR\*(T> 
新しい MAC アドレスをランダムに生成せずに、元のコンテナと同じ MAC アドレスを使用します。
.TP 
\*(T<\fB\-H, \-\-copyhooks\fR\*(T> 
全てのマウントフックを新しいコンテナのディレクトリにコピーします。
そして、lxcpath とコンテナ名を必要に応じて更新します。
.TP 
\*(T<\fB\-L, \-\-fssize \fR\*(T>\fIfssize\fR 
ブロックデバイスのバックエンドのコンテナの場合、新しいブロックデバイスのサイズ。
デフォルトでは、新しいデバイスは元のデバイスと同じサイズとなります。
.TP 
\*(T<\fB\-p, \-\-lxcpath \fR\*(T>\fIlxcpath\fR 
オリジナルのコンテナの lxcpath。デフォルトでは、システム全体で設定された lxcpath が使われます。
.TP 
\*(T<\fB\-P, \-\-newpath \fR\*(T>\fInewlxcpath\fR 
新しいコンテナの lxcpath。
デフォルトでは、オリジナルの lxcpath と同じものが使われます。
btrfs のスナップショットの場合は注意が必要で、lxcpath の変更はできない可能性があります。
これは subvolume のスナップショットが、同じ btrfs ファイルシステム上に存在しなければならないからです。
.TP 
\*(T<\fB\-B, \-\-backingstore \fR\*(T>\fIbackingstore\fR 
新しいコンテナで元のコンテナと違うバッキングストアを使う場合のバッキングストアを選択します。
デフォルトでは元のコンテナと同じものが使われます。
現時点では、バッキングストアの変更は、ディレクトリバックエンドのコンテナに対する aufs と overlayfs のスナップショットに対してのみサポートされます。
有効なバッキングストアは dir(directory), aufs, btrfs, lvm, zfs, loop, overlayfs です。
.TP 
\*(T<\fB\-o, \-\-orig \fR\*(T>\fIorig\fR 
クローンしたい元のコンテナの名前。
.TP 
\*(T<\fB\-n, \-\-new \fR\*(T>\fInew\fR 
作製する新しいコンテナの名前。
.SH "CLONE HOOK"
クローンされるコンテナに 1 つ以上の \*(T<\fIlxc.hook.clone\fR\*(T> の指定が存在する場合、指定されたフックは新しいコンテナに対して呼ばれます。
クローンフックに渡される最初の 3 つの引数は、コンテナ名、セクション ('lxc')、フックタイプ ('clone') となります。
\fBlxc-clone\fR に渡される追加の引数は、フックプログラムに渡される引数の 4 番目以降となります。
\*(T<\fILXC_ROOTFS_MOUNT\fR\*(T> 環境変数には、コンテナの root ファイルシステムがマウントされるパスが与えられます。
設定ファイルのパス名は \*(T<\fILXC_CONFIG_FILE\fR\*(T> に、新しいコンテナ名は \*(T<\fILXC_NAME\fR\*(T>、古いコンテナ名は \*(T<\fILXC_SRC_NAME\fR\*(T> に、rootfs のあるパスまたはデバイスは \*(T<\fILXC_ROOTFS_PATH\fR\*(T> に保存されます。
.SH "SEE ALSO"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)
.SH 作者
Serge Hallyn <\*(T<serge.hallyn@ubuntu.com\*(T>>