Skip to main content
Version: v0.8

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​

NameVersionDetails
Kubernetes cluster>=1.26.0
Helm>=3.12.0
Rancher`>=2.8.1Using 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.0Using helm based installation or via kubectl apply command or as a helm dependency (recommended)
Cluster API Operator>=v0.9.1Using Rancher UI (recommended) or Helm install (for advanced use cases)
Cluster APIv1.4.6
Rancher Turtlesv0.8.0Using 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: