cloudshell

command module
v1.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 5, 2020 License: MIT Imports: 21 Imported by: 0

README

cloudshell

cloudshell gives you access to the Google Cloud Shell from your terminal.

It's like gcloud alpha cloud-shell, but simpler and packed into a single binary.

Installation

  1. Install Go 1.15 if you haven't yet.

  2. Two installation options are supported:

    • Install with go get:

       $ pushd $(mktemp -d); go mod init tmp; go get github.com/astrophena/cloudshell; popd
      

      go get puts binaries by default to $GOPATH/bin (e.g. ~/go/bin).

      Use GOBIN environment variable to change this behavior.

    • Install with make:

       $ git clone https://github.com/astrophena/cloudshell
       $ cd cloudshell
       $ make install
      

      make install installs cloudshell by default to $HOME/bin.

      Use PREFIX environment variable to change this behavior:

       $ make install PREFIX="$HOME/.local" # Installs to $HOME/.local/bin.
      

Setup

  • Create a project in the Google API Console.
  • Enable the Cloud Shell API.
  • Create credentials, download and place them to:
    • $XDG_CONFIG_HOME/cloudshell/client_secrets.json (Linux)
    • $HOME/Library/Application Support/cloudshell/client_secrets.json (macOS)
  • Run any command (e.g. cloudshell info) to authenticate.
  • Add your SSH key by running cloudshell key add.
  • Try to connect: cloudshell connect.

License

MIT © Ilya Mateyko

Documentation

Overview

cloudshell is the Google Cloud Shell CLI.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL