Install and configure

Install ybm, configure default settings, and set up autocompletion

Install ybm

To install ybm, download the appropriate binary from the ybm-cli GitHub project releases.

On MacOS and Linux, you can also install ybm using Homebrew by entering the following command:

brew install yugabyte/tap/ybm

If you don't have a YugabyteDB Aeon account yet, you can use the following command to bring up the sign up page:

ybm signup

For help, enter the following command:

ybm help

Upgrade ybm

To upgrade ybm using Homebrew, enter the following commands:

brew update && brew upgrade ybm

Configure ybm

Using ybm CLI requires providing, at minimum, an API key.

You can pass the key as a flag when running ybm commands. For example:

ybm cluster list --apiKey "eyJ..."

For convenience, you can configure ybm with a default API key as follows:

  • Use the auth command to write the key to a YAML configuration file, as follows:

    ybm auth
    

    At the prompt, paste your API key and press Enter.

    By default, this writes the value to the file .ybm-cli.yaml under your $HOME directory.

    You can create multiple configuration files, and switch between them using the --config flag. You can add any of the other global flags to your configuration files.

  • Using environment variables. Environment variables must begin with YBM_. For example:

    export YBM_APIKEY=AWERDFSSS
    ybm cluster list
    

If a value is set in an environment variable and a configuration file, the environment variable takes precedence. Setting the value using the flag takes precedence over both.

Environment variables

You can set the following ybm environment variables.

Variable Description
YBM_APIKEY The API key to use to authenticate to your YugabyteDB Aeon account.
YBM_CI Set to true to avoid outputting unnecessary log lines.
YBM_AWS_SECRET_KEY AWS secret access key. For encryption at rest of AWS clusters.

Autocompletion

You can configure command autocompletion for your shell using the completion command. For example:

ybm completion bash

This generates an autocompletion script for the specified shell. Available options are as follows:

  • bash
  • fish
  • powershell
  • zsh

Bash

ybm CLI autocompletion depends on the 'bash-completion' package. If not already installed, install it using your operating system's package manager.

To load completions in your current shell session, enter the following command:

source <(ybm completion bash)

To load completions for every new session, execute the following command:

#### for Linux:
ybm completion bash > /etc/bash_completion.d/ybm

#### for macOS:
ybm completion bash > $(brew --prefix)/etc/bash_completion.d/ybm

Start a new shell for the setup to take effect.

fish

To load completions in your current shell session, use the following command:

ybm completion fish | source

To load completions for every new session, execute the following command:

ybm completion fish > ~/.config/fish/completions/ybm.fish

Start a new shell for the setup to take effect.

PowerShell

To load completions in your current shell session, use the following command:

ybm completion powershell | Out-String | Invoke-Expression

To load completions for every new session, add the output of the preceding command to your PowerShell profile.

Zsh

If shell completion is not already enabled in your environment, you can turn it on by running the following command:

echo "autoload -U compinit; compinit" >> .zshrc

To load completions in your current shell session, enter the following command:

source <(ybm completion zsh); compdef _ybm ybm

To load completions for every new session, execute the following:

#### for Linux:
ybm completion zsh > "${fpath[1]}/_ybm"

#### for macOS:
ybm completion zsh > $(brew --prefix)/share/zsh/site-functions/_ybm

Start a new shell for the setup to take effect.