A new platform for documentation and tutorials is launching soon.
We are migrating Consul documentation into HashiCorp Developer, our new developer experience.
This feature requires Consul Enterprise.
namespace command provides management of Consul Enterprise namespaces. This was added in Consul Enterprise 1.7.0.
If ACLs are enabled then a token with operator privileges may be required in order to use this command. Write requests are forwarded to the leader in the primary datacenter. Therefore these commands can be run against any agent in any datacenter.
consul namespace <subcommand>
For the exact documentation for your Consul version, run
consul namespace -h to view the complete list of subcommands.
Usage: consul namespace <subcommand> [options] [args] This command has subcommands for interacting with Consul Enterprise Namespaces. Here are some simple examples. More detailed examples are available in the subcommands or the documentation. ... Subcommands: create Create a Namespace delete Delete a Namespace list List all Namespaces read Read a Namespace update Update a Namespace write Create or update a Namespace from its full definition
For more information, examples, and usage about a subcommand, click on the name of the subcommand in the sidebar.
Create a Namespace
$ consul namespace create -name team1
Create or Update a Namespace from its full definition:
$ consul namespace write ns1.hcl
Read a Namespace:
$ consul namespace read ns1
List all Namespaces:
$ consul namespace list
Update a namespace
$ consul namespace update -name team1 -description "first namespace"
Delete a Namespace:
$ consul namespace delete team1