github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/operator/gossip/keyring-use.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: operator gossip keyring use'
     4  description: |
     5    Use a new gossip encryption key
     6  ---
     7  
     8  # Command: operator gossip keyring use
     9  
    10  The `operator gossip keyring use` command changes the encryption key
    11  used for gossip. The key must already be installed before this
    12  operation can succeed.
    13  
    14  This command can only be run against server nodes. It returns 0 if all nodes
    15  reply and there are no errors. If any node fails to reply or reports failure,
    16  the exit code will be 1.
    17  
    18  If ACLs are enabled, this command requires a token with the `agent:write`
    19  capability.
    20  
    21  ## Usage
    22  
    23  ```plaintext
    24  nomad operator gossip keyring use [options] <key>
    25  ```
    26  
    27  ## General Options
    28  
    29  @include 'general_options_no_namespace.mdx'
    30  
    31  ## Examples
    32  
    33  ```shell-session
    34  $ nomad operator gossip keyring use HD5Y61iE+neTxd1n6TnXhCPViPIUq5QpWq8WW8012XA=
    35  Changing primary gossip encryption key...
    36  ```