diff --git a/command/ui.go b/command/ui.go index c343677ba..d11e75d71 100644 --- a/command/ui.go +++ b/command/ui.go @@ -24,7 +24,7 @@ func (c *UiCommand) Help() string { Usage: nomad ui [options] Open the Nomad Web UI in the default browser. An optional identifier may be -provided in which case the UI will be opened to view the details for that +provided, in which case the UI will be opened to view the details for that object. Supported identifiers are jobs, allocations and nodes. General Options: diff --git a/website/source/docs/commands/ui.html.md.erb b/website/source/docs/commands/ui.html.md.erb new file mode 100644 index 000000000..2cd534171 --- /dev/null +++ b/website/source/docs/commands/ui.html.md.erb @@ -0,0 +1,51 @@ +--- +layout: "docs" +page_title: "Commands: ui" +sidebar_current: "docs-commands-ui" +description: > + The ui command is used to open the Nomad Web UI. +--- + +# Command: ui + +The `ui` command is used to open the Nomad Web UI. + +## Usage + +``` +nomad ui [options] +``` + +The `ui` command can be called with no arguments, in which case the UI homepage +will be opened in the default browser. + +An identifier may be provided, in which case the UI will be opened to view the +details for that object. Supported identifiers are jobs, allocations and nodes. + + +## General Options + +<%= partial "docs/commands/_general_options" %> + +## Examples + +Open the UI homepage: + +``` +$ nomad ui +Opening URL "http://127.0.0.1:4646" +``` + +Open the UI directly to look at a job: + +``` +$ nomad ui redis-job +http://127.0.0.1:4646/ui/jobs/example +``` + +Open the UI directly to look at an allocation: + +``` +$ nomad ui d4005969 +Opening URL "http://127.0.0.1:4646/ui/allocations/d4005969-b16f-10eb-4fe1-a5374986083d" +``` diff --git a/website/source/layouts/docs.erb b/website/source/layouts/docs.erb index 16560fbd6..dd9b0ba08 100644 --- a/website/source/layouts/docs.erb +++ b/website/source/layouts/docs.erb @@ -332,6 +332,9 @@ > stop + > + ui + > validate