Plusieurs versions de Kubernetes

Cette rubrique explique comment répertorier les versions de Kubernetes disponibles et déployer un cluster de charge de travail avec une version de Kubernetes autre que celle par défaut.

À propos des versions de Kubernetes

Chaque version de Tanzu Kubernetes Grid avec un cluster de gestion autonome fournit une version par défaut et deux versions non par défaut de Kubernetes, que vous pouvez répertorier en exécutant tanzu kubernetes-release get.

Tanzu Kubernetes Grid gère les versions de Kubernetes avec des objets de version de Tanzu Kubernetes (TKr). Une TKr spécifie les images de système d'exploitation, les composants Kubernetes principaux et les modules de démarrage compatibles avec la version de Kubernetes définie dans la TKr. Lorsque vous exécutez tanzu cluster create avec une TKr par défaut ou non par défaut, Tanzu Kubernetes Grid utilise les composants et les modules de démarrage spécifiés dans la TKr pour créer le cluster. Il lit également votre fichier de configuration de cluster pour déterminer les images de système d'exploitation compatibles à utiliser lors de la création du cluster.

Pour obtenir la liste complète des versions de Kubernetes prises en charge, reportez-vous à la section Versions de Kubernetes prises en charge dans Tanzu Kubernetes Grid v2.1 des Notes de mise à jour de VMware Tanzu Kubernetes Grid 2.1.

Répertorier les versions disponibles

Pour répertorier toutes les versions de Kubernetes disponibles avec leur état de compatibilité et de mise à niveau actuel, exécutez tanzu kubernetes-release get avec un argument de correspondance de version facultatif, par exemple :

Pour répertorier toutes les versions, exécutez tanzu kubernetes-release get.
Pour répertorier toutes les versions correspondant à la v1.23.16, exécutez tanzu kubernetes-release get v1.23.10.

tanzu kubernetes-release get
NAME                       VERSION                  COMPATIBLE  ACTIVE  UPDATES AVAILABLE
v1.22.17---vmware.1-tkg.1  v1.22.17+vmware.1-tkg.1  True        True
v1.23.16---vmware.1-tkg.1  v1.23.16+vmware.1-tkg.1  True        True
v1.24.10---vmware.1-tkg.1  v1.24.10+vmware.1-tkg.1  True        True

Répertorier les mises à niveau disponibles

Pour découvrir les versions de TKr disponibles pour un cluster de charge de travail spécifique, exécutez tanzu cluster available-upgrades get avec le nom complet du cluster. Par exemple :

tanzu cluster available-upgrades get my-cluster

Activer ou désactiver une version de Tanzu Kubernetes

Une TKR peut être activée ou désactivée. Pour activer une TKR :

tanzu kubernetes-release activate TKR-NAME

Par exemple :

tanzu kubernetes-release activate v1.22.11---vmware.1-tkg.1

Pour désactiver une TKr :

tanzu kubernetes-release deactivate TKR-NAME

Par exemple :

tanzu kubernetes-release deactivate v1.22.11---vmware.1-tkg.1

Déployer un cluster avec une version de Kubernetes non définie par défaut

Chaque version de Tanzu Kubernetes Grid fournit une version par défaut de Kubernetes. La version par défaut de Tanzu Kubernetes Grid v2.1.1 est Kubernetes v1.24.10.

Lorsque Kubernetes publie des correctifs ou de nouvelles versions en amont, VMware les publie dans un registre public et le contrôleur de version de Tanzu Kubernetes les importe dans le cluster de gestion. Cela permet à la CLI tanzu de créer des clusters basés sur les nouvelles versions.

Pour répertorier les versions de Kubernetes disponibles, reportez-vous à la section Versions de Kubernetes disponibles ci-dessus.
Pour déployer des clusters qui exécutent une version de Kubernetes non définie par défaut, suivez les étapes ci-dessous.

Publier la version de Kubernetes sur votre infrastructure

Sur vSphere et Azure, vous devez effectuer une étape supplémentaire avant de pouvoir déployer des clusters qui exécutent des versions de Kubernetes non définie par défaut :

vSphere : Importez le fichier OVA du modèle d'image de base approprié dans vSphere et convertissez-le en modèle de machine virtuelle. Pour plus d'informations sur l'importation de fichiers OVA de base dans vSphere, reportez-vous à la section Importez le modèle d'image de base dans vSphere.
Azure : Exécutez la commande CLI Azure pour accepter la licence pour la version du système d'exploitation de base. Une fois que vous avez accepté une licence, vous pouvez ignorer cette étape à l'avenir :
1. Convertissez votre version cible de Kubernetes répertoriée dans la sortie de la commande tanzu kubernetes-release get en son SKU d'image Azure comme suit :
  - Remplacez le v du début par k8s-.
  - Remplacez . par dot dans le numéro de version.
  - Remplacez +vmware.* par -ubuntu-2004 pour désigner Ubuntu v20.04, la version du système d'exploitation par défaut pour toutes les machines virtuelles Tanzu Kubernetes Grid sur Azure.
  - Exemples : k8s-1dot24dot10-ubuntu-2004, k8s-1dot23dot16-ubuntu-2004.
2. Exécutez az vm image terms accept. Par exemple :
```
az vm image terms accept --publisher vmware-inc --offer tkg-capi-2022-06-24 --plan k8s-1dot24dot10-ubuntu-2004
```
Amazon Web Services (AWS) : Aucune action n'est requise. Les images de machine Amazon (AMI) Amazon Linux 2 qui incluent les versions de Kubernetes prises en charge sont disponibles publiquement pour tous les utilisateurs AWS, dans toutes les régions AWS prises en charge. Tanzu Kubernetes Grid utilise automatiquement l'AMI appropriée pour la version de Kubernetes que vous spécifiez.

Déployer le cluster Kubernetes

Si vous déployez un cluster basé sur un plan, définissez une variable d'environnement ALLOW_LEGACY_CLUSTER sur true :

export ALLOW_LEGACY_CLUSTER=true

Pour déployer un cluster de charge de travail avec une version de Kubernetes qui n'est pas la version par défaut pour votre version de Tanzu Kubernetes Grid, spécifiez la version de Tanzu Kubernetes dans l'option --tkr. Par exemple, pour déployer un cluster Kubernetes v1.22.17, exécutez :

tanzu cluster create my-1-22-17-cluster --tkr v1.22.17---vmware.1-tkg

Pour plus d'informations sur la création d'un cluster de charge de travail, reportez-vous à la section Créer des clusters de charge de travail.

Déployer un cluster avec une image de machine personnalisée

Pour les combinaisons courantes de version du système d'exploitation, de version de Kubernetes et d'infrastructure cible, Tanzu Kubernetes Grid avec un cluster de gestion autonome fournit des images de machine par défaut. Vous pouvez éventuellement créer des images de machine et des TKr personnalisées.

Voici quelques raisons d'effectuer cette opération :

Créer des clusters sur un système d'exploitation de base que VMware prend en charge, mais ne distribue pas, tel que Red Hat Enterprise Linux (RHEL) v8.
Installer des modules supplémentaires dans l'image de la machine de base ou la personnaliser comme décrit dans la section Personnalisation de la documentation d'Image Builder.

Pour obtenir des instructions, reportez-vous à la section Créer des images de machine.