github.com/Ilhicas/nomad@v1.0.4-0.20210304152020-e86851182bc3/website/content/docs/commands/node/config.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: node config'
     4  sidebar_title: config
     5  description: |
     6    The node config command is used to view or modify client configuration.
     7  ---
     8  
     9  # Command: node config
    10  
    11  The `node config` command is used to view or modify client configuration
    12  details. This command only works on client nodes, and can be used to update
    13  the running client configurations it supports.
    14  
    15  ## Usage
    16  
    17  ```plaintext
    18  nomad node config [options]
    19  ```
    20  
    21  The arguments behave differently depending on the flags given. See each flag's
    22  description below for specific usage information and requirements.
    23  
    24  ## General Options
    25  
    26  @include 'general_options_no_namespace.mdx'
    27  
    28  ## Node Config Options
    29  
    30  - `-servers`: List the client's known servers. Client nodes do not participate
    31    in the gossip pool, and instead register with these servers periodically over
    32    the network. The initial value of this list may come from configuration files
    33    using the [`servers`] configuration option in the client block.
    34  
    35    If ACLs are enabled, this option requires a token with the 'agent:read'
    36    capability.
    37  
    38  - `-update-servers`: Updates the client's server list using the provided
    39    arguments. Multiple server addresses may be passed using multiple arguments.
    40    When updating the servers list, you must specify ALL of the server nodes you
    41    wish to configure. The set is updated atomically. It is an error to specify
    42    this flag without any server addresses. If you do _not_ specify a port for each
    43    server address, the default port `4647` will be used.
    44  
    45    If ACLs are enabled, this option requires a token with the 'agent:write'
    46    capability.
    47  
    48  ## Examples
    49  
    50  Query the currently known servers:
    51  
    52  ```shell-session
    53  $ nomad node config -servers
    54  server1:4647
    55  server2:4647
    56  ```
    57  
    58  Update the list of servers:
    59  
    60  ```shell-session
    61  $ nomad node config -update-servers server1:4647 server2:4647 server3:4647 server4
    62  
    63  ```
    64  
    65  [`servers`]: /docs/configuration/client#servers