-
Notifications
You must be signed in to change notification settings - Fork 6
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
2e1618c
commit d9b92d5
Showing
16 changed files
with
136 additions
and
58 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,52 +1,60 @@ | ||
# 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](https://github.com/rancherfederal/hauler) by [Rancher Government Solutions](https://github.com/rancherfederal) 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](examples)*!** | ||
|
||
**High Level Workflow:** | ||
|
||
```bash | ||
Collection -> Across the Airgap -> Distribution | ||
``` | ||
|
||
**Detailed Workflow:** | ||
|
||
```bash | ||
fetch -> validate -> save -> | <airgap> | -> load -> validate -> distribute | ||
``` | ||
|
||
## Repository Structure | ||
|
||
### Core Components | ||
* [hauler/rke2](hauler/rke2/README.md) - provides the content manifest for Rancher Kubernetes (RKE2) | ||
* currently supports: `RKE2 v1.26.13` | ||
* [hauler/rancher](hauler/rancher/README.md) - provides the content manifest for Cert-Manager | ||
* currently supports: `Cert-Manager v1.14.2` | ||
* [hauler/rancher](hauler/rancher/README.md) - provides the content manifest for Rancher Multi-Cluster Manager | ||
* currently supports: `Rancher v2.8.2` | ||
* [hauler/longhorn](hauler/longhorn/README.md) - provides the content manifest for Rancher Longhorn | ||
* currently supports: `Longhorn v1.6.0` | ||
* [hauler/neuvector](hauler/neuvector/README.md) - provides the content manifest for Rancher NeuVector | ||
* currently supports: `NeuVector v5.3.0` | ||
* [hauler/harvester](hauler/harvester/README.md) - provides the content manifest for Rancher Harvester | ||
* currently supports: `Harvester v1.2.1` | ||
|
||
- [hauler/rke2](hauler/rke2/README.md) - provides the content manifest for Rancher Kubernetes (RKE2) | ||
- currently supports: `RKE2: v1.26.13` | ||
- [hauler/rancher](hauler/rancher/README.md) - provides the content manifest for Cert-Manager | ||
- currently supports: `Cert-Manager: v1.14.2` | ||
- [hauler/rancher](hauler/rancher/README.md) - provides the content manifest for Rancher Multi-Cluster Manager | ||
- currently supports: `Rancher: v2.8.2` | ||
- [hauler/longhorn](hauler/longhorn/README.md) - provides the content manifest for Rancher Longhorn | ||
- currently supports: `Longhorn: v1.6.0` | ||
- [hauler/neuvector](hauler/neuvector/README.md) - provides the content manifest for Rancher NeuVector | ||
- currently supports: `NeuVector: v5.3.0` | ||
- [hauler/harvester](hauler/harvester/README.md) - provides the content manifest for Rancher Harvester | ||
- currently supports: `Harvester: v1.2.1` | ||
|
||
### Addons | ||
* [hauler/hauler](hauler/hauler/README.md) - provides the content manifest for Hauler | ||
* currently supports: `Hauler v0.4.4` | ||
* [hauler/helm](hauler/helm/README.md) - provides the content manifest for Helm | ||
* currently supports: `Helm v3.14.0` | ||
* [hauler/cosign](hauler/cosign/README.md) - provides the content manifest for Cosign | ||
* currently supports: `Cosign v2.2.3` | ||
* [hauler/harbor](hauler/harbor/README.md) - provides the content manifest for Harbor | ||
* currently supports: `Harbor v2.9.1` | ||
|
||
- [hauler/hauler](hauler/hauler/README.md) - provides the content manifest for Hauler | ||
- currently supports: `Hauler: v0.4.4` | ||
- [hauler/helm](hauler/helm/README.md) - provides the content manifest for Helm | ||
- currently supports: `Helm: v3.14.0` | ||
- [hauler/cosign](hauler/cosign/README.md) - provides the content manifest for Cosign | ||
- currently supports: `Cosign: v2.2.3` | ||
- [hauler/harbor](hauler/harbor/README.md) - provides the content manifest for Harbor | ||
- currently supports: `Harbor: v2.9.1` | ||
- [hauler/kubevip](hauler/kubevip/README.md) - provides the content manifest for KubeVip | ||
- currently supports: `KubeVip: Latest` | ||
|
||
**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 | ||
|
||
```bash | ||
# https://github.com/rancherfederal/hauler | ||
curl -sfL https://get.hauler.dev | bash | ||
``` | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,30 @@ | ||
# KubeVip (by the CNCF) | ||
|
||
**Note:** View the [README](https://github.com/zackbradys/rancher-airgap/blob/main/README.md) for the latest versions! | ||
|
||
## Collection and Packaging | ||
|
||
[hauler/kubevip/rancher-airgap-kubevip.yaml](https://github.com/zackbradys/rancher-airgap/blob/main/hauler/kubevip/rancher-airgap-kubevip.yaml) - provides the content manifest for all the assets. | ||
|
||
```bash | ||
# pull the manifest | ||
curl -sfOL https://raw.githubusercontent.com/zackbradys/rancher-airgap/main/hauler/kubevip/rancher-airgap-kubevip.yaml | ||
|
||
# sync to the store | ||
hauler store sync --files rancher-airgap-kubevip.yaml | ||
|
||
# save to tarball | ||
hauler store save --filename rancher-airgap-kubevip.tar.zst | ||
``` | ||
|
||
## Across the Airgap | ||
|
||
```bash | ||
# coming soon | ||
``` | ||
|
||
## Loading and Distribution | ||
|
||
```bash | ||
# coming soon | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
apiVersion: content.hauler.cattle.io/v1alpha1 | ||
kind: Images | ||
metadata: | ||
name: rancher-airgap-images-kubevip | ||
spec: | ||
images: | ||
- name: ghcr.io/kube-vip/kube-vip:v0.5.11 | ||
--- | ||
apiVersion: content.hauler.cattle.io/v1alpha1 | ||
kind: Files | ||
metadata: | ||
name: rancher-airgap-files-kubevip | ||
spec: | ||
files: | ||
- path: https://kube-vip.io/k3s | ||
name: kubevip-daemonset-manifest.yaml | ||
- path: https://kube-vip.io/manifests/rbac.yaml | ||
name: kubevip-rbac-manifest.yaml |
Oops, something went wrong.