plugin Stanza
Warning
This content is part of the legacy version of Waypoint that is no longer actively maintained. For additional information on the new vision of Waypoint, check out this blog post and the HCP Waypoint documentation.
Placement | plugin |
The plugin
stanza configures a plugin that will be used by the Waypoint
configuration. This can set settings such as the checksum of the plugin,
the kind of features the plugin supports, etc.
The plugin
stanza is optional. When you use a use
stanza, it implicitly defines a plugin that Waypoint will require. You do not
need to explicitly create a plugin
configuration as well. You only need to
create a plugin
stanza for additional plugin configuration.
Multiple plugin
stanzas can be specified.
plugin
Parameters
Label
The plugin
stanza takes a label. The label of the stanza is the name
of the plugin. In the above example, the label is "my-platform"
The plugin name is significant because it defines how the plugin binary will be named on the local system. See plugin loading for more information.
Optional
checksum
(string: "")
- A SHA-256 checksum for the external plugin binary. This has no effect for built-in plugins.type
(type: nil)
- The type of plugin that this is. A plugin can implement multiple types.
type
Parameters
The type
stanza is used only within a plugin
stanza. It defines what features
a plugin implements. Each field in the type
stanza should be set to "true"
if the plugin implements that type.
Optional
builder
(bool: false)
mapper
(bool: false)
platform
(bool: false)
registry
(bool: false)
releaser
(bool: false)
Note: mappers are special. A mapper type plugin is always loaded, because it may provide mapping functions used for other plugins to interoperate.