Last modified April 20, 2022

Installing kubectl-gs

kubectl-gs is the Giant Swarm plug-in for kubectl with the official plug-in name gs.

The latest version is v2.19.2.

The simplest way to manage kubectl plug-ins across platforms is using Krew. If you don’t have Krew installed, check the Krew installation docs on how to get it installed.

Further down you will also find instructions on installing kubectl-gs without Krew and additional platform-specific instructions.

Using Krew

To install the gs plug-in, simply execute this command:

kubectl krew install gs

Lastly, let’s check that the plug-in is working as it’s supposed to.

kubectl gs

You should see information regarding the commands available.

To upgrade to the latest version of the plug-in, use this command:

kubectl krew upgrade gs

Without Krew

For platform-specific instuctions, please select a platform below.

  1. Download the release binary

    curl -L https://github.com/giantswarm/kubectl-gs/releases/download/v2.19.2/kubectl-gs-v2.19.2-linux-amd64.tar.gz -o kubectl-gs-v2.19.2-linux-amd64.tar.gz
    
  2. Unpack the downloaded package

    tar xzf kubectl-gs-v2.19.2-linux-amd64.tar.gz
    
  3. Copy the executable into a folder included in your PATH

    sudo cp kubectl-gs-v2.19.2-linux-amd64/kubectl-gs /usr/local/bin/
    
  1. Download the release binary

    curl -L https://github.com/giantswarm/kubectl-gs/releases/download/v2.19.2/kubectl-gs-v2.19.2-linux-arm64.tar.gz -o kubectl-gs-v2.19.2-linux-arm64.tar.gz
    
  2. Unpack the downloaded package

    tar xzf kubectl-gs-v2.19.2-linux-arm64.tar.gz
    
  3. Copy the executable into a folder included in your PATH

    sudo cp kubectl-gs-v2.19.2-linux-arm64/kubectl-gs /usr/local/bin/
    
  1. Download the release binary

    curl -L https://github.com/giantswarm/kubectl-gs/releases/download/v2.19.2/kubectl-gs-v2.19.2-darwin-amd64.tar.gz -o kubectl-gs-v2.19.2-darwin-amd64.tar.gz
    
  2. Unpack the downloaded package

    tar xzf kubectl-gs-v2.19.2-darwin-amd64.tar.gz
    
  3. Copy the executable into a folder included in your PATH

    sudo cp kubectl-gs-v2.19.2-darwin-amd64/kubectl-gs /usr/local/bin/
    
  1. Download the release binary

    curl -L https://github.com/giantswarm/kubectl-gs/releases/download/v2.19.2/kubectl-gs-v2.19.2-darwin-arm64.tar.gz -o kubectl-gs-v2.19.2-darwin-arm64.tar.gz
    
  2. Unpack the downloaded package

    tar xzf kubectl-gs-v2.19.2-darwin-arm64.tar.gz
    
  3. Copy the executable into a folder included in your PATH

    sudo cp kubectl-gs-v2.19.2-darwin-arm64/kubectl-gs /usr/local/bin/
    

Please note that we only provide a 64bit release.

  1. Download the release ZIP file

  2. Extract the downloaded ZIP file

  3. Copy kubectl-gs.exe to a location that is included in your %PATH%. For example:

    %USERPROFILE%\AppData\Local\Microsoft\WindowsApps
    
  1. Install the kubectl-gs binary for Linux first. You can use the instructions using Krew shown above, or follow the Linux instructions without Krew.

  2. Run the following command so that kubectl gs login can open your browser:

    sudo ln -s $(which wslview) /usr/local/bin/xdg-open
    

Docker

We offer a Docker image via our public Quay repository. The semantic release version number is used to tag images.

  1. Pull the image

    docker pull quay.io/giantswarm/kubectl-gs:2.19.2
    
  2. Execute a command

    docker run --rm -ti quay.io/giantswarm/kubectl-gs:2.19.2 help