website: document token create

This commit is contained in:
Armon Dadgar 2017-09-14 22:05:17 -07:00
parent a6370a433b
commit 08f592d38d
4 changed files with 57 additions and 1 deletions

View file

@ -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

View file

@ -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

View file

@ -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
```

View file

@ -176,6 +176,9 @@
<li<%= sidebar_current("docs-commands-acl-policy-apply") %>>
<a href="/docs/commands/acl/policy-apply.html">acl policy apply</a>
</li>
<li<%= sidebar_current("docs-commands-acl-token-create") %>>
<a href="/docs/commands/acl/token-create.html">acl token create</a>
</li>
</ul>
</li>
<li<%= sidebar_current("docs-commands-_agent") %>>