doc/ja/lxc-create.sgml.in

   1 <!--
   2
   3 lxc: linux Container library
   4
   5 (C) Copyright IBM Corp. 2007, 2008
   6
   7 Authors:
   8 Daniel Lezcano <daniel.lezcano at free.fr>
   9
  10 This library is free software; you can redistribute it and/or
  11 modify it under the terms of the GNU Lesser General Public
  12 License as published by the Free Software Foundation; either
  13 version 2.1 of the License, or (at your option) any later version.
  14
  15 This library is distributed in the hope that it will be useful,
  16 but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18 Lesser General Public License for more details.
  19
  20 You should have received a copy of the GNU Lesser General Public
  21 License along with this library; if not, write to the Free Software
  22 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  23
  24 Translated into Japanese
  25 by KATOH Yasufumi <karma at jazz.email.ne.jp>
  26
  27 -->
  28
  29 <!DOCTYPE refentry PUBLIC @docdtd@ [
  30
  31 <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
  32 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
  33 ]>
  34
  35 <refentry>
  36
  37   <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
  38
  39   <refmeta>
  40     <refentrytitle>lxc-create</refentrytitle>
  41     <manvolnum>1</manvolnum>
  42   </refmeta>
  43
  44   <refnamediv>
  45     <refname>lxc-create</refname>
  46
  47     <refpurpose>
  48       <!--
  49       creates a container
  50       -->
  51       コンテナの作成
  52     </refpurpose>
  53   </refnamediv>
  54
  55   <refsynopsisdiv>
  56     <cmdsynopsis>
  57       <command>lxc-create</command>
  58       <arg choice="req">-n <replaceable>name</replaceable></arg>
  59       <arg choice="opt">-f <replaceable>config_file</replaceable></arg>
  60       <arg choice="req">-t <replaceable>template</replaceable></arg>
  61       <arg choice="opt">-B <replaceable>backingstore</replaceable></arg>
  62       <arg choice="opt">-- <replaceable>template-options</replaceable></arg>
  63     </cmdsynopsis>
  64   </refsynopsisdiv>
  65
  66   <refsect1>
  67     <title><!-- Description -->説明</title>
  68
  69     <para>
  70       <!--
  71       <command>lxc-create</command> creates a system object where is
  72       stored the configuration information and where can be stored
  73       user information. The identifier <replaceable>name</replaceable>
  74       is used to specify the container to be used with the different
  75       lxc commands.
  76       -->
  77       <command>lxc-create</command> は、設定情報とユーザ情報が保存されているシステムオブジェクトを作成します。
  78       <replaceable>name</replaceable> で指定された名前が、他の lxc コマンドで、コンテナを特定する名前として使われます。
  79     </para>
  80     <para>
  81       <!--
  82       The object is a directory created in <filename>@LXCPATH@</filename>
  83       and identified by its name.
  84       -->
  85       オブジェクトは <filename>@LXCPATH@</filename> 内に作られる、自身の名前がついたディレクトリです。
  86     </para>
  87
  88     <para>
  89       <!--
  90       The object is the definition of the different resources an
  91       application can use or can see. The more the configuration file
  92       contains information, the more the container is isolated and
  93       the more the application is jailed.
  94       -->
  95       オブジェクトは、アプリケーションが使用したり、参照したりする様々なリソースの定義です。
  96       設定ファイルがより多くの情報を持つほど、コンテナやアプリケーションはより隔離されたものになります。
  97     </para>
  98
  99     <para>
 100       <!--
 101       If the configuration file <replaceable>config_file</replaceable>
 102       is not specified, the container will be created with the default
 103       isolation: processes, sysv ipc and mount points.
 104       -->
 105       設定ファイルが <replaceable>config_file</replaceable> で指定されない場合、コンテナはデフォルトの隔離状態で作られます: プロセス、sysv ipc、マウントポイントです。
 106     </para>
 107   </refsect1>
 108
 109   <refsect1>
 110     <title><!-- Options -->オプション</title>
 111     <variablelist>
 112
 113       <varlistentry>
 114         <term>
 115           <option>-f, --config <replaceable>config_file</replaceable></option>
 116         </term>
 117         <listitem>
 118           <para>
 119             <!--
 120             Specify the configuration file to configure the virtualization
 121             and isolation functionalities for the container.
 122             -->
 123             コンテナの仮想化と隔離機能を設定するための設定ファイルを指定します。
 124           </para>
 125         </listitem>
 126       </varlistentry>
 127
 128       <varlistentry>
 129         <term>
 130           <option>-t, --template <replaceable>template</replaceable></option>
 131         </term>
 132         <listitem>
 133           <para>
 134             <!--
 135             'template' is the short name of an existing 'lxc-template'
 136             script that is called by lxc-create,
 137             eg. busybox, debian, fedora, ubuntu or sshd.
 138             Refer to the examples in <filename>@LXCTEMPLATEDIR@</filename>
 139             for details of the expected script structure.
 140             Alternatively, the full path to an executable template script
 141             can also be passed as a parameter.
 142             "none" can be used to force lxc-create to skip rootfs creation.
 143             -->
 144             <replaceable>template</replaceable> は lxc-create コマンドが呼び出す、存在する 'lxc-template' スクリプトの短い名前です。
 145             例えば、busybox, debian, fedora, ubuntu, sshd があります。
 146             期待されるスクリプトの構造の詳細は、<filename>@LXCTEMPLATEDIR@</filename> 内の例を参照してください。
 147             加えて、実行可能なテンプレートスクリプトへのフルパスも指定することが可能です。rootfs の作成を行わないように "none" を指定することも可能です。
 148           </para>
 149         </listitem>
 150       </varlistentry>
 151
 152       <varlistentry>
 153         <term>
 154           <option>-B, --bdev <replaceable>backingstore</replaceable></option>
 155         </term>
 156         <listitem>
 157           <para>
 158             <!--
 159             'backingstore' is one of 'dir', 'lvm', 'loop', 'btrfs', 'zfs', 'rbd', or 'best'.  The
 160             default is 'dir', meaning that the container root filesystem
 161             will be a directory under <filename>@LXCPATH@/container/rootfs</filename>.
 162             This backing store type allows the optional
 163             <replaceable>&#045;&#045;dir ROOTFS</replaceable> to be specified, meaning
 164             that the container rootfs should be placed under the specified path,
 165             rather than the default.  (The 'none' backingstore type is an alias for
 166             'dir'.)  If 'btrfs' is specified, then the
 167             target filesystem must be btrfs, and the container rootfs will be
 168             created as a new subvolume.  This allows snapshotted clones to be
 169             created, but also causes rsync &#045;&#045;one-filesystem to treat it as a
 170             separate filesystem.
 171             If backingstore is 'lvm', then an lvm block device will be
 172             used and the following further options are available:
 173             <replaceable>&#045;&#045;lvname lvname1</replaceable> will create an LV
 174             named <filename>lvname1</filename> rather than the default, which
 175             is the container name.  <replaceable>&#045;&#045;vgname vgname1</replaceable>
 176             will create the LV in volume group <filename>vgname1</filename>
 177             rather than the default, <filename>lxc</filename>.
 178             <replaceable>&#045;&#045;thinpool thinpool1</replaceable> will create the
 179             LV as a thin-provisioned volume in the pool named
 180             <filename>thinpool1</filename> rather than the
 181             default, <filename>lxc</filename>.
 182             <replaceable>&#045;&#045;fstype FSTYPE</replaceable> will create an FSTYPE
 183             filesystem on the LV, rather than the default, which is ext4.
 184             <replaceable>&#045;&#045;fssize SIZE</replaceable> will create a LV (and
 185             filesystem) of size SIZE rather than the default, which is 1G.
 186             -->
 187             'backingstore' には 'dir', 'lvm', 'loop', 'btrfs', 'zfs', 'rbd', 'best' のいずれかを指定します。
 188             デフォルトは 'dir' で、コンテナのルートファイルシステムが <filename>@LXCPATH@/container/rootfs</filename> 以下のディレクトリであることを意味します。
 189             'dir' にはオプションとして <replaceable>--dir ROOTFS</replaceable> を指定することも可能です。
 190             このオプションは、デフォルトの代わりに特定のパス以下にコンテナの rootfs を置くということになります。
 191             ('none' は 'dir' のエイリアスです。)
 192             'btrfs' が指定された場合、ターゲットのファイルシステムは btrfs でなければいけません。
 193             そして、コンテナの rootfs は新しい subvolume として作製されます。
 194             このことにより、スナップショットによるクローンが作製可能になりますが、結果として rsync --one-filesystem が、別々のファイルシステムとして取り扱ってしまうことにもなります。
 195             backingstore が 'lvm' である場合、lvm ブロックデバイスを使用します。
 196             この時、以下のオプションが有効になります: <replaceable>--lvname lvname1</replaceable> はデフォルト値のコンテナ名の LV の代わりに <filename>lvname1</filename> という名前の LV を作成します。
 197             <replaceable>--vgname vgname1</replaceable> は、デフォルト値である <filename>lxc</filename> という volume group の代わりに <filename>vgname1</filename> という名前の volume group 内に LV を作成します。
 198             <replaceable>--thinpool thinpool1</replaceable> は、デフォルトである <filename>lxc</filename> のという名前のプールの代わりに <filename>thinpool1</filename> という名前のプール内にシンプロビジョニングされたボリュームとして LV を作成します。
 199             <replaceable>--fstype FSTYPE</replaceable> は LV 上のファイルシステムをデフォルト値である ext4 の代わりに FSTYPE で指定したもので作成します。
 200             <replaceable>--fssize SIZE</replaceable> はデフォルト値である 1G の代わりに SIZE で指定したサイズで LV を作成します。
 201           </para>
 202           <para>
 203             <!--
 204             If backingstore is 'loop', you can use <replaceable>&#045;&#045;fstype FSTYPE</replaceable> and <replaceable>&#045;&#045;fssize SIZE</replaceable> as 'lvm'. The default values for these options are the same as 'lvm'.
 205             -->
 206             backingstore が 'loop' の場合、'lvm' と同様に <replaceable>--fstype FSTYPE</replaceable> と <replaceable>--fssize SIZE</replaceable> が使えます。これらの値のデフォルト値は 'lvm' の場合と同じです。
 207           </para>
 208           <para>
 209                  <!--
 210                  If backingstore is 'rbd', then you will need to have a valid configuration in <filename>ceph.conf</filename> and a <filename>ceph.client.admin.keyring</filename> defined.
 211                  You can specify the following options :
 212                  <replaceable>&#045;&#045;rbdname RBDNAME</replaceable> will create a blockdevice named RBDNAME rather than the default, which is the container name.
 213                  <replaceable>&#045;&#045;rbdpool POOL</replaceable> will create the blockdevice in the pool named POOL, rather than the default, which is 'lxc'.
 214                  -->
 215                  backingstore が 'rbd' の場合、<filename>ceph.conf</filename> に有効な設定がされており、<filename>ceph.client.admin.keyring</filename> が定義されている必要があります。
 216                  <replaceable>--rbdname RBDNAME</replaceable> を指定すると、RBDNAME という名前のブロックデバイスを作成します。このオプションを指定しない場合のデフォルトのブロックデバイス名はコンテナ名です。
 217                  <replaceable>--rbdpool POOL</replaceable> を指定すると、POOL という名前のプール内にブロックデバイスを作成します。このオプションを指定しない場合のデフォルトのプール名は 'lxc' です。
 218           </para>
 219           <para>
 220             <!--
 221             If backingstore is 'best', then lxc will try, in order, btrfs,
 222             zfs, lvm, and finally a directory backing store.
 223             -->
 224             backingstore が 'best' の時、lxc は btrfs, zfs, lvm, dir の順に試行します。
 225           </para>
 226         </listitem>
 227       </varlistentry>
 228
 229       <varlistentry>
 230         <term>
 231           <option>-- <replaceable>template-options</replaceable></option>
 232         </term>
 233         <listitem>
 234           <para>
 235             <!--
 236             This will pass <replaceable>template-options</replaceable> to the
 237             template as arguments.  To see the list of options supported by
 238             the template, you can run
 239             <command>lxc-create -t TEMPLATE -h</command>.
 240             -->
 241             これは <replaceable>template-options</replaceable> で指定したものをオプションとしてテンプレートへ渡します。
 242             テンプレートでサポートされているオプションを調べるには、<command>lxc-create -t TEMPLATE -h</command> というコマンドが使えます。
 243           </para>
 244         </listitem>
 245       </varlistentry>
 246
 247     </variablelist>
 248
 249   </refsect1>
 250
 251   &commonoptions;
 252
 253   <refsect1>
 254     <title><!-- Diagnostic -->診断</title>
 255
 256     <variablelist>
 257
 258       <varlistentry>
 259         <term>The container already exists</term>
 260         <listitem>
 261           <para>
 262             <!--
 263             As the message mention it, you try to create a container
 264             but there is a container with the same name. You can use
 265             the <command>lxc-ls</command> command to list the
 266             available containers on the system.
 267             -->
 268             メッセージの通り、コンテナを作成しようとしたけれども、同じ名前のコンテナが存在しています。
 269             <command>lxc-ls</command> コマンドを使って、システム上に存在する利用可能なコンテナのリストが表示できます。
 270           </para>
 271         </listitem>
 272       </varlistentry>
 273
 274     </variablelist>
 275
 276   </refsect1>
 277
 278   &seealso;
 279
 280   <refsect1>
 281     <title><!-- Author -->作者</title>
 282     <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
 283   </refsect1>
 284
 285 </refentry>
 286
 287 <!-- Keep this comment at the end of the file
 288 Local variables:
 289 mode: sgml
 290 sgml-omittag:t
 291 sgml-shorttag:t
 292 sgml-minimize-attributes:nil
 293 sgml-always-quote-attributes:t
 294 sgml-indent-step:2
 295 sgml-indent-data:t
 296 sgml-parent-document:nil
 297 sgml-default-dtd-file:nil
 298 sgml-exposed-tags:nil
 299 sgml-local-catalogs:nil
 300 sgml-local-ecat-files:nil
 301 End:
 302 -->