Introduction
Rancher Turtles is a Kubernetes Operator that provides integration between Rancher Manager and Cluster API (CAPI) with the aim of bringing full CAPI support to Rancher. With Rancher Turtles, you can:
- Automatically import CAPI clusters into Rancher, by installing the Rancher Cluster Agent in CAPI provisioned clusters.
- Configure the CAPI Operator.
Demo​
This demo shows how to use the Rancher UI to install Rancher Turtles, create/import a CAPI cluster, and install monitoring on the cluster:
Prerequisites​
| Name | Version | Details |
|---|---|---|
| Kubernetes cluster | >=1.26.0 | |
| Helm | >=3.12.0 | |
| Rancher | `>=2.8.1 | Using helm based installation on any kubernetes cluster directly or on a newly created Amazon, Azure or Google service based options. Additional feature gate modifications are required. |
| Cert-manager | >=v1.12.0 | Using helm based installation or via kubectl apply command or as a helm dependency (recommended) |
| Cluster API Operator | >=v0.9.1 | Using Rancher UI (recommended) or Helm install (for advanced use cases) |
| Cluster API | v1.4.6 | |
| Rancher Turtles | v0.8.0 | Using Rancher UI (recommended) or Helm install (for advanced use cases) |
Reference Guides​
This section focuses on implementation details including architecture, how Rancher Turtles integrates with Rancher, and Helm Chart configuration values.
Tasks​
In this section we cover additional operational tasks including basic CAPIProvider installation, an example Azure infrastructure provider install using CAPIProvider, and upgrade instructions for early adopters of Rancher Turtles.
Security​
Rancher Turtles meets SLSA Level 3 requirements as an appropriate hardened build platform, with consistent build processes, and provenance distribution. This section contains more information on security-related topics: