751c8217d1
This change modifies the Nomad job register and deregister RPCs to accept an updated option set which includes eval priority. This param is optional and override the use of the job priority to set the eval priority. In order to ensure all evaluations as a result of the request use the same eval priority, the priority is shared to the allocReconciler and deploymentWatcher. This creates a new distinction between eval priority and job priority. The Nomad agent HTTP API has been modified to allow setting the eval priority on job update and delete. To keep consistency with the current v1 API, job update accepts this as a payload param; job delete accepts this as a query param. Any user supplied value is validated within the agent HTTP handler removing the need to pass invalid requests to the server. The register and deregister opts functions now all for setting the eval priority on requests. The change includes a small change to the DeregisterOpts function which handles nil opts. This brings the function inline with the RegisterOpts.
78 lines
2.2 KiB
Plaintext
78 lines
2.2 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: 'Commands: job stop'
|
|
description: |
|
|
The job stop command is used to stop a running job.
|
|
---
|
|
|
|
# Command: job stop
|
|
|
|
**Alias: `nomad stop`**
|
|
|
|
The `job stop` command is used to stop a running job and signals the scheduler
|
|
to cancel all of the running allocations.
|
|
|
|
## Usage
|
|
|
|
```plaintext
|
|
nomad job stop [options] <job>
|
|
```
|
|
|
|
The `job stop` command requires a single argument, specifying the job ID or
|
|
prefix to cancel. If there is an exact match based on the provided job ID or
|
|
prefix, then the job will be cancelled. Otherwise, a list of matching jobs and
|
|
information will be displayed.
|
|
|
|
Stop will issue a request to deregister the matched job and then invoke an
|
|
interactive monitor that exits automatically once the scheduler has processed
|
|
the request. It is safe to exit the monitor early using ctrl+c.
|
|
|
|
When ACLs are enabled, this command requires a token with the `submit-job`,
|
|
`read-job`, and `list-jobs` capabilities for the job's namespace.
|
|
|
|
## General Options
|
|
|
|
@include 'general_options.mdx'
|
|
|
|
## Stop Options
|
|
|
|
- `-detach`: Return immediately instead of entering monitor mode. After the
|
|
deregister command is submitted, a new evaluation ID is printed to the screen,
|
|
which can be used to examine the evaluation using the [eval status] command.
|
|
|
|
- `-eval-priority`: Override the priority of the evaluations produced as a result
|
|
of this job deregistration. By default, this is set to the priority of the job.
|
|
|
|
- `-verbose`: Show full information.
|
|
|
|
- `-yes`: Automatic yes to prompts.
|
|
|
|
- `-purge`: Purge is used to stop the job and purge it from the system. If not
|
|
set, the job will still be queryable and will be purged by the garbage
|
|
collector.
|
|
|
|
- `-global`
|
|
Stop a [multi-region] job in all its regions. By default, `job stop` will
|
|
stop only a single region at a time. Ignored for single-region jobs.
|
|
|
|
## Examples
|
|
|
|
Stop the job with ID "job1":
|
|
|
|
```shell-session
|
|
$ nomad job stop job1
|
|
==> Monitoring evaluation "43bfe672"
|
|
Evaluation status changed: "pending" -> "complete"
|
|
==> Evaluation "43bfe672" finished with status "complete"
|
|
```
|
|
|
|
Stop the job with ID "job1" and return immediately:
|
|
|
|
```shell-session
|
|
$ nomad job stop -detach job1
|
|
507d26cb
|
|
```
|
|
|
|
[eval status]: /docs/commands/eval-status
|
|
[multi-region]: /docs/job-specification/multiregion
|