lxc-create.sgml.in revision eb7829c1c6ae93e695e55a43eedf655750ba7b60
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankglxc: linux Container library
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg(C) Copyright IBM Corp. 2007, 2008
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgDaniel Lezcano <daniel.lezcano at free.fr>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgThis library is free software; you can redistribute it and/or
0662ed52e814f8f08ef0e09956413a792584eddffuankgmodify it under the terms of the GNU Lesser General Public
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgLicense as published by the Free Software Foundation; either
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgversion 2.1 of the License, or (at your option) any later version.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgThis library is distributed in the hope that it will be useful,
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgbut WITHOUT ANY WARRANTY; without even the implied warranty of
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgLesser General Public License for more details.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgYou should have received a copy of the GNU Lesser General Public
16b55a35cff91315d261d1baa776138af465c4e4fuankgLicense along with this library; if not, write to the Free Software
16b55a35cff91315d261d1baa776138af465c4e4fuankgFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgTranslated into Japanese
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankgby KATOH Yasufumi <karma at jazz.email.ne.jp>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <refnamediv>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <refpurpose>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg creates a container
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </refpurpose>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </refnamediv>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <refsynopsisdiv>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <cmdsynopsis>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <arg choice="req">-n <replaceable>name</replaceable></arg>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <arg choice="opt">-f <replaceable>config_file</replaceable></arg>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <arg choice="opt">-t <replaceable>template</replaceable></arg>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <arg choice="opt">-B <replaceable>backingstore</replaceable></arg>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <arg choice="opt">-- <replaceable>template-options</replaceable></arg>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </cmdsynopsis>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </refsynopsisdiv>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <command>lxc-create</command> creates a system object where is
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg stored the configuration information and where can be stored
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg user information. The identifier <replaceable>name</replaceable>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg is used to specify the container to be used with the different
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg lxc commands.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <command>lxc-create</command> は，設定情報とユーザ情報が保存されているシステムオブジェクトを作成します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>name</replaceable> で指定された名前が，他の lxc コマンドで，コンテナを特定する名前として使われます．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg The object is a directory created in <filename>@LXCPATH@</filename>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg and identified by its name.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg オブジェクトは <filename>@LXCPATH@</filename> 内に作られる，自身の名前がついたディレクトリです．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg The object is the definition of the different resources an
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg application can use or can see. The more the configuration file
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg contains information, the more the container is isolated and
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg the more the application is jailed.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg オブジェクトは，アプリケーションが使用したり，参照したりする様々なリソースの定義です．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 設定ファイルがより多くの情報を持つほど，コンテナやアプリケーションはより隔離されたものになります．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg If the configuration file <replaceable>config_file</replaceable>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg is not specified, the container will be created with the default
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg isolation: processes, sysv ipc and mount points.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 設定ファイルが <replaceable>config_file</replaceable> で指定されない場合，コンテナはデフォルトの隔離状態で作られます: プロセス，sysv ipc，マウントポイントです．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </refsect1>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <variablelist>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <option>-f <replaceable>config_file</replaceable></option>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg Specify the configuration file to configure the virtualization
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg and isolation functionalities for the container.
0662ed52e814f8f08ef0e09956413a792584eddffuankg コンテナの仮想化と隔離機能を設定するための設定ファイルを指定します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </listitem>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </varlistentry>
0662ed52e814f8f08ef0e09956413a792584eddffuankg <varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <option>-t <replaceable>template</replaceable></option>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 'template' is the short name of an existing 'lxc-template'
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg script that is called by lxc-create,
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg eg. busybox, debian, fedora, ubuntu or sshd.
0662ed52e814f8f08ef0e09956413a792584eddffuankg Refer to the examples in <filename>@LXCTEMPLATEDIR@</filename>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg for details of the expected script structure.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg Alternatively, the full path to an executable template script
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg can also be passed as a parameter.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>template</replaceable> は lxc-create コマンドが呼び出す，存在する 'lxc-template' スクリプトの短い名前です．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 例えば，busybox, debian, fedora, ubuntu, sshd があります．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 期待されるスクリプトの構造の詳細は，<filename>@LXCTEMPLATEDIR@</filename> 内の例を参照してください．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 加えて，実行可能なテンプレートスクリプトへのフルパスも指定することが可能です．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </listitem>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <option>-B <replaceable>backingstore</replaceable></option>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 'backingstore' is one of 'none', 'dir', 'lvm', 'loop', or 'btrfs'. The
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg default is 'none', meaning that the container root filesystem
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg will be a directory under <filename>@LXCPATH@/container/rootfs</filename>.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 'dir' has the same meaning as 'none', but also allows the optional
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--dir ROOTFS</replaceable> to be specified, meaning
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg that the container rootfs should be placed under the specified path,
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg rather than the default. If 'btrfs' is specified, then the
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg target filesystem must be btrfs, and the container rootfs will be
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg created as a new subvolume. This allows snapshotted clones to be
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg created, but also causes rsync --one-filesystem to treat it as a
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg separate filesystem.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg If backingstore is 'lvm', then an lvm block device will be
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg used and the following further options are available:
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--lvname lvname1</replaceable> will create an LV
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg named <filename>lvname1</filename> rather than the default, which
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg is the container name. <replaceable>--vgname vgname1</replaceable>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg will create the LV in volume group <filename>vgname1</filename>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg rather than the default, <filename>lxc</filename>.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--thinpool thinpool1</replaceable> will create the
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg LV as a thin-provisioned volume in the pool named
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <filename>thinpool1</filename> rather than the
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg default, <filename>lxc</filename>.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--fstype FSTYPE</replaceable> will create an FSTYPE
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg filesystem on the LV, rather than the default, which is ext4.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--fssize SIZE</replaceable> will create a LV (and
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg filesystem) of size SIZE rather than the default, which is 1G.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>backingstore</replaceable> には 'none' か 'dir' か 'lvm' か 'btrfs' のいずれかを指定します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg デフォルトは 'none' で，コンテナのルートファイルシステムが <filename>@LXCPATH@/container/rootfs</filename> 以下のディレクトリであることを意味します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg'dir' は 'none' と同じ意味ですが，オプションとして <replaceable>--dir ROOTFS</replaceable> を指定することも可能です．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg このオプションは，デフォルトの代わりに特定のパス以下にコンテナの rootfs を置くということになります．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg 'btrfs' が指定された場合，ターゲットのファイルシステムは btrfs でなければいけません．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg そして，コンテナの rootfs は新しい subvolume として作製されます．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg このことにより，スナップショットによるクローンが作製可能になりますが，結果として rsync --one-filesystem が，別々のファイルシステムとして取り扱ってしまうことにもなります．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg backingstore が 'lvm' である場合，lvm ブロックデバイスを使用します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg この時，以下のオプションが有効になります: <replaceable>--lvname lvname1</replaceable> はデフォルト値のコンテナ名の LV の代わりに <filename>lvname1</filename> という名前の LV を作成します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--vgname vgname1</replaceable> は，デフォルト値である <filename>lxc</filename> という volume group の代わりに <filename>vgname1</filename> という名前の volume group 内に LV を作成します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--thinpool thinpool1</replaceable> は，デフォルトである <filename>lxc</filename> のという名前のプールの代わりに <filename>thinpool1</filename> という名前のプール内にシンプロビジョニングされたボリュームとして LV を作成します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--fstype FSTYPE</replaceable> は LV 上のファイルシステムをデフォルト値である ext4 の代わりに FSTYPE で指定したもので作成します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <replaceable>--fssize SIZE</replaceable> はデフォルト値である 1G の代わりに SIZE で指定したサイズで LV を作成します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </listitem>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <option>-- <replaceable>template-options</replaceable></option>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg This will pass <replaceable>template-options</replaceable> to the
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg template as arguments. To see the list of options supported by
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg the template, you can run
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <command>lxc-create -t TEMPLATE -h</command>.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg これは <replaceable>template-options</replaceable> で指定したものをオプションとしてテンプレートへ渡します．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg テンプレートでサポートされているオプションを調べるには，<command>lxc-create -t TEMPLATE -h</command> というコマンドが使えます．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </listitem>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </variablelist>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </refsect1>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg &commonoptions;
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <variablelist>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg As the message mention it, you try to create a container
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg but there is a container with the same name. You can use
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg the <command>lxc-ls</command> command to list the
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg available containers on the system.
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg メッセージの通り，コンテナを作成しようとしたけれども，同じ名前のコンテナが存在しています．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg <command>lxc-ls</command> コマンドを使って，システム上に存在する利用可能なコンテナのリストが表示できます．
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </listitem>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </varlistentry>
0e168a1fd4f9d8bbb7ce1034c70bad56e316df07fuankg </variablelist>