Skip to content

L
lxc
Unverified Commit 70b63c0f by KATOH Yasufumi Committed by Stéphane Graber
Options

doc: Tweak Japanese lxc.container.conf(5)

Add description of new network configuration, and tweak. Update for commit b9986e43Signed-off-by: 's avatarKATOH Yasufumi <karma@jazz.email.ne.jp>
parent 569eb78e
Showing with 239 additions and 247 deletions
doc/ja/lxc.container.conf.sgml.in
...@@ -56,61 +56,94 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -56,61 +56,94 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<para> <para>
<!-- <!--
The linux containers (<command>lxc</command>) are always created LXC is the well-known and heavily tested low-level Linux container
before being used. This creation defines a set of system runtime. It is in active development since 2008 and has proven itself in
resources to be virtualized / isolated when a process is using critical production environments world-wide. Some of its core contributors
the container. By default, the pids, sysv ipc and mount points are the same people that helped to implement various well-known
are virtualized and isolated. The other system resources are containerization features inside the Linux kernel.
shared across containers, until they are explicitly defined in -->
the configuration file. For example, if there is no network LXC は良く知られた、多くのテストが行われた Linux コンテナのランタイムです。LXC は、2008 年以来アクティブに開発されており、世界中の重要な本番環境で実証されています。開発への貢献者の中には、Linux カーネル内の良く知られた様々なコンテナ機能の実装に貢献した人と同じ人もいます。
configuration, the network will be shared between the creator of
the container and the container itself, but if the network is
specified, a new network stack is created for the container and
the container can no longer use the network of its ancestor.
-->
linux コンテナ (<command>lxc</command>) は、常に使用する前に作成されます。
コンテナは、プロセスがコンテナを使う時に仮想化/隔離するシステムリソースのセットを定義することによって作成します。
デフォルトでは、pid, sysv ipc, マウントポイントが仮想化され、隔離されます。
他のシステムリソースは、設定ファイルで明確に定義されない限りは、コンテナをまたいで共有されます。
例えば、もしネットワークが設定されていなければ、コンテナを作成する側とコンテナでネットワークを共有します。
しかし、ネットワークが指定されれば、新しいネットワークスタックがコンテナ用に作成され、コンテナは作成元の環境のネットワークを使いません。
</para> </para>
<para> <para>
<!-- <!--
The configuration file defines the different system resources to LXC's main focus is system containers. That is, containers which offer an
be assigned for the container. At present, the utsname, the environment as close as possible as the one you'd get from a VM but
network, the mount points, the root file system, the user namespace, without the overhead that comes with running a separate kernel and
and the control groups are supported. simulating all the hardware.
--> -->
設定ファイルは、コンテナに割り当てられる様々なシステムリソースを定義します。 LXC は主にシステムコンテナにフォーカスを当てています。つまり、VM で得られる環境と可能な限り近い環境を提供を提供するにも関わらず、別々のカーネルを実行したり、ハードウェアをすべてシミュレートしたりすることによるオーバーヘッドがないコンテナのことです。
現時点では、utsname、ネットワーク、マウントポイント、root ファイルシステム、ユーザ名前空間、control groups がサポートされます。 </para>
<para>
<!--
This is achieved through a combination of kernel security features such as
namespaces, mandatory access control and control groups.
-->
このような環境は、名前空間 (namespace)、強制アクセスコントロール、cgroup といったカーネルのセキュリティ機能の組み合わせで実現しています。
</para>
<para>
<!--
LXC has supports unprivileged containers. Unprivileged containers are
containers that are run without any privilege. This requires support for
user namespaces in the kernel that the container is run on. LXC was the
first runtime to support unprivileged containers after user namespaces
were merged into the mainline kernel.
-->
LXC は非特権コンテナをサポートしています。非特権コンテナは、いかなる特権も持たずに実行するコンテナです。非特権コンテナの実行には、コンテナを実行しているカーネルにユーザ名前空間 (user namespace) のサポートが必要です。LXC は、ユーザ名前空間がメインラインカーネルにマージされてから、初めて非特権コンテナをサポートしたランタイムです。
</para>
<para>
<!--
In essence, user namespaces isolate given sets of UIDs and GIDs. This is
achieved by establishing a mapping between a range of UIDs and GIDs on the
host to a different (unprivileged) range of UIDs and GIDs in the
container. The kernel will translate this mapping in such a way that
inside the container all UIDs and GIDs appear as you would expect from the
host whereas on the host these UIDs and GIDs are in fact unprivileged. For
example, a process running as UID and GID 0 inside the container might
appear as UID and GID 100000 on the host. The implementation and working
details can be gathered from the corresponding user namespace man page.
UID and GID mappings can be defined with the <option>lxc.id_map</option>
key.
-->
本質的には、ユーザ名前空間は与えられた UID、GID の組を隔離します。ユーザ名前空間は、ホスト上の UID、GID のある範囲を、それとは異なるコンテナ上の UID、GID の範囲へマッピングすることで実現します。カーネルは、ホスト上では実際には UID、GID は特権を持たないにも関わらず、コンテナ内ではすべての UID、GID が期待されるように見えるように変換を行います。
例えば、コンテナ内では UID、GID が 0 として実行中のプロセスは、ホスト上では UID、GID が 100000 として見えるでしょう。実装と動作の詳細は、ユーザ名前空間の man ページから得られます。UID と GID のマッピングは <option>lxc.id_map</option> を使って定義できます。
</para> </para>
<para> <para>
<!-- <!--
Each option in the configuration file has the form <command>key Linux containers are defined with a simple configuration file. Each
= value</command> fitting in one line. The '#' character means option in the configuration file has the form <command>key =
the line is a comment. List options, like capabilities and cgroups value</command> fitting in one line. The "#" character means the line is a
options, can be used with no value to clear any previously comment. List options, like capabilities and cgroups options, can be used
defined values of that option. with no value to clear any previously defined values of that option.
-->
Linux コンテナは、簡単な設定ファイルで定義します。設定ファイル中のオプションは <command>key = value</command> の形で一行で表します。'#' は、その行はコメントであることを示します。ケーパビリティや cgroup のオプションのような、リスト形式で指定するオプションでは、value がない形式で指定でき、そのように使うと、それ以前に定義した値をすべてクリアします。
</para>
<para>
<!--
LXC namespaces configuration keys by using single dots. This means complex
configuration keys such as <option>lxc.network</option> expose various
subkeys such as <option>lxc.network.type</option>,
<option>lxc.network.link</option>, <option>lxc.network.ipv6</option>, and
others for even more fine-grained configuration.
--> -->
設定ファイルのオプション一つを、<command>key = value</command> の形で一行で表します。 LXC は、シングルドットを使って設定キーの名前空間を表します。<option>lxc.network</option> のような複雑な設定キーは、<option>lxc.network.type</option>、<option>lxc.network.link</option>、<option>lxc.network.ipv6</option> や、さらに細分化された設定向けの色々なサブキーを持つことを意味します。
'#' は、その行はコメントであることを示します。
ケーパビリティや cgroup のオプションのような、リスト形式で指定するオプションでは、value がない形式で指定できます。このように使うと、それ以前に定義した値をすべてクリアします。
</para> </para>
<refsect2> <refsect2>
<title><!-- Configuration -->設定</title> <title><!-- Configuration -->設定</title>
<para> <para>
<!-- <!--
In order to ease administration of multiple related containers, it In order to ease administration of multiple related containers, it is
is possible to have a container configuration file cause another possible to have a container configuration file cause another file to be
file to be loaded. For instance, network configuration loaded. For instance, network configuration can be defined in one common
can be defined in one common file which is included by multiple file which is included by multiple containers. Then, if the containers
containers. Then, if the containers are moved to another host, are moved to another host, only one file may need to be updated.
only one file may need to be updated. -->
-->
複数の関係するコンテナの管理を容易にするために、コンテナの設定ファイルに別のファイルをロードすることが可能です。 複数の関係するコンテナの管理を容易にするために、コンテナの設定ファイルに別のファイルをロードすることが可能です。
例えば、ネットワークの設定を、複数のコンテナから include させるように 1 つのファイルに定義することが可能です。 例えば、ネットワークの設定を、複数のコンテナから include させるように 1 つのファイルに定義することが可能です。
その場合、コンテナが他のホストに移動すると、そのファイルだけを更新する必要があるかもしれません。 その場合、コンテナが他のホストに移動すると、そのファイルだけを更新する必要があるかもしれません。
...@@ -139,11 +172,10 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -139,11 +172,10 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<title><!-- Architecture -->アーキテクチャ</title> <title><!-- Architecture -->アーキテクチャ</title>
<para> <para>
<!-- <!--
Allows one to set the architecture for the container. For example, Allows one to set the architecture for the container. For example, set a
set a 32bits architecture for a container running 32bits 32bits architecture for a container running 32bits binaries on a 64bits
binaries on a 64bits host. That fixes the container scripts host. This fixes the container scripts which rely on the architecture to
which rely on the architecture to do some work like do some work like downloading the packages.
downloading the packages.
--> -->
コンテナに対してアーキテクチャを設定することが可能です。 コンテナに対してアーキテクチャを設定することが可能です。
例えば、64 ビットのホスト上で 32 ビットのバイナリを動かすために 32 ビットアーキテクチャを設定することが可能です。 例えば、64 ビットのホスト上で 32 ビットのバイナリを動かすために 32 ビットアーキテクチャを設定することが可能です。
...@@ -164,20 +196,20 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -164,20 +196,20 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
</para> </para>
<para> <para>
<!-- <!--
Valid options are Some valid options are
<option>x86</option>, <option>x86</option>,
<option>i686</option>, <option>i686</option>,
<option>x86_64</option>, <option>x86_64</option>,
<option>amd64</option> <option>amd64</option>
--> -->
有効なオプションは以下です。 有効なオプションには以下のようなものがあります。
<option>x86</option>, <option>x86</option>,
<option>i686</option>, <option>i686</option>,
<option>x86_64</option>, <option>x86_64</option>,
<option>amd64</option> <option>amd64</option>
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect2> </refsect2>
...@@ -186,10 +218,9 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -186,10 +218,9 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<title><!-- Hostname -->ホスト名</title> <title><!-- Hostname -->ホスト名</title>
<para> <para>
<!-- <!--
The utsname section defines the hostname to be set for the The utsname section defines the hostname to be set for the container.
container. That means the container can set its own hostname That means the container can set its own hostname without changing the
without changing the one from the system. That makes the one from the system. That makes the hostname private for the container.
hostname private for the container.
--> -->
utsname セクションは、コンテナに設定されるホスト名を定義します。 utsname セクションは、コンテナに設定されるホスト名を定義します。
コンテナは、システムのホスト名を変えることなく、自身のホスト名を持つ事が可能です。 コンテナは、システムのホスト名を変えることなく、自身のホスト名を持つ事が可能です。
...@@ -215,17 +246,15 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -215,17 +246,15 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<refsect2> <refsect2>
<title><!-- Halt signal -->クリーンなシャットダウン時のシグナル</title> <title><!-- Halt signal -->クリーンなシャットダウン時のシグナル</title>
<para> <para>
<!-- <!--
Allows one to specify signal name or number, sent by lxc-stop to the Allows one to specify signal name or number sent to the container's
container's init process to cleanly shutdown the container. Different init process to cleanly shutdown the container. Different init systems
init systems could use different signals to perform clean shutdown could use different signals to perform clean shutdown sequence. This
sequence. This option allows the signal to be specified in kill(1) option allows the signal to be specified in kill(1) fashion, e.g.
fashion, e.g. SIGPWR, SIGRTMIN+14, SIGRTMAX-10 or plain number. The SIGPWR, SIGRTMIN+14, SIGRTMAX-10 or plain number. The default signal is
default signal is SIGPWR. SIGPWR.
--> -->
lxc-stop がコンテナをクリーンにシャットダウンするためにコンテナの init プロセスに送るシグナル名か番号を指定できます。 コンテナをクリーンにシャットダウンするためにコンテナの init プロセスに送るシグナル名か番号を指定できます。init システムによって、クリーンなシャットダウンを行うために使うシグナルは異なります。このオプションではシグナルとして kill(1) で使う形式を指定できます。
init システムによって、クリーンなシャットダウンを行うために使うシグナルは異なります。
このオプションではシグナルとして kill(1) で使う形式を指定することができます。
例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式、もしくは数字を指定します。デフォルトのシグナルは SIGPWR です。 例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式、もしくは数字を指定します。デフォルトのシグナルは SIGPWR です。
</para> </para>
<variablelist> <variablelist>
...@@ -249,13 +278,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -249,13 +278,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<title>リブート時のシグナル <!-- Reboot signal --></title> <title>リブート時のシグナル <!-- Reboot signal --></title>
<para> <para>
<!-- <!--
Allows one to specify signal name or number, sent by lxc-stop to Allows one to specify signal name or number to reboot the container.
reboot the container. This option allows signal to be specified in This option allows signal to be specified in kill(1) fashion, e.g.
kill(1) fashion, e.g. SIGTERM, SIGRTMIN+14, SIGRTMAX-10 or plain number. SIGTERM, SIGRTMIN+14, SIGRTMAX-10 or plain number. The default signal
The default signal is SIGINT. is SIGINT.
--> -->
lxc-stop がコンテナをリブートするために送るシグナル名か番号を指定できます。 コンテナをリブートするために送るシグナル名か番号を指定できます。このオプションではシグナルとして kill(1) で使う形式を指定できます。
このオプションではシグナルとして kill(1) で使う形式を指定することができます。
例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式、もしくは数字を指定します。デフォルトのシグナルは SIGINT です。 例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式、もしくは数字を指定します。デフォルトのシグナルは SIGINT です。
</para> </para>
<variablelist> <variablelist>
...@@ -279,13 +307,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -279,13 +307,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<title><!-- Stop signal -->強制停止時のシグナル</title> <title><!-- Stop signal -->強制停止時のシグナル</title>
<para> <para>
<!-- <!--
Allows one to specify signal name or number, sent by lxc-stop to forcibly Allows one to specify signal name or number to forcibly shutdown the
shutdown the container. This option allows signal to be specified in container. This option allows signal to be specified in kill(1) fashion,
kill(1) fashion, e.g. SIGKILL, SIGRTMIN+14, SIGRTMAX-10 or plain number. e.g. SIGKILL, SIGRTMIN+14, SIGRTMAX-10 or plain number. The default
The default signal is SIGKILL. signal is SIGKILL.
--> -->
lxc-stop がコンテナを強制的にシャットダウンするために送るシグナル名か番号を指定することができます。 コンテナを強制的にシャットダウンするために送るシグナル名か番号を指定できます。このオプションではシグナルとして kill(1) で使う形式を指定できます。
このオプションではシグナルとして kill(1) で使う形式を指定することができます。
例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式、もしくは数字を指定します。デフォルトのシグナルは SIGKILL です。 例えば SIGKILL, SIGRTMIN+14, SIGRTMAX-10 のような形式、もしくは数字を指定します。デフォルトのシグナルは SIGKILL です。
</para> </para>
<variablelist> <variablelist>
...@@ -339,20 +366,17 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -339,20 +366,17 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<refsect2> <refsect2>
<title><!-- Init ID -->Init が使う ID</title> <title><!-- Init ID -->Init が使う ID</title>
<para> <para>
<!-- <!--
Sets the UID/GID to use for the init system, and subsequent command, executed by lxc-execute. Sets the UID/GID to use for the init system, and subsequent commands.
--> Note that using a non-root uid when booting a system container will
lxc-execute が実行するコンテナの init と、その後に起動するコマンドが使用する UID/GID を設定します。 likely not work due to missing privileges. Setting the UID/GID is mostly
useful when running application container.
<!--
These options are only used when lxc-execute is started in a private user namespace.
-->
このオプションは lxc-execute がユーザ名前空間内で起動するときのみ使われます。
<!--
Defaults to: UID(0), GID(0) Defaults to: UID(0), GID(0)
--> -->
デフォルト値は UID(0), GID(0) です。 init と後続のコマンドが使う UID/GID を設定します。システムコンテナを起動するのに非 root な UID を使うと、特権がないために動作しないでしょう。UID/GID の指定は、通常はアプリケーションコンテナの動作の際に役に立ちます。
デフォルト値: UID(0)、GID(0)
</para> </para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
...@@ -361,10 +385,10 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -361,10 +385,10 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
UID to use within a private user namesapce for init. UID to use for init.
--> -->
ユーザ名前空間内で init が使う UID です。 init が使う UID です。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -375,9 +399,9 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -375,9 +399,9 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<listitem> <listitem>
<para> <para>
<!-- <!--
GID to use within a private user namesapce for init. GID to use for init.
--> -->
ユーザ名前空間内で init が使う GID です。 init が使う GID です。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -444,25 +468,28 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -444,25 +468,28 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.type</option> <option>lxc.network.[i].type</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify what kind of network virtualization to be used specify what kind of network virtualization to be used
for the container. Each time for the container.
a <option>lxc.network.type</option> field is found a new Multiple networks can be specified by using an additional index
round of network configuration begins. In this way, <option>i</option>
several network virtualization types can be specified after all <option>lxc.network.*</option> keys. For example,
for the same container, as well as assigning several <option>lxc.network.0.type = veth</option> and
network interfaces for one container. The different <option>lxc.network.1.type = veth</option> specify two different
virtualization types can sbe: networks of the same type. All keys sharing the same index
--> <option>i</option> will be treated as belonging to the same
コンテナがどの種類のネットワーク仮想化を使うかを指定します。 network. For example, <option>lxc.network.0.link = br0</option>
一つのネットワークの設定ごとに <option>lxc.network.type</option> フィールドを指定します。 will belong to <option>lxc.network.0.type</option>.
このように、一つのコンテナに複数のネットワークインターフェースを割り当てることができるだけでなく、同じコンテナに対して複数のネットワーク仮想化の種類を指定することが出来ます。 Currently, the different virtualization types can be:
仮想化の種類は以下の値を取る事が出来ます: -->
</para> コンテナがどの種類のネットワーク仮想化を使うかを指定します。すべての <option>lxc.network.*</option> キーに、追加のインデックス <option>i</option> を使うと、複数のネットワークを指定できます。例えば、<option>lxc.network.0.type = veth</option> と <option>lxc.network.1.type = veth</option> は、同じタイプの異なるネットワークを 2 つ指定します。
同じインデックスを指定したキーはすべて同じネットワークの指定になります。例えば、<option>lxc.network.0.link = br0</option> は <option>lxc.network.0.type</option> と同じネットワークの設定になります。
現時点では、以下のネットワーク仮想化のタイプが使えます:
</para>
<para> <para>
<!-- <!--
...@@ -591,13 +618,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -591,13 +618,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.flags</option> <option>lxc.network.[i].flags</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify an action to do for the Specify an action to do for the network.
network.
--> -->
ネットワークに対して行うアクションを指定します。 ネットワークに対して行うアクションを指定します。
</para> </para>
...@@ -613,13 +639,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -613,13 +639,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.link</option> <option>lxc.network.[i].link</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify the interface to be used for real network Specify the interface to be used for real network traffic.
traffic.
--> -->
実際のネットワークトラフィックに使うインターフェースを指定します。 実際のネットワークトラフィックに使うインターフェースを指定します。
</para> </para>
...@@ -628,12 +653,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -628,12 +653,12 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.mtu</option> <option>lxc.network.[i].mtu</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify the maximum transfer unit for this interface. Specify the maximum transfer unit for this interface.
--> -->
インターフェースに対する MTU を指定します。 インターフェースに対する MTU を指定します。
</para> </para>
...@@ -642,77 +667,64 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -642,77 +667,64 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.name</option> <option>lxc.network.[i].name</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
the interface name is dynamically allocated, but if The interface name is dynamically allocated, but if another name
another name is needed because the configuration files is needed because the configuration files being used by the
being used by the container use a generic name, container use a generic name, eg. eth0, this option will rename
eg. eth0, this option will rename the interface in the the interface in the container.
container.
--> -->
インターフェース名は動的に割り当てられます。 インターフェース名は動的に割り当てられます。しかし、もしコンテナが使用する設定ファイルが一般的な名前を使用するために、他の特定の名前が必要であれば (例えば eth0 など)、コンテナ内のインターフェースは、このオプションで指定した名前にリネームされます。
しかし、もしコンテナが使用する設定ファイルが一般的な名前を使用するために、他の特定の名前が必要であれば (例えば eth0 など)、コンテナ内のインターフェースは、このオプションで指定した名前にリネームされます。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.hwaddr</option> <option>lxc.network.[i].hwaddr</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
the interface mac address is dynamically allocated by The interface mac address is dynamically allocated by default to
default to the virtual interface, but in some cases, the virtual interface, but in some cases, this is needed to
this is needed to resolve a mac address conflict or to resolve a mac address conflict or to always have the same
always have the same link-local ipv6 address. link-local ipv6 address. Any "x" in address will be replaced by
Any "x" in address will be replaced by random value, random value, this allows setting hwaddr templates.
this allows setting hwaddr templates. -->
--> 仮想インターフェースの MAC アドレスは、デフォルトでは動的に割り当てられます。しかし、MAC アドレスの衝突や、リンクローカルIPv6 アドレスを常に同じにした場合などは、このオプションが必要です。アドレス中の "x" という文字は、ランダムな値に置き換えられます。これによりテンプレートに hwaddr を設定することが可能になります。
仮想インターフェースの MAC アドレスは、デフォルトでは動的に割り当てられます。
しかし、MAC アドレスの衝突や、リンクローカルIPv6 アドレスを常に同じにした場合などは、このオプションが必要です。
アドレス中の "x" という文字は、ランダムな値に置き換えられます。
これによりテンプレートに hwaddr を設定することが可能になります。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.ipv4</option> <option>lxc.network.[i].ipv4</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify the ipv4 address to assign to the virtualized Specify the ipv4 address to assign to the virtualized interface.
interface. Several lines specify several ipv4 addresses. Several lines specify several ipv4 addresses. The address is in
The address is in format x.y.z.t/m, format x.y.z.t/m, eg. 192.168.1.123/24.
eg. 192.168.1.123/24.The broadcast address should be -->
specified on the same line, right after the ipv4 仮想インターフェースに割り当てる ipv4 アドレスを指定します。複数行により複数の ipv4 アドレスを指定します。このアドレスは x.y.z.t/m というフォーマットで指定します。例) 192.168.1.123/24
address.
-->
仮想インターフェースに割り当てる ipv4 アドレスを指定します。
複数行により複数の ipv4 アドレスを指定します。
このアドレスは x.y.z.t/m というフォーマットで指定します。
例えば、192.168.1.123/24。ブロードキャストアドレスも同じ行の ipv4 アドレスのすぐ後で指定しなくてはなりません。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.ipv4.gateway</option> <option>lxc.network.[i].ipv4.gateway</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify the ipv4 address to use as the gateway inside the specify the ipv4 address to use as the gateway inside the
container. The address is in format x.y.z.t, eg. container. The address is in format x.y.z.t, eg. 192.168.1.123.
192.168.1.123.
Can also have the special value <option>auto</option>, Can also have the special value <option>auto</option>,
which means to take the primary address from the bridge which means to take the primary address from the bridge
...@@ -722,13 +734,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -722,13 +734,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
using the <option>veth</option> and using the <option>veth</option> and
<option>macvlan</option> network types. <option>macvlan</option> network types.
--> -->
コンテナでゲートウェイとして使う IPv4 アドレスを指定します。 コンテナでゲートウェイとして使う IPv4 アドレスを指定します。アドレスは x.y.z.t というフォーマットです。例) 192.168.1.123
アドレスは x.y.z.t というフォーマットです。 <option>auto</option> という特別な値を指定できます。これは (<option>lxc.network.link</option> で指定した) ブリッジインターフェースの最初のアドレスを使用し、それをゲートウェイに使うという意味になります。<option>auto</option> はネットワークタイプとして <option>veth</option> と <option>macvlan</option> を指定している時だけ有効となります。
例えば、192.168.1.123。
<option>auto</option> という特別な値を記述する事も可能です。
これは (<option>lxc.network.link</option> で指定した) ブリッジインターフェースの最初のアドレスを使用し、それをゲートウェイに使うという意味になります。
<option>auto</option> はネットワークタイプとして <option>veth</option> と <option>macvlan</option> を指定している時だけ有効となります。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -736,34 +743,30 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -736,34 +743,30 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.ipv6</option> <option>lxc.network.[i].ipv6</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify the ipv6 address to assign to the virtualized Specify the ipv6 address to assign to the virtualized
interface. Several lines specify several ipv6 addresses. interface. Several lines specify several ipv6 addresses. The
The address is in format x::y/m, address is in format x::y/m, eg.
eg. 2003:db8:1:0:214:1234:fe0b:3596/64 2003:db8:1:0:214:1234:fe0b:3596/64
--> -->
仮想インターフェースに割り当てる ipv6 アドレスを指定します。 仮想インターフェースに割り当てる ipv6 アドレスを指定します。複数行により複数の ipv6 アドレスを指定します。このアドレスは x::y/m というフォーマットで指定します。例) 2003:db8:1:0:214:1234:fe0b:3596/64
複数行により複数の ipv6 アドレスを指定します。
このアドレスは x::y/m というフォーマットで指定します。
例えば、2003:db8:1:0:214:1234:fe0b:3596/64。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.ipv6.gateway</option> <option>lxc.network.[i].ipv6.gateway</option>
</term> </term>
<listitem> <listitem>
<para> <para>
<!-- <!--
specify the ipv6 address to use as the gateway inside the Specify the ipv6 address to use as the gateway inside the
container. The address is in format x::y, container. The address is in format x::y, eg. 2003:db8:1:0::1
eg. 2003:db8:1:0::1
Can also have the special value <option>auto</option>, Can also have the special value <option>auto</option>,
which means to take the primary address from the bridge which means to take the primary address from the bridge
...@@ -773,19 +776,15 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -773,19 +776,15 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
using the <option>veth</option> and using the <option>veth</option> and
<option>macvlan</option> network types. <option>macvlan</option> network types.
--> -->
コンテナでゲートウェイとして使う IPv6 アドレスを指定します。 コンテナでゲートウェイとして使う IPv6 アドレスを指定します。アドレスは x::y というフォーマットです。例) 2003:db8:1:0::1
アドレスは x::y というフォーマットです。例えば、2003:db8:1:0::1。 <option>auto</option> という特別な値を記述する事も可能です。これは (<option>lxc.network.link</option> で指定した) ブリッジインターフェースの最初のアドレスを使用し、それをゲートウェイに使うという意味になります。<option>auto</option> はネットワークタイプとして <option>veth</option> と <option>macvlan</option> を指定している時だけ有効となります。
<option>auto</option> という特別な値を記述する事も可能です。
これは (<option>lxc.network.link</option> で指定した) ブリッジインターフェースの最初のアドレスを使用し、それをゲートウェイに使うという意味になります。
<option>auto</option> はネットワークタイプとして <option>veth</option> と <option>macvlan</option> を指定している時だけ有効となります。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.script.up</option> <option>lxc.network.[i].script.up</option>
</term> </term>
<listitem> <listitem>
<para> <para>
...@@ -801,10 +800,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -801,10 +800,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
type, other arguments may be passed: type, other arguments may be passed:
veth/macvlan/phys. And finally (host-sided) device name. veth/macvlan/phys. And finally (host-sided) device name.
--> -->
ホスト側から使われる、ネットワークの作成と設定が済んだ後に実行するスクリプトを指定します。 ホスト側から使われる、ネットワークの作成と設定が済んだ後に実行するスクリプトを指定します。以下の引数がスクリプトに渡されます: コンテナ名、設定セクション名(net)。
以下の引数がスクリプトに渡されます: コンテナ名、設定セクション名(net)。 その後の引数はスクリプトのフックで使われる設定セクションに依存します。以下がネットワークシステムによって使われます: 実行コンテキスト (up)、ネットワークのタイプ (empty/veth/macvlan/phys)
その後の引数はスクリプトのフックで使われる設定セクションに依存します。
以下がネットワークシステムによって使われます: 実行コンテキスト (up)、ネットワークのタイプ (empty/veth/macvlan/phys)
ネットワークのタイプによっては、更に別の引数が渡されるかもしれません: veth/macvlan/phys の場合 (ホスト側の) デバイス名 ネットワークのタイプによっては、更に別の引数が渡されるかもしれません: veth/macvlan/phys の場合 (ホスト側の) デバイス名
</para> </para>
<para> <para>
...@@ -813,16 +810,14 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -813,16 +810,14 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
Standard error is not logged, but can be captured by the Standard error is not logged, but can be captured by the
hook redirecting its standard error to standard output. hook redirecting its standard error to standard output.
--> -->
スクリプトからの標準出力は debug レベルでロギングされます。 スクリプトからの標準出力は debug レベルでロギングされます。標準エラー出力はロギングされません。しかし、フックの標準エラー出力を標準出力にリダイレクトすることにより保存することは可能です。
標準エラー出力はロギングされません。
しかし、フックの標準エラー出力を標準出力にリダイレクトすることにより保存することは可能です。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term> <term>
<option>lxc.network.script.down</option> <option>lxc.network.[i].script.down</option>
</term> </term>
<listitem> <listitem>
<para> <para>
...@@ -838,10 +833,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -838,10 +833,8 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
type, other arguments may be passed: type, other arguments may be passed:
veth/macvlan/phys. And finally (host-sided) device name. veth/macvlan/phys. And finally (host-sided) device name.
--> -->
ホスト側から使われる、ネットワークを破壊する前に実行するスクリプトを指定します。 ホスト側から使われる、ネットワークを破壊する前に実行するスクリプトを指定します。以下の引数がスクリプトに渡されます: コンテナ名、設定セクション名(net)。
以下の引数がスクリプトに渡されます: コンテナ名、設定セクション名(net)。 その後の引数はスクリプトのフックで使われる設定セクションに依存します。以下がネットワークシステムによって使われます: 実行コンテキスト (up)、ネットワークのタイプ (empty/veth/macvlan/phys)。
その後の引数はスクリプトのフックで使われる設定セクションに依存します。
以下がネットワークシステムによって使われます: 実行コンテキスト (up)、ネットワークのタイプ (empty/veth/macvlan/phys)。
ネットワークのタイプによっては、更に別の引数が渡されるかもしれません: veth/macvlan/phys。そして最後に (ホスト側の) デバイス名が渡されます。 ネットワークのタイプによっては、更に別の引数が渡されるかもしれません: veth/macvlan/phys。そして最後に (ホスト側の) デバイス名が渡されます。
</para> </para>
<para> <para>
...@@ -850,9 +843,7 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -850,9 +843,7 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
Standard error is not logged, but can be captured by the Standard error is not logged, but can be captured by the
hook redirecting its standard error to standard output. hook redirecting its standard error to standard output.
--> -->
スクリプトからの標準出力は debug レベルでロギングされます。 スクリプトからの標準出力は debug レベルでロギングされます。標準エラー出力はロギングされません。しかし、フックの標準エラー出力を標準出力にリダイレクトすることにより保存することは可能です。
標準エラー出力はロギングされません。
しかし、フックの標準エラー出力を標準出力にリダイレクトすることにより保存することは可能です。
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
...@@ -1134,9 +1125,9 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp> ...@@ -1134,9 +1125,9 @@ by KATOH Yasufumi <karma at jazz.email.ne.jp>
マウント情報の書かれた <filename>fstab</filename> フォーマットで書かれたファイルの場所を指定します。 マウント情報の書かれた <filename>fstab</filename> フォーマットで書かれたファイルの場所を指定します。
マウントする場所は相対バスで書くことができます。そして、ほとんどの場合にコンテナの root からの相対パスとなるはずです。例えば、以下のように書きます。 マウントする場所は相対バスで書くことができます。そして、ほとんどの場合にコンテナの root からの相対パスとなるはずです。例えば、以下のように書きます。
</para> </para>
<screen> <programlisting>
proc proc proc nodev,noexec,nosuid 0 0 proc proc proc nodev,noexec,nosuid 0 0
</screen> </programlisting>
<para> <para>
<!-- <!--
Will mount a proc filesystem under the container's /proc, Will mount a proc filesystem under the container's /proc,
...@@ -1144,8 +1135,7 @@ proc proc proc nodev,noexec,nosuid 0 0 ...@@ -1144,8 +1135,7 @@ proc proc proc nodev,noexec,nosuid 0 0
is resilient to block device backed filesystems as well as is resilient to block device backed filesystems as well as
container cloning. container cloning.
--> -->
この例は、root ファイルシステムがどこにあっても、コンテナの /proc 以下に proc ファイルシステムをマウントします。 この例は、root ファイルシステムがどこにあっても、コンテナの /proc 以下に proc ファイルシステムをマウントします。これは、ブロックデバイスがバックエンドのファイルシステムだけでなく、コンテナのクローンにも柔軟に対応できます。
これは、ブロックデバイスがバックエンドのファイルシステムだけでなく、コンテナのクローンにも柔軟に対応できます。
</para> </para>
<para> <para>
<!-- <!--
...@@ -1829,11 +1819,13 @@ proc proc proc nodev,noexec,nosuid 0 0 ...@@ -1829,11 +1819,13 @@ proc proc proc nodev,noexec,nosuid 0 0
--> -->
以下にブラックリストのポリシーの例を示します。これは mknod 以外の全てのシステムコールが許可され、mknod が呼ばれると、何もせずに単に 0(成功) を返します。 以下にブラックリストのポリシーの例を示します。これは mknod 以外の全てのシステムコールが許可され、mknod が呼ばれると、何もせずに単に 0(成功) を返します。
</para> </para>
<screen>
2 <programlisting>
blacklist 2
mknod errno 0 blacklist
</screen> mknod errno 0
</programlisting>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
<term> <term>
...@@ -2631,37 +2623,37 @@ mknod errno 0 ...@@ -2631,37 +2623,37 @@ mknod errno 0
この例は、control group を使って、複雑なネットワークスタックを作成し、新しいホスト名を指定し、いくつかの場所をマウントし、ルートファイルシステムを変更するような複雑な設定を示します。 この例は、control group を使って、複雑なネットワークスタックを作成し、新しいホスト名を指定し、いくつかの場所をマウントし、ルートファイルシステムを変更するような複雑な設定を示します。
</para> </para>
<programlisting> <programlisting>
lxc.utsname = complex lxc.utsname = complex
lxc.network.type = veth lxc.network.0.type = veth
lxc.network.flags = up lxc.network.0.flags = up
lxc.network.link = br0 lxc.network.0.link = br0
lxc.network.hwaddr = 4a:49:43:49:79:bf lxc.network.0.hwaddr = 4a:49:43:49:79:bf
lxc.network.ipv4 = 10.2.3.5/24 10.2.3.255 lxc.network.0.ipv4 = 10.2.3.5/24 10.2.3.255
lxc.network.ipv6 = 2003:db8:1:0:214:1234:fe0b:3597 lxc.network.0.ipv6 = 2003:db8:1:0:214:1234:fe0b:3597
lxc.network.ipv6 = 2003:db8:1:0:214:5432:feab:3588 lxc.network.0.ipv6 = 2003:db8:1:0:214:5432:feab:3588
lxc.network.type = macvlan lxc.network.1.type = macvlan
lxc.network.flags = up lxc.network.1.flags = up
lxc.network.link = eth0 lxc.network.1.link = eth0
lxc.network.hwaddr = 4a:49:43:49:79:bd lxc.network.1.hwaddr = 4a:49:43:49:79:bd
lxc.network.ipv4 = 10.2.3.4/24 lxc.network.1.ipv4 = 10.2.3.4/24
lxc.network.ipv4 = 192.168.10.125/24 lxc.network.1.ipv4 = 192.168.10.125/24
lxc.network.ipv6 = 2003:db8:1:0:214:1234:fe0b:3596 lxc.network.1.ipv6 = 2003:db8:1:0:214:1234:fe0b:3596
lxc.network.type = phys lxc.network.2.type = phys
lxc.network.flags = up lxc.network.2.flags = up
lxc.network.link = dummy0 lxc.network.2.link = dummy0
lxc.network.hwaddr = 4a:49:43:49:79:ff lxc.network.2.hwaddr = 4a:49:43:49:79:ff
lxc.network.ipv4 = 10.2.3.6/24 lxc.network.2.ipv4 = 10.2.3.6/24
lxc.network.ipv6 = 2003:db8:1:0:214:1234:fe0b:3297 lxc.network.2.ipv6 = 2003:db8:1:0:214:1234:fe0b:3297
lxc.cgroup.cpuset.cpus = 0,1 lxc.cgroup.cpuset.cpus = 0,1
lxc.cgroup.cpu.shares = 1234 lxc.cgroup.cpu.shares = 1234
lxc.cgroup.devices.deny = a lxc.cgroup.devices.deny = a
lxc.cgroup.devices.allow = c 1:3 rw lxc.cgroup.devices.allow = c 1:3 rw
lxc.cgroup.devices.allow = b 8:0 rw lxc.cgroup.devices.allow = b 8:0 rw
lxc.mount = /etc/fstab.complex lxc.mount = /etc/fstab.complex
lxc.mount.entry = /lib /root/myrootfs/lib none ro,bind 0 0 lxc.mount.entry = /lib /root/myrootfs/lib none ro,bind 0 0
lxc.rootfs = /mnt/rootfs.complex lxc.rootfs = /mnt/rootfs.complex
lxc.cap.drop = sys_module mknod setuid net_raw lxc.cap.drop = sys_module mknod setuid net_raw
lxc.cap.drop = mac_override lxc.cap.drop = mac_override
</programlisting> </programlisting>
</refsect2> </refsect2>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment