https://github.com/rancher-sandbox/rancher-turtles-fleet-example

A sample repository containing CAPI cluster definitions for use with Fleet.
https://github.com/rancher-sandbox/rancher-turtles-fleet-example

cluster-api fleet rancher-turtles

Last synced: about 1 month ago
JSON representation

A sample repository containing CAPI cluster definitions for use with Fleet.

• Host: GitHub
• URL: https://github.com/rancher-sandbox/rancher-turtles-fleet-example
• Owner: rancher-sandbox
• License: apache-2.0
• Created: 2023-09-13T10:53:12.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-08-26T16:05:32.000Z (4 months ago)
• Last Synced: 2024-08-26T19:02:03.773Z (4 months ago)
• Topics: cluster-api, fleet, rancher-turtles
• Homepage:
• Size: 46.9 KB
• Stars: 2
• Watchers: 6
• Forks: 8
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Rancher Turtles - Fleet Example

This repository can be used to import clusters into Rancher using Fleet. There are a number of different branches that you can use that demonstrate different aspects of this integration:

- **main (this branch)** - used for for importing cluster definitions where all clusters within a namespace are automatically imported into Rancher.

- **[per-cluster-import](https://github.com/rancher-sandbox/rancher-turtles-fleet-example/tree/per-cluster-import)** - used for importing cluster definitions where individual clusters are marked for auto-importing into Rancher.

- **[templates](https://github.com/rancher-sandbox/rancher-turtles-fleet-example/tree/templates)** - contains Cluster API templates that are used by the Rancher Turtles documentation.

- **[cluster-class](https://github.com/rancher-sandbox/rancher-turtles-fleet-example/tree/clusterclass)** - contains a sample using ClusterClass

- **[aws](https://github.com/rancher-sandbox/rancher-turtles-fleet-example/tree/aws)** - contains a sample using AWS.

Switch to the branch to read further information.

## Branch explanation

The [clusters](./clusters/) folder contains the definition for the clusters that you want to create and have imported into Rancher Manager. These definitions can be created using **clusterctl** or hand crafted. See the [Rancher Turtles documentation](https://rancher.github.io/turtles-docs/) for further details.

The [fleet.yaml](./clusters/fleet.yaml) file contains configuration used by Fleet when creating bundles. Specifically in this file we are declaring that the cluster definitions should be placed in a namespace called **default**.

You will need to add the **cluster-api.cattle.io/rancher-auto-import** label with a value of **true** to the **default** namespace to have the cluster auto-imported.