A CLI for Crunchy Bridge with very good tab completion.
- For homebrew (on macOS or linux)
brew install CrunchyData/brew/cb
. This will install bothcb
and the fish shell tab completions for you. - For others, download the latest release,
put it somewhere in your path, and be sure to manually install shell tab
completions from the
completions
directory.
First get your application ID
and application secret
from https://www.crunchybridge.com/account
Then run cb login
to register the CLI with your Crunchy Bridge account.
Once you are logged in, you can run cb list
to see all of your clusters, and
cb psql <cluster id>
to securely connect to your database or cb scope
to
run health checks against it. There are many more commands that you can use to
manage things such as log destinations, firewall rules, and more.
To see what commands are available run cb --help
, and to see more detailed
information for a given command add --help
to it, for example cb create --help
.
If you use the fish command line shell and have the completions installed for you (either automatically through homebrew or otherwise), nearly all arguments can be intelligently completed for you. This includes all cluster IDs available to just your account, in addition to normal subcommands and flags. Also where possible the current arguments you've given are taken into consideration. For example if you're creating a new cluster on AWS, instances sizes on Azure or regions in GCP will not be shown.
Install dependencies: crystal
You can run quick checks by executing src/cli.cr
directly. While this can be
handy, it is slow because the executable is being built each time, then
executed. To build a development version run make
or shards build
. The
binary will be at bin/cb
by default. There is a helper script
dev_setup.fish
which puts the local bin directory in your path so the cb
in
that directory will be ran, as well as an scb
alias for running src/cli.cr
.
It will also set up completions for each.
crystal tool --format
will format the code as required. It is useful to have
your editor run this for you on save.
You can run crystal spec
to run all of the specs, or make test
to also run linting checks.
- Fork it (https://github.com/CrunchyData/bridge-cli/fork)
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Include an entry in the changelog
- Create a new Pull Request