regatta-client

Unofficial CLI client for Regatta store

Installation

you can install regatta-client using Homebrew

brew tap tantalor93/regatta-client
brew install regatta-client

or using Go tooling

go install github.com/tantalor93/regatta-client

Usage

Command-line tool wrapping API calls to Regatta (https://engineering.jamf.com/regatta/).
Simplifies querying for data in Regatta store and other operations.

Usage:
  regatta-client [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  delete      Delete data from Regatta store
  help        Help about any command
  put         Put data into Regatta store
  range       Retrieve data from Regatta store

Flags:
      --cert string       regatta CA cert
      --endpoint string   regatta API endpoint (default "localhost:8443")
  -h, --help              help for regatta-client
      --insecure          allow insecure connection, controls whether certificates are validated
  -v, --version           version for regatta-client

Use "regatta-client [command] --help" for more information about a command.

Examples

get all records in table

this example retrieves all records in example-table table

regatta-client --endpoint localhost:8443 --insecure range example-table

get all records in table without decoding keys/values to UTF-8

this example retrieves all records in example-table table without decoding binary data, data is shown as Base64 strings

regatta-client --endpoint localhost:8443 --binary --insecure range example-table

get record by key in table

this example retrieves record with key example-key in example-table table

regatta-client --endpoint localhost:8443 --insecure range example-table example-key

get all records with prefix in table

this example retrieves all records with keys prefixed with example in example-table table

regatta-client --endpoint localhost:8443 --insecure range example-table 'example*'

delete record by key in table

this example deletes record with key example-key in example-table table

regatta-client --endpoint localhost:8443 --insecure delete example-table example-key

delete all records with given prefix in table

this example deletes all records with keys prefixed with example in example-table table

regatta-client --endpoint localhost:8443 --insecure delete example-table 'example*'

delete all records in table

this example deletes all records in example-table table

regatta-client --endpoint localhost:8443 --insecure delete example-table '*'

put data into the table

this example inserts (or updates existing record with same key) into table example-table a record with key example-key and value example-value

regatta-client --insecure --endpoint localhost:8443 put example-table example-key example-value

put binary data into table

to put binary data into Regatta using this tool, you need to encode the value using Base64 and use --binary flag, for example this inserts into table example-table a record with key example-key and value example-value, where the value was provided encoded as Base64 string

regatta-client --binary --insecure --endpoint localhost:8443 put example-table example-key ZXhhbXBsZS12YWx1ZQ==

coufalja / regatta-client