Rancher RKE2

Rancher RKE2

Note

Keypoints:

• Disabling the RKE2 embedded CCM
• Enabling cloud-provider=external for kubelet
• Installing Helm Chart with RKE2 Helm Addons and with the field `spec.bootstrap: true`

Reference: RKE2 documentation: deploying an external cloud controller manager

Server Node Installation

1. Before installing anything, create the following file /etc/rancher/rke2/config.yaml:

# /etc/rancher/rke2/config.yaml
disable-cloud-controller: true
kubelet-arg: cloud-provider=external

2. Create a manifest to install the CCM Helm Chart during the cluster boostrap in /var/lib/rancher/rke2/server/manifests (ref):

# /var/lib/rancher/rke2/server/manifests/xenorchestra-ccm.yaml
apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  name: xenorchestra-ccm
  namespace: kube-system
spec:
  chart: oci://ghcr.io/vatesfr/charts/xenorchestra-cloud-controller-manager
  targetNamespace: kube-system
  bootstrap: true
  valuesContent: |-
    # Configuration pour XenOrchestra
    config:
      url: "<xo-url>"
      token: "<xo-token>"
      insecure: false

3. Then follow the instruction of the official documentation: Quickstart

Xen Orchestra CSI

Simply follow the related installation documentations.

Linux Agent (Worker) Node Installation

Same steps than the server node + the official documentation:

1. Create/etc/rancher/rke2/config.yaml with content

# /etc/rancher/rke2/config.yaml
server: https://<server>:9345
token: <token from server node>
disable-cloud-controller: true
kubelet-arg: cloud-provider=external

2. Follow the official RKE2 documentation for a worker node.