1e3c3cb287
IOPS have been modelled as a resource since Nomad 0.1 but has never actually been detected and there is no plan in the short term to add detection. This is because IOPS is a bit simplistic of a unit to define the performance requirements from the underlying storage system. In its current state it adds unnecessary confusion and can be removed without impacting any users. This PR leaves IOPS defined at the jobspec parsing level and in the api/ resources since these are the two public uses of the field. These should be considered deprecated and only exist to allow users to stop using them during the Nomad 0.9.x release. In the future, there should be no expectation that the field will exist.
85 lines
1.9 KiB
Plaintext
85 lines
1.9 KiB
Plaintext
---
|
|
layout: "docs"
|
|
page_title: "Commands: job history"
|
|
sidebar_current: "docs-commands-job-history"
|
|
description: >
|
|
The history command is used to display all tracked versions of a job.
|
|
---
|
|
|
|
# Command: job history
|
|
|
|
The `job history` command is used to display the known versions of a particular
|
|
job. The command can display the diff between job versions and can be useful for
|
|
understanding the changes that occurred to the job as well as deciding job
|
|
versions to revert to.
|
|
|
|
## Usage
|
|
|
|
```
|
|
nomad job history [options] <job>
|
|
```
|
|
|
|
The `job history` command requires a single argument, the job ID or an ID prefix
|
|
of a job to display the history for.
|
|
|
|
## General Options
|
|
|
|
<%= partial "docs/commands/_general_options" %>
|
|
|
|
## History Options
|
|
|
|
* `-p`: Display the differences between each job and its predecessor.
|
|
|
|
* `-full`: Display the full job definition for each version.
|
|
|
|
* `-version`: Display only the history for the given version.
|
|
|
|
* `-json` : Output the job versions in its JSON format.
|
|
|
|
* `-t` : Format and display the job versions using a Go template.
|
|
|
|
## Examples
|
|
|
|
Display the history showing differences between versions:
|
|
|
|
```
|
|
$ nomad job history -p e
|
|
Version = 2
|
|
Stable = false
|
|
Submit Date = 07/25/17 20:35:43 UTC
|
|
Diff =
|
|
+/- Job: "example"
|
|
+/- Task Group: "cache"
|
|
+/- Task: "redis"
|
|
+/- Resources {
|
|
CPU: "500"
|
|
DiskMB: "0"
|
|
+/- MemoryMB: "256" => "512"
|
|
}
|
|
|
|
Version = 1
|
|
Stable = false
|
|
Submit Date = 07/25/17 20:35:31 UTC
|
|
Diff =
|
|
+/- Job: "example"
|
|
+/- Task Group: "cache"
|
|
+/- Count: "1" => "3"
|
|
Task: "redis"
|
|
|
|
Version = 0
|
|
Stable = false
|
|
Submit Date = 07/25/17 20:35:28 UTC
|
|
```
|
|
|
|
Display the memory ask across submitted job versions:
|
|
|
|
```
|
|
$ nomad job history -t "{{range .}}\
|
|
v{{.Version}}: {{with index .TaskGroups 0}}{{with index .Tasks 0}}{{.Resources.MemoryMB}}{{end}}{{end}}\
|
|
|
|
{{end}}" example
|
|
v2: 512
|
|
v1: 256
|
|
v0: 256
|
|
```
|