Contents

All the commands in this runbook were tested against a VM with Canonical, Ubuntu, 20.04 LTS, amd64 as root.

Document Details

Introduction

Installation

1. Install K3s and wait for the pods to become ready:

   Code Block
   language bash
   $ curl -sfL https://get.k3s.io | INSTALL_K3S_VERSION="v1.23.9+k3s1" K3S_KUBECONFIG_MODE="644" sh -s - server --node-name=local-01 $ kubectl get deploy -n kube-system --output name | xargs -n1 -t kubectl rollout status -n kube-system

2. Install Helm 3:

   Code Block
   language bash
   $ wget --quiet https://raw.githubusercontent.com/helm/helm/master/scripts/get -O /tmp/get_helm.sh \ && chmod 0755 /tmp/get_helm.sh \ && /tmp/get_helm.sh -v v3.8.2

3. Configure GetVisibility private Docker image registry (replace $USERNAME and $PASSWORD with the Docker credentials provided):

   Code Block
   language bash
   $ kubectl create secret docker-registry gv-docker-registry \ --docker-server=https://images.master.k3s.getvisibility.com \ --docker-username=$USERNAME \ --docker-password=$PASSWORD \ --docker-email=no@email.com

4. Configure GetVisibility private Helm repository (replace $USERNAME and $PASSWORD with the Helm credentials provided):

   Code Block
   language bash
   $ helm repo add gv_stable https://charts.master.k3s.getvisibility.com/stable --username $USERNAME --password $PASSWORD $ helm repo update

5. Install chart GetVisibility Essentials and wait for the pods to become ready:

   Code Block
   language bash
   $ helm upgrade --install gv-essentials gv_stable/gv-essentials --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml $ kubectl get deploy --output name | xargs -n1 -t kubectl rollout status

6. Depending on the theme you want to use, run one of the commands below to install the chart GV Platform:

   1. GetVisibility theme:

      Code Block
      language bash
      $ helm upgrade --install gv-platform gv_stable/gv-platform --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --set-string clusterLabels.environment=prod \ --set-string clusterLabels.cluster_reseller=getvisibility \ --set-string clusterLabels.cluster_name=mycluster \ --set-string clusterLabels.product=synergy

   2. Forcepoint theme:

      Code Block
      language bash
      $ helm upgrade --install gv-platform gv_stable/gv-platform --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --set-string clusterLabels.environment=prod \ --set-string clusterLabels.cluster_reseller=forcepoint \ --set-string clusterLabels.cluster_name=mycluster \ --set-string clusterLabels.product=synergy \ --set-string dashboard.imageSuffix=-forcepoint \ --set-string gvKeycloak.imageSuffix=-forcepoint

...

To access Prometheus dashboard run the command kubectl port-forward svc/rancher-monitoring-prometheus -n cattle-monitoring-system 3001:9090 --address='0.0.0.0' and in your browser type the address http://$SERVER_IP:3001.

End Of Document