From 08f592d38d2ccde51bee1dba95190c3d7989c3ad Mon Sep 17 00:00:00 2001 From: Armon Dadgar Date: Thu, 14 Sep 2017 22:05:17 -0700 Subject: [PATCH] website: document token create --- website/source/docs/commands/acl.html.md.erb | 2 + .../commands/acl/policy-apply.html.md.erb | 2 +- .../commands/acl/token-create.html.md.erb | 51 +++++++++++++++++++ website/source/layouts/docs.erb | 3 ++ 4 files changed, 57 insertions(+), 1 deletion(-) create mode 100644 website/source/docs/commands/acl/token-create.html.md.erb diff --git a/website/source/docs/commands/acl.html.md.erb b/website/source/docs/commands/acl.html.md.erb index 801c0aebe..bf27ac151 100644 --- a/website/source/docs/commands/acl.html.md.erb +++ b/website/source/docs/commands/acl.html.md.erb @@ -21,7 +21,9 @@ subcommands are available: * [`acl bootstrap`][bootstrap] - Bootstrap the initial ACL token * [`acl policy apply`][policyapply] - Create or update ACL policies +* [`acl token create`][tokencreate] - Create new ACL token [bootstrap]: /docs/commands/acl/bootstrap.html [policyapply]: /docs/commands/acl/policy-apply.html +[tokencreate]: /docs/commands/acl/token-create.html diff --git a/website/source/docs/commands/acl/policy-apply.html.md.erb b/website/source/docs/commands/acl/policy-apply.html.md.erb index 5f57df9c8..f0d44428c 100644 --- a/website/source/docs/commands/acl/policy-apply.html.md.erb +++ b/website/source/docs/commands/acl/policy-apply.html.md.erb @@ -29,7 +29,7 @@ The policy can be read from stdin by setting the path to "-". ## Examples -Create a new acl policy +Create a new ACL Policy: ``` $ nomad acl policy apply my-policy my-policy.json diff --git a/website/source/docs/commands/acl/token-create.html.md.erb b/website/source/docs/commands/acl/token-create.html.md.erb new file mode 100644 index 000000000..ac0066ec1 --- /dev/null +++ b/website/source/docs/commands/acl/token-create.html.md.erb @@ -0,0 +1,51 @@ +--- +layout: "docs" +page_title: "Commands: acl token create" +sidebar_current: "docs-commands-acl-token-create" +description: > + The token create command is used to create new ACL tokens. +--- + +# Command: acl token create + +The `acl token create` command is used to create new ACL tokens. + +## Usage + +``` +nomad acl token create [options] +``` + +The `acl token create` command requires no arguments. + +## General Options + +<%= partial "docs/commands/_general_options" %> + +## Create Options + +* `-name`: Sets the human readable name for the ACL token. + +* `-type`: Sets the type of token. Must be one of "client" (default), or "management". + +* `-global`: Toggles the global mode of the token. Global tokens are replicated to all regions. Defaults false. + +* `-policy`: Specifies a policy to associate with the token. Can be specified multiple times, + but only with client type tokens. + +## Examples + +Create a new ACL token: + +``` +$ nomad acl token create -name="my token" -policy=foo -policy=bar +Accessor ID = d532c40a-30f1-695c-19e5-c35b882b0efd +Secret ID = 85310d07-9afa-ef53-0933-0c043cd673c7 +Name = my token +Type = client +Global = false +Policies = [foo bar] +Create Time = 2017-09-15 05:04:41.814954949 +0000 UTC +Create Index = 8 +Modify Index = 8 +``` diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb index 64b54b7b6..ded57717c 100644 --- a/website/source/layouts/docs.erb +++ b/website/source/layouts/docs.erb @@ -176,6 +176,9 @@ > acl policy apply + > + acl token create + >