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.
- 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
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
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