evrblk is an official all-in-one CLI tool for all Everblack services. It can be used for:

• calling API methods on all Everblack services:
  • Grackle
  • Moab
  • Bison
  • IAM
  • MyAccount
• working with API keys (Alfa, Bravo)

$ go install github.com/evrblk/evrblk-cli/cmd/evrblk

$ evrblk <SERVICE> <METHOD> --endpoint=<ENDPOINT>

• SERVICE is a versioned name of a service, i.e. grackle-preview
• METHOD is a method name, i.e. list-namespaces
• ENDPOINT is an address of API gateway, i.e. localhost:8000

evrblk takes a JSON request via a pipe and prints JSON response from the API call:

# use echo
$ echo '{"namespace_name": "my_namespace"}' | evrblk grackle-preview list-semaphores --endpoint=localhost:8000

# or use files
$ cat acquire_lock_request.json | evrblk grackle-preview acquire-lock --endpoint=localhost:8000

By default evrblk runs in unauthenticated mode. To use authentication add API keys via env variables:

export EVRBLK_API_KEY_ID=<KEY_ID>
export EVRBLK_API_SECRET_KEY=<KEY_SECRET>

• evrblk authn generate-alfa-key generates Alfa key. Store the private PEM along with your application and pass to Everblack SDK. Take the public PEM into the cloud or into your own installation (save as a file named with prefix key_alfa_).
• evrblk authn generate-bravo-key generates Bravo key. Store the secret along with your application and pass to Everblack SDK. Take the same secret into your own installation (save as a file named with prefix key_bravo_).

Everblack CLI is released under the MIT License.