open-nomad/website/source/docs/drivers/raw_exec.html.md
Clint Shryock 343daeb1ea drivers: Add/Use go-getter to fetch remote binaries
Updates Qemu, Java drivers to use go-getter to fetch binaries
Adds remote artifact support for Exec, Raw Exec drivers
2015-10-26 09:40:06 -05:00

2 KiB
Raw Blame History

layout page_title sidebar_current description
docs Drivers: Raw Exec docs-drivers-raw-exec The Raw Exec task driver simply fork/execs and provides no isolation.

Raw Fork/Exec Driver

Name: raw_exec

The raw_exec driver is used to execute a command for a task without any isolation. Further, the task is started as the same user as the Nomad process. As such, it should be used with extreme care and is disabled by default.

Task Configuration

The raw_exec driver supports the following configuration in the job spec:

  • command - (Required) The command to execute. Must be provided.
  • artifact_source (Optional) Source location of an executable artifact. Must be accessible from the Nomad client. If you specify an artifact_source to be executed, you must reference it in the command as show in the examples below
  • args - The argument list to the command, space seperated. Optional.

Client Requirements

The raw_exec driver can run on all supported operating systems. It is however disabled by default. In order to be enabled, the Nomad client configuration must explicitly enable the raw_exec driver in the options field:

options = {
    driver.raw_exec.enable = "1"
}

You must specify a command to be executed. Optionally you can specify an artifact_source to be executed. Any command is assumed to be present on the running client, or a downloaded artifact

Examples

To run a binary present on the Node:

  config {
    command = "/bin/sleep"
    args = 1
  }

To execute a binary specified by artifact_source:

  config {
    artifact_source = "https://dl.dropboxusercontent.com/u/1234/binary.bin"
    command = "$NOMAD_TASK_DIR/binary.bin"
  }

Client Attributes

The raw_exec driver will set the following client attributes:

  • driver.raw_exec - This will be set to "1", indicating the driver is available.

Resource Isolation

The raw_exec driver provides no isolation.