mirror of
https://github.com/kemko/nomad.git
synced 2026-01-06 10:25:42 +03:00
dae496e427
* Enhance front matter description for search * acl section * alloc section * config section * deployment section * eval section * job section * license section * namespace section * node section * node pool section * operator section * plugin section * quota section * recommendation section * scaling section * sentinel section * server section * service section * setup section * system section * tls section * var section * volume section * change reference to command reference * Apply suggestions from code review Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com> --------- Co-authored-by: Jeff Boruszak <104028618+boruszak@users.noreply.github.com>
65 lines
2.0 KiB
Plaintext
65 lines
2.0 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: 'nomad node config command reference'
|
|
description: |
|
|
The `nomad node config` command displays configuration details for the specified client. You can also update the client's server list with this command.
|
|
---
|
|
|
|
# `nomad node config` command reference
|
|
|
|
The `node config` command is used to view or modify client configuration
|
|
details. This command only works on client nodes, and can be used to update
|
|
the running client configurations it supports.
|
|
|
|
## Usage
|
|
|
|
```plaintext
|
|
nomad node config [options]
|
|
```
|
|
|
|
The arguments behave differently depending on the flags given. See each flag's
|
|
description below for specific usage information and requirements.
|
|
|
|
## General options
|
|
|
|
@include 'general_options_no_namespace.mdx'
|
|
|
|
## Node Config options
|
|
|
|
- `-servers`: List the client's known servers. Client nodes do not participate
|
|
in the gossip pool, and instead register with these servers periodically over
|
|
the network. The initial value of this list may come from configuration files
|
|
using the [`servers`] configuration option in the client block.
|
|
|
|
If ACLs are enabled, this option requires a token with the 'agent:read'
|
|
capability.
|
|
|
|
- `-update-servers`: Updates the client's server list using the provided
|
|
arguments. Multiple server addresses may be passed using multiple arguments.
|
|
When updating the servers list, you must specify ALL of the server nodes you
|
|
wish to configure. The set is updated atomically. It is an error to specify
|
|
this flag without any server addresses. If you do _not_ specify a port for each
|
|
server address, the default port `4647` will be used.
|
|
|
|
If ACLs are enabled, this option requires a token with the 'agent:write'
|
|
capability.
|
|
|
|
## Examples
|
|
|
|
Query the currently known servers:
|
|
|
|
```shell-session
|
|
$ nomad node config -servers
|
|
server1:4647
|
|
server2:4647
|
|
```
|
|
|
|
Update the list of servers:
|
|
|
|
```shell-session
|
|
$ nomad node config -update-servers server1:4647 server2:4647 server3:4647 server4
|
|
|
|
```
|
|
|
|
[`servers`]: /nomad/docs/configuration/client#servers
|