Skip to content

getting-started.md

Latest commit

 

History

History
88 lines (51 loc) · 3.53 KB

getting-started.md

File metadata and controls

88 lines (51 loc) · 3.53 KB

Get Started with Kubeapps

Kubeapps is a set of tools written by Bitnami to super-charge your Kubernetes cluster with:

  • Your own applications dashboard, allowing you to deploy Kubernetes-ready applications into your cluster with a single click.
  • Kubeless - a Kubernetes-native Serverless Framework, compatible with serverless.com.
  • SealedSecrets - a SealedSecret can be decrypted only by the controller running in the cluster and nobody else (not even the original author).

This guide will walk you through the process of deploying Kubeapps for your cluster and installing an example application.

Prerequisites

Kubeapps assumes a working Kubernetes (v1.8+) with RBAC enabled and kubectl installed and configured to talk to your Kubernetes cluster. Kubeapps binaries are available for both Linux and OS X, and Kubeapps has been tested with both minikube, Google Kubernetes Engine (GKE) and Azure Container Service (AKS).

Step 1: Install Kubeapps

To install Kubeapps, download the latest Kubeapps Installer binary for your platform from the release page.

Review our installation guide for more detailed instructions.

Once the Kubeapps Installer is installed, deploy Kubeapps in your cluster with this command:

kubeapps up

You should see something like this as Kubeapps is deployed:

Kubeapps deployment

If you would like to see what exactly kubeapps up is installing on your system, we provide --dry-run option to show you the Kubeapps manifest as below:

kubeapps up --dry-run -o yaml

# prefer json format
kubeapps up --dry-run -o json

To remove Kubeapps from your cluster, run this command:

kubeapps down

Step 2: Start the Kubeapps Dashboard

Once Kubeapps is installed, securely access the Kubeapps Dashboard from your system by running:

kubeapps dashboard

This will start an HTTP proxy for secure access to the Kubeapps Dashboard and launch your default browser to access it. Here's what you should see:

Dashboard main page

Step 3: Deploy WordPress

Once you have the Kubeapps Dashboard up and running, you can start deploying applications into your cluster.

  • Use the "Charts" page in the Dashboard to select an application from the list of charts in the official Kubernetes chart repository. This example assumes you want to deploy WordPress.

    WordPress chart

  • Click the "Deploy using Helm" button.

    WordPress chart

  • You will be prompted for the release name, cluster namespace and values for the application.

    WordPress installation

  • Click the "Submit" button. The application will be deployed. You will be able to track the new Kubernetes deployment directly from the browser.

    WordPress deployment

To obtain the WordPress username and password, refer to the "Notes" section of the deployment page, which contains the commands you will need to run to obtain the credentials for the deployment.

WordPress deployment notes

Next Steps

Learn more about Kubeapps with the links below: