Known Good Designs on Support Tools

ArgoCD

Tue, 17 Dec 2024 00:00:00 -0500

This is the known good design for deploying ArgoCD in a Kubernetes cluster.

Cert Manager

Tue, 17 Dec 2024 00:00:00 -0500

This is the known good design for cert-manager using Helm or Argo CD.

Ingress NGINX Controller on DOKS: Retirement, Gateway API, and Traefik

Tue, 17 Dec 2024 00:00:00 -0500

This page used to describe Ingress NGINX on DigitalOcean Kubernetes (DOKS). Ingress NGINX is now retired, and DOKS ships a managed Gateway API implementation, so the known good design has changed.

Ingress NGINX Controller on EKS: Retirement and Migrating to Traefik

Tue, 17 Dec 2024 00:00:00 -0500

This page used to describe Ingress NGINX on Amazon EKS. Ingress NGINX is now retired, so the known good design for a self-managed ingress controller on EKS is Traefik behind a Network Load Balancer created by the AWS Load Balancer Controller.

Ingress NGINX Controller on RKE2: Retirement and the Traefik Default

Tue, 17 Dec 2024 00:00:00 -0500

RKE2 used to ship the Ingress NGINX Controller as its built-in ingress. That project is now retired, and RKE2 v1.36 deploys Traefik by default on new clusters. This page covers the current known good design for ingress on RKE2 and how to move existing clusters off ingress-nginx.

Kube-VIP as TCP/UDP Load Balancer for RKE2

Tue, 17 Dec 2024 00:00:00 -0500

This guide sets up kube-vip in Layer 2 (ARP) mode on an RKE2 cluster for two jobs: a virtual IP for the RKE2 control plane, and external IPs for Services of type: LoadBalancer.

For ingress on RKE2 (Traefik by default from v1.36), see the Ingress on RKE2 guide.

MetalLB as TCP/UDP Load Balancer for RKE2

Tue, 17 Dec 2024 00:00:00 -0500

This guide sets up MetalLB in Layer 2 mode so that Services of type: LoadBalancer on a bare-metal or on-prem RKE2 cluster get reachable IP addresses.

For ingress on RKE2 (Traefik by default from v1.36), see the Ingress on RKE2 guide.

Provisioning an RKE2 Cluster in AWS via Rancher

Tue, 17 Dec 2024 00:00:00 -0500

This guide demonstrates how to add AWS cloud credentials in Rancher and use them to provision an RKE2 cluster in AWS.

Provisioning an RKE2 Cluster in DigitalOcean via Rancher

Tue, 17 Dec 2024 00:00:00 -0500

This guide demonstrates how to add DigitalOcean cloud credentials in Rancher and use them to provision an RKE2 cluster in DigitalOcean (DO).

Provisioning an RKE2 Cluster on Custom VMs

Tue, 17 Dec 2024 00:00:00 -0500

This guide provisions a downstream RKE2 cluster on VMs or bare-metal servers that you create outside Rancher. Rancher installs and manages RKE2 on those machines through its custom cluster flow: you create the cluster in Rancher, then run a registration command on each node.

Rancher on Small DOKS Cluster

Tue, 17 Dec 2024 00:00:00 -0500

This guide deploys Rancher on a small DigitalOcean Kubernetes Service (DOKS) cluster, using Terraform for the cluster and Helm for Traefik, cert-manager, and Rancher.

Rancher on Small EKS Cluster

Tue, 17 Dec 2024 00:00:00 -0500

This guide deploys Rancher on a small Amazon EKS cluster, using Terraform for the infrastructure and Helm for Traefik, cert-manager, and Rancher.

Rancher on Small RKE2 Cluster

Tue, 17 Dec 2024 00:00:00 -0500

This guide deploys Rancher on a small, highly available RKE2 cluster built from three servers that you provision yourself (bare metal or VMs). It follows the layout Rancher supports for the management (local) cluster.