Files
nomad/website/content/docs/commands/recommendation/apply.mdx
Aimee Ukasick 23fd87d9c9 Docs: Commands section move "General options" to page bottom (#26001)
* sectionless files plus acl section

* alloc section

* config, deployment sections

* job section

* licence, namespace

* node, node-pool

* operator

* plugin, quota, recommendation

* scaling, sentinel, server, service, system, var, volume

* Add "ENT" label to left nav for enterprise commands

* job tag break into separate folder and files; update options header
2025-06-12 14:31:38 -05:00

71 lines
2.3 KiB
Plaintext

---
layout: docs
page_title: 'nomad recommendation apply command reference'
description: |
The `nomad recommendation apply` command applies one or more recommendations in Nomad Enterprise.
---
# `nomad recommendation apply` command reference
The `recommendation apply` command is used to apply recommendations.
<EnterpriseAlert product="nomad"/>
## Usage
```plaintext
nomad recommendation apply [options] <recommendation_ids>
```
The `recommendation apply` command requires at least one recommendation ID to
be passed to it. Multiple IDs can be passed, with each recommendation ID
separated from the next by a space.
When ACLs are enabled, this command requires a token with the `submit-job`,
`read-job`, and `submit-recommendation` capabilities for the recommendation's
namespace.
## Options
- `-detach`: Return immediately instead of entering monitor mode. After applying
a recommendation, the evaluation ID will be printed to the screen, which can
be used to examine the evaluation using the [`eval status`][/docs/commands/eval-status] command. If applying
recommendations for multiple jobs, this value will always be true.
- `-policy-override`: If set, any soft mandatory Sentinel policies will be
overridden. This allows a recommendation to be applied when it would be denied
by a policy.
- `-verbose`: Display full information.
## Examples
Apply a single recommendation and enter monitor mode:
```shell-session
$ nomad recommendation apply a9c041c5-3c04-aa24-bd55-0a80cded4f10
==> Monitoring evaluation "529cc88e"
Evaluation triggered by job "job1"
Evaluation within deployment: "28a3378f"
Allocation "2a4df8ca" created: node "2f0a2f93", group "group1"
Evaluation status changed: "pending" -> "complete"
==> Evaluation "529cc88e" finished with status "complete"
```
Apply multiple recommendations for different jobs:
```shell-session
$ nomad recommendation apply a9c041c5-3c04-aa24-bd55-0a80cded4f10 811900b6-da11-ef08-f515-f5e6684007a8
Errors
None
Results
IDs Namespace Job ID Eval ID Warnings
a9c041c5-3c04-aa24-bd55-0a80cded4f10 default example 7c39ad13-0246-ab8e-6c50-9f3ee500bf5f <none>
811900b6-da11-ef08-f515-f5e6684007a8 default demoapp 68236421-c90f-efa6-fc02-37ae2d59bf03 <none>
```
## General options
@include 'general_options.mdx'