'\" -*- coding: UTF-8 -*- .if \n(.g .ds T< \\FC .if \n(.g .ds T> \\F[\n[.fam]] .de URL \\$2 \(la\\$1\(ra\\$3 .. .if \n(.g .mso www.tmac .TH lxc 7 2019-04-14 "Version 3.0.3 " "" .SH NAME lxc \- Linux コンテナ .SH 概要 コンテナ技術は、メインストリームの Linux Kernel で活発に開発が進んでいる技術です。コンテナ技術は、cgroup によりリソースを管理する機能を提供し、名前空間によりリソースを隔離する機能を提供します。 .PP \fBlxc\fR は、アプリケーションまたはシステムのために完全なリソースの隔離やコントロールを提供する、ユーザースペースのコンテナオブジェクトを提供するためのこれらの新しい機能を使う事を目指しています。 .PP \fBlxc\fR は、シンプルなコマンドラインでコンテナを簡単に管理できるほど軽量で、他の用途に使うのにも十分に機能がそろっています。 .SH 動作条件 カーネルのバージョンが 3.10 以上のディストリビューションであれば、\fBlxc\fR が動作するでしょう。このバージョンは機能は少ないですが、それでも十分楽しめるでしょう。 .PP \fBlxc\fR はカーネルが提供する様々な機能に依存します。\fBlxc-checkconfig\fR がカーネルの設定や、必要な機能、足りない機能についての情報を提供してくれるでしょう。 .SH 機能仕様 コンテナは、ホストのリソースのいくつかを隔離して、内部でアプリケーションやシステムを実行します。 .PP アプリケーションやシステムは、あらかじめ作成した設定や、コマンドへのパラメータで与えた設定で、コンテナ内で実行されます。 .PP コンテナ内でアプリケーションを実行する方法 .PP アプリケーションを実行する前に、隔離したいリソースについて知っておくべきです。デフォルトの設定では、PID、sysv IPC、マウントポイントが隔離されます。コンテナ内でシンプルなシェルを実行したい場合で、特に rootfs を共有したい場合、基本的な設定が必要です。 もし、\fBsshd\fR のようなアプリケーションを実行したい場合、新しいネットワークスタックと、新しいホスト名を準備しなくてはなりません。もし、同じファイル (\*(T<\fI/var/run/httpd.pid\fR\*(T> 等) の衝突を避けたい場合、空の \*(T<\fI/var/run/\fR\*(T> を再度マウントしなければなりません。 どんな場合でも衝突を避けたい場合、コンテナ専用の rootfs を指定することができます。rootfs はディレクトリツリーとする事も可能で、前もって元の rootfs を bind マウントし、\*(T<\fI/etc\fR\*(T> や \*(T<\fI/home\fR\*(T>だけは自身のディレクトリを使って、自身のディストリビューションを使えます。 .PP ここで、\fBsshd\fR のためのディレクトリツリーのサンプルを示しましょう。 .nf \*(T< [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 \*(T> .fi そして、それに対応するマウントポイントのファイルは以下のようになります。 .nf \*(T< [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 \*(T> .fi .PP コンテナ内でシステムを実行する方法 .PP コンテナ内でシステムを実行するのは、逆説的ではありますが、アプリケーションを実行するよりも簡単です。 それは、隔離するリソースについて考える必要がないからで、全てを隔離する必要があるからです。 他のリソースは、コンテナが設定を行うので、設定なしで隔離されるように指定されます。 例えば、IPv4 アドレスはコンテナの init スクリプトでシステムによってセットアップされるでしょう。 以下に、(システムを実行するときの) マウントポイントファイルを示します。 .PP .nf \*(T< [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 \*(T> .fi .SS コンテナのライフサイクル コンテナが作成されるとき、コンテナは設定情報を含みます。プロセスが生成されるとき、コンテナは開始し、実行されるでしょう。コンテナ内で実行されている最後のプロセスが終了したとき、コンテナは停止します。 .PP コンテナの初期化時の失敗の場合は、(以下の図の) 中断の状態を通ります。 .PP .nf \*(T< \-\-\-\-\-\-\-\-\- | STOPPED |<\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\- | | | start | | | V | \-\-\-\-\-\-\-\-\-\- | | STARTING |\-\-error\- | \-\-\-\-\-\-\-\-\-\- | | | | | V V | \-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\- | | RUNNING | | ABORTING | | \-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\- | | | | no process | | | | | V | | \-\-\-\-\-\-\-\-\-\- | | | STOPPING |<\-\-\-\-\-\-\- | \-\-\-\-\-\-\-\-\-\- | | | \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- \*(T> .fi .SS 設定 コンテナは設定ファイル経由で設定します。設定の書式は \fB\*(T<\fIlxc.conf\fR\*(T>\fR(5) で説明しています。 .SS コンテナの作成と削除 持続性のコンテナオブジェクトは \fBlxc-create\fR コマンドで作成できます。コマンドにはコンテナ名をパラメータとして与え、オプションで設定ファイルとテンプレートを指定します。ここで指定する名前は、他のコマンドからこのコンテナを参照する際に使います。 \fBlxc-destroy\fR コマンドはコンテナオブジェクトを削除します。 .nf \*(T< lxc\-create \-n foo lxc\-destroy \-n foo \*(T> .fi .SS "一時的な (揮発性の) コンテナ" コンテナを開始する前にコンテナオブジェクトを作成する必要はありません。パラメータとして設定ファイルを指定して、コンテナを直接起動できます。 .SS コンテナの起動と停止 コンテナが作成されると、アプリケーションもしくはシステムを実行できます。このために使用するのが \fBlxc-execute\fR と \fBlxc-start\fR コマンドです。 アプリケーションを開始する前にコンテナを作成しなかった場合、コンテナはコマンドにパラメータとして渡した設定ファイルを使用します。もし、このようなパラメータもない場合は、デフォルトで指定されている通りに隔離されます。 アプリケーションが終了した場合、コンテナも停止します。\fBlxc-stop\fR コマンドを使って、実行中のアプリケーションを停止することもできます。 .PP コンテナ内でアプリケーションを実行することは、正確にはシステムとして実行するのとは異なります。このため、コンテナ内でアプリケーションを実行するためのコマンドには、2 種類の違ったものがあります。 .nf \*(T< lxc\-execute \-n foo [\-f config] /bin/bash lxc\-start \-n foo [\-f config] [/bin/bash] \*(T> .fi .PP \fBlxc-execute\fR コマンドは、間に \fBlxc-init\fR プロセスを介して、コンテナ内で指定したコマンドを実行します。 lxc-init はコマンドを実行した後、(コンテナ内でのデーモンの実行をサポートするために) 実行したコマンドと生成された全てのプロセスが終了するのを待ちます。 言いかえると、コンテナ内では \fBlxc-init\fR は PID 1 を持ち、アプリケーションの最初のプロセスは PID 2 をもちます。 .PP \fBlxc-start\fR コマンドは、コンテナ内の特定のコマンドを直接実行します。最初のプロセスの PID が 1 となります。 もし、実行するコマンドが指定されていない場合は、\fBlxc-start\fR は lxc.init.cmd で設定されたコマンドを実行します。もし lxc.init.cmd が設定されていない場合は \*(T<\fI/sbin/init\fR\*(T> を実行します。 .PP まとめると、\fBlxc-execute\fR はアプリケーションを実行するためのコマンドであり、\fBlxc-start\fR はシステムを実行するのにより適したコマンドです。 .PP もしアプリケーションの反応がなくなった場合や、アクセスできなくなった場合、自分で終了できない場合は、荒っぽいですが、\fBlxc-stop\fR コマンドがコンテナ内の全てのプロセスを容赦なく停止させてくれるでしょう。 .nf \*(T< lxc\-stop \-n foo \-k \*(T> .fi .SS "利用可能な TTY への接続" コンテナが tty を持つように設定されているならば、tty を通してコンテナにアクセスすることができます。 アクセスできるかどうかは、以下のコマンドが使う tty がコンテナで利用できるように設定されているか次第です。 tty が失われたとき、再度のログインなしでその tty に再接続することが可能です。 .nf \*(T< lxc\-console \-n foo \-t 3 \*(T> .fi .SS コンテナの凍結と解凍 ジョブスケジューリングなどで、コンテナに属する全てのプロセスを停止する事が役に立つときがあります。 コマンド .nf \*(T< lxc\-freeze \-n foo \*(T> .fi は、全てのプロセスを中断不可能な状態に置きます。そして、 .nf \*(T< lxc\-unfreeze \-n foo \*(T> .fi その全てのプロセスを再開します。 .PP この機能は、カーネルで cgroup v1 の freezer コントローラが有効になっている場合に使用できます。 .SS コンテナに関する情報の取得 多数のコンテナが存在する場合、それらが実行されたり削除されたりすること、何が実行されていて、特定のコンテナ内で実行されている PID が何であるかをフォローするのは大変です。このような時には、以下のようなコマンドが役に立つかもしれません。 .nf \*(T< lxc\-ls \-f lxc\-info \-n foo \*(T> .fi .PP \fBlxc-ls\fR はコンテナをリスト表示します。 .PP \fBlxc-info\fR は、指定したコンテナに関する情報を表示します。 .PP ここで、以上のコマンドを組み合わせて、どのようにしたら全てのコンテナのリストと、それぞれの状態が得られるかの例を示します。 .nf \*(T< for i in $(lxc\-ls \-1); do lxc\-info \-n $i done \*(T> .fi .SS コンテナのモニタリング 時々、コンテナの状態を追跡することが出来ると便利な事があります。例えば、状態をモニタリングしたり、スクリプト内で特定の状態を待ったりするような場合です。 .PP \fBlxc-monitor\fR コマンドは、一つもしくは複数のコンテナをモニタリングします。このコマンドのパラメータは、正規表現を受け付けます。例えば .nf \*(T< lxc\-monitor \-n "foo|bar" \*(T> .fi は 'foo' と 'bar' という名前のコンテナの状態をモニタリングします。そして、 .nf \*(T< lxc\-monitor \-n ".*" \*(T> .fi は全てのコンテナの状態をモニタリングします。 .PP コンテナ 'foo' が開始され、いくつか処理を行い、終了した場合、出力は以下のようになります。 .nf \*(T< 'foo' changed state to [STARTING] 'foo' changed state to [RUNNING] 'foo' changed state to [STOPPING] 'foo' changed state to [STOPPED] \*(T> .fi .PP \fBlxc-wait\fR コマンドは指定した状態を待って終了します。これは、コンテナの開始や終了に同期したいスクリプトで役に立ちます。パラメータは、異なった状態の論理和 (OR) を指定します。 以下の例は、バックグラウンドで実行されたコンテナをどのようにして待つかを示します。 .nf \*(T< # 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" \*(T> .fi .SS "コンテナの CGROUP の設定" コンテナは control group と結合しています。コンテナを開始すると cgroup が生成され、結びつけられます。 cgroup のプロパティは、lxc-cgroup コマンドを使って、コンテナが実行中に読み取ったり変更したりできます。 .PP \fBlxc-cgroup\fR コマンドは、コンテナと結びつけられている control group サブシステムを設定したり、取得したりするのに使います。サブシステム名の指定はユーザが行ない、このコマンドはサブシステム名の文法チェックは一切行ないません。もし、指定したサブシステム名が存在しない場合は、コマンドの実行は失敗します。 .PP .nf \*(T< lxc\-cgroup \-n foo cpuset.cpus \*(T> .fi は、このサブシステムの内容を表示します。 .nf \*(T< lxc\-cgroup \-n foo cpu.shares 512 \*(T> .fi は、このサブシステムに指定した値を設定します。 .SH "SEE ALSO" \fBlxc\fR(7), \fBlxc-create\fR(1), \fBlxc-copy\fR(1), \fBlxc-destroy\fR(1), \fBlxc-start\fR(1), \fBlxc-stop\fR(1), \fBlxc-execute\fR(1), \fBlxc-console\fR(1), \fBlxc-monitor\fR(1), \fBlxc-wait\fR(1), \fBlxc-cgroup\fR(1), \fBlxc-ls\fR(1), \fBlxc-info\fR(1), \fBlxc-freeze\fR(1), \fBlxc-unfreeze\fR(1), \fBlxc-attach\fR(1), \fBlxc.conf\fR(5) .SH 作者 Daniel Lezcano <\*(T> .PP Christian Brauner <\*(T> .PP Serge Hallyn <\*(T> .PP Stéphane Graber <\*(T>