Skip to content

Commit

Permalink
cleaned up and removed base functionality
Browse files Browse the repository at this point in the history
  • Loading branch information
zackbradys committed Aug 7, 2023
1 parent db16b27 commit 2331374
Show file tree
Hide file tree
Showing 24 changed files with 104 additions and 2,053 deletions.
255 changes: 11 additions & 244 deletions .github/workflows/main.yaml

Large diffs are not rendered by default.

9 changes: 1 addition & 8 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,4 @@
# This is useful for ignoring large files that you don't want to be part of the repository.
# The files are ignored in the repository and not pushed to source control.

**/.DS_Store
**/.terraform
**/.terraform.lock.hcl
**/terraform.tfvars
**/*.tfstate
**/*.tfstate.*
**/extras
**/script.sh
**/.DS_Store
47 changes: 12 additions & 35 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,26 @@
![rancher-long-banner](/images/rgs-banner-rounded.png)

# Airgap Deployment of Rancher RKE2, Rancher Manager, Longhorn, and Neuvector
# Rancher Airgap Tool and Guide

### Table of Contents
* [Introduction](#introduction)
* [Infrastructure](#infrastructure)
* [Collection and Packaging](#collection-and-packaging)
* [Across the Airgap](#across-the-airgap)
* [Loading and Distribution](#loading-and-distribution)
* [RKE2 Configuration](#rke2-configuration)
* [Longhorn Configuration](#longhorn-configuration)
* [NeuVector Configuration](#neuvector-configuration)
* [Final Thoughts](#final-thoughts)

## Introduction

### Welcome to the Rancher Airgap Tool and Guide
### Welcome to the Rancher Airgap Tool
Rancher Airgap is a tool built for collecting, packaging, installating Rancher RKE2, Rancher Manager, Longhorn and NeuVector. Specifically engineered, designed, and built for those tricky disconnected environments. **Review the most recent release on the [Releases](https://github.com/zackbradys/rancher-airgap/releases) page!**

We utilize a tool known as [Rancher Federal Hauler](https://github.com/rancherfederal/hauler) to collect, package, and distribute content across the airgap. `Hauler` simplifies the airgap process, by representing assets as content or collections groups to easily fetch and package them with declarative manifests. In this repositry, we generate these manifests and subsequent compress files to ease the burden of collecting all components required the airgap the [Rancher Stack](https://ranchergovernment.com/products)!
We utilize a project known as [Hauler](https://github.com/rancherfederal/hauler) by [Rancher Government Solutions](https://github.com/rancherfederal) to collect, package, and distribute content across the airgap. `Hauler` simplifies the airgap process, by representing assets as content or collections to easily fetch, store, and package with declarative manifests. In this repositry, we generate these manifests and subsequent compressed files ("stores") to ease the burden of collecting all components required to the airgap the [Rancher Stack](https://ranchergovernment.com/products)!

**High Level Workflow:**
```bash
fetch -> validate -> save -> | <airgap> | -> validate -> load -> distribute
Collection -> Across the Airgap -> Distribution
```

## Infrastructure

**Detailed Workflow:**
```bash
Collection and Package -> Across the Airgap -> Loading and Distribution
fetch -> validate -> save -> | <airgap> | -> validate -> load -> distribute
```

**Example Workflow:** [examples/rancherstack.md](examples/rancherstack.md)

## Repository Structure

* [hauler/base](hauler/base/README.md) - provides the content manifest for most Operating System Dependencies
* currently supports and validated: `Rocky 9.1` `RHEL 9.1` `Rocky 8.5` `RHEL 8.5` `CentOS 7.8`
* [hauler/rke2](hauler/rke2/README.md) - provides the content manifest for Rancher RKE2
Expand All @@ -49,18 +40,4 @@ Collection and Package -> Across the Airgap -> Loading and Distribution
curl -#OL https://github.com/rancherfederal/hauler/releases/download/v0.3.0/hauler_0.3.0_linux_amd64.tar.gz
tar -xf hauler_0.3.0_linux_amd64.tar.gz
cp hauler /usr/bin/hauler
```

## RKE2 Configuration


## Rancher Configuration


## Longhorn Configuration


## NeuVector Configuration


## Final Thoughts
```
43 changes: 43 additions & 0 deletions examples/rancherstack.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
## Internet Connected Server
```bash
### Set Variables
export vRancherAirgap=0.6.0
export date=date
```

```bash
### Fetch Hauler TARs
mkdir -p /opt/rancher/hauler
cd /opt/rancher/hauler
curl -#OL https://rancher-airgap.s3.amazonaws.com/${vRancherAirgap}/hauler/hauler/rancher-airgap-hauler.tar.zst
curl -#OL https://rancher-airgap.s3.amazonaws.com/${vRancherAirgap}/hauler/rke2/rancher-airgap-rke2.tar.zst
curl -#OL https://rancher-airgap.s3.amazonaws.com/${vRancherAirgap}/hauler/rancher/rancher-airgap-rancher.tar.zst
curl -#OL https://rancher-airgap.s3.amazonaws.com/${vRancherAirgap}/hauler/longhorn/rancher-airgap-longhorn.tar.zst
curl -#OL https://rancher-airgap.s3.amazonaws.com/${vRancherAirgap}/hauler/neuvector/rancher-airgap-neuvector.tar.zst
```

```bash
### Compress Repo and Hauler TARs
tar -czvf /opt/rancher/hauler/rancher-airgap-$(date +"%Y%d%m").tar.zst /opt/rancher
```

---

**MOVE *SINGLE TARBALL* ACROSS THE AIRGAP**

---

## Disconnected Server

```bash
### Verify Hauler Store
hauler store info

### Import Hauler TARs (will take a minute)
hauler store load rancher-airgap-base-rocky-el9.tar.zst rancher-airgap-rke2.tar.zst rancher-airgap-rancher.tar.zst rancher-airgap-longhorn.tar.zst rancher-airgap-neuvector.tar.zst
```

```bash
### Verify Hauler Store
hauler store info
```
55 changes: 0 additions & 55 deletions hauler/base/README.md

This file was deleted.

14 changes: 0 additions & 14 deletions hauler/base/rancher-airgap-base-centos-el7.yaml

This file was deleted.

14 changes: 0 additions & 14 deletions hauler/base/rancher-airgap-base-rhel-el8.yaml

This file was deleted.

14 changes: 0 additions & 14 deletions hauler/base/rancher-airgap-base-rhel-el9.yaml

This file was deleted.

14 changes: 0 additions & 14 deletions hauler/base/rancher-airgap-base-rocky-el8.yaml

This file was deleted.

14 changes: 0 additions & 14 deletions hauler/base/rancher-airgap-base-rocky-el9.yaml

This file was deleted.

Loading

0 comments on commit 2331374

Please sign in to comment.