github.com/dkerwin/nomad@v0.3.3-0.20160525181927-74554135514b/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 which 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 [intepretable 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  ## Task Directories
    46  
    47  The `rkt` driver currently does not support mounting of the `alloc/` and `local/` directory. 
    48  Once support is added, version `v0.10.0` or above of `rkt` will be required. 
    49  
    50  ## Client Requirements
    51  
    52  The `rkt` driver requires rkt to be installed and in your systems `$PATH`.
    53  The `trust_prefix` must be accessible by the node running Nomad. This can be an
    54  internal source, private to your cluster, but it must be reachable by the client
    55  over HTTP.
    56  
    57  ## Client Attributes
    58  
    59  The `rkt` driver will set the following client attributes:
    60  
    61  * `driver.rkt` - Set to `1` if rkt is found on the host node. Nomad determines
    62  this by executing `rkt version` on the host and parsing the output
    63  * `driver.rkt.version` - Version of `rkt` eg: `0.8.1`. Note that the minimum required
    64  version is `0.14.0`
    65  * `driver.rkt.appc.version` - Version of `appc` that `rkt` is using eg: `0.8.1`
    66  
    67  ## Resource Isolation
    68  
    69  This driver supports CPU and memory isolation by delegating to `rkt`. Network isolation
    70  is not supported as of now.