Before You Begin

kubectl

You must install and set up kubectl the Kubernetes command-line tool before you can run the Vamp Release Agent installer.

NGINX Ingress Controller

If you selected NGINX as the ingress controller for your application and it was installed using these instructions, then the Release Agent installer needs no further configuration.

If NGINX is installed in a different location or there are multiple NGINX Ingress controllers running the cluster, then you need follow these instructions.

Contour Ingress Controller

If you selected CONTOUR as the ingress controller the Release Agent installer needs no further configuration.

Prometheus

The Vamp Release Agent relies on an instance of Prometheus being available. Prometheus is a commonly used open-source monitoring system and time series database.

NGINX

The installer looks for this service prometheus-server.nginx-ingress:9090 by default.

If you installed Prometheus using these instructions, then the Release Agent installer needs no further configuration.

If your Prometheus server is installed in a different location or has a the different name, then follow these instructions.

Contour

The installer looks for this service prometheus.projectcontour-monitoring:9090 by default.

If you installed using these instructions, then the Release Agent installer needs no further configuration.

If Prometheus server is installed in a different location then follow these instructions to configure a custom Prometheus location.

Installing the Release Agent

1. Check that kubectl is configured for the cluster when you want to install the Vamp Release Agent. You can do this with the get-context command:

kubectl config get-context

The command displays the details of each of the defined contexts as well as the currently selected context, indicated by the asterisk (*).

CURRENT   NAME         CLUSTER          AUTHINFO        NAMESPACE
*         test         gke-test         gke-test     
          staging      gke-staging      gke-staging
          production   gke-production   gke-production

1. If you want to use a different context, you can do this with the use-context command. For example:

kubectl config use-context staging

1. The installer requires a token that is unique to an application, this token is generated using the Vamp Cloud UI.

1. Run the install command:

$ curl -sSL https://vampcloud.github.io/vamp-cloud-installer/install.sh | sh -s -- <token>

If the Vamp Release Agent is successfully installed you will see these messages:

 Sending success status to Vamp Cloud
 ---------------------------------------------
 
Sent
​
 +------------------------------------------+
 |                                          |
 | Done!                                    |
 |                                          |
 +------------------------------------------+

If the Vamp Release Agent is not installed successfully then the installer will display an error message which you can use to find the solution in the Troubleshooting Guide.