Skip to main content

Airgapped installation

GitGuardian can be installed on an airgapped environment. Both the embedded cluster and existing cluster installations are supported. If you want to do an airgapped installation, please contact your representative.

Airgap installation on Embedded Cluster#

Requirements#

For the list of requirements, refer to the embedded cluster installation page. There is no additional requirement.

Download and install the kubernetes cluster#

First you will need to setup the cluster. kURL allows to download a bundle beforehand, and run the install using it. There are two places to download it. The first and recommended one is the download portal where you can also download your licence and the application bundle. The second one is with this link, which can be useful for automation purposes:

curl -LSO https://k8s.kurl.sh/bundle/gitguardian-seal-prod.tar.gz

Then, copy the archive to your server using for example scp. Go to your server, with ssh, or another tool. Extract the archive:

scp gitguardian-seal-prod.tar.gz ${your-server-address}:.ssh ${your-server-address}tar -xvzf gitguardian-seal-prod.tar.gz

You can now install the cluster:

cat install.sh | sudo bash -s airgap

Once the installation finishes, the admin console will be available on http://${your-server-address}:8800. If needed you can setup an SSH tunnel to access it locally on http://localhost:8800:

ssh -N -L 8800:localhost:8800 ${your-server-ip}

Upload the application bundle to the admin console#

First, you will need to download the licence and the application bundle from the download portal. The filename should end with .airgap.

Download portal airgap embedded

Upload your license on the admin console. Then upload the application bundle.

Follow the rest of the instructions here to complete the installation.

Upgrades#

To upgrade the cluster itself, download the latest kURL bundle, and follow the installation instructions above: copy the bundle, extract it, and run the install.sh script. Then, you will need to upgrade the kots application running in the cluster:

kubectl kots admin-console upgrade -n default

To upgrade the application, first download the latest application bundle on the download portal. Then go to your admin console on the "Version History", and click on "Upload new version". Upload the bundle and deploy it.

Airgap installation on Existing Cluster#

Requirements#

For the list of requirements, refer to the existing cluster installation page. There is no additional requirement.

Download and install the kots admin console#

First, install the kubectl kots plugin on your machine:

curl https://kots.io/install | bash

Then, you need to download the latest bundle for the kots admin console. There are two places to download it. The first and recommended one is the download portal where you can also download your licence and the application bundle. The second one is the release assets on GitHub. In both cases, make sure to match your locally installed kots plugin version. You can check it by running:

kubectl kots version

Now you need to upload this images to your registry using a user with write access to your internal registry:

kubectl kots admin-console push-images ./kotsadm.tar.gz \  ${private.registry.host}/gitguardian \  --registry-username ${rw-username} \  --registry-password ${rw-password}

Username and password for the registry are not stored anywhere.

Finally, you can run the install command for the kots admin console:

kubectl kots install gitguardian \  --kotsadm-namespace gitguardian \  --kotsadm-registry ${private.registry.host} \  --registry-username ${ro-username} \  --registry-password ${ro-password}

A kubernetes secret will be used to store these credentials.

A automatic port-forward is launched, you can now access the kots admin console on http://localhost:8800.

Upload the application bundle to the admin console#

First, you will need to download the licence and the application bundle from the download portal. The filename should end with .airgap.

Download portal airgap embedded

Upload your license on the admin console. Then follow the instructions to setup the registry for the application itself and upload the application bundle.

Follow the rest of the instructions here to complete the installation.

Upgrades#

To upgrade the kots admin interface, follow the installation instructions above: install the latest version of the kots plugin of your machine, download the latest kots bundle and upload these images to your registry. Then, instead of running the installation command, you will need to upgrade the kots application running in the cluster:

kubectl kots admin-console upgrade -n gitguardian

To upgrade the application, first download the latest application bundle on the download portal. Then go to your admin console on the "Version History", and click on "Upload new version". Upload the bundle and deploy it.