Rancher Airgap Guide

Welcome to the Rancher Airgap Guide

Rancher Airgap is a framework and guide built for collecting, packaging, and distributing the Rancher Product Stack for deployment in disconnected or airgapped environments.

We utilize Project Hauler by Rancher Government Solutions to collect, package, and distribute the assets. Hauler simplifies the airgap process, by representing assets as content and collections and allows users to easily fetch, store, package, and distribute with declarative manifests or the command line. In this repositry, we generate these manifests for each of the products.

Review the high level example use cases!

High Level Workflow:

Collection -> Across the Airgap -> Distribution

Detailed Workflow:

fetch -> validate -> save -> | <airgap> | -> load -> validate -> distribute

Repository Structure

Core Components

• hauler/rke2 - provides the content manifest for Rancher Kubernetes (RKE2)
  • currently supports: RKE2: v1.30.6
• hauler/rancher - provides the content manifest for Cert-Manager
  • currently supports: Cert-Manager: v1.16.2
• hauler/rancher - provides the content manifest for Rancher Multi-Cluster Manager
  • currently supports: Rancher: v2.9.4
• hauler/longhorn - provides the content manifest for Rancher Longhorn
  • currently supports: Longhorn: v1.7.2
• hauler/neuvector - provides the content manifest for Rancher NeuVector
  • currently supports: NeuVector: v5.4.1
• hauler/harvester - provides the content manifest for Rancher Harvester
  • currently supports: Harvester: v1.4.0

Addons

• hauler/hauler - provides the content manifest for Hauler
  • currently supports: Hauler: v1.1.1
• hauler/helm - provides the content manifest for Helm
  • currently supports: Helm: v3.16.3
• hauler/cosign - provides the content manifest for Cosign
  • currently supports: Cosign: v2.4.1
• hauler/gitea - provides the content manifest for Gitea
  • currently supports: Gitea: v1.22.3
• hauler/vault - provides the content manifest for Vault
  • currently supports: Vault: v1.18.1
• hauler/kubevip - provides the content manifest for KubeVip
  • currently supports: KubeVip: v0.5.11

Note: We are currently planning and working towards supporting every major version of our products. We will continue to update to the latest until we implement previous major verions.

Hauler Installation

# https://github.com/hauler-dev/hauler
curl -sfL https://get.hauler.dev | bash