...
Note |
---|
Make sure you have |
Info |
---|
The commands have been tested on Ubuntu Server 20.04 LTS, SUSE Linux Enterprise Server 15 SP4 and RHEL 9.2 and 9.4. |
Note |
---|
For RHEL, K3s needs the following package to be installed: Other SUSE, CentOS, RedHat prerequisites: Prerequisites for k3s on RHEL/CentOS/Oracle Linux Ubuntu prerequisites: Prerequisites for k3s on Ubuntu Linux |
The steps below you guide you through the air-gap installation of K3s, a lightweight Kubernetes distribution created by Rancher Labs:
Extract the downloaded file:
Code Block |
---|
tar -xf gv-platform-$VERSION.tar |
...
# (replace$VERSION according to downloaded file) |
Prepare K3s for air-gap installation:
Code Block | ||||
---|---|---|---|---|
|
...
sudo su - mkdir -p /var/lib/rancher/k3s/agent/images/ |
...
gunzip -c assets/k3s-airgap-images-amd64.tar.gz > /var/lib/rancher/k3s/agent/images/airgap-images.tar
|
...
cp assets/k3s /usr/local/bin && chmod +x /usr/local/bin/k3s |
...
tar -xzf assets/helm-v3.8.2-linux-amd64.tar.gz
|
...
cp linux-amd64/helm /usr/local/bin |
Before installation, it’s recommended to run automatic checks (as root;
PRODUCT_NAME
is either “synergy” (endpoint agent) or “dspm“ (dspm without endpoint agent) or “ultimate“ (dspm + endpoint agent). If unsure use “ultimate“):Code Block
...
cat scripts/k3s.sh | PRODUCT_NAME=ultimate ONLY_PRECHECK=true bash -
Install K3s:
Code Block | ||
---|---|---|
|
...
cat scripts/k3s.sh | INSTALL_K3S_SKIP_DOWNLOAD=true K3S_KUBECONFIG_MODE="644" \ SKIP_NETWORK_CHECKS=true sh -s - server --node-name=local-01 |
Info |
---|
Few more arguments that can be used to customize the execution of the k3s script:
Example:
|
...
Import Docker images locally:
Code Block | ||||
---|---|---|---|---|
|
...
mkdir /tmp/import
|
...
for f in images/*.gz; do IMG=$(basename "${f}" .gz); gunzip -c "${f}" > /tmp/import/"${IMG}"; done |
...
for f in /tmp/import/*.tar; do ctr -n=k8s.io images import "${f}"; done |
Install Helm charts
The following steps guide you through the installation of the dependencies required by DSPM and Synergy (Endpoint Agent).
Info |
---|
Replace Replace IPADDRESS/DNS/FQDN with IP Adress or FQDN or DNS name for Keycloak in formats like below |
Install Getvisibility Essentials and set the daily UTC backup hour (0-23) for performing backups.
Code Block # helm upgrade --install gv-essentials charts/gv-essentials-$VERSION.tgz --wait \ --timeout=10m0s --kubeconfig /etc/rancher/k3s/k3s.yaml \ --set backup.hour=1 \ --set eck-operator.enabled=true \ --set updateclusterid.enabled=false \ --set keycloak.url=https://(IPADDRESS/|DNS/|FQDN)
Install Monitoring CRD:
Code Block # helm upgrade --install rancher-monitoring-crd charts/rancher-monitoring-crd-$VERSION.tgz \ --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --namespace=cattle-monitoring-system \ --create-namespace
Install Monitoring:
Code Block # helm upgrade --install rancher-monitoring charts/rancher-monitoring-$VERSION.tgz \ --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --namespace=cattle-monitoring-system \ --set k3sServer.enabled=true \ --set k3sControllerManager.enabled=true \ --set k3sScheduler.enabled=true \ --set k3sProxy.enabled=true \ --set prometheus.retention=5 \
Info |
---|
To expose Grafana via an ingress on the path |
...
$VERSION
with the version that is present in the bundle that has been downloaded$RESELLER
with the reseller code (eithergetvisibility
orforcepoint
)$PRODUCT
with the product being installed (synergy, dspm, enterprise or ultimate
)
Code Block |
---|
# helm upgrade --install gv-platform charts/gv-platform-$VERSION.tgz --wait \
--timeout=10m0s --kubeconfig /etc/rancher/k3s/k3s.yaml \
--set-string clusterLabels.environment=prod \
--set-string clusterLabels.cluster_reseller=$RESELLER \
--set-string clusterLabels.cluster_name=mycluster \
--set-string clusterLabels.product=$PRODUCT |
Info | ||
---|---|---|
In case if you expirience experience 404 error for accessing to Keycloak or UI and use 1.26 (default) version of K3s ensure that treafik traefik patch is applied
|
...
Install Getvisibility Essentials and set the daily UTC backup hour (0-23) for performing backups.
Code Block $ helm upgrade --install gv-essentials charts/gv-essentials-$VERSION.tgz --wait \ --timeout=10m0s --kubeconfig /etc/rancher/k3s/k3s.yaml \ --set global.high_available=true \ --set eck-operator.enabled=true \ --set minio.replicas=4 \ --set minio.mode=distributed \ --set consul.server.replicas=3 \ --set updateclusterid.enabled=false \ --set backup.hour=1 --set eck-operator.enabled=true
Install Monitoring CRD:
Code Block $ helm upgrade --install rancher-monitoring-crd charts/rancher-monitoring-crd-$VERSION.tgz --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --namespace=cattle-monitoring-system \ --create-namespace
Install Monitoring:
Code Block $ helm upgrade --install rancher-monitoring charts/rancher-monitoring-$VERSION.tgz --wait \ --kubeconfig /etc/rancher/k3s/k3s.yaml \ --set global.high_available=true \ --namespace=cattle-monitoring-system \ --set loki-stack.loki.replicas=2 \ --set prometheus.prometheusSpec.replicas=2 --set prometheus.retention=5
Info |
---|
To expose Grafana via an ingress on the path |
...