diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md index ce5859d2c..744c4bfc7 100644 --- a/docs/src/SUMMARY.md +++ b/docs/src/SUMMARY.md @@ -5,6 +5,11 @@ - [Getting Started](./topics/getting-started.md) - [Troubleshooting](./topics/troubleshooting.md) - [Addons](./topics/addons.md) + - [Flavors](./topics/flavors/flavors.md) + - [Default (kubeadm)](./topics/flavors/default.md) + - [ClusterClass kubeadm](./topics/flavors/clusterclass-kubeadm.md) + - [k3s](./topics/flavors/k3s.md) + - [rke2](./topics/flavors/rke2.md) - [Development](./developers/development.md) - [Releasing](./developers/releasing.md) - [Reference](./reference/reference.md) diff --git a/docs/src/flavors/clusterclass-kubeadm.md b/docs/src/topics/flavors/clusterclass-kubeadm.md similarity index 100% rename from docs/src/flavors/clusterclass-kubeadm.md rename to docs/src/topics/flavors/clusterclass-kubeadm.md diff --git a/docs/src/flavors/default.md b/docs/src/topics/flavors/default.md similarity index 100% rename from docs/src/flavors/default.md rename to docs/src/topics/flavors/default.md diff --git a/docs/src/flavors/flavors.md b/docs/src/topics/flavors/flavors.md similarity index 79% rename from docs/src/flavors/flavors.md rename to docs/src/topics/flavors/flavors.md index 273b4c0a6..425aa00bf 100644 --- a/docs/src/flavors/flavors.md +++ b/docs/src/topics/flavors/flavors.md @@ -1,5 +1,7 @@ # Flavors +This section contains information about supported flavors in Cluster API Provider Linode + In `clusterctl` the infrastructure provider authors can provide different types of cluster templates referred to as "flavors". You can use the `--flavor` flag to specify which flavor to use for a cluster, e.g: @@ -11,10 +13,3 @@ clusterctl generate cluster test-cluster --flavor clusterclass To use the default flavor, omit the `--flavor` flag. See the [`clusterctl` flavors docs](https://cluster-api.sigs.k8s.io/clusterctl/commands/generate-cluster.html#flavors) for more information. - - -## Supported flavors - -- [Default (kubeadm)](default.md) -- [Cluster Class Kubeadm](clusterclass-kubeadm.md) -- [k3s](k3s.md) diff --git a/docs/src/flavors/k3s.md b/docs/src/topics/flavors/k3s.md similarity index 100% rename from docs/src/flavors/k3s.md rename to docs/src/topics/flavors/k3s.md diff --git a/docs/src/topics/flavors/rke2.md b/docs/src/topics/flavors/rke2.md new file mode 100644 index 000000000..309b33914 --- /dev/null +++ b/docs/src/topics/flavors/rke2.md @@ -0,0 +1,24 @@ +# RKE2 +## Specification +| Control Plane | CNI | Default OS | Installs ClusterClass | +|-----------------------------|--------|--------------|-----------------------| +| [rke2](https://docs.rke2.io/) | Cilium | Ubuntu 22.04 | No | +## Prerequisites +* [Quickstart](../topics/getting-started.md) completed +* Select an [rke2 kubernetes version](https://github.com/rancher/rke2/releases) to set for the kubernetes version + ```bash + export KUBERNETES_VERSION=v1.29.1+rke2r1 + ``` +* Installed [rke2 bootstrap provider](https://github.com/rancher-sandbox/cluster-api-provider-rke2) into your management cluster + ```shell + clusterctl init --bootstrap rke2 --control-plane rke2 + ``` +## Usage +1. Generate cluster yaml + ```bash + clusterctl generate cluster test-cluster --infrastructure linode:0.0.0 --flavor rke2 > test-rke2-cluster.yaml + ``` +2. Apply cluster yaml + ```bash + kubectl apply -f test-rke2-cluster.yaml + ```