docs: explain behavior of system gc command (#13342)
This commit is contained in:
parent
5ebd06a8f9
commit
f41ea0e5dc
|
@ -10,6 +10,20 @@ description: |
|
|||
Initializes a garbage collection of jobs, evaluations, allocations, and nodes.
|
||||
This is an asynchronous operation.
|
||||
|
||||
Nomad periodically garbage collects jobs, evaluations, allocations, and nodes.
|
||||
The exact garbage collection logic varies by object, but in general Nomad only
|
||||
permanently deletes objects once they are terminal and no longer needed for
|
||||
future scheduling decisions. See [`gc` related server agent configuration
|
||||
parameters][gc_params] for details on tuning periodic garbage collection.
|
||||
|
||||
[gc_params]: /docs/configuration/server#node_gc_threshold
|
||||
|
||||
The `system gc` command bypasses these settings and immediately attempts to
|
||||
garbage collect dead objects regardless of any "threshold" or "interval" server
|
||||
settings. This is useful to quickly free memory on servers running low, but
|
||||
users should prefer tuning periodic garbage collection parameters to meet their
|
||||
needs instead of relying on manually running `system gc`.
|
||||
|
||||
## Usage
|
||||
|
||||
```plaintext
|
||||
|
|
Loading…
Reference in New Issue