diff --git a/website/source/docs/agent/config.html.md b/website/source/docs/agent/config.html.md index 56532f921..261514752 100644 --- a/website/source/docs/agent/config.html.md +++ b/website/source/docs/agent/config.html.md @@ -207,8 +207,8 @@ configured on server nodes. option is not required and has no default. * `meta`: This is a key/value mapping of metadata pairs. This is a free-form map and can contain any string values. - * `options`: This is a key/value mapping of internal configuration for clients, - such as for driver configuration. + * `options`: This is a key/value mapping of internal + configuration for clients, such as for driver configuration. * `network_interface`: This is a string to force network fingerprinting to use a specific network interface * `network_speed`: This is an int that sets the diff --git a/website/source/docs/drivers/exec.html.md b/website/source/docs/drivers/exec.html.md index dd30af74a..1f3e50935 100644 --- a/website/source/docs/drivers/exec.html.md +++ b/website/source/docs/drivers/exec.html.md @@ -11,9 +11,10 @@ description: |- Name: `exec` The `exec` driver is used to simply execute a particular command for a task. -This is the simplest driver and is extremely flexible. In particlar, because -it can invoke any command, it can be used to call scripts or other wrappers -which provide higher level features. +However unlike [`raw_exec`](raw_exec.html) it uses the underlying isolation +primitives of the operating system to limit the tasks access to resources. While +simple, since the `exec` driver can invoke any command, it can be used to call +scripts or other wrappers which provide higher level features. ## Task Configuration diff --git a/website/source/docs/drivers/raw_exec.html.md b/website/source/docs/drivers/raw_exec.html.md new file mode 100644 index 000000000..fdbcb956c --- /dev/null +++ b/website/source/docs/drivers/raw_exec.html.md @@ -0,0 +1,47 @@ +--- +layout: "docs" +page_title: "Drivers: Raw Exec" +sidebar_current: "docs-drivers-raw-exec" +description: |- + 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 +resource isolation. 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` - The command to execute. Must be provided. + +* `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](../agent/config.html#options) field: + +``` +options = { + driver.raw_exec.enable = "1" +} +``` + +## 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. diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb index 62d1dddca..e428cb593 100644 --- a/website/source/layouts/docs.erb +++ b/website/source/layouts/docs.erb @@ -49,7 +49,11 @@