With the CLI

Install the CLI

It can can be installed with homebrew by running:

brew install CrunchyData/brew/cb

You can update to newer versions with:

brew upgrade cb

You can also find packaged releases available on GitHub

Tab completion

The Crunchy Bridge CLI offers tab completion so you can easily find the syntax for line completion. The CLI works best when used with the Fish (Friendly Interactive Shell) shell.

Authentication and API keys

The CLI will connect to your Bridge account via an API key. You can create and access API keys in your Account Settings. You'll need to create an API key before you can login to the CLI for the first time. This API key will remain part of your account until you delete it.

After creating your API key, run:

cb login

Paste the application ID and application secret into the terminal when prompted. To confirm that you are logged in, or to see your username, run cb whoami.

A CLI tutorial is available on YouTube at https://www.youtube.com/watch?v=tZNfZ-rl65I.

Creating a cluster

commandaboutrequireddefault valuevalues
-h, --helpShow this helpno
--planPlan (server vCPU+memory)yeshobby-2, hobby-4, standard-8, standard-16, standard-32, standard-64, standard-128, standard-192, standard-384, memory-16, memory-32, memory-64, memory-128, memory-512, memory-768
-n, --nameCluster namenoCluster date+timeYou can create custom cluster names with standard ASCII characters
-p, --platformCloud provideryesaws, azr, gcp
-r, --regionCluster regionyesGCP: asia-northeast1 (Tokyo) asia-south1 (Mumbai) australia-southeast1 (Sydney) europe-north1 (Finland) europe-west1 (Belgium) europe-west3 (Frankfurt) northamerica-northeast1 (Montreal) us-central1 (Iowa) us-east4 (Virginia) us-west1 (Oregon) AWS: ap-northeast-1 (Tokyo) ap-southeast-1 (Singapore) ap-southeast-2 (Sydney) ap-south-1 (Mumbai) ca-central-1 (Toronto) eu-central-1 (Frankfurt) eu-north-1 (Stockholm) eu-south-1 (Milan) eu-west-1 (Ireland) eu-west-3 (Paris) sa-east-1 (Sao Paulo) us-east-1 (N. Virginia) us-east-2 (Ohio) us-west-1 (N. California) us-west-2 (Oregon) Azure: australiaeast (Australia) australiasoutheast (Australia) canadacentral (Toronto) centralus (Iowa)
-s, --storageSize of cluster in GByesAny number from 10 - 20480
-t, --teamTeam IDyesTo get your list of team ids, use cb teams
--networkNetworknoNew networkTo get the network of an existing cluster, use the cb info command
--replicaCommand to create replica of existing clusternoInput the ID of the cluster you want to replicate. Cluster IDs can be found with cb list.
--forkCommand to create a fork / point-in-time recovery of an existing clusternoInput the ID of the cluster you want to fork, Cluster IDs can be found with cb list.
--at timeTime for create fork/PITRnoCurrent timeRecovery point in RFC3339 for the last 10 days. Example UTC: 2021-10-12T23:20:50.52Z or with timezone offset: 2021-10-12T16:20:50.52-07:00.

For example:

cb create --platform aws --plan standard-8 --region us-east-2 --ha false --storage 100 -t fb545b7f7jfbhfrrdnnupz6qvm

Which would produce something like:

Created cluster vz72xkaswnbhpaxddxzfhzgimq "Cluster 2021-10-19 15_02_09"

Or to create a replica:

cb create --platform aws --plan hobby-2 --region us-east-2 --ha false --storage 10 --replica vz72xkaswnbhpaxddxzfhzgimq --team fb545b7f7jfbhfrrdnnupz6qvm

Which would produce:

Created cluster ojmu5tgjj5cn5gm763oto6irf4 "Replica of Cluster 2021-10-19 15_02_09"

Available CLI Commands

For a full list of available commands, see the CLI documentation page or run cb --help on the command line.