Debian Codegraph @

doc/ja/lxc-autostart.sgml.in

raw
1 <!-- SPDX-License-Identifier: LGPL-2.1+ -->
2
3 <!DOCTYPE refentry PUBLIC @docdtd@ [
4 <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
5 <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
6 ]>
7
8 <refentry>
9 <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
10 <refmeta>
11 <refentrytitle>lxc-autostart</refentrytitle>
12 <manvolnum>1</manvolnum>
13 </refmeta>
14
15 <refnamediv>
16 <refname>lxc-autostart</refname>
17
18 <refpurpose>
19 <!--
20 start/stop/kill auto-started containers
21 -->
22 自動起動の設定がされたコンテナの開始/停止/kill
23 </refpurpose>
24 </refnamediv>
25
26 <refsynopsisdiv>
27 <cmdsynopsis>
28 <command>lxc-autostart</command>
29 <arg choice="opt">-k</arg>
30 <arg choice="opt">-L</arg>
31 <arg choice="opt">-r</arg>
32 <arg choice="opt">-s</arg>
33 <arg choice="opt">-a</arg>
34 <arg choice="opt">-A</arg>
35 <arg choice="opt">-g <replaceable>groups</replaceable></arg>
36 <arg choice="opt">-t <replaceable>timeout</replaceable></arg>
37 </cmdsynopsis>
38 </refsynopsisdiv>
39
40 <refsect1>
41 <title><!-- Description -->説明</title>
42
43 <para>
44 <!--
45 <command>lxc-autostart</command> processes containers
46 with lxc.start.auto set. It lets the user start, shutdown,
47 kill, restart containers in the right order, waiting the
48 right time. Supports filtering by lxc.group or just run
49 against all defined containers. It can also be used by
50 external tools in list mode where no action will be performed
51 and the list of affected containers (and if relevant, delays)
52 will be shown.
53 -->
54 <command>lxc-autostart</command> は lxc.start.auto が設定されたコンテナの処理を行います。
55 ユーザがコンテナの開始、シャットダウン、kill、再起動を、設定した時間間隔で、設定した順番で行えるようにします。
56 lxc.group でのフィルタリングによって、もしくは定義された全てのコンテナを実行します。
57 何の動作も行わず、対象のコンテナ (とコンテナに設定された起動待機時間) のリストを表示するリストモードを外部ツールから使用することも可能です。
58 </para>
59
60 <para>
61 <!--
62 The <optional>-r</optional>, <optional>-s</optional>
63 and <optional>-k</optional> options specify the action to perform.
64 If none is specified, then the containers will be started.
65 <optional>-a</optional> and <optional>-g</optional> are used to
66 specify which containers will be affected. By default only
67 containers without a lxc.group set will be affected.
68 <optional>-t TIMEOUT</optional> specifies the maximum amount
69 of time to wait for the container to complete the shutdown
70 or reboot.
71 -->
72 <optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional> オプションは実行する動作を指定します。何も指定しない場合は、コンテナを起動します。
73 <optional>-a</optional>, <optional>-g</optional> は、どのコンテナを対象にするかを指定するのに使います。デフォルトでは、lxc.group が指定されていないコンテナにだけが対象となります。
74 <optional>-t TIMEOUT</optional> はコンテナが完全にシャットダウンもしくはリブートを待つ最大時間を指定します。
75 </para>
76 </refsect1>
77
78 <refsect1>
79 <title><!-- Options -->オプション</title>
80 <variablelist>
81 <varlistentry>
82 <term>
83 <option>-r,--reboot </option>
84 </term>
85 <listitem>
86 <para>
87 <!--
88 Request a reboot of the container.
89 -->
90 コンテナのリブートを要求します。
91 </para>
92 </listitem>
93 </varlistentry>
94
95 <varlistentry>
96 <term>
97 <option>-s,--shutdown </option>
98 </term>
99 <listitem>
100 <para>
101 <!--
102 Request a clean shutdown. If a
103 <optional>-t timeout</optional> greater than 0 is
104 given and the container has not shut down within
105 this period, it will be killed as with the
106 <optional>-k kill</optional> option.
107 -->
108 クリーンなシャットダウンを要求します。もし、<optional>-t timeout</optional> が 0 より大きい場合で、コンテナがこの時間内にシャットダウンしない場合は、コンテナは <optional>-k kill</optional> オプションを指定した時のように kill されます。
109 </para>
110 </listitem>
111 </varlistentry>
112
113 <varlistentry>
114 <term>
115 <option>-k,--kill </option>
116 </term>
117 <listitem>
118 <para>
119 <!--
120 Rather than requesting a clean shutdown of the
121 container, explicitly kill all tasks in the container.
122 -->
123 コンテナのクリーンなシャットダウンを要求するのではなく、明確にコンテナの全てのタスクを kill します。
124 </para>
125 </listitem>
126 </varlistentry>
127
128 <varlistentry>
129 <term>
130 <option>-L,--list </option>
131 </term>
132 <listitem>
133 <para>
134 <!--
135 Rather than performing the action, just print
136 the container name and wait delays until starting the next container.
137 -->
138 実際の動作は行わず、コンテナ名と次のコンテナを開始するまでの間隔の表示だけを行います。
139 </para>
140 </listitem>
141 </varlistentry>
142
143 <varlistentry>
144 <term>
145 <option>-t,--timeout <replaceable>TIMEOUT</replaceable></option>
146 </term>
147 <listitem>
148 <para>
149 <!--
150 Wait TIMEOUT seconds before hard-stopping the container.
151 -->
152 コンテナの強制停止まで TIMEOUT 秒待ちます。
153 </para>
154 </listitem>
155 </varlistentry>
156
157 <varlistentry>
158 <term>
159 <option>-g,--groups <replaceable>GROUP</replaceable></option>
160 </term>
161 <listitem>
162 <para>
163 <!--
164 Comma separated list of groups to select
165 (defaults to those without a lxc.group - the NULL group).
166 This option may be specified multiple times
167 and the arguments concatenated. The NULL or
168 empty group may be specified as a leading comma,
169 trailing comma, embedded double comma, or empty
170 argument where the NULL group should be processed.
171 Groups are processed in the order specified on the
172 command line. Multiple invocations of the -g option
173 may be freely intermixed with the comma separated
174 lists and will be combined in specified order.
175 -->
176 対象にするコンテナのグループのカンマ区切りのリスト (デフォルトでは lxc.group 指定のないコンテナ、つまり NULL グループが対象になります)。
177 このオプションは複数回指定することができ、オプションは連結されます。NULL もしくは空のグループは、NULL グループを処理すべき場所に指定された先頭のカンマ、末尾のカンマ、途中に現れる 2 つ続きのカンマ、空のオプション引数で指定することができます。
178 グループはコマンドラインで指定された順番に処理されます。-g オプションの複数回の呼び出しはカンマ区切りのリストと自由に混ぜることができ、指定した順番に連結されます。
179 </para>
180 </listitem>
181 </varlistentry>
182
183 <varlistentry>
184 <term>
185 <option>-a,--all</option>
186 </term>
187 <listitem>
188 <para>
189 <!--
190 Ignore lxc.group and select all auto-started containers.
191 -->
192 lxc.group の指定を無視して、自動起動が設定されているコンテナを全て選択します。
193 </para>
194 </listitem>
195 </varlistentry>
196
197 <varlistentry>
198 <term>
199 <option>-A,--ignore-auto</option>
200 </term>
201 <listitem>
202 <para>
203 <!--
204 Ignore the lxc.start.auto flag. Combined with
205 -a, will select all containers on the system.
206 -->
207 lxc.start.auto で設定されているフラグを無視します。-a と組み合わせることにより、システム上の全てのコンテナを選択します。
208 </para>
209 </listitem>
210 </varlistentry>
211 </variablelist>
212 </refsect1>
213
214 <refsect1>
215 <title><!-- Autostart and System Boot -->自動起動とシステムブート</title>
216
217 <para>
218 <!--
219 The <command>lxc-autostart</command> command is used as part of the
220 LXC system service, when enabled to run on host system at bootup and at
221 shutdown. It's used to select which containers to start in what order
222 and how much to delay between each startup when the host system boots.
223 -->
224 <command>lxc-autostart</command> コマンドは、LXC システムサービスがホストシステムのブートおよびシャットダウン時に実行するように有効化されているとき、LXC システムサービスの一部として使用されます。
225 このコマンドはホストシステムのブート時に、どのコンテナをどういう順番で、それぞれのコンテナの起動間隔をどれくらい開けるかを選択するのに使います。
226 </para>
227
228 <para>
229 <!--
230 Each container can be part of any number of groups or no group at all.
231 Two groups are special. One is the NULL group, i.e. the container does
232 not belong to any group. The other group is the "onboot" group.
233 -->
234 コンテナはいくつでもグループに属することができ、全く属さないことも可能です。特別なグループが 2 つ存在します。1 つは NULL グループです。これはどのグループにも属さないコンテナです。もう 1 つは "onboot" グループです。
235 </para>
236
237 <para>
238 <!--
239 When the system boots with the LXC service enabled, it will first
240 attempt to boot any containers with lxc.start.auto == 1 that is a member
241 of the "onboot" group. The startup will be in order of lxc.start.order.
242 If an lxc.start.delay has been specified, that delay will be honored
243 before attempting to start the next container to give the current
244 container time to begin initialization and reduce overloading the host
245 system. After starting the members of the "onboot" group, the LXC system
246 will proceed to boot containers with lxc.start.auto == 1 which are not
247 members of any group (the NULL group) and proceed as with the onboot
248 group.
249 -->
250 LXC サービスが有効になった状態でシステムがブートすると、最初に "onboot" グループのメンバーである lxc.start.auto == 1 が設定されたコンテナを起動しようとします。起動は lxc.start.order の順に起動します。
251 lxc.start.delay が指定されている場合、現在対象となっているコンテナに初期化の時間を与え、ホストシステムの負荷を低減するために、次のコンテナを開始させるまでに遅延時間を与えます。
252 "onboot" グループのメンバーが開始した後、LXC システムは lxc.start.auto == 1 が設定された、どのグループのメンバーでもない (NULL グループの) コンテナのブートを onboot グループのコンテナと同様に開始します。
253 </para>
254 </refsect1>
255
256 <refsect1>
257 <title><!-- Startup Group Examples -->スタートアップグループの例</title>
258 <variablelist>
259 <varlistentry>
260 <term>
261 <option>-g "onboot,"</option>
262 </term>
263 <listitem>
264 <para>
265 <!--
266 Start the "onboot" group first then the NULL group.
267 -->
268 まず最初に "onboot" グループの処理を開始し、その後 NULL グループの処理を開始します。
269 </para>
270 <para>
271 <!--
272 This is the equivalent of: <option>-g onboot -g ""</option>.
273 -->
274 これは以下と等価です: <option>-g onboot -g ""</option>
275 </para>
276 </listitem>
277 </varlistentry>
278 <varlistentry>
279 <term>
280 <option>-g "dns,web,,onboot"</option>
281 </term>
282 <listitem>
283 <para>
284 <!--
285 Starts the "dns" group first, the "web" group second, then
286 the NULL group followed by the "onboot" group.
287 -->
288 まず最初に "dns" グループの処理を開始し、2 番目に "web" グループ、その後 NULL グループ、"onboot" グループの順に処理を開始します。
289 </para>
290 <para>
291 <!--
292 This is the equivalent of: <option>-g dns,web -g ,onboot</option> or <option>-g dns -g web -g "" -g onboot</option>.
293 -->
294 これは以下と等価です: <option>-g dns,web -g ,onboot</option> もしくは <option>-g dns -g web -g "" -g onboot</option>
295 </para>
296 </listitem>
297 </varlistentry>
298 </variablelist>
299 </refsect1>
300
301 &seealso;
302 </refentry>
303
304 <!-- Keep this comment at the end of the file
305 Local variables:
306 mode: sgml
307 sgml-omittag:t
308 sgml-shorttag:t
309 sgml-minimize-attributes:nil
310 sgml-always-quote-attributes:t
311 sgml-indent-step:2
312 sgml-indent-data:t
313 sgml-parent-document:nil
314 sgml-default-dtd-file:nil
315 sgml-exposed-tags:nil
316 sgml-local-catalogs:nil
317 sgml-local-ecat-files:nil
318 End:
319 -->