docs: Add docs for nomad-alloc-restart

website/source/docs/commands/alloc.html.md.erb

@@ -19,8 +19,10 @@ subcommands are available:
 
 * [`alloc fs`][fs] - Inspect the contents of an allocation directory
 * [`alloc logs`][logs] - Streams the logs of a task
+* [`alloc restart`][restart] - Restart a running allocation or task
 * [`alloc status`][status] - Display allocation status information and metadata
 
 [fs]: /docs/commands/alloc/fs.html "Inspect the contents of an allocation directory"
 [logs]: /docs/commands/alloc/logs.html "Streams the logs of a task"
+[restart]: /docs/commands/alloc/restart.html "Restart a running allocation or task"
 [status]: /docs/commands/alloc/status.html "Display allocation status information and metadata"

website/source/docs/commands/alloc/restart.html.md.erb

@@ -0,0 +1,42 @@
+---
+layout: "docs"
+page_title: "Commands: alloc restart"
+sidebar_current: "docs-commands-alloc-restart"
+description: >
+  Restart a running allocation or task
+---
+
+# Command: alloc restart
+
+The `alloc restart` command allows a user to perform an in place restart of an
+an entire allocation or individual task.
+
+## Usage
+
+```
+nomad alloc stop [options] <allocation> <task>
+```
+
+This command accepts a single allocation ID and a task name. The task name must
+be part of the allocation and the task must be currently running. The task name
+is optional and if omitted every task in the allocation will be restarted.
+
+## General Options
+
+<%= partial "docs/commands/_general_options" %>
+
+## Restart Options
+
+* `-verbose`: Display verbose output.
+
+## Examples
+
+```
+$ nomad alloc restart eb17e557
+
+$ nomad alloc restart eb17e557 foo
+Could not find task named: foo, found:
+* test
+<blocking>
+```
+

website/source/layouts/docs.erb

@@ -126,6 +126,9 @@
               <li<%= sidebar_current("docs-commands-alloc-logs") %>>
                 <a href="/docs/commands/alloc/logs.html">logs</a>
               </li>
+              <li<%= sidebar_current("docs-commands-alloc-restart") %>>
+                <a href="/docs/commands/alloc/restart.html">restart</a>
+              </li>
               <li<%= sidebar_current("docs-commands-alloc-status") %>>
                 <a href="/docs/commands/alloc/status.html">status</a>
               </li>