Installation

Before you can install the Release Agent you need to create an application using the Vamp Cloud UI

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.

The installer token must be used within 30 minutes.

Time limited installation command
  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.