<!DOCTYPE refentry PUBLIC @docdtd@ [

<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">

<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">

]>

<refentry>

<docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>

<refmeta>

<refentrytitle>lxc-copy</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-copy</refname>

<refpurpose>

<!--

既存のコンテナのコピー

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-copy</command>

<arg choice="req">-n, --name <replaceable>name</replaceable></arg>

<arg choice="opt">-P, --lxcpath <replaceable>path</replaceable></arg>

<arg choice="req">-N, --newname <replaceable>newname</replaceable></arg>

<arg choice="opt">-p, --newpath <replaceable>newpath</replaceable></arg>

<arg choice="opt">-B, --backingstorage <replaceable>backingstorage</replaceable></arg>

<arg choice="opt">-s, --snapshot</arg>

<arg choice="opt">-K, --keepdata</arg>

<arg choice="opt">-M, --keepmac</arg>

<arg choice="opt">-L, --fssize <replaceable>size [unit]</replaceable></arg>

<arg choice="opt">-- hook arguments</arg>

</cmdsynopsis>

<cmdsynopsis>

<command>lxc-copy</command>

<arg choice="req">-n, --name <replaceable>name</replaceable></arg>

<arg choice="opt">-P, --lxcpath <replaceable>path</replaceable></arg>

<arg choice="opt">-N, --newname <replaceable>newname</replaceable></arg>

<arg choice="opt">-p, --newpath <replaceable>newpath</replaceable></arg>

<arg choice="req">-e, --ephemeral</arg>

<arg choice="opt">-B, --backingstorage <replaceable>backingstorage</replaceable></arg>

<arg choice="opt">-s, --snapshot</arg>

<arg choice="opt">-K, --keepdata</arg>

<arg choice="opt">-M, --keepmac</arg>

<arg choice="opt">-L, --fssize <replaceable>size [unit]</replaceable></arg>

<arg choice="opt">-- hook arguments</arg>

</cmdsynopsis>

<cmdsynopsis>

<command>lxc-copy</command>

<arg choice="req">-n, --name <replaceable>name</replaceable></arg>

<arg choice="opt">-P, --lxcpath <replaceable>path</replaceable></arg>

<arg choice="req">-N, --newname <replaceable>newname</replaceable></arg>

<arg choice="opt">-p, --newpath <replaceable>newpath</replaceable></arg>

<arg choice="req">-R, --rename</arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title><!-- Description -->説明</title>

<para>

<!--

<command>lxc-copy</command> は、すでに存在するコンテナのコピーを作成します。オプションを指定することで、作成後にそのコピーを起動できます (コピーは一時的なコピーまたは永続的なコピーのどちらも可能です)。

このコマンドは <command>lxc-clone</command> と <command>lxc-start-ephemeral</command> の置き換えのコマンドです。

</para>

<para>

<!--

<command>lxc-copy</command> は、既存のコンテナのコピーを作成します。

コピーは元のコンテナの完全なクローンにできます。この場合、単にコンテナのルートファイルシステムのすべてが、新しいコンテナにコピーされます。

また、スナップショットを取得することも可能です。すなわち、元のコンテナの小さなコピーオンライトのコピーにするということです。この場合、コピーで指定するバッキングストレージがスナップショットをサポートしている必要があります。

スナップショットをサポートしているバッキングストレージは、現時点では aufs、btrfs、lvm (lvm デバイスはスナップショットのスナップショットはサポートしていません)、overlay、zfs です。

</para>

<para>

<!--

コピー先のバッキングストレージは、元のコンテナと同じタイプになるでしょう。ただし、ディレクトリバックエンドのコンテナのスナップショットは aufs と overlayfs で取得できますので例外です。

</para>

<para>

<!--

<replaceable>-e</replaceable> オプションを指定した場合は、元のコンテナの一時的なスナップショットを作成し、起動します。一時的なコンテナの場合、設定ファイルに <command>lxc.ephemeral = 1</command> がセットされ、シャットダウン後に削除されます。

<replaceable>-e</replaceable> と <replaceable>-D</replaceable> を同時に指定すると、元のコンテナの一時的ではないスナップショットを作成し、起動します。

</para>

<para>

<!--

<replaceable>-e</replaceable> を指定した場合で、<replaceable>-N</replaceable> でコンテナの名前を指定しない場合は、スナップショットの名前はランダムで命名されます。

</para>

<para>

<!--

<replaceable>-e</replaceable> で作成し、起動したコンテナは、コンテナ独自のマウントを行えます。現時点では <replaceable>aufs</replaceable>、<replaceable>bind</replaceable>、<replaceable>overlay</replaceable> という 3 つのタイプのマウントがサポートされています。

マウントタイプは <replaceable>-m</replaceable> オプションのサブオプションとして指定します。この指定はカンマ区切りで複数回指定できます。

<replaceable>aufs</replaceable> と <replaceable>overlay</replaceable> マウントの場合は、現時点では <replaceable>-m overlay=/src:/dest</replaceable> のように指定します。マウント先の <replaceable>dest</replaceable> を指定しない場合は、<replaceable>dest</replaceable> は <replaceable>src</replaceable> と同じになります。

読み込み専用の <replaceable>bind</replaceable> マウントは <replaceable>-m bind=/src:/dest:ro</replaceable> のように指定します。読み書き可能な <replaceable>bind</replaceable> マウントは <replaceable>-m bind=/src:/dest:rw</replaceable> のように指定します。<replaceable>bind</replaceable> マウントのデフォルトは読み書き可能ですので、読み書き可能なマウントを行う場合は省略できます。マウント先の <replaceable>dest</replaceable> を指定しない場合は、<replaceable>dest</replaceable> は <replaceable>src</replaceable> と同じになります。

複数のマウントを行う場合の例を示すと、<replaceable>-m bind=/src1:/dest1:ro,bind=/src2:ro,overlay=/src3:/dest3</replaceable> のようになります。

</para>

<para>

<!--

<replaceable>-m</replaceable> オプションで指定するマウント、オプション、指定フォーマットは変更される可能性があります。

</para>

</refsect1>

<refsect1>

<title><!-- Options -->オプション</title>

<variablelist>

<varlistentry>

<term> <option>-N,--newname <replaceable>newname</replaceable></option> </term>

<listitem>

<para><!-- The name for the copy. -->コピー先のコンテナの名前。</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-p,--newpath <replaceable>newpath</replaceable></option> </term>

<listitem>

<para><!-- The path for the copy. -->コピー先のパス。</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-R,--rename </option> </term>

<listitem>

<para><!-- Rename the original container. -->元のコンテナをリネームします。</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-s,--snapshot </option> </term>

<listitem>

<para><!-- Create a snapshot of the original container. The backing

元のコンテナのスナップショットを作成します。コピー先のバッキングストレージがスナップショットをサポートしている必要があります。現時点では aufs、btrfs、lvm、overlay、zfs が対象となります。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-F,--foreground</option> </term>

<listitem>

<para><!-- Run the snapshot in the foreground. The snapshots console will

スナップショットしたコンテナをフォアグラウンドで起動します。スナップショットしたコンテナのコンソールは現在の tty にアタッチされます。(このオプションは <replaceable>-e</replaceable> と同時の場合のみ指定できます。)

</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-d, --daemon</option> </term>

<listitem>

<para><!-- Run the snapshot as a daemon (This is the default mode for

スナップショットしたコンテナをデーモンで起動します (一時的なコンテナではこのモードがデフォルトです)。

コンテナは tty を持ちませんので、エラーが発生しても何も表示されません。エラーをチェックするにはログファイルを使います。(このオプションは <replaceable>-e</replaceable> と同時の場合のみ指定できます。)

</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-m, --mount <replaceable>mounttype</replaceable></option> </term>

<listitem>

<para><!-- Specify a mount for a snapshot The

<replaceable>-e</replaceable>.). --></para>

スナップショットするコンテナで行うマウントを指定します。マウントタイプは {aufs, bind, overlay} のどれかで指定します。例えば <option>-m bind=/src:/dest:ro,overlay=/src:/dest</option> のようになります。(このオプションは <replaceable>-e</replaceable> と同時の場合のみ指定できます。)

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-B, --backingstorage <replaceable>backingstorage</replaceable></option></term>

<listitem>

<para><!-- Specify the backing storage type to be used for the copy

コピー先コンテナのバッキングストレージのタイプを指定します。ここで 'backingsotrage' は 'aufs'、'btrfs'、'dir'、'lvm'、'loop'、'overlay'、'zfs' のどれかです。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-L, --fssize <replaceable>size [unit]</replaceable></option></term>

<listitem>

<para><!-- Specify the size for an 'lvm' filesystem. -->'lvm' ファイルシステムのサイズを指定します。</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-D, --keepdata </option></term>

<listitem>

<para><!-- When this option is specified with

<replaceable>-e</replaceable> オプションと同時にこのオプションを使うと、一時的でないコンテナを作成し、起動します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-K, --keepname </option></term>

<listitem>

<para><!-- When this option is specified the hostname of the original

このオプションを指定すると、元のコンテナのホスト名をコピー先でもそのまま使います。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term> <option>-M, --keepmac </option></term>

<listitem>

<para><!-- When this option is specified the MAC address of the original

このオプションを指定すると、元のコンテナの MAC アドレスをコピー先でもそのまま使います。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1>

<title><!-- Copy hook -->コピー時のフック</title>

<para>

<!--

コピーされるコンテナに 1 つ以上の <filename>lxc.hook.clone</filename> の指定が存在する場合、指定されたフックは新しいコンテナに対して呼ばれます。

クローンフックに渡される最初の 3 つの引数は、コンテナ名、セクション ('lxc')、フックタイプ ('clone') となります。

<command>lxc-copy</command> に渡される追加の引数は、フックプログラムに渡される引数の 4 番目以降となります。

<filename>LXC_ROOTFS_MOUNT</filename> 環境変数には、コンテナの root ファイルシステムがマウントされるパスが与えられます。

設定ファイルのパス名は <filename>LXC_CONFIG_FILE</filename> に、新しいコンテナ名は <filename>LXC_NAME</filename>、古いコンテナ名は <filename>LXC_SRC_NAME</filename> に、rootfs のあるパスまたはデバイスは <filename>LXC_ROOTFS_PATH</filename> に保存されます。

</para>

</refsect1>

&commonoptions;

&seealso;

<refsect1>

<title>Author</title>

<para>Christian Brauner <email>christian.brauner@mailbox.org</email></para>

</refsect1>

</refentry>