Giter Club home page Giter Club logo

koyeb-cli's Introduction

Build

Koyeb CLI

The Koyeb CLI (Command Line Interface) is a powerful tool to manage your Koyeb serverless infrastructure directly from your terminal.

Installation

Download from GitHub

The CLI can be installed from pre-compiled binaries for macOS (darwin), Linux and Windows. You can download the appropriate version from the Releases page.

MacOS

You can install the latest version of the Koyeb CLI on macOS using Homebrew:

brew install koyeb/tap/koyeb

You can upgrade an existing installation of the Koyeb CLI running:

brew upgrade koyeb

Living at the Edge

To install the latest koyeb binary with go, simply run:

go get github.com/koyeb/koyeb-cli/cmd/koyeb
go install github.com/koyeb/koyeb-cli/cmd/koyeb

If you need a go environment, follow the official Go installation documentation.

Getting started

Initial configuration

Generate an API token and run koyeb login to create a new configuration file.

➜ koyeb login
? Do you want to create a new configuration file in (/Users/kbot/.koyeb.yaml)? [y/N]
✗ Enter your api access token, you can create a new token here ( https://app.koyeb.com/account/api ): █****************************************************************
INFO[0006] Creating new configuration in /Users/kbot/.koyeb.yaml

General usage

➜ koyeb --help
Koyeb CLI

Usage:
  koyeb [command]

Available Commands:
  apps        Apps
  completion  Generate completion script
  deployments Deployments
  help        Help about any command
  instances   Instances
  login       Login to your Koyeb account
  secrets     Secrets
  services    Services
  version     Get version

Flags:
  -c, --config string   config file (default is $HOME/.koyeb.yaml)
  -d, --debug           debug
      --full            show full id
  -h, --help            help for koyeb
  -o, --output string   output format (yaml,json,table)
      --token string    API token
      --url string      url of the api (default "https://app.koyeb.com")

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

Enabling shell auto-completion

koyeb has auto-completion support for bash, zsh and fish.

Bash

You can easily do source <(koyeb completion bash) to add completion to your current Bash session.

To load completions for all sessions, simply add the auto-completion script to your bash_completion.d folder.

On Linux:

koyeb completion bash > /etc/bash_completion.d/koyeb

On MacOs:

koyeb completion bash > /usr/local/etc/bash_completion.d/koyeb

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

Zsh

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 automatically load completions for all your shell session, execute once:

koyeb completion zsh > "${fpath[1]}/_koyeb"

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

Fish

You can easily run koyeb completion fish | source to add completions to your current Fish session.

To automatically load completions for all your shell session, execute once:

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

Contribute

Checkout CONTRIBUTING.md

koyeb-cli's People

Contributors

brmzkw avatar bchatelard avatar novln avatar nicoche avatar edouardb avatar antham avatar torrefatto avatar pawelbeza avatar imchairmanm avatar razvanazamfirei avatar nokrik avatar llecoq avatar lukaszo avatar arm4b avatar cherryblossom000 avatar dependabot[bot] avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.