Namespace Specification
Tip
Visit the Nomad Namespaces tutorial for more information.Nomad Namespaces may be specified as HCL files and submitted by the nomad
namespace apply
CLI command.
Unlike Job specifications, Namespace specifications do not support HCL2 features like functions.
Example namespace specification:
Namespace Specification Parameters
name
(string: <required>)
- Specifies the namespace to create or update.description
(string: "")
- Specifies an optional human-readable description of the namespace.quota
(string: "")
Enterprise - Specifies a quota to attach to the namespace.meta
(object: null)
- Optional object with string keys and values of metadata to attach to the namespace. Namespace metadata is not used by Nomad and is intended for use by operators and third party tools.capabilities
(Capabilities: <optional>)
- Specifies capabilities allowed in the namespace. These values are checked at job submission.node_pool_config
(NodePoolConfiguration: <optional>)
Enterprise - Specifies node pool configurations. These values are checked at job submission.vault
(Vault: <optional>)
Enterprise - Specifies which Vault clusters are allowed to be used from this namespace. These values are checked at job submission.consul
(Consul: <optional>)
Enterprise - Specifies which Consul clusters are allowed to be used from this namespace. These values are checked at job submission.
capabilities
Parameters
enabled_task_drivers
(array<string>: [])
- List of task drivers allowed in the namespace. If empty all task drivers are allowed.disabled_task_drivers
(array<string>: [])
- List of task drivers disabled in the namespace.
node_pool_config
Parameters Enterprise
default
(string: "default")
- Specifies the node pool to use for jobs in this namespace that don't define a node pool in their specification.allowed
(array<string>: nil)
- Specifies the node pools that are allowed to be used by jobs in this namespace. By default, all node pools are allowed. If an empty list is provided only the namespace's default node pool is allowed. This field supports wildcard globbing through the use of*
for multi-character matching. This field cannot be used withdenied
.denied
(array<string>: nil)
- Specifies the node pools that are not allowed to be used by jobs in this namespace. This field supports wildcard globbing through the use of*
for multi-character matching. If specified, any node pool is allowed to be used, except for those that match any of these patterns. This field cannot be used withallowed
.
vault
Parameters Enterprise
default
(string: "default")
- Specifies the Vault cluster to use for jobs in this namespace that don't define a Vault cluster in their specification.allowed
(array<string>: nil)
- Specifies the Vault clusters that are allowed to be used by jobs in this namespace. By default, all Vault clusters are allowed. If an empty list is provided only the namespace's default Vault cluster is allowed. This field supports wildcard globbing through the use of*
for multi-character matching. This field cannot be used withdenied
.denied
(array<string>: nil)
- Specifies the Vault clusters that are not allowed to be used by jobs in this namespace. This field supports wildcard globbing through the use of*
for multi-character matching. If specified, any Vault cluster is allowed to be used, except for those that match any of these patterns. This field cannot be used withallowed
.
consul
Parameters Enterprise
default
(string: "default")
- Specifies the Consul cluster to use for jobs in this namespace that don't define a Consul cluster in their specification.allowed
(array<string>: nil)
- Specifies the Consul clusters that are allowed to be used by jobs in this namespace. By default, all Consul clusters are allowed. If an empty list is provided only the namespace's default Consul cluster is allowed. This field supports wildcard globbing through the use of*
for multi-character matching. This field cannot be used withdenied
.denied
(array<string>: nil)
- Specifies the Consul clusters that are not allowed to be used by jobs in this namespace. This field supports wildcard globbing through the use of*
for multi-character matching. If specified, any Consul cluster is allowed to be used, except for those that match any of these patterns. This field cannot be used withallowed
.