Skip to content

Latest commit

 

History

History
88 lines (60 loc) · 3.15 KB

install.md

File metadata and controls

88 lines (60 loc) · 3.15 KB

Installation

Kubeapps assumes a working Kubernetes (v1.8+) with RBAC enabled and kubectl installed and configured to talk to your Kubernetes cluster.

Kubeapps has been tested with both minikube, Kubernetes Engine (GKE) and Azure Container Service (AKS).

On GKE, you must either be an "Owner" or have the "Container Engine Admin" role in order to install Kubeapps.

Install pre-built binary

  • Download a binary version of the latest Kubeapps Installer for your platform from the release page. Currently, the Kubeapps Installer is distributed in binary form for Linux, OS X and Windows (64-bit).
  • Make the binary executable.

For example, to install the latest binary release on Linux or OS X, use this command:

curl -s https://api.github.com/repos/kubeapps/kubeapps/releases/latest | grep -i $(uname -s) | grep browser_download_url | cut -d '"' -f 4 | wget -i -
sudo mv kubeapps-linux-amd64 /usr/local/bin/kubeapps
sudo chmod +x /usr/local/bin/kubeapps

Build binary from source

The Kubeapps Installer is a CLI tool written in Go that will deploy the Kubeapps components into your cluster. You can build the latest Kubeapps Installer from source by following the steps below:

  • Visit the Go website, download the most recent binary distribution of Go and install it following the official instructions.

    The remainder of this section assumes that Go is installed in /usr/local/go. Update the paths in subsequent commands if you used a different location.

  • Set the Go environment variables:

    export GOROOT=/usr/local/go
export GOPATH=/usr/local/go
export PATH=$GOPATH/bin:$PATH

  • Create a working directory for the project:

    working_dir=$GOPATH/src/github.com/kubeapps/
mkdir -p $working_dir

  • Clone the Kubeapps source repository:

    cd $working_dir
git clone https://github.com/kubeapps/kubeapps

  • Build the Kubeapps binary and move it to a location in your path:

    cd kubeapps
make binary
cp kubeapps /usr/local

Next Steps

Confirm that kubectl is installed and verify the Kubernetes version:

kubectl version
Client Version: version.Info{Major:"1", Minor:"7", GitVersion:"v1.7.0", GitCommit:"d3ada0119e776222f11ec7945e6d860061339aad", GitTreeState:"clean", BuildDate:"2017-06-29T23:15:59Z", GoVersion:"go1.8.3", Compiler:"gc", Platform:"darwin/amd64"}
Server Version: version.Info{Major:"1", Minor:"8", GitVersion:"v1.8.0", GitCommit:"0b9efaeb34a2fc51ff8e4d34ad9bc6375459c4a4", GitTreeState:"dirty", BuildDate:"2017-10-17T15:09:55Z", GoVersion:"go1.8.3", Compiler:"gc", Platform:"linux/amd64"}

Use the Kubeapps Installer to deploy Kubeapps and launch a browser with the Kubeapps dashboard.

kubeapps up
kubeapps dashboard

To remove Kubeapps, use this command:

kubeapps down

Useful Resources