hedzr / consul-tags

A CLI tool to Update, add, remove the service tags at consul store.

Consul Service Tags Modifier

consul-tags can add, remove tag(s) of a consul service (one or all its instances).

Here is a first release for key functionality.

News

v0.7.3

• upgrade deps

v0.7.1

• fixed and re-enable docker build

v0.7.0

• move to go1.17+
• upgrade to the newest consul api
• upgrade hedzr/cmdr to v1.11.6+
• a slightly smaller binary file

v0.6.1

• upgrade to the newest consul api
• upgrade hedzr/cmdr to v1.8.0+

v0.5.9

• fixed release files

v0.5.7

• update the CI scripts
• re-enable the docker image on Docker Hub

v0.5.5

• update all codes with newest deps: cmdr, log, logex, errors.v2, ...

v0.5.1

• new release has been testing and released soon.
• it has been rewrote and optimized.

v0.5.0 is a pre-release

• rewrote by cmdr
• pre-released for v0.5.1 (final)

Install

Binary

Download binary from Release page.

Docker Hub (paused since v0.5.x)

docker pull hedzr/consul-tags
docker run -it --rm hedzr/consul-tags --addr 192.168.0.71:8500 ms --name test-redis tags ls

Replace 192.168.0.71 with your consul center ip or name.

DON'T use 127.0.0.1 with dockerize release.

latest: master branch and based on golang:alpine

Go Build

clone the repo and build:

cd $GOPATH/github.com/hedzr/consul-tags
go mod download
go build -o consul-tags ./cli/main.go 

mixin:

go get -u github.com/hedzr/consul-tags

Usage

# run consul demo instance for testing
./build.sh consul run &

# use the local consul demo instance as default addrress, see also `--addr` in `consul-tags ms --help`
export CT_APP_MS_ADDR=localhost:8500

# list services
consul-tags ms ls

# list tags
consul-tags ms --name test-redis tags ls
consul-tags ms tags ls --name test-redis

# modify tags
consul-tags ms tags modify --name test-redis tags --add a,c,e
consul-tags ms tags mod --name test-redis --add a --add c --add e
consul-tags ms tags mod --name test-redis --rm a,c,e
consul-tags ms tags mod --name test-redis --rm a --rm c --rm e
# by id
consul-tags ms tags ls --id test-redis-1

# toggle master/slave
consul-tags ms tags toggle --name test-redis --addr 10.7.13.1:6379 --set role=master --reset role=slave
consul-tags ms tags tog --name test-mq --addr 10.7.16.3:5672 --set role=leader,type=ram --reset role=peer,type=disk

# get commands and sub-commands help
consul-tags ms -h
# get help: -h or --help
consul-tags -h

Default consul address is consul.ops.local:8500, can be overridden with environment variable CT_APP_MS_ADDR (host:port), too. Such as:

export CT_APP_MS_ADDR=localhost:8500
consul-tags ms tags ls --name=consul
# or
CT_APP_MS_ADDR=localhost:8500 consul-tags --help
# or
consul-tags ms tags ls --name=consul --addr 127.0.0.1:8500

COMMANDS

     kv              K/V pair Operations, ...
     ms, service, m  Microservice Operations, ...
     help, h         Shows a list of commands or help for one command

GLOBAL OPTIONS

   --help, -h                          show help (default: false)
   --version, -v                       print the version (default: false)

Shell completion

consul-tags gen sh --zsh
consul-tags gen sh --bash

Thanks

my plan is building a suite of devops. consul operations is part of it.

and some repositories are good:

• colebrumley/consul-kv-backup
• https://github.com/shreyu86/consul-backup
• https://github.com/kailunshi/consul-backup

Third-party repos

License

MIT/APache 2.0