github.com/mattyr/nomad@v0.3.3-0.20160919021406-3485a065154a/website/source/docs/drivers/rkt.html.md (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Drivers: Rkt"
     4  sidebar_current: "docs-drivers-rkt"
     5  description: |-
     6    The rkt task driver is used to run application containers using rkt.
     7  ---
     8  
     9  # Rkt Driver - Experimental
    10  
    11  Name: `rkt`
    12  
    13  The `rkt` driver provides an interface for using CoreOS rkt for running
    14  application containers. Currently, the driver supports launching containers but
    15  does not support dynamic ports. This can lead to port conflicts and as such,
    16  this driver is being marked as experimental and should be used with care.
    17  
    18  ## Task Configuration
    19  
    20  The `rkt` driver supports the following configuration in the job spec:
    21  
    22  * `image` - The image to run. May be specified by name, hash, ACI address
    23    or docker registry.
    24  
    25  * `command` - (Optional) A command to execute on the ACI.
    26  
    27  *   `args` - (Optional) A list of arguments to the optional `command`.
    28      References to environment variables or any [interpretable Nomad
    29      variables](/docs/jobspec/interpreted.html) will be interpreted
    30      before launching the task. For example:
    31  
    32      ```
    33          args = ["${nomad.datacenter}", "${MY_ENV}", ${meta.foo}"]
    34      ```
    35  
    36  * `trust_prefix` - (Optional) The trust prefix to be passed to rkt. Must be
    37    reachable from the box running the nomad agent. If not specified, the image is
    38    run without verifying the image signature.
    39  
    40  * `dns_servers` - (Optional) A list of DNS servers to be used in the containers.
    41  
    42  * `dns_search_domains` - (Optional) A list of DNS search domains to be used in
    43     the containers.
    44  
    45  * `debug` - (Optional) Enable rkt command debug option.
    46  
    47  ## Task Directories
    48  
    49  The `rkt` driver currently does not support mounting of the `alloc/` and `local/` directories.
    50  Once support is added, version `v0.10.0` or above of `rkt` will be required. 
    51  
    52  ## Client Requirements
    53  
    54  The `rkt` driver requires rkt to be installed and in your system's `$PATH`.
    55  The `trust_prefix` must be accessible by the node running Nomad. This can be an
    56  internal source, private to your cluster, but it must be reachable by the client
    57  over HTTP.
    58  
    59  ## Client Attributes
    60  
    61  The `rkt` driver will set the following client attributes:
    62  
    63  * `driver.rkt` - Set to `1` if rkt is found on the host node. Nomad determines
    64  this by executing `rkt version` on the host and parsing the output
    65  * `driver.rkt.version` - Version of `rkt` eg: `0.8.1`. Note that the minimum required
    66  version is `0.14.0`
    67  * `driver.rkt.appc.version` - Version of `appc` that `rkt` is using eg: `0.8.1`
    68  
    69  ## Resource Isolation
    70  
    71  This driver supports CPU and memory isolation by delegating to `rkt`. Network isolation
    72  is not supported as of now.