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
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:
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!
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!
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
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 then the installer will display an error message which you can use to find the solution in the Troubleshooting Guide.

Built-in Metrics

Troubleshooting Guide

Last modified 9mo ago

Copy link

Contents

Before You Begin

kubectl

NGINX Ingress Controller

Contour Ingress Controller

Prometheus

Installing the Release Agent