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