Reference
Nomad Variables
Path-addressed variables with compare-and-set writes, decrypted on read.
Path-addressed variables with compare-and-set writes, decrypted on read.
Connection
| What | This provider |
|---|---|
| Vendor | HashiCorp |
| Key | nomad-variables |
| Availability | available. You can connect it today. |
| Credential we hold | nomad-token |
| Values read back | yes |
| Activation | on-next-deploy |
Directions
| Direction | What it does |
|---|---|
import | We read names and values out of the store into your environment. |
export | We write names and values from your environment into the store. |
Activation
on-next-deploy. A new value waits there and arrives with your next deploy.
Conflict policies
| Direction | Policies you can pick |
|---|---|
import | skip_existing, new_version, fail |
export | create_only, overwrite, overwrite_and_prune |
How syncs work says what each one does.
Connect
Paste a credential from the vendor. We seal it and never show it again.
| Field | Label | Kind | Required | What it is |
|---|---|---|---|---|
token | ACL token | secret; we mask it here and seal it | yes | Needs variables:list, read, write and destroy in this namespace. |
Connection fields
You set these when you connect. Every mapping on the connection shares them.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
address | Nomad address | text | yes | no | Must be reachable from the internet for us to write to it. |
namespace | Namespace | text | no | yes | The ACL token's own namespace, if it is not default. Starts at default. |
Mapping fields
You answer these once per environment you map.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
pathPrefix | Path prefix | text | yes | no | A sync owns one prefix. Each secret is one variable path under it, and pruning deletes every path in reach, including ones this sync did not write. |
Required permissions
We probe for these when we verify the connection.
| Permission | Directions | Blocking | Without it |
|---|---|---|---|
variables:list | every direction | yes | Preview cannot list the paths under the prefix. |
variables:read | import | yes | Import cannot read a variable's items. |
variables:write | export | yes | Export cannot create or change a variable. |
variables:destroy | export | yes | The overwrite_and_prune policy cannot remove a variable. |