suse / suse-at-home

SUSE at Home

Objectives

• Give a hands-on experience with some of our newer technologies including Kubernetes and Rancher

• Provide a base of SLES, Kubernetes and Rancher that you can then deploy applications to make your life better

Suggested Installation Paths

Production Rancher Installation - SLES+RKE+Rancher

• Install SLES15 SP3 on x86_64
• Install Kubernetes Tools
• Install RKE on SLES
• Install Rancher using helm

RKE 2 Based Rancher Installation - SLES+RKE2+Rancher

• Install SLES15 SP3 on x86_64
• Install Helm
• Install of Rancher on RKE2 using Rancherd

K3s Rancher Install - SLES+K3s+Rancher

• Install SLES15 SP3 on x86_64
• Install K3s
• Install Helm
• Install Rancher using helm

Install K3s on Raspberry Pi

• Installation of SLES15 SP3 on Raspberry Pi/aarch64
• Install K3s

What's here

Install - /install

All information on how go from metal until you have SLES, Kubernetes 
(RKE or K3s) and Rancher 

This is where you should start...even if you have SLES install just look.
Make sure you have the proper packages installed and enabled, turn off or 
open up the firewall and make sure you setup the ssh-keys.

Install SLES

Pick one of the methods below to install SLES

• Installation of SLES15 SP3 on x86_64

• Installation of SLES15 SP3 on Raspberry Pi/aarch64

• Installation and booting of SLES15 SP3 on x86_64 using USB

• Setup cloud-init for KVM installs

• Terraform install of SLES on KVM

• Airgap deployment of K3S on SLE Micro 5.1 on Raspberry Pi 4

Install Kubernetes Tools

• Installation of Kubernetes Tools

Installing Kubernetes

• RKE - Full Blown Kubernetes
  • Simple single-node RKE install on SLES15 SP3 x86_64
• RKE2 (Rancher Government)
  • Install RKE2 (RKE Government) on SLES15 SP3 x86_64
• K3s - Lightweight w/ batteries
  • Install K3s

Install Rancher

We have a couple of options for Rancher.

Rancher normally runs on top of Kubernetes. You pick any of our 
Kubernetes (RKE, RKE2 or K3s) and then install Rancher via helm.  

• Rancher
  • Quick install of Rancher using docker
  • Quick install of Rancher on RKE2 using Rancherd
  • Using helm to install Rancher on k8s
  • Using helm to install Rancher 2.6 on k8s

Upgrade Rancher

• Upgrading Rancher and K8s

Configuration of cluster after it's up and running

Networking

Install and Configure MetalLB - LoadBalancer that allows you to define a pool(s) of local IP addresses that can be automatically assigned/used by Applications deployed in Kubernetes

Install and configure Traefik (on k3s) - This lab will show you how to create different type of Ingress rules using a few different sample applications

Storage

Longhorn - highly available persistent block storage for your Kubernetes workloads

Install NFS Provisioner

Installing NFS Server

Installing NFS Client on Nodes

Adding Downstream Clusters to Rancher

Now that you have Rancher up and running, it's very easy to create new clusters and import
existing clusters.

Install Downstream RKE Cluster from Rancher

Import existing Downstream Cluster

Deployments

Pi-hole - Network-based ad-blocking software, and a custom DNS server. It blocks ads from being displayed on the devices on your network. It uses DNS sinkholing and blocklists as a way of stopping internet ads, malware, malvertising, etc.

MQTT - Simple, light weight publish/subscribe message bus

NodeRed - Browser based Development Environment that make it easy to connect various things together

Install M5Stick - Configuration and tools to setup your M5Stick

Install Navidrome - Personal Media Server for stream audio

Install Minecraft - Prepare for an adventure of limitless possibilities as you build, mine, battle mobs, and explore the ever-changing Minecraft landscape

Install Valheim - Valheim is an upcoming survival and sandbox video game by the Swedish developer Iron Gate Studio - Requires a Steam Lic

suse-at-home's Issues

Add notes on how to use Leap Micro for non-employees

To make this easier for non-employees to use, would it make sense to add a note on the availability of Leap Micro as the upstream? My understanding is that the only real difference would be the lack of registration flow, right?

Docs for using rancher master-head

In order to test/play with the most recent commits...like testing out the 2.6 changes you need to pull from master. Add this to docs somewhere?

Via docker
docker pull rancher/rancher:master-head && docker run -d -p 443:443 --privileged rancher/rancher:master-head

via helm
--set rancherImage=rancher/rancher
--set rancherImageTag=master-head
--set rancherImagePullPolicy=Always \

Feature request: suse at home should be opensuse at home

For non-SUSE customers to participate in the whole Rancher Labs, SUSE evolution at home and be able to convince their respective employers or customers to adopt a SUSE contract. As it is now, it is only for existing SUSE customers and not an efficient marketing initiative, roadmap to paid SUSE engagements.

Or at least have something similar to vmware's VMUG which allows users to pay for the use of enterprise software for non-production use.

SCC link 404

https://github.com/SUSE/suse-at-home/blob/main/install/InstallSLESonx86.md

points to https://scc.suse.com/admin/products/1939

which is 404

Missing helm instruction when using k3s

When following k3s installation "how-to", there is no explanation on how to install Helm. This is only present in the RKE install how-to. I would suggest to move this section in a proper section which would be referenced by the various "install some k8s implementation" how-to guide.

Add how-to for enabling traefik dashboard

The current how-to starts k3s without traefik and adds traefik later with details on enabling the dashboard. This request is to create a how-to to use kustomize or an additional .yaml to enable the dashboard post k3s install

secure kubernetes tools installation

Hello,

is there any way to install kubernetes tools securely?

Downloading random script from the internet and executing it on your machine does not look like sound security practice.

NTP via chronyd not active

Seems time sync is not active at least on minimal sles installs. chrony is installed but not active. Probably a good idea to activate it.

disable swap in SLES install

There is no explicit mention of disabling swap during the installation of SLES15.

Fix k8s-at-home breaking changes

node-red deployment
mqtt deployment
both rely on the common library in k8s-at-home and this chart has breaking changes
for our purposes we need to change the loadbalancer to service.main.type.loadbalancer in order for the chart to pickup that we want to switch from the default of clusterip to loadbalancer

Where is the variable?

I assume there was a step that was supposed to set the token env variable before these instructions.

2) Setup environment variable for the token
Use the variable below to install an agent (worker) node

curl -sfL https://get.rke2.io | INSTALL_RKE2_TYPE="agent" sh -