lxc-clone.sgml.in revision f7f1ba77b76e4d4dc18638cfdc859c3dc1750a9e
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
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi this includes only btrfs, lvm, overlayfs and zfs. LVM devices do not support
99282c429a23a2ffa699ca149bb7f9cd5705646aKATOH Yasufumi snapshots of snapshots.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi <command>lxc-clone</command> は，新しいコンテナを既に存在するコンテナのクローンとして作製します．クローンは 2 つのタイプをサポートします: コピーとスナップショットです．コピータイプのクローンは元のコンテナから新しいコンテナへ root ファイルシステムをコピーします．スナップショットファイルシステムは，バッキングストアのスナップショット機能を使い，元のコンテナの非常に小さな copy-on-write でのスナップショットを作製します．スナップショットでのクローンは，新しいコンテナのバッキングストアとしてスナップショット機能のサポートが必要になります．現時点では，このようなバッキングストアとしては btrfs, lvm, overlayfs, zfs のみをサポートします．LVM デバイスはスナップショットのスナップショットはサポートしていません．
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi The backing store of the new container will be the same type as the
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi original container,
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi with one exception: overlayfs snapshots can be created of directory backed
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi containers. This can be requested by using the <replaceable>-B overlayfs</replaceable>
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH 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
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH 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.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH 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.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH 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.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi 新しいコンテナの lxcpath．デフォルトでは，オリジナルの lxcpath と同じものが使われます．btrfs のスナップショットの場合は注意が必要で，lxcpath の変更はできない可能性があります．これは 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
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi overlayfs snapshots of directory backed containers. Valid
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi backing stores include dir (directory), btrfs, lvm, zfs, loop
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi and overlayfs.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi 新しいコンテナで元のコンテナと違うバッキングストアを使う場合のバッキングストアを選択します．デフォルトでは元のコンテナと同じものが使われます．現時点では，バッキングストアの変更は，ディレクトリバックエンドのコンテナに対する overlayfs スナップショットに対してのみサポートされます．有効なバッキングストアは dir(directory), 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>.
a5ba96715d4ef264c43d4f187251de491ba198c0KATOH Yasufumi クローンされたコンテナに 1 つ以上の <filename>lxc.hook.clone</filename> の指定が存在する場合，指定されたフックは新しいコンテナに対して呼ばれます．クローンフックに渡される最初の 3 つの引数は，コンテナ名，セクション ('lxc')，フックタイプ ('clone') となります．<command>lxc-clone</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> に保存されます．
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