doc/ko/lxc-autostart.sgml.in

   1 <!--
   2
   3 lxc-autostart
   4
   5 (C) Copyright 2013 Canonical Ltd.
   6
   7 Authors:
   8 Stéphane Graber <stgraber@ubuntu.com>
   9
  10 This library is free software; you can redistribute it and/or
  11 modify it under the terms of the GNU Lesser General Public
  12 License as published by the Free Software Foundation; either
  13 version 2.1 of the License, or (at your option) any later version.
  14
  15 This library is distributed in the hope that it will be useful,
  16 but WITHOUT ANY WARRANTY; without even the implied warranty of
  17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  18 Lesser General Public License for more details.
  19
  20 You should have received a copy of the GNU Lesser General Public
  21 License along with this library; if not, write to the Free Software
  22 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  23
  24 Translated into Korean
  25 by Sungbae Yoo <sungbae.yoo at samsung.com>
  26
  27 -->
  28
  29 <!DOCTYPE refentry PUBLIC @docdtd@ [
  30     <!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
  31     <!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
  32 ]>
  33
  34 <refentry>
  35     <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
  36     <refmeta>
  37         <refentrytitle>lxc-autostart</refentrytitle>
  38         <manvolnum>1</manvolnum>
  39     </refmeta>
  40
  41     <refnamediv>
  42         <refname>lxc-autostart</refname>
  43
  44         <refpurpose>
  45           <!--
  46             start/stop/kill auto-started containers
  47             -->
  48           자동시작하게 설정된 컨테이너의 시작/종료/강제종료
  49         </refpurpose>
  50     </refnamediv>
  51
  52     <refsynopsisdiv>
  53         <cmdsynopsis>
  54             <command>lxc-autostart</command>
  55             <arg choice="opt">-k</arg>
  56             <arg choice="opt">-L</arg>
  57             <arg choice="opt">-r</arg>
  58             <arg choice="opt">-s</arg>
  59             <arg choice="opt">-a</arg>
  60             <arg choice="opt">-A</arg>
  61             <arg choice="opt">-g <replaceable>groups</replaceable></arg>
  62             <arg choice="opt">-t <replaceable>timeout</replaceable></arg>
  63         </cmdsynopsis>
  64     </refsynopsisdiv>
  65
  66     <refsect1>
  67         <title><!-- Description -->설명</title>
  68
  69         <para>
  70           <!--
  71             <command>lxc-autostart</command> processes containers
  72             with lxc.start.auto set. It lets the user start, shutdown,
  73             kill, restart containers in the right order, waiting the
  74             right time. Supports filtering by lxc.group or just run
  75             against all defined containers. It can also be used by
  76             external tools in list mode where no action will be performed
  77             and the list of affected containers (and if relevant, delays)
  78             will be shown.
  79             -->
  80           <command>lxc-autostart</command>는 lxc.start.auto가 설정되어 있는 컨테이너들을 다룬다.
  81           사용자가 컨테이너의 시작, 종료, 강제종료, 재시작의 순서와 대기 시간을 정할 수 있게 해준다.
  82           lxc.group으로 필터링하거나 모든 정의된 컨테이너를 실행하는 등의 동작을 지원한다.
  83           또한 리스트 모드를 통해 외부 툴이 이를 사용할 수 있고, 대상 컨테이너의 리스트와 대기시간 등을 얻어올 수 있다.
  84         </para>
  85
  86         <para>
  87           <!--
  88             The <optional>-r</optional>, <optional>-s</optional>
  89             and <optional>-k</optional> options specify the action to perform.
  90             If none is specified, then the containers will be started.
  91             <optional>-a</optional> and <optional>-g</optional> are used to
  92             specify which containers will be affected. By default only
  93             containers without a lxc.group set will be affected.
  94             <optional>-t TIMEOUT</optional> specifies the maximum amount
  95             of time to wait for the container to complete the shutdown
  96             or reboot.
  97             -->
  98           <optional>-r</optional>, <optional>-s</optional>, <optional>-k</optional> 옵션은 어떤 동작을 수행할지 지정해 줄 수 있다. 만약 아무것도 지정하지 않았다면, 컨테이너를 시작한다.
  99           <optional>-a</optional>, <optional>-g</optional>는 어떤 컨테이너를 대상으로 할지 지정한다. 기본적으로 lxc.group가 지정되지 않은 컨테이너들이 대상이 된다.
 100           <optional>-t TIMEOUT</optional>은 컨테이너가 종료나 재부팅을 마칠 때까지 기다릴 최대 시간을 지정한다.
 101         </para>
 102     </refsect1>
 103
 104     <refsect1>
 105         <title><!-- Options -->옵션</title>
 106         <variablelist>
 107             <varlistentry>
 108                 <term>
 109                     <option>-r,--reboot </option>
 110                 </term>
 111                 <listitem>
 112                     <para>
 113                       <!--
 114                         Request a reboot of the container.
 115                         -->
 116                       컨테이너가 재부팅하도록 요청한다.
 117                     </para>
 118                 </listitem>
 119             </varlistentry>
 120
 121             <varlistentry>
 122                 <term>
 123                     <option>-s,--shutdown </option>
 124                 </term>
 125                 <listitem>
 126                     <para>
 127                       <!--
 128                         Request a clean shutdown. If a
 129                         <optional>-t timeout</optional> greater than 0 is
 130                         given and the container has not shut down within
 131                         this period, it will be killed as with the
 132                         <optional>-k kill</optional> option.
 133                         -->
 134                        깔끔한 종료를 요청한다. 만약 <optional>-t timeout</optional>가 0보다 크고 컨테이너가 그 기간안에 종료되지 않는다면 <optional>-k kill</optional> 옵션과 같은 동작을 수행하여 강제종료 한다.
 135                     </para>
 136                 </listitem>
 137             </varlistentry>
 138
 139             <varlistentry>
 140                 <term>
 141                     <option>-k,--kill </option>
 142                 </term>
 143                 <listitem>
 144                     <para>
 145                       <!--
 146                         Rather than requesting a clean shutdown of the
 147                         container, explicitly kill all tasks in the container.
 148                         -->
 149                       깔끔한 종료를 요청하는 것이 아니라 컨테이너의 모든 태스크들을 명시적으로 강제종료 시킨다.
 150                     </para>
 151                 </listitem>
 152             </varlistentry>
 153
 154             <varlistentry>
 155                 <term>
 156                     <option>-L,--list </option>
 157                 </term>
 158                 <listitem>
 159                     <para>
 160                       <!--
 161                         Rather than performing the action, just print
 162                         the container name and wait delays until starting the next container.
 163                         -->
 164                       실제 동작은 수행하지 않고, 단지 컨테이너의 이름과 다음 컨테이너를 시작할 때까지의 대기시간들을 표시한다.
 165                     </para>
 166                 </listitem>
 167             </varlistentry>
 168
 169             <varlistentry>
 170                 <term>
 171                     <option>-t,--timeout <replaceable>TIMEOUT</replaceable></option>
 172                 </term>
 173                 <listitem>
 174                     <para>
 175                       <!--
 176                         Wait TIMEOUT seconds before hard-stopping the container.
 177                         -->
 178                       컨테이너가 강제종료되기 전까지 TIMEOUT 초만큼 기다린다.
 179                     </para>
 180                 </listitem>
 181             </varlistentry>
 182
 183             <varlistentry>
 184                 <term>
 185                     <option>-g,--group <replaceable>GROUP</replaceable></option>
 186                 </term>
 187                 <listitem>
 188                     <para>
 189                       <!--
 190                         Comma separated list of groups to select
 191                         (defaults to those without a lxc.group - the NULL group).
 192                         This option may be specified multiple times
 193                         and the arguments concatenated.  The NULL or
 194                         empty group may be specified as a leading comma,
 195                         trailing comma, embedded double comma, or empty
 196                         argument where the NULL group should be processed.
 197                         Groups are processed in the order specified on the
 198                         command line.  Multiple invocations of the -g option
 199                         may be freely intermixed with the comma separated
 200                         lists and will be combined in specified order.
 201                         -->
 202                       쉼표(,)로 구분된 선택할 그룹의 리스트.
 203                       (기본값은 lxc.group이 없는 것이다 - NULL 그룹)
 204
 205                       이 옵션은 여러번 지정될 수 있으며, 각 옵션들은 연결될 수 있다. NULL 또는 빈 그룹은 첫번째 쉼표, 맨 뒤의 쉼표, 두개의 쉼표 등으로 지정할 수 있다. 그룹들은 지정한 순서대로 처리된다. 여러번 호출된 -g 옵션과 콤마로 구분된 목록들은 자유롭게 혼용하여 사용 할 수 있다.
 206                     </para>
 207                 </listitem>
 208             </varlistentry>
 209
 210             <varlistentry>
 211                 <term>
 212                     <option>-a,--all</option>
 213                 </term>
 214                 <listitem>
 215                     <para>
 216                       <!--
 217                         Ignore lxc.group and select all auto-started containers.
 218                         -->
 219                       lxc.group를 무시하고 모든 자동 시작하게 설정된 컨테이너들을 선택한다.
 220                     </para>
 221                 </listitem>
 222             </varlistentry>
 223
 224             <varlistentry>
 225                 <term>
 226                     <option>-A,--ignore-auto</option>
 227                 </term>
 228                 <listitem>
 229                     <para>
 230                       <!--
 231                         Ignore the lxc.start.auto flag. Combined with
 232                         -a, will select all containers on the system.
 233                         -->
 234                       lxc.start.auto 옵션을 무시하고 시스템의 모든 컨테이너를 선택한다.
 235                     </para>
 236                 </listitem>
 237             </varlistentry>
 238         </variablelist>
 239     </refsect1>
 240
 241     <refsect1>
 242         <title><!-- Autostart and System Boot -->자동시작과 시스템 부팅</title>
 243
 244         <para>
 245           <!--
 246             The <command>lxc-autostart</command> command is used as part of the
 247             LXC system service, when enabled to run on host system at bootup and at
 248             shutdown.  It's used to select which containers to start in what order
 249             and how much to delay between each startup when the host system boots.
 250             -->
 251           부팅과 종료시 호스트의 시스>템에서 실행되도록 활성화 되어있을 때, <command>lxc-autostart</command> 명령어는 LXC 시스템 서비스의 일부로 사용된다. 어떤 컨테이너를 어떤 순서로 얼마만큼 간격을 두어 시작할지 선택하는데 사용된다.
 252         </para>
 253
 254         <para>
 255           <!--
 256             Each container can be part of any number of groups or no group at all.
 257             Two groups are special. One is the NULL group, i.e. the container does
 258             not belong to any group. The other group is the "onboot" group.
 259             -->
 260           각각의 컨테이너는 여러 그룹에 속할수도 있고 아무그룹에도 속하지 않을 수 있다. 두개의 그룹은 특수한데, 하나는 NULL 그룹이고 컨테이너가 아무그룹에도 속하지 않을때 사용된다. 그리고 나머지 하나는 "onboot" 그룹이다.
 261         </para>
 262
 263         <para>
 264           <!--
 265             When the system boots with the LXC service enabled, it will first
 266             attempt to boot any containers with lxc.start.auto == 1 that is a member
 267             of the "onboot" group. The startup will be in order of lxc.start.order.
 268             If an lxc.start.delay has been specified, that delay will be honored
 269             before attempting to start the next container to give the current
 270             container time to begin initialization and reduce overloading the host
 271             system. After starting the members of the "onboot" group, the LXC system
 272             will proceed to boot containers with lxc.start.auto == 1 which are not
 273             members of any group (the NULL group) and proceed as with the onboot
 274             group.
 275             -->
 276           LXC 서비스가 활성화된 상태로 시스템이 부팅될 때, 먼저 lxc.start.auto == 1이고 "onboot" 그룹인 컨테이너들을 시작하려고 시도한다. 시작과정은 lxc.start.order의 순서대로 이루어진다.
 277           만약 lxc.start.delay가 지정 되었다면, 다음 컨테이너를 시작하려고 시도하기 전, 현재 컨테이너의 초기화 및 호스트 시스템의 부하를 줄이기 위해서 지연시간을 준다.
 278           "onboot" 그룹의 멤버들을 시작시킨 후, LXC 시스템은 lxc.start.auto == 1이고 어떤 그룹에도 속하지 않은(NULL 그룹) 컨테이너들을 시작한다.
 279         </para>
 280     </refsect1>
 281
 282     <refsect1>
 283         <title><!-- Startup Group Examples -->시작 그룹 예제</title>
 284         <variablelist>
 285             <varlistentry>
 286                 <term>
 287                     <option>-g "onboot,"</option>
 288                 </term>
 289                 <listitem>
 290                     <para>
 291                       <!--
 292                         Start the "onboot" group first then the NULL group.
 293                         -->
 294                       먼저 "onboot" 그룹을 실행하고 NULL 그룹을 실행한다.
 295                     </para>
 296                     <para>
 297                       <!--
 298                         This is the equivalent of: <option>-g onboot -g ""</option>.
 299                         -->
 300                       이것은 다음과 같다 : <option>-g onboot -g ""</option>
 301                     </para>
 302                 </listitem>
 303             </varlistentry>
 304             <varlistentry>
 305                 <term>
 306                     <option>-g "dns,web,,onboot"</option>
 307                 </term>
 308                 <listitem>
 309                     <para>
 310                       <!--
 311                         Starts the "dns" group first, the "web" group second, then
 312                         the NULL group followed by the "onboot" group.
 313                         -->
 314                       첫번째로 dns 그룹을 실행하고, web 그룹을 두번째로 실행하고, NULL그룹을 실행한 뒤, "onboot" 그룹을 실행한다.
 315                     </para>
 316                     <para>
 317                       <!--
 318                         This is the equivalent of: <option>-g dns,web -g ,onboot</option> or <option>-g dns -g web -g "" -g onboot</option>.
 319                         -->
 320                       이것은 다음과 같다 : <option>-g dns,web -g ,onboot</option> 또는  <option>-g dns -g web -g "" -g onboot</option>
 321                     </para>
 322                 </listitem>
 323             </varlistentry>
 324         </variablelist>
 325     </refsect1>
 326
 327     &seealso;
 328
 329     <refsect1>
 330         <title><!--Author-->저자</title>
 331         <para>Stéphane Graber <email>stgraber@ubuntu.com</email></para>
 332     </refsect1>
 333 </refentry>
 334
 335 <!-- Keep this comment at the end of the file
 336 Local variables:
 337 mode: sgml
 338 sgml-omittag:t
 339 sgml-shorttag:t
 340 sgml-minimize-attributes:nil
 341 sgml-always-quote-attributes:t
 342 sgml-indent-step:2
 343 sgml-indent-data:t
 344 sgml-parent-document:nil
 345 sgml-default-dtd-file:nil
 346 sgml-exposed-tags:nil
 347 sgml-local-catalogs:nil
 348 sgml-local-ecat-files:nil
 349 End:
 350 -->