Agent Air-gapped
Suse Rancher Prime
Last updated
Suse Rancher Prime
Last updated
This document provides a step-by-step guide for installing the Rancher Prime Observability Agent using Helm charts in an air-gapped environment. The installation process involves preparing the necessary Docker images and Helm chart on a host with internet access, transferring them to a host within a private network, uploading Docker images to a private registry, and deploying the Helm charts.
Operating System: Linux or MacOS
Tools Installed:
Scripts for downloading Docker images from the source registry (links will be provided later in the guide).
Internet Access: Required to pull Docker images from Quay.io and Helm charts from ChartMuseum.
Access: SSH access to the host.
Tools Installed:
Scripts for downloading Docker images from the source registry (links will be provided later in the guide).
Network access and credentials to upload images to a private Docker registry.
A configured Kubeconfig to install the Helm charts on the target clusters.
Run the following commands on the local host to obtain the necessary Docker images and Helm charts:
Adding Helm Repositories to the Local Helm Cache:
Fetching the Latest Version of the Chart
The following command will download a TGZ archive of the chart from the Helm repository:
Getting the Bash scripts to save Docker images.
Extracting and Saving Docker Images
The following files have to be copied from the local host to the host in the private network:
o11y-agent-images.txt (List of images required by the Rancher Prime Observability Agent chart)
o11y-agent-images.tar.gz (An archive with the Rancher Prime Observability Agent's Docker images)
Helm charts downloaded earlier:
stackstate-k8s-agent-X.Y.Z.tgz
Uploading the images to the private registry:
The command to install the Rancher Prime Observability Agent has to be received from Rancher Prime Observability UI. Log in to your instance and in the left-side menu choose the Stackpacks
. Press ADD NEW INSTANCE
and fill in the name of the cluster. For correct integration with Rancher it has to be the same as the cluster name in the Rancher UI.
When an instance is added, the UI will provide the instructions how the Helm chart can be deployed. Scroll down to the Self-hosted
section and copy helm upgrade ...
command
The command has to be updated for the air-gapped installation:
Overriding the image registry with all.image.registry
value.
Using the arhive with the Helm chart instead of the Helm repository. stackstate/stackstate-k8s-agent
-> ./stackstate-k8s-agent-X.Y.Z.tgz
Run the command to install the Rancher Prime Observability Agent
Validating the Deployment
(Bash script to upload Docker images to a registry)