Search…
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, 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, you need to follow these instructions.

Contour Ingress Controller

If you selected Contour as the Ingress controller, the Release Agent installer needs no further configuration.

No Ingress Controller

If you selected No Ingress as the Ingress controller, the Release Agent installer needs no further configuration.

Prometheus

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

NGINX

By default, the installer looks for this service: prometheus.monitoring:9090.
If you installed Prometheus using the prometheus-community/helm-charts, the Release Agent installer needs no further configuration.
If the Prometheus server is installed in a different location, follow these instructions to configure a custom Prometheus location.

Contour

By default, the installer looks for this service: prometheus.projectcontour-monitoring:9090.
If you installed using these instructions, the Release Agent installer needs no further configuration.
If the Prometheus server is installed in a different location, follow these instructions to configure a custom Prometheus location.

No Ingress

By default, the installer looks for this service: prometheus.monitoring:9090.
If you installed Prometheus using the prometheus-community/helm-charts, the Release Agent installer needs no further configuration.
If the Prometheus server is installed in a different location, follow these instructions to configure a custom Prometheus location.

Installing the Release Agent

Step 1

Check that kubectl is configured for the cluster where you want to install the Vamp Release Agent. You can do this with the get-context command:
1
kubectl config get-context
Copied!
The command displays the details of each of the defined contexts, as well as the currently selected context, indicated by the asterisk (*).
1
CURRENT NAME CLUSTER AUTHINFO NAMESPACE
2
* test gke-test gke-test
3
staging gke-staging gke-staging
4
production gke-production gke-production
Copied!

Step 2

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

Step 3

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

Step 4

If the application namespace doesn't exist then it will be automatically created.
If the application namespace already exists, you need to follow these instructions and create a Kubernetes Secret before running the installer
If your Prometheus is in a custom location, please follow these instructions before running the installer.
Run the install command:
1
$ curl -sSL https://vampcloud.github.io/vamp-cloud-installer/install.sh | sh -s -- <token>
Copied!
If the Vamp Release Agent is successfully installed, you will see these messages:
1
Sending success status to Vamp Cloud
2
---------------------------------------------
3
4
Sent
5
6
+------------------------------------------+
7
| |
8
| Done! |
9
| |
10
+------------------------------------------+
Copied!
If the Vamp Release Agent is not installed successfully, the installer will display an error message. You can find the solution in the Troubleshooting Guide.