<!DOCTYPE refentry PUBLIC @docdtd@ [

<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">

<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">

]>

<refentry>

<docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>

<refmeta>

<refentrytitle>lxc-create</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-create</refname>

<refpurpose>

<!--

コンテナの作成

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-create</command>

<arg choice="req">-n <replaceable>name</replaceable></arg>

<arg choice="opt">-f <replaceable>config_file</replaceable></arg>

<arg choice="req">-t <replaceable>template</replaceable></arg>

<arg choice="opt">-B <replaceable>backingstore</replaceable></arg>

<arg choice="opt">-- <replaceable>template-options</replaceable></arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title><!-- Description -->説明</title>

<para>

<!--

<command>lxc-create</command> は、設定情報とユーザ情報が保存されているシステムオブジェクトを作成します。

<replaceable>name</replaceable> で指定された名前が、他の lxc コマンドで、コンテナを特定する名前として使われます。

</para>

<para>

<!--

オブジェクトは <filename>@LXCPATH@</filename> 内に作られる、自身の名前がついたディレクトリです。

</para>

<para>

<!--

オブジェクトは、アプリケーションが使用したり、参照したりする様々なリソースの定義です。

設定ファイルがより多くの情報を持つほど、コンテナやアプリケーションはより隔離されたものになります。

</para>

<para>

<!--

設定ファイルが <replaceable>config_file</replaceable> で指定されない場合、コンテナはデフォルトの隔離状態で作られます: プロセス、sysv ipc、マウントポイントです。

</para>

</refsect1>

<refsect1>

<title><!-- Options -->オプション</title>

<variablelist>

<varlistentry>

<term>

<option>-f, --config <replaceable>config_file</replaceable></option>

</term>

<listitem>

<para>

<!--

コンテナの仮想化と隔離機能を設定するための設定ファイルを指定します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-t, --template <replaceable>template</replaceable></option>

</term>

<listitem>

<para>

<!--

<replaceable>template</replaceable> は lxc-create コマンドが呼び出す、存在する 'lxc-template' スクリプトの短い名前です。

例えば、busybox, debian, fedora, ubuntu, sshd があります。

期待されるスクリプトの構造の詳細は、<filename>@LXCTEMPLATEDIR@</filename> 内の例を参照してください。

加えて、実行可能なテンプレートスクリプトへのフルパスも指定することが可能です。rootfs の作成を行わないように "none" を指定することも可能です。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-B, --bdev <replaceable>backingstore</replaceable></option>

</term>

<listitem>

<para>

<!--

'backingstore' には 'dir', 'lvm', 'loop', 'btrfs', 'zfs', 'rbd', 'best' のいずれかを指定します。

デフォルトは 'dir' で、コンテナのルートファイルシステムが <filename>@LXCPATH@/container/rootfs</filename> 以下のディレクトリであることを意味します。

'dir' にはオプションとして <replaceable>--dir ROOTFS</replaceable> を指定することも可能です。

このオプションは、デフォルトの代わりに特定のパス以下にコンテナの rootfs を置くということになります。

('none' は 'dir' のエイリアスです。)

'btrfs' が指定された場合、ターゲットのファイルシステムは btrfs でなければいけません。

そして、コンテナの rootfs は新しい subvolume として作製されます。

このことにより、スナップショットによるクローンが作製可能になりますが、結果として rsync --one-filesystem が、別々のファイルシステムとして取り扱ってしまうことにもなります。

backingstore が 'lvm' である場合、lvm ブロックデバイスを使用します。

この時、以下のオプションが有効になります: <replaceable>--lvname lvname1</replaceable> はデフォルト値のコンテナ名の LV の代わりに <filename>lvname1</filename> という名前の LV を作成します。

<replaceable>--vgname vgname1</replaceable> は、デフォルト値である <filename>lxc</filename> という volume group の代わりに <filename>vgname1</filename> という名前の volume group 内に LV を作成します。

<replaceable>--thinpool thinpool1</replaceable> は、デフォルトである <filename>lxc</filename> のという名前のプールの代わりに <filename>thinpool1</filename> という名前のプール内にシンプロビジョニングされたボリュームとして LV を作成します。

<replaceable>--fstype FSTYPE</replaceable> は LV 上のファイルシステムをデフォルト値である ext4 の代わりに FSTYPE で指定したもので作成します。

<replaceable>--fssize SIZE</replaceable> はデフォルト値である 1G の代わりに SIZE で指定したサイズで LV を作成します。

</para>

<para>

<!--

backingstore が 'loop' の場合、'lvm' と同様に <replaceable>--fstype FSTYPE</replaceable> と <replaceable>--fssize SIZE</replaceable> が使えます。これらの値のデフォルト値は 'lvm' の場合と同じです。

</para>

<para>

<!--

backingstore が 'rbd' の場合、<filename>ceph.conf</filename> に有効な設定がされており、<filename>ceph.client.admin.keyring</filename> が定義されている必要があります。

<replaceable>--rbdname RBDNAME</replaceable> を指定すると、RBDNAME という名前のブロックデバイスを作成します。このオプションを指定しない場合のデフォルトのブロックデバイス名はコンテナ名です。

<replaceable>--rbdpool POOL</replaceable> を指定すると、POOL という名前のプール内にブロックデバイスを作成します。このオプションを指定しない場合のデフォルトのプール名は 'lxc' です。

</para>

<para>

<!--

backingstore が 'best' の時、lxc は btrfs, zfs, lvm, dir の順に試行します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term>

<option>-- <replaceable>template-options</replaceable></option>

</term>

<listitem>

<para>

<!--

これは <replaceable>template-options</replaceable> で指定したものをオプションとしてテンプレートへ渡します。

テンプレートでサポートされているオプションを調べるには、<command>lxc-create -t TEMPLATE -h</command> というコマンドが使えます。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&commonoptions;

<refsect1>

<title><!-- Diagnostic -->診断</title>

<variablelist>

<varlistentry>

<term>The container already exists</term>

<listitem>

<para>

<!--

メッセージの通り、コンテナを作成しようとしたけれども、同じ名前のコンテナが存在しています。

<command>lxc-ls</command> コマンドを使って、システム上に存在する利用可能なコンテナのリストが表示できます。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&seealso;

<refsect1>

<title><!-- Author -->作者</title>

<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

</refsect1>

</refentry>