mirror of
https://git.proxmox.com/git/mirror_lxc
synced 2025-07-27 05:03:17 +00:00
7f12cae956
lxc-ps and lxc-netstat have an unfortunate tendency to break every so often, produce mostly unreadable output and should be replaced by a lxc-attach call in 99% of the cases. In an effort to cleanup the lxc-* namespace, I think those two should go, so this patch gets rid of them as well as any reference to them in our documentation. I also think that lxc-version should disappear as it's only a one line shell script printing the version string, so having a whole command just for that seems to be a bit of a waste. Instead, this patch introduces a new --version common option which all binaries will automatically inherit and that'll print LXC_VERSION on stdout and exit 0. Signed-off-by: Stéphane Graber <stgraber@ubuntu.com> Acked-by: Serge E. Hallyn <serge.hallyn@ubuntu.com>
916 lines
36 KiB
Plaintext
916 lines
36 KiB
Plaintext
<!--
|
||
|
||
lxc: linux Container library
|
||
|
||
(C) Copyright IBM Corp. 2007, 2008
|
||
|
||
Authors:
|
||
Daniel Lezcano <daniel.lezcano at free.fr>
|
||
|
||
This library is free software; you can redistribute it and/or
|
||
modify it under the terms of the GNU Lesser General Public
|
||
License as published by the Free Software Foundation; either
|
||
version 2.1 of the License, or (at your option) any later version.
|
||
|
||
This library is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
Lesser General Public License for more details.
|
||
|
||
You should have received a copy of the GNU Lesser General Public
|
||
License along with this library; if not, write to the Free Software
|
||
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||
|
||
Translated into Japanese
|
||
by KATOH Yasufumi <karma at jazz.email.ne.jp>
|
||
|
||
-->
|
||
|
||
<!DOCTYPE refentry PUBLIC @docdtd@ [
|
||
|
||
<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
|
||
]>
|
||
|
||
<refentry>
|
||
|
||
<docinfo>
|
||
<date>@LXC_GENERATE_DATE@</date>
|
||
</docinfo>
|
||
|
||
|
||
<refmeta>
|
||
<refentrytitle>lxc</refentrytitle>
|
||
<manvolnum>7</manvolnum>
|
||
<refmiscinfo>
|
||
Version @PACKAGE_VERSION@
|
||
</refmiscinfo>
|
||
</refmeta>
|
||
|
||
<refnamediv>
|
||
<refname>lxc</refname>
|
||
|
||
<refpurpose>
|
||
<!--
|
||
linux containers
|
||
-->
|
||
Linux コンテナ
|
||
</refpurpose>
|
||
</refnamediv>
|
||
|
||
<refsect1>
|
||
<title><!-- Quick start -->クイックスタート</title>
|
||
<para>
|
||
<!--
|
||
You are in a hurry, and you don't want to read this man page. Ok,
|
||
without warranty, here are the commands to launch a shell inside
|
||
a container with a predefined configuration template, it may
|
||
work.
|
||
<command>@BINDIR@/lxc-execute -n foo -f
|
||
@DOCDIR@/examples/lxc-macvlan.conf /bin/bash</command>
|
||
-->
|
||
急いでいて，この man ページすら読みたくないという場合は，いいでしょう，
|
||
保証はないですが，あらかじめ準備されている設定テンプレートを使ったコンテナ内でシェルを動かすためのコマンドを紹介しましょう．
|
||
<command>@BINDIR@/lxc-execute -n foo -f
|
||
@DOCDIR@/examples/lxc-macvlan.conf /bin/bash</command>
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1>
|
||
<title><!-- Overview -->概要</title>
|
||
<para>
|
||
<!--
|
||
The container technology is actively being pushed into the
|
||
mainstream linux kernel. It provides the resource management
|
||
through the control groups aka process containers and resource
|
||
isolation through the namespaces.
|
||
-->
|
||
コンテナ技術は，メインストリームの linux kernel で活発に開発が進んでいる技術です．
|
||
コンテナ技術は，process container という名前でも知られる control groups の機能を使って，リソース管理を提供し，名前空間を使って，リソースの隔離を提供します．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
The linux containers, <command>lxc</command>, aims to use these
|
||
new functionalities to provide an userspace container object
|
||
which provides full resource isolation and resource control for
|
||
an applications or a system.
|
||
-->
|
||
linux コンテナ (<command>lxc</command>) は，ユーザースペースのコンテナオブジェクトを提供するための新しい機能を使う事を目指しています．
|
||
この新しい機能とは，アプリケーションやシステムでの利用を目的とした，完全なリソースの隔離やリソースコントロールを提供する機能です．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
The first objective of this project is to make the life easier
|
||
for the kernel developers involved in the containers project and
|
||
especially to continue working on the Checkpoint/Restart new
|
||
features. The <command>lxc</command> is small enough to easily
|
||
manage a container with simple command lines and complete enough
|
||
to be used for other purposes.
|
||
-->
|
||
このプロジェクトの第一の目的は，コンテナプロジェクトに参加するカーネル開発者の作業を快適にすることと，特に新機能である Checkpoint/Restart 機能への取り組みを続ける事です．
|
||
<command>lxc</command> コマンドは，シンプルなコマンドでコンテナの管理を簡単に行えるように小さく，他の目的のために使うのに充分な機能を持っています．
|
||
</para>
|
||
</refsect1>
|
||
|
||
<refsect1>
|
||
<title><!-- Requirements -->必要条件</title>
|
||
<para>
|
||
<!--
|
||
The <command>lxc</command> relies on a set of functionalities
|
||
provided by the kernel which needs to be active. Depending of
|
||
the missing functionalities the <command>lxc</command> will
|
||
work with a restricted number of functionalities or will simply
|
||
fail.
|
||
-->
|
||
<command>lxc</command> は，カーネルが提供するいくつかの機能に依存しており，その機能がアクティブになっている必要があります．
|
||
機能が足りない場合は，<command>lxc</command> は，いくつかの機能が制限されるか，単純に動作が失敗します．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
The following list gives the kernel features to be enabled in
|
||
the kernel to have the full features container:
|
||
-->
|
||
以下のリストは，コンテナの全機能を有効にするために，カーネルで有効にする必要のある機能の一覧です．
|
||
</para>
|
||
<programlisting>
|
||
* General setup
|
||
* Control Group support
|
||
-> Namespace cgroup subsystem
|
||
-> Freezer cgroup subsystem
|
||
-> Cpuset support
|
||
-> Simple CPU accounting cgroup subsystem
|
||
-> Resource counters
|
||
-> Memory resource controllers for Control Groups
|
||
* Group CPU scheduler
|
||
-> Basis for grouping tasks (Control Groups)
|
||
* Namespaces support
|
||
-> UTS namespace
|
||
-> IPC namespace
|
||
-> User namespace
|
||
-> Pid namespace
|
||
-> Network namespace
|
||
* Device Drivers
|
||
* Character devices
|
||
-> Support multiple instances of devpts
|
||
* Network device support
|
||
-> MAC-VLAN support
|
||
-> Virtual ethernet pair device
|
||
* Networking
|
||
* Networking options
|
||
-> 802.1d Ethernet Bridging
|
||
* Security options
|
||
-> File POSIX Capabilities
|
||
</programlisting>
|
||
|
||
<para>
|
||
<!--
|
||
The kernel version >= 2.6.27 shipped with the distros, will
|
||
work with <command>lxc</command>, this one will have less
|
||
functionalities but enough to be interesting.
|
||
|
||
With the kernel 2.6.29, <command>lxc</command> is fully
|
||
functional.
|
||
|
||
The helper script <command>lxc-checkconfig</command> will give
|
||
you information about your kernel configuration.
|
||
-->
|
||
2.6.27 以上のバージョンが採用されているディストリビューションならば，<command>lxc</command> は動作するでしょう．
|
||
機能的には若干少ない形ですが，充分に楽しめるはずです．
|
||
2.6.29 カーネルであれば，<command>lxc</command> は完全に機能します．
|
||
ヘルパースクリプトの <command>lxc-checkconfig</command> を使って，あなたのカーネルの設定に関する情報を取得できるでしょう．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
Before using the <command>lxc</command>, your system should be
|
||
configured with the file capabilities, otherwise you will need
|
||
to run the <command>lxc</command> commands as root.
|
||
-->
|
||
<command>lxc</command> を使う前に，システムがファイルに対するケーパビリティーをえられるように設定するか，もしくは <command>lxc</command> コマンドを root で実行する必要があるでしょう．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
The control group can be mounted anywhere, eg:
|
||
<command>mount -t cgroup cgroup /cgroup</command>.
|
||
|
||
If you want to dedicate a specific cgroup mount point
|
||
for <command>lxc</command>, that is to have different cgroups
|
||
mounted at different places with different options but
|
||
let <command>lxc</command> to use one location, you can bind
|
||
the mount point with the <option>lxc</option> name, eg:
|
||
<command>mount -t cgroup lxc /cgroup4lxc</command> or
|
||
<command>mount -t cgroup -ons,cpuset,freezer,devices
|
||
lxc /cgroup4lxc</command>
|
||
-->
|
||
control group は，どこにでもマウント可能です．
|
||
例えば，<command>mount -t cgroup cgroup /cgroup</command> のようにです．
|
||
|
||
もし，異なる場所で，異なるオプションでマウントされた別々の cgroup を持ち，一つの場所の <command>lxc</command> コマンドを使うための，特定の <command>lxc</command> のための専用の cgroup のマウントポイントを提供したければ，lxc という名前でマウントポイントにバインドすることが出来ます．例えば以下のようにです．
|
||
<command>mount -t cgroup lxc /cgroup4lxc</command> or
|
||
<command>mount -t cgroup -ons,cpuset,freezer,devices
|
||
lxc /cgroup4lxc</command>
|
||
</para>
|
||
|
||
</refsect1>
|
||
|
||
<refsect1>
|
||
<title><!-- Functional specification -->機能仕様</title>
|
||
<para>
|
||
<!--
|
||
A container is an object isolating some resources of the host,
|
||
for the application or system running in it.
|
||
-->
|
||
コンテナは，コンテナ内で実行されているシステムやアプリケーションに対するホストのリソースのいくつかが，隔離されているオブジェクトです．
|
||
</para>
|
||
<para>
|
||
<!--
|
||
The application / system will be launched inside a
|
||
container specified by a configuration that is either
|
||
initially created or passed as parameter of the starting
|
||
commands.
|
||
-->
|
||
アプリケーション／システムは，あらかじめ作成された設定もしくは開始コマンドのパラメータで指定された設定で，コンテナ内で実行されます．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
How to run an application in a container ?
|
||
-->
|
||
どうやってコンテナ内でアプリケーションを実行するのでしょう?
|
||
</para>
|
||
<para>
|
||
<!--
|
||
Before running an application, you should know what are the
|
||
resources you want to isolate. The default configuration is to
|
||
isolate the pids, the sysv ipc and the mount points. If you want
|
||
to run a simple shell inside a container, a basic configuration
|
||
is needed, especially if you want to share the rootfs. If you
|
||
want to run an application like <command>sshd</command>, you
|
||
should provide a new network stack and a new hostname. If you
|
||
want to avoid conflicts with some files
|
||
eg. <filename>/var/run/httpd.pid</filename>, you should
|
||
remount <filename>/var/run</filename> with an empty
|
||
directory. If you want to avoid the conflicts in all the cases,
|
||
you can specify a rootfs for the container. The rootfs can be a
|
||
directory tree, previously bind mounted with the initial rootfs,
|
||
so you can still use your distro but with your
|
||
own <filename>/etc</filename> and <filename>/home</filename>
|
||
-->
|
||
アプリケーションを実行する前に，隔離したいリソースについて知っておくべきです．
|
||
デフォルトの設定では，pid，sysv ipc，マウントポイントが隔離されます．
|
||
コンテナ内でシンプルなシェルを実行したい場合で，特に rootfs を共有したい場合，基本的な設定が必要です．
|
||
もし，<command>sshd</command> のようなアプリケーションを実行したい場合，新しいネットワークスタックと，新しいホスト名を準備しなくてはなりません．
|
||
もし，同じファイル (<filename>/var/run/httpd.pid</filename> 等) の衝突を避けたい場合，空の <filename>/var/run/</filename> を再度マウントしなければなりません．
|
||
どんな場合でも，衝突を避けたい場合，コンテナ専用の rootfs を指定することができます．
|
||
rootfs はディレクトリツリーとなる事も可能で，前もって元の rootfs を bind マウントし，しかし，自身の <filename>/etc</filename> や <filename>/home</filename>を使って．自身のディストリビューションを使うことが可能です．
|
||
</para>
|
||
<para>
|
||
<!--
|
||
Here is an example of directory tree
|
||
for <command>sshd</command>:
|
||
<programlisting>
|
||
[root@lxc sshd]$ tree -d rootfs
|
||
|
||
rootfs
|
||
|-- bin
|
||
|-- dev
|
||
| |-- pts
|
||
| `-- shm
|
||
| `-- network
|
||
|-- etc
|
||
| `-- ssh
|
||
|-- lib
|
||
|-- proc
|
||
|-- root
|
||
|-- sbin
|
||
|-- sys
|
||
|-- usr
|
||
`-- var
|
||
|-- empty
|
||
| `-- sshd
|
||
|-- lib
|
||
| `-- empty
|
||
| `-- sshd
|
||
`-- run
|
||
`-- sshd
|
||
</programlisting>
|
||
|
||
and the mount points file associated with it:
|
||
<programlisting>
|
||
[root@lxc sshd]$ cat fstab
|
||
|
||
/lib /home/root/sshd/rootfs/lib none ro,bind 0 0
|
||
/bin /home/root/sshd/rootfs/bin none ro,bind 0 0
|
||
/usr /home/root/sshd/rootfs/usr none ro,bind 0 0
|
||
/sbin /home/root/sshd/rootfs/sbin none ro,bind 0 0
|
||
</programlisting>
|
||
-->
|
||
ここで，<command>sshd</command> のためのディレクトリツリーのサンプルを示しましょう．
|
||
<programlisting>
|
||
[root@lxc sshd]$ tree -d rootfs
|
||
|
||
rootfs
|
||
|-- bin
|
||
|-- dev
|
||
| |-- pts
|
||
| `-- shm
|
||
| `-- network
|
||
|-- etc
|
||
| `-- ssh
|
||
|-- lib
|
||
|-- proc
|
||
|-- root
|
||
|-- sbin
|
||
|-- sys
|
||
|-- usr
|
||
`-- var
|
||
|-- empty
|
||
| `-- sshd
|
||
|-- lib
|
||
| `-- empty
|
||
| `-- sshd
|
||
`-- run
|
||
`-- sshd
|
||
</programlisting>
|
||
|
||
そして，それに対応するマウントポイントのファイルは以下のようになります．
|
||
<programlisting>
|
||
[root@lxc sshd]$ cat fstab
|
||
|
||
/lib /home/root/sshd/rootfs/lib none ro,bind 0 0
|
||
/bin /home/root/sshd/rootfs/bin none ro,bind 0 0
|
||
/usr /home/root/sshd/rootfs/usr none ro,bind 0 0
|
||
/sbin /home/root/sshd/rootfs/sbin none ro,bind 0 0
|
||
</programlisting>
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
How to run a system in a container ?
|
||
-->
|
||
コンテナ内でシステムを実行する方法は?
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
Running a system inside a container is paradoxically easier
|
||
than running an application. Why ? Because you don't have to care
|
||
about the resources to be isolated, everything need to be
|
||
isolated, the other resources are specified as being isolated but
|
||
without configuration because the container will set them
|
||
up. eg. the ipv4 address will be setup by the system container
|
||
init scripts. Here is an example of the mount points file:
|
||
|
||
<programlisting>
|
||
[root@lxc debian]$ cat fstab
|
||
|
||
/dev /home/root/debian/rootfs/dev none bind 0 0
|
||
/dev/pts /home/root/debian/rootfs/dev/pts none bind 0 0
|
||
</programlisting>
|
||
|
||
More information can be added to the container to facilitate the
|
||
configuration. For example, make accessible from the container
|
||
the resolv.conf file belonging to the host.
|
||
|
||
<programlisting>
|
||
/etc/resolv.conf /home/root/debian/rootfs/etc/resolv.conf none bind 0 0
|
||
</programlisting>
|
||
-->
|
||
コンテナ内でシステムを実行するのは，逆説的ではありますが，アプリケーションを実行するよりも簡単です．
|
||
それは，隔離するリソースについて考える必要がないからで，全てを隔離する必要があるからです．
|
||
他のリソースは，コンテナが設定を行うので，設定なしで隔離されるように指定されます．
|
||
例えば，IPv4 アドレスはコンテナの init スクリプトでシステムによってセットアップされるでしょう．
|
||
以下に，(システムを実行するときの) マウントポイントファイルを示します．
|
||
|
||
<programlisting>
|
||
[root@lxc debian]$ cat fstab
|
||
|
||
/dev /home/root/debian/rootfs/dev none bind 0 0
|
||
/dev/pts /home/root/debian/rootfs/dev/pts none bind 0 0
|
||
</programlisting>
|
||
|
||
設定を手助けするために，コンテナに更なる情報を追加することも可能です．
|
||
例えば，ホスト上に存在する resolv.conf ファイルをコンテナからアクセス可能にするには，以下のようにします．
|
||
|
||
<programlisting>
|
||
/etc/resolv.conf /home/root/debian/rootfs/etc/resolv.conf none bind 0 0
|
||
</programlisting>
|
||
</para>
|
||
|
||
<refsect2>
|
||
<title><!-- Container life cycle -->コンテナのライフサイクル</title>
|
||
<para>
|
||
<!--
|
||
When the container is created, it contains the configuration
|
||
information. When a process is launched, the container will be
|
||
starting and running. When the last process running inside the
|
||
container exits, the container is stopped.
|
||
-->
|
||
コンテナが作成されるとき，コンテナは設定情報を含みます．
|
||
プロセスが生成されるとき，コンテナは開始し，実行されるでしょう．
|
||
コンテナ内で実行されている最後のプロセスが終了したとき，コンテナは停止します．
|
||
</para>
|
||
<para>
|
||
<!--
|
||
In case of failure when the container is initialized, it will
|
||
pass through the aborting state.
|
||
-->
|
||
コンテナの初期化時の失敗の場合は，(以下の図の) 中断の状態を通ります．
|
||
</para>
|
||
|
||
<programlisting>
|
||
<![CDATA[
|
||
---------
|
||
| STOPPED |<---------------
|
||
--------- |
|
||
| |
|
||
start |
|
||
| |
|
||
V |
|
||
---------- |
|
||
| STARTING |--error- |
|
||
---------- | |
|
||
| | |
|
||
V V |
|
||
--------- ---------- |
|
||
| RUNNING | | ABORTING | |
|
||
--------- ---------- |
|
||
| | |
|
||
no process | |
|
||
| | |
|
||
V | |
|
||
---------- | |
|
||
| STOPPING |<------- |
|
||
---------- |
|
||
| |
|
||
---------------------
|
||
]]>
|
||
</programlisting>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Configuration -->設定</title>
|
||
<para>
|
||
<!--
|
||
The container is configured through a configuration
|
||
file, the format of the configuration file is described in
|
||
<citerefentry>
|
||
<refentrytitle><filename>lxc.conf</filename></refentrytitle>
|
||
<manvolnum>5</manvolnum>
|
||
</citerefentry>
|
||
-->
|
||
</para>
|
||
コンテナは設定ファイル経由で設定します．設定の書式は以下で説明しています．
|
||
<citerefentry>
|
||
<refentrytitle><filename>lxc.conf</filename></refentrytitle>
|
||
<manvolnum>5</manvolnum>
|
||
</citerefentry>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!--Creating / Destroying container
|
||
(persistent container) -->コンテナの生成と終了 (持続性のコンテナ)</title>
|
||
<para>
|
||
<!--
|
||
A persistent container object can be
|
||
created via the <command>lxc-create</command>
|
||
command. It takes a container name as parameter and
|
||
optional configuration file and template.
|
||
The name is used by the different
|
||
commands to refer to this
|
||
container. The <command>lxc-destroy</command> command will
|
||
destroy the container object.
|
||
<programlisting>
|
||
lxc-create -n foo
|
||
lxc-destroy -n foo
|
||
</programlisting>
|
||
-->
|
||
持続性のコンテナオブジェクトは <command>lxc-create</command> コマンドで作成することができます．
|
||
コマンドにはコンテナ名をパラメータとして，オプションで設定ファイルとテンプレートを指定します．
|
||
ここで指定する名前は，他のコマンドからこのコンテナを参照する際に使います．
|
||
<command>lxc-destroy</command> コマンドはコンテナオブジェクトを破壊します．
|
||
<programlisting>
|
||
lxc-create -n foo
|
||
lxc-destroy -n foo
|
||
</programlisting>
|
||
</para>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Volatile container -->揮発性のコンテナ</title>
|
||
<para>
|
||
<!--
|
||
It is not mandatory to create a container object
|
||
before to start it.
|
||
The container can be directly started with a
|
||
configuration file as parameter.
|
||
-->
|
||
コンテナを開始する前にコンテナオブジェクトを作成する必要はありません．
|
||
コンテナを設定ファイルのパラメータで指定して直接開始することができます．
|
||
</para>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Starting / Stopping container -->コンテナの開始と終了</title>
|
||
<para>
|
||
<!--
|
||
When the container has been created, it is ready to run an
|
||
application / system.
|
||
This is the purpose of the <command>lxc-execute</command> and
|
||
<command>lxc-start</command> commands.
|
||
If the container was not created before
|
||
starting the application, the container will use the
|
||
configuration file passed as parameter to the command,
|
||
and if there is no such parameter either, then
|
||
it will use a default isolation.
|
||
If the application is ended, the container will be stopped also,
|
||
but if needed the <command>lxc-stop</command> command can
|
||
be used to kill the still running application.
|
||
-->
|
||
コンテナが作成されると，アプリケーションもしくはシステムとして実行することができます．
|
||
このために使用するのが <command>lxc-execute</command> と <command>lxc-start</command> コマンドです．
|
||
アプリケーションが開始する前にコンテナが作成されなかった場合，コンテナはコマンドへ与えるパラメータを取得するのに設定ファイルを使うでしょう．
|
||
もし，このようなパラメータもない場合は，デフォルトで指定されている通りに隔離されます．
|
||
アプリケーションが終了した場合，コンテナも停止しますが，実行中のアプリケーションを停止するには <command>lxc-stop</command> を使用する必要があります．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
Running an application inside a container is not exactly the
|
||
same thing as running a system. For this reason, there are two
|
||
different commands to run an application into a container:
|
||
<programlisting>
|
||
lxc-execute -n foo [-f config] /bin/bash
|
||
lxc-start -n foo [-f config] [/bin/bash]
|
||
</programlisting>
|
||
-->
|
||
コンテナ内のアプリケーションの実行は，正確にはシステムとして実行するのとは異なります．
|
||
そのような理由で，コンテナ内でアプリケーションを実行するためのコマンドには，2 種類の違ったものがあります．
|
||
<programlisting>
|
||
lxc-execute -n foo [-f config] /bin/bash
|
||
lxc-start -n foo [-f config] [/bin/bash]
|
||
</programlisting>
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
<command>lxc-execute</command> command will run the
|
||
specified command into the container via an intermediate
|
||
process, <command>lxc-init</command>.
|
||
This lxc-init after launching the specified command,
|
||
will wait for its end and all other reparented processes.
|
||
(to support daemons in the container).
|
||
In other words, in the
|
||
container, <command>lxc-init</command> has the pid 1 and the
|
||
first process of the application has the pid 2.
|
||
-->
|
||
<command>lxc-execute</command> コマンドは，<command>lxc-init</command> プロセス経由で，コンテナ内で特定のコマンドを実行します．
|
||
lxc-init はコマンドを実行した後，(コンテナ内でのデーモンの実行をサポートするために) 実行したコマンドと生成された全てのプロセスが終了するのを待ちます．
|
||
言いかえると，コンテナ内では <command>lxc-init</command> は pid 1 を持ち，アプリケーションの最初のプロセスは pid 2 をもちます．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
<command>lxc-start</command> command will run directly the specified
|
||
command into the container.
|
||
The pid of the first process is 1. If no command is
|
||
specified <command>lxc-start</command> will
|
||
run <filename>/sbin/init</filename>.
|
||
-->
|
||
<command>lxc-start</command> コマンドは，コンテナ内の特定のコマンドを直接実行します．
|
||
最初のプロセスの pid が 1 となります．
|
||
もし，実行するコマンドが指定されない場合は，<command>lxc-start</command> は <filename>/sbin/init</filename> を実行します．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
To summarize, <command>lxc-execute</command> is for running
|
||
an application and <command>lxc-start</command> is better suited for
|
||
running a system.
|
||
-->
|
||
まとめると，<command>lxc-execute</command> はアプリケーションを実行するためのコマンドであり，<command>lxc-start</command> はシステムを実行するのにより適したコマンドです．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
If the application is no longer responding, is inaccessible or is
|
||
not able to finish by itself, a
|
||
wild <command>lxc-stop</command> command will kill all the
|
||
processes in the container without pity.
|
||
<programlisting>
|
||
lxc-stop -n foo
|
||
</programlisting>
|
||
-->
|
||
もしアプリケーションの反応がなくなった場合や，アクセスできなくなった場合，自分で終了することができない場合は，荒っぽいですが，<command>lxc-stop</command> コマンドがコンテナ内の全てのプロセスを容赦なく停止させてくれるでしょう．
|
||
</para>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Connect to an available tty -->利用可能な tty への接続</title>
|
||
<para>
|
||
<!--
|
||
If the container is configured with the ttys, it is possible
|
||
to access it through them. It is up to the container to
|
||
provide a set of available tty to be used by the following
|
||
command. When the tty is lost, it is possible to reconnect it
|
||
without login again.
|
||
<programlisting>
|
||
lxc-console -n foo -t 3
|
||
</programlisting>
|
||
-->
|
||
コンテナが tty を持つように設定されているならば，tty を通してコンテナにアクセスすることができます．
|
||
それは以下のコマンドが使う tty がコンテナで利用可能に設定されているか次第です．
|
||
tty が失われたとき，再度のログインなしでその tty に再接続することが可能です．
|
||
<programlisting>
|
||
lxc-console -n foo -t 3
|
||
</programlisting>
|
||
</para>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Freeze / Unfreeze container -->コンテナの凍結と解凍</title>
|
||
<para>
|
||
<!--
|
||
Sometime, it is useful to stop all the processes belonging to
|
||
a container, eg. for job scheduling. The commands:
|
||
<programlisting>
|
||
lxc-freeze -n foo
|
||
</programlisting>
|
||
|
||
will put all the processes in an uninteruptible state and
|
||
|
||
<programlisting>
|
||
lxc-unfreeze -n foo
|
||
</programlisting>
|
||
|
||
will resume them.
|
||
-->
|
||
ジョブスケジューリングなどで，コンテナに属する全てのプロセスを停止する事が役に立つときがあります．
|
||
コマンド
|
||
<programlisting>
|
||
lxc-freeze -n foo
|
||
</programlisting>
|
||
は，全てのプロセスを中断不可能な状態に置きます．そして，
|
||
|
||
<programlisting>
|
||
lxc-unfreeze -n foo
|
||
</programlisting>
|
||
|
||
その全てのプロセスを再開します．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
This feature is enabled if the cgroup freezer is enabled in the
|
||
kernel.
|
||
-->
|
||
この機能は，カーネルで cgroup freezer 機能が有効になっている場合に使用可能です．
|
||
</para>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Getting information about container -->
|
||
コンテナに関する情報の取得</title>
|
||
<para>
|
||
<!--
|
||
When there are a lot of containers, it is hard to follow
|
||
what has been created or destroyed, what is running or what are
|
||
the pids running into a specific container. For this reason, the
|
||
following commands may be useful:
|
||
<programlisting>
|
||
lxc-ls
|
||
lxc-info -n foo
|
||
</programlisting>
|
||
-->
|
||
多数のコンテナが存在する場合，それらが実行されたり破壊されたりすること，何が実行されていて，特定のコンテナ内で実行されている pid が何であるかをフォローするのは大変です．
|
||
このような時には，以下のようなコマンドが役に立つかもしれません．
|
||
<programlisting>
|
||
lxc-ls
|
||
lxc-info -n foo
|
||
</programlisting>
|
||
</para>
|
||
<para>
|
||
<!--
|
||
<command>lxc-ls</command> lists the containers of the
|
||
system.
|
||
-->
|
||
<command>lxc-ls</command> は，システムのコンテナを一覧します．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
<command>lxc-info</command> gives information for a specific
|
||
container.
|
||
-->
|
||
<command>lxc-info</command> は，指定したコンテナに関する情報を取得します．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
Here is an example on how the combination of these commands
|
||
allow to list all the containers and retrieve their state.
|
||
<programlisting>
|
||
for i in $(lxc-ls -1); do
|
||
lxc-info -n $i
|
||
done
|
||
</programlisting>
|
||
-->
|
||
ここで，以上のコマンドを組み合わせて，どのようにしたら全てのコンテナのリストと，それぞれの状態が得られるかの例を示します．
|
||
<programlisting>
|
||
for i in $(lxc-ls -1); do
|
||
lxc-info -n $i
|
||
done
|
||
</programlisting>
|
||
</para>
|
||
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Monitoring container -->コンテナのモニタリング</title>
|
||
<para>
|
||
<!--
|
||
It is sometime useful to track the states of a container,
|
||
for example to monitor it or just to wait for a specific
|
||
state in a script.
|
||
-->
|
||
時々，コンテナの状態を追跡することが出来ると便利な事があります．
|
||
例えば，状態をモニタリングしたり，スクリプト内で特定の状態を待ったりするような場合です．
|
||
</para>
|
||
|
||
<para>
|
||
<!--
|
||
<command>lxc-monitor</command> command will monitor one or
|
||
several containers. The parameter of this command accept a
|
||
regular expression for example:
|
||
<programlisting>
|
||
lxc-monitor -n "foo|bar"
|
||
</programlisting>
|
||
will monitor the states of containers named 'foo' and 'bar', and:
|
||
<programlisting>
|
||
lxc-monitor -n ".*"
|
||
</programlisting>
|
||
will monitor all the containers.
|
||
-->
|
||
<command>lxc-monitor</command> コマンドは，一つもしくはいくつかのコンテナをモニタリングします．
|
||
このコマンドのパラメータは，正規表現を受け付けます．例えば
|
||
<programlisting>
|
||
lxc-monitor -n "foo|bar"
|
||
</programlisting>
|
||
は 'foo' と 'bar' という名前のコンテナの状態をモニタリングします．そして，
|
||
<programlisting>
|
||
lxc-monitor -n ".*"
|
||
</programlisting>
|
||
は全てのコンテナの状態をモニタリングします．
|
||
</para>
|
||
<para>
|
||
<!--
|
||
For a container 'foo' starting, doing some work and exiting,
|
||
the output will be in the form:
|
||
<programlisting>
|
||
'foo' changed state to [STARTING]
|
||
'foo' changed state to [RUNNING]
|
||
'foo' changed state to [STOPPING]
|
||
'foo' changed state to [STOPPED]
|
||
</programlisting>
|
||
-->
|
||
コンテナ 'foo' が開始され，いくつか処理を行い，終了した場合，出力は以下のようになります．
|
||
<programlisting>
|
||
'foo' changed state to [STARTING]
|
||
'foo' changed state to [RUNNING]
|
||
'foo' changed state to [STOPPING]
|
||
'foo' changed state to [STOPPED]
|
||
</programlisting>
|
||
</para>
|
||
<para>
|
||
<!--
|
||
<command>lxc-wait</command> command will wait for a specific
|
||
state change and exit. This is useful for scripting to
|
||
synchronize the launch of a container or the end. The
|
||
parameter is an ORed combination of different states. The
|
||
following example shows how to wait for a container if he went
|
||
to the background.
|
||
|
||
<programlisting>
|
||
<![CDATA[
|
||
# launch lxc-wait in background
|
||
lxc-wait -n foo -s STOPPED &
|
||
LXC_WAIT_PID=$!
|
||
|
||
# this command goes in background
|
||
lxc-execute -n foo mydaemon &
|
||
|
||
# block until the lxc-wait exits
|
||
# and lxc-wait exits when the container
|
||
# is STOPPED
|
||
wait $LXC_WAIT_PID
|
||
echo "'foo' is finished"
|
||
]]>
|
||
</programlisting>
|
||
-->
|
||
<command>lxc-wait</command> コマンドは指定した状態を待って，終了します．
|
||
これは，コンテナの開始や終了に同期したいスクリプトで役に立ちます．
|
||
パラメータは，異なった状態の論理和 (OR) を指定します．
|
||
以下の例は，バックグラウンドで実行されたコンテナをどのようにして待つかを示します．
|
||
|
||
<programlisting>
|
||
<![CDATA[
|
||
# launch lxc-wait in background
|
||
lxc-wait -n foo -s STOPPED &
|
||
LXC_WAIT_PID=$!
|
||
|
||
# this command goes in background
|
||
lxc-execute -n foo mydaemon &
|
||
|
||
# block until the lxc-wait exits
|
||
# and lxc-wait exits when the container
|
||
# is STOPPED
|
||
wait $LXC_WAIT_PID
|
||
echo "'foo' is finished"
|
||
]]>
|
||
</programlisting>
|
||
</para>
|
||
</refsect2>
|
||
|
||
<refsect2>
|
||
<title><!-- Setting the control group for container -->
|
||
コンテナの control group の設定
|
||
</title>
|
||
<para>
|
||
<!--
|
||
The container is tied with the control groups, when a
|
||
container is started a control group is created and associated
|
||
with it. The control group properties can be read and modified
|
||
when the container is running by using the lxc-cgroup command.
|
||
-->
|
||
コンテナは control group と結合しています．
|
||
コンテナが開始すると control group が生成され，それと結びつけられます．
|
||
control group のプロパティは，lxc-cgroup コマンドを使って，コンテナが実行中に読み取ったり，変更したりすることができます．
|
||
</para>
|
||
<para>
|
||
<!--
|
||
<command>lxc-cgroup</command> command is used to set or get a
|
||
control group subsystem which is associated with a
|
||
container. The subsystem name is handled by the user, the
|
||
command won't do any syntax checking on the subsystem name, if
|
||
the subsystem name does not exists, the command will fail.
|
||
-->
|
||
<command>lxc-cgroup</command> コマンドは，コンテナと結びつけられている control group サブシステムを設定したり，取得したりするのに使います．
|
||
サブシステム名の指定はユーザが行ない，このコマンドはサブシステム名の文法チェックは一切行ないません．
|
||
もし，指定したサブシステム名が存在しない場合は，コマンドの実行は失敗します．
|
||
</para>
|
||
<para>
|
||
<!--
|
||
<programlisting>
|
||
lxc-cgroup -n foo cpuset.cpus
|
||
</programlisting>
|
||
will display the content of this subsystem.
|
||
<programlisting>
|
||
lxc-cgroup -n foo cpu.shares 512
|
||
</programlisting>
|
||
will set the subsystem to the specified value.
|
||
-->
|
||
<programlisting>
|
||
lxc-cgroup -n foo cpuset.cpus
|
||
</programlisting>
|
||
は，このサブシステムの内容を表示します．
|
||
<programlisting>
|
||
lxc-cgroup -n foo cpu.shares 512
|
||
</programlisting>
|
||
は，このサブシステムに指定した値を設定します．
|
||
</para>
|
||
</refsect2>
|
||
</refsect1>
|
||
|
||
<refsect1>
|
||
<title><!-- Bugs -->バグ</title>
|
||
<para>
|
||
<!--
|
||
The <command>lxc</command> is still in development, so the
|
||
command syntax and the API can change. The version 1.0.0 will be
|
||
the frozen version.
|
||
-->
|
||
<command>lxc</command> はまだ開発中です．
|
||
従って，コマンドの文法や API は変更される可能性があります．
|
||
バージョン 1.0.0 がそれらを凍結するバージョンとなるでしょう．
|
||
</para>
|
||
</refsect1>
|
||
|
||
&seealso;
|
||
|
||
<refsect1>
|
||
<title><!-- Author -->作者</title>
|
||
<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
|
||
</refsect1>
|
||
|
||
</refentry>
|
||
|
||
<!-- Keep this comment at the end of the file Local variables: mode:
|
||
sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil
|
||
sgml-always-quote-attributes:t sgml-indent-step:2 sgml-indent-data:t
|
||
sgml-parent-document:nil sgml-default-dtd-file:nil
|
||
sgml-exposed-tags:nil sgml-local-catalogs:nil
|
||
sgml-local-ecat-files:nil End: -->
|