lxc-clone.sgml.in revision e8ea311657f82b91710dfcb8bca656bd5b94c66c
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumilxc: linux Container library
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi(C) Copyright IBM Corp. 2007, 2008
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiDaniel Lezcano <daniel.lezcano at free.fr>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiSerge Hallyn <serge.hallyn at ubuntu.com>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiThis library is free software; you can redistribute it and/or
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumimodify it under the terms of the GNU Lesser General Public
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLicense as published by the Free Software Foundation; either
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumiversion 2.1 of the License, or (at your option) any later version.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiThis library is distributed in the hope that it will be useful,
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumibut WITHOUT ANY WARRANTY; without even the implied warranty of
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLesser General Public License for more details.
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiYou should have received a copy of the GNU Lesser General Public
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLicense along with this library; if not, write to the Free Software
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH YasufumiFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
8900b9eb2514c07047541833286428572493a9fdStéphane GraberTranslated into Japanese
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumiby KATOH Yasufumi <karma at jazz.email.ne.jp>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi clone a new container from an existing one.
6127da6b3f5815028bee187ac98840cd94313841KATOH Yasufumi 既存のコンテナからの新しいコンテナのクローン
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </refpurpose>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </refnamediv>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <refsynopsisdiv>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <cmdsynopsis>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <arg choice="opt">-B <replaceable>backingstore</replaceable></arg>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <arg choice="opt">-L <replaceable>fssize</replaceable></arg>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <arg choice="opt">-p <replaceable>lxcpath</replaceable></arg>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <arg choice="opt">-P <replaceable>newlxcpath</replaceable></arg>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <arg choice="req">-o <replaceable>orig</replaceable></arg>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <arg choice="req">-n <replaceable>new</replaceable></arg>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi </cmdsynopsis>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <cmdsynopsis>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <arg choice="opt">-B <replaceable>backingstore</replaceable></arg>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <arg choice="opt">-L <replaceable>fssize</replaceable></arg>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <arg choice="opt">-p <replaceable>lxcpath</replaceable></arg>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <arg choice="opt">-P <replaceable>newlxcpath</replaceable></arg>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </cmdsynopsis>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </refsynopsisdiv>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <command>lxc-clone</command> Creates a new container as a clone of an existing
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi container. Two types of clones are supported: copy and snapshot. A copy
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi clone copies the root filessytem from the original container to the new. A
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi snapshot filesystem uses the backing store's snapshot functionality to create
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi a very small copy-on-write snapshot of the original container. Snapshot
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi clones require the new container backing store to support snapshotting. Currently
48e49f08c0f0d33d75e42cd1f6bf446f740fff8aKATOH Yasufumi this includes only aufs, btrfs, lvm, overlayfs and zfs. LVM devices do not support
99282c429a23a2ffa699ca149bb7f9cd5705646aKATOH Yasufumi snapshots of snapshots.
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi <command>lxc-clone</command> は，新しいコンテナを既に存在するコンテナのクローンとして作製します．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi クローンは 2 つのタイプをサポートします: コピーとスナップショットです．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi コピータイプのクローンは元のコンテナから新しいコンテナへ root ファイルシステムをコピーします．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi スナップショットファイルシステムは，バッキングストアのスナップショット機能を使い，元のコンテナの非常に小さな copy-on-write でのスナップショットを作製します．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi スナップショットでのクローンは，新しいコンテナのバッキングストアとしてスナップショット機能のサポートが必要になります．
48e49f08c0f0d33d75e42cd1f6bf446f740fff8aKATOH Yasufumi 現時点では，このようなバッキングストアとしては aufs, btrfs, lvm, overlayfs, zfs のみをサポートします．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi LVM デバイスはスナップショットのスナップショットはサポートしていません．
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The backing store of the new container will be the same type as the
e8ea311657f82b91710dfcb8bca656bd5b94c66cKATOH Yasufumi original container, with one exception, overlay containers.
e8ea311657f82b91710dfcb8bca656bd5b94c66cKATOH Yasufumi aufs and overlayfs snapshots can be created of directory backed
e8ea311657f82b91710dfcb8bca656bd5b94c66cKATOH Yasufumi containers. This can be requested by using (for overlayfs) the
e8ea311657f82b91710dfcb8bca656bd5b94c66cKATOH Yasufumi <replaceable>-B overlayfs</replaceable> arguments.
e8ea311657f82b91710dfcb8bca656bd5b94c66cKATOH Yasufumi 新しいコンテナのバッキングストアは，オーバーレイタイプのコンテナを除いては元のコンテナのタイプと同じになります．
e8ea311657f82b91710dfcb8bca656bd5b94c66cKATOH Yasufumi ディレクトリバックエンドのコンテナのスナップショットを aufs もしくは overlayfs で作成することは可能です．
48e49f08c0f0d33d75e42cd1f6bf446f740fff8aKATOH Yasufumi 例えば，overlayfs の場合は <replaceable>-B overlayfs</replaceable> という引数を使って指定することが可能です．
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The names of the original and new container can be given (in that order)
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi after all options, or can be specified with the
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <replaceable>-o</replaceable> and <replaceable>-n</replaceable> options,
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi respectively.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi 元のコンテナと新しいコンテナの名前は，全てのオプションの後に順番に与えることも，<replaceable>-o</replaceable> と <replaceable>-n</replaceable> オプションを使ってそれぞれ指定することも可能です．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <variablelist>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The new container's rootfs should be a LVM or btrfs snapshot of the original.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi 新しいコンテナの rootfs は，オリジナルの LVM か btrfs のスナップショットになります．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi Do not change the hostname of the container (in the root
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi (root ファイルシステム内では) コンテナのホスト名を変更しません．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
99282c429a23a2ffa699ca149bb7f9cd5705646aKATOH Yasufumi Use the same MAC address as the original container, rather than
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi generating a new random one.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi 新しい MAC アドレスをランダムに生成せずに，元のコンテナと同じ MAC アドレスを使用します．
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi </varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi Copy all mount hooks into the new container's directory, and
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi update any lxcpaths and container names as needed.
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi 全てのマウントフックを新しいコンテナのディレクトリにコピーします．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi そして，lxcpath とコンテナ名を必要に応じて更新します．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <option>-L, --fssize <replaceable>fssize</replaceable></option>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi In the case of a block device backed container, a size for the new
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi block device. By default, the new device will be made the
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi same size as the original.
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi ブロックデバイスのバックエンドのコンテナの場合，新しいブロックデバイスのサイズ．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi デフォルトでは，新しいデバイスは元のデバイスと同じサイズとなります．
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi </varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <option>-p, --lxcpath <replaceable>fssize</replaceable></option>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The lxcpath of the original container. By default, the system
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi wide configured lxcpath will be used.
f7f1ba77b76e4d4dc18638cfdc859c3dc1750a9eStéphane Graber オリジナルのコンテナの lxcpath．デフォルトでは，システム全体で設定された lxcpath が使われます．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <option>-P, --newpath <replaceable>fssize</replaceable></option>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The lxcpath for the new container. By default the same lxcpath
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi as the original will be used. Note that with btrfs snapshots,
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi changing lxcpaths may not be possible, as subvolume snapshots
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi must be in the same btrfs filesystem.
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi 新しいコンテナの lxcpath．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi デフォルトでは，オリジナルの lxcpath と同じものが使われます．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi btrfs のスナップショットの場合は注意が必要で，lxcpath の変更はできない可能性があります．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi これは subvolume のスナップショットが，同じ btrfs ファイルシステム上に存在しなければならないからです．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <option>-B, --backingstore <replaceable>fssize</replaceable></option>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi Select a different backing store for the new container. By
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi default the same as the original container's is used. Note that
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi currently changing the backingstore is only supported for
48e49f08c0f0d33d75e42cd1f6bf446f740fff8aKATOH Yasufumi aufs and overlayfs snapshots of directory backed containers. Valid
48e49f08c0f0d33d75e42cd1f6bf446f740fff8aKATOH Yasufumi backing stores include dir (directory), aufs, btrfs, lvm, zfs, loop
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi and overlayfs.
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi 新しいコンテナで元のコンテナと違うバッキングストアを使う場合のバッキングストアを選択します．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi デフォルトでは元のコンテナと同じものが使われます．
48e49f08c0f0d33d75e42cd1f6bf446f740fff8aKATOH Yasufumi 現時点では，バッキングストアの変更は，ディレクトリバックエンドのコンテナに対する aufs と overlayfs のスナップショットに対してのみサポートされます．
48e49f08c0f0d33d75e42cd1f6bf446f740fff8aKATOH Yasufumi 有効なバッキングストアは dir(directory), aufs, btrfs, lvm, zfs, loop, overlayfs です．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <option>-o, --orig <replaceable>orig</replaceable></option>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The name of the original container to clone.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi クローンしたい元のコンテナの名前．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <varlistentry>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <option>-n, --new <replaceable>new</replaceable></option>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The name of the new container to create.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi 作製する新しいコンテナの名前．
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi </varlistentry>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi </variablelist>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi If the container being cloned has one or more <filename>lxc.hook.clone</filename>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi specified, then the specified hooks will be called for the new container. The
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi first 3 arguments passed to the clone hook will be the container name, a section
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi ('lxc'), and the hook type ('clone'). Extra arguments passed
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <command>lxc-clone</command> will be passed to the hook program starting at
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi argument 4. The <filename>LXC_ROOTFS_MOUNT</filename> environment variable gives
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi the path under which the container's root filesystem is mounted. The
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi configuration file pathname is stored in <filename>LXC_CONFIG_FILE</filename>, the
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi new container name in <filename>LXC_NAME</filename>, the old container name in
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <filename>LXC_SRC_NAME</filename>, and the path or device on which
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi the rootfs is located is in <filename>LXC_ROOTFS_PATH</filename>.
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi クローンされるコンテナに 1 つ以上の <filename>lxc.hook.clone</filename> の指定が存在する場合，指定されたフックは新しいコンテナに対して呼ばれます．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi クローンフックに渡される最初の 3 つの引数は，コンテナ名，セクション ('lxc')，フックタイプ ('clone') となります．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi <command>lxc-clone</command> に渡される追加の引数は，フックプログラムに渡される引数の 4 番目以降となります．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi <filename>LXC_ROOTFS_MOUNT</filename> 環境変数には，コンテナの root ファイルシステムがマウントされるパスが与えられます．
9a97d4e4bdf331bb2c2b8ed14bcefa53358c288fKATOH Yasufumi 設定ファイルのパス名は <filename>LXC_CONFIG_FILE</filename> に，新しいコンテナ名は <filename>LXC_NAME</filename>，古いコンテナ名は <filename>LXC_SRC_NAME</filename> に，rootfs のあるパスまたはデバイスは <filename>LXC_ROOTFS_PATH</filename> に保存されます．
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi <para>Serge Hallyn <email>serge.hallyn@ubuntu.com</email></para>
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumi<!-- Keep this comment at the end of the file
57da8c32f85c0255efa61ee32e260068afdaa565KATOH YasufumiLocal variables:
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-omittag:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-shorttag:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-minimize-attributes:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-always-quote-attributes:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-indent-step:2
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-indent-data:t
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-parent-document:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-default-dtd-file:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-exposed-tags:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-local-catalogs:nil
57da8c32f85c0255efa61ee32e260068afdaa565KATOH Yasufumisgml-local-ecat-files:nil