KaaS – Installation de Cluster API

Prérequis

1. Outils

Pour installer Cluster API sur un cluster Kubernetes il est nécessaire d’avoir certains outils installés sur votre machine d’administration.

1. kubectl
2. clusterctl
3. git
4. kctx (optionnel)

Si vous n’avez pas encore installé ces outils, veuillez suivre la page Outils

2. Connexion au cluster

Vérifiez que vous soyez connecté au cluster sur lequel vous souhaitez installer Cluster API.

# kubectl get nodes

NAME        STATUS   ROLES                  AGE   VERSION
mstr-atom   Ready    control-plane,master   61m   v1.22.9+vmware.1
node-3v9t   Ready    <none>                 58m   v1.22.9+vmware.1

3. Compte VCD

Cluster API utilise un compte VCD pour communiquer avec l’API de vCloud Director et ceci afin d’automatiser le déploiement et la gestion du cycle de vide de vos clusters.

Vous pouvez utiliser un rôle par défaut ou bien en créer un spécifique, voici les droits à avoir au minimum pour ce compte.

• User > Manage user’s own API token
• vApp > Preserve ExtraConfig Elements during OVA Import and Export (follow the KB to enable this right on VCD)
• Catalog > View Shared Catalogs from Other Organizations
• Gateway > View Gateway
• Gateway Services > NAT Configure, LoadBalancer Configure
• Rights from the default vApp Author role
• Right ‘Full Control: VMWARE:CAPVCDCLUSTER’
• Organization VDC > Create a Shared Disk

• Vous pouvez choisir le CIDR pour vos PODS et vos services.

Installation

Préparez le Provider Cluster API pour vCloud Director

Cluster API a besoin d’un provider afin de pouvoir communiquer avec l’API de vCloud Director afin d’orchestrer le déploiement et de gérer le cycle de vie des clusters.

Ce provider est fourni par VMware et est disponible sur un reposository GIT que l’on va utiliser pour l’installation de Cluster API.

Le principe est le suivant :

1. Clonez le repository GIT
2. Récupérez les fichiers de template et de configuration
3. Déclarez le provider dans la configuration de cluster api

git clone --branch v1.1.0 https://github.com/vmware/cluster-api-provider-cloud-director.git

Préparez les templates et fichiers configuration

mkdir -p infrastructure-vcd/v1.1.0/
cp -r cluster-api-provider-cloud-director/templates/* ./infrastructure-vcd/v1.1.0/
cp cluster-api-provider-cloud-director/metadata.yaml ./infrastructure-vcd/v1.1.0/
mkdir ~/.cluster-api/
cp infrastructure-vcd/v1.1.0/clusterctl.yaml ~/.cluster-api/clusterctl.yaml

Déclarer le provider dans la configuration de cluster api

• Editez le fichier ~/.cluster-api/clusterctl.yaml
• Modifiez le paramètre url du provider vcd

Exemple :

Exemple :

providers:
  - name: "vcd"
    url: "/root/infrastructure-vcd/v1.1.0/infrastructure-components.yaml"
    type: "InfrastructureProvider"

Installation de Cluster API

1. Lancez la commande clusterctl init

Vous devez recevoir le message ci-dessous en retour  :

Your management cluster has been initialized successfully!

clusterctl init --core cluster-api:v1.4.0 -b kubeadm:v1.4.0 -c kubeadm:v1.4.0 -i vcd:v1.1.0

Appliquez les CRS (ClusterResourceSet)

Le ClusterResourceSet est un objet provenant de cluster api, il permet de créer des ressources automatiquement sur les clusters enfants qui seront déployés. Dans notre cas nous l’utilisons pour déployer automatiquement :

• Le CNI Antrea
• Le CSI pour vCloud Director
• Le CPI pour vCloud Director

Si vous avez copié les fichiers dans un répertoire différent lors des étapes précédentes, vous pouvez modifier la première ligne afin de fournir le bon emplacement.

CRS="infrastructure-vcd/v1.1.0/crs/"
kubectl create configmap antrea-crs-cm --from-file=${CRS}/cni/antrea.yaml
kubectl apply -f ${CRS}/cni/antrea-crs.yaml

kubectl create configmap cloud-director-crs-cm --from-file=${CRS}/cpi/cloud-director-ccm.yaml
kubectl apply -f ${CRS}/cpi/cloud-director-crs.yaml

kubectl create configmap csi-controller-crs-cm --from-file=${CRS}/csi/csi-controller-crs.yaml
kubectl create configmap csi-node-crs-cm --from-file=${CRS}/csi/csi-node-crs.yaml
kubectl create configmap csi-driver-crs-cm --from-file=${CRS}/csi/csi-driver.yaml
kubectl apply -f ${CRS}/csi/csi-crs.yaml

L’ensemble des PODS et des configurations vont être automatiquement appliqués sur le cluster.

Attendez que l’ensemble de ces PODS soient en status Running

Si une erreur survient, merci de vous référer à la page Dépannage

# kubectl get pods -A

NAMESPACE                           NAME                                                            READY   STATUS    RESTARTS   AGE
capi-kubeadm-bootstrap-system       capi-kubeadm-bootstrap-controller-manager-7dc44947-hrmvc        1/1     Running   0          36m
capi-kubeadm-control-plane-system   capi-kubeadm-control-plane-controller-manager-cb9d954f5-r8w54   1/1     Running   0          36m
capi-system                         capi-controller-manager-7594c7bc57-jr75r                        1/1     Running   0          37m
capvcd-system                       capvcd-controller-manager-89758d745-kw4sm                       1/1     Running   0          13s

Etape suivante

Ensuite vous allez devoir déployer vos clusters, cela peut-être soit votre cluster de management ou des clusters de travail.

En fonction de votre besoin, choisissez le lien ci-dessous correspondant :

Déployer un cluster de travail : KaaS – Déployer un cluster de travail

Cluster de Management : KaaS – Cluster de management