Skip to content

symbiosis-cloud/cli

Repository files navigation

Symbiosis Cloud CLI


Easily manage all symbiosis related resources with our user-friendly CLI tool.

Installation

Homebrew

brew install symbiosis-cloud/tap/cli

Linux

curl -s https://raw.githubusercontent.com/symbiosis-cloud/cli/main/install.sh | sh

Usage

Using your Symbiosis Cloud login

In order to get started using your Symbiosis Cloud login, simply run:

sym login

A browser window will open and ask you to login to your team. Once you're logged in your CLI client is ready.

Using an API key

If you do not have a Symbiosis account already, you can head over to https://app.symbiosis.host/signup to signup for a new account.

Once you are logged in you will need to create an API key with admin permissions.

  1. Head over to https://app.symbiosis.host/api-keys to generate a new API key
  2. run sym config init

Functionality

Currently the CLI is in Beta. We only expose a limited number of CLI commands currently but are aiming for a more comprehensive set of features soon.

Clusters

  • Create cluster
  • Delete cluster
  • List clusters
  • Describe cluster
  • Get cluster identity

Node pools

  • Create node pool
  • Delete node pool
  • Describe node pool
  • List node pools

Autocomplete

To load completions:

Bash

# To load completions for each session, execute once:

# Linux:
$ sym completion bash > /etc/bash_completion.d/sym

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

Zsh (Linux / macOS)

# If shell completion is not already enabled in your environment,
# you will need to enable it.  You can execute the following once:

$ echo "autoload -U compinit; compinit" >> ~/.zshrc

# To load completions for each session, execute once:
$ sym completion zsh > "${fpath[1]}/_sym"

# You will need to start a new shell for this setup to take effect.

fish:

$ sym completion fish | source

# To load completions for each session, execute once:
$ sym completion fish > ~/.config/fish/completions/sym.fish

PowerShell

PS> sym completion powershell | Out-String | Invoke-Expression

# To load completions for every new session, run:
PS> sym completion powershell > sym.ps1
# and source this file from your PowerShell profile.