» Serf Tags
Command: serf tags
The serf tags
command modifies a member's tags while the Serf agent is running.
The changed tags will be immediately propagated to other members in the
cluster.
By default, any tag changes made at runtime are not written to disk.
Tag persistence can be enabled using the -tags-file
option to the Serf
agent. More information is available on the
agent configuration options page.
Tag changes can also be handled using
event handlers and the
member-update
event.
» Usage
Usage: serf tags [options]
At least one of -set
or -delete
must be passed. The list of available
flags are:
-set
- Will either create a new tag on a member, or update it if it already exists with a new value. Must be passed as-set tag=value
. Can be passed multiple times to set multiple tags.-delete
- Delete an existing tag from a member. Can be passed multiple times to delete multiple tags.-rpc-addr
- Address to the RPC server of the agent you want to contact to send this command. If this isn't specified, the command will contact "127.0.0.1:7373" which is the default RPC address of a Serf agent. This option can also be controlled using theSERF_RPC_ADDR
environment variable.-rpc-auth
- Optional RPC auth token. If the agent is configured to use an auth token, then this must be provided or the agent will refuse the command. This option can also be controlled using theSERF_RPC_AUTH
environment variable.