open-nomad/website/source/docs/configuration/plugin.html.md
Omar Khawaja 55ccd41634
add plugin content (docs) (#5186)
* call out pluggable drivers in task drivers section and link/add info to plugin stanza

* fix hyphenation

* removing page and nav that tells users drivers are not pluggable

* show new syntax for configuring raw_exec plugin on client

* enabled option value for raw_exec is boolean

* add plugin options section and mark client options as soon to be deprecated

* fix typos

* add plugin options for rkt task drivers and place deprecation warning in client options

* add some plugin options with plugin configuration example + mark client options as soon to be deprecated

* modify deprecation warning

* replace colon with - for options

* add docker plugin options

* update links within docker task driver to point to plugin options

* fix typo and clarify config options for lxc task driver

* replace raw_exec plugin syntax example with docker example

* create external section

* restructure lxc docs and add backward incompatibility warning

* update lxc driver doc

* add redirect for lxc driver doc

* call out plugin options and mark client config options for drivers as deprecated

* add placeholder for lxc driver binary download

* update data_dir/plugins reference with plugin_dir reference

* Update website/source/docs/external/lxc.html.md

Co-Authored-By: Omar-Khawaja <Omar-Khawaja@users.noreply.github.com>

* corrections

* remove lxc from built-in drivers navigation

* reorganize doc structure and fix redirect

* add detail about 0.9 changes

* implement suggestions/fixes

* removed extraneous punctuation

* add official lxc driver link
2019-01-29 15:53:05 -05:00

46 lines
1.1 KiB
Markdown

---
layout: "docs"
page_title: "plugin Stanza - Agent Configuration"
sidebar_current: "docs-configuration-plugin"
description: |-
The "plugin" stanza is used to configure a Nomad plugin.
---
# `plugin` Stanza
<table class="table table-bordered table-striped">
<tr>
<th width="120">Placement</th>
<td>
<code>**plugin**</code>
</td>
</tr>
</table>
The `plugin` stanza is used to configure plugins.
```hcl
plugin "example-plugin" {
args = ["-my-flag"]
config {
foo = "bar"
bam {
baz = 1
}
}
}
```
The name of the plugin is the plugin's executable name relative to to the
[plugin_dir](/docs/configuration/index.html#plugin_dir). If the plugin has a
suffix, such as `.exe`, this should be omitted.
## `plugin` Parameters
- `args` `(array<string>: [])` - Specifies a set of arguments to pass to the
plugin binary when it is executed.
- `config` `(hcl/json: nil)` - Specifies configuration values for the plugin
either as HCL or JSON. The accepted values are plugin specific. Please refer
to the individual plugin's documentation.