Kubernetes Quickstart

This section describes how to quickly install Vamp 1.0 on Kubernetes so you can evaluate it. The installation uses an installer built into the Vamp Lifter application to bootstrap a full Vamp installation.

After a successful installation, you will be able to login to Vamp EE as an admin user and deploy services.

Note!

Do not run this default installation in production! It does not include persistent storage and makes use of a Hashicorp Vault ‘dev’ server.

What You’ll Need

  • A machine on which to run the installation. This can be your laptop, a virtual machine instance or a Docker container that has kubectl installed
  • A Kubernetes cluster on which to install Vamp
    • This can be a 1.8.x, 1.9.x or 1.10.x cluster
    • The cluster should have 4 nodes and a minimum of 2 vCPUs and 7GB memory per node

Azure

To launch a suitable cluster on Azure follow the Azure Kubernetes Service (AKS) Quickstart guide.

Google Cloud

To launch a suitable cluster on Google Cloud follow the Kubernetes Engine (GKE) Quickstart guide.

Deploying Vamp Lifter

  • Sign up for a Vamp Enterprise Edition trial, if you haven’t already. Then download the lifter-standalone.yml file
  • Download the clusterrolebinding.yml file
  • Configure kubectl command line access to your Kubernetes cluster
  • Create a cluster-admin user. This step can be skipped if you already have a suitable user with the cluster-admin role.
  kubectl create -f clusterrolebinding.yml
  • Deploy the Vamp Lifter application into the default Kubernetes namespace:
  kubectl --namespace default create -f lifter-standalone.yml

Install Vamp and dependencies

  • Start a HTTP Proxy to allow access the Vamp Lifter UI
  kubectl proxy &

This will start a proxy server on http://localhost:8001

  • Create a link to the Vamp Lifter UI
  kubectl --namespace default get pods -l app=lifter -o go-template --template '{{range .items}}http://localhost:8001/api/v1/namespaces/default/pods/{{.metadata.name}}/proxy/{{"\n"}}{{end}}'
  • Open the link to the Vamp Lifter UI in your web browser
  • Select Installer → Deploy
  • Click on the Deploy button (top right), this will start the installation and:
    • Deploy MySQL, Hashicorp Vault and Elasticsearch into the default Kubernetes namespace
    • Create a sample organisation called organisation
    • Create a sample environment called environment for the sample organisation
    • Create a Kubernetes namespace called vampio-organisation-environment
    • Install the Vamp Gateway Agent (VGA) into the vampio-organisation-environment namespace
    • Deploy the Vamp application into the default Kubernetes namespace
  • To view the progress of the installation, click on the Log tab

Login to the Vamp UI

At the end of the installer log there is a message with a link to the Vamp UI, paste this link into your web browser

You can login using the username: admin and password: abc12345

If necessary, you can regenerate the link with the following command:

kubectl --namespace default get pods -l app=vamp -o go-template --template '{{range .items}}http://localhost:8001/api/v1/namespaces/default/pods/{{.metadata.name}}/proxy/{{"\n"}}{{end}}'

What next?

If you need help you can find us on Gitter

Last updated on September 7, 2018