Cette page explique comment spécifier l'environnement d'exécution de conteneur utilisé par votre cluster pour exécuter les pods Kubernetes. Vous spécifiez l'environnement d'exécution de conteneur en définissant la valeur du champ containerRuntime
dans le fichier de configuration du cluster.
Vous ne pouvez modifier la valeur du champ containerRuntime
que lors de la mise à niveau ou de l'installation d'un cluster. Ce champ est facultatif et est défini par défaut sur containerd
si vous le laissez non défini.
Fin de compatibilité de Kubernetes 1.24 avec Docker Engine
Le composant dockershim
de Kubernetes permet aux nœuds de cluster d'utiliser l'environnement d'exécution de conteneur Docker Engine. Toutefois, Kubernetes 1.24 a supprimé le composant dockershim
. Étant donné que les clusters Anthos sur solution Bare Metal version 1.13 s'exécuteront sur Kubernetes 1.24, les versions 1.13 et ultérieures ne peuvent plus utiliser Docker Engine.
Lors de la mise à niveau ou de la création de clusters, notez les règles d'exécution de conteneur suivantes :
- Vous devez utiliser
containerd
pour les clusters des versions 1.13 et ultérieures. Vous ne pouvez pas mettre à niveau un cluster 1.12 qui utilise Docker vers la version 1.13. - Vous ne pouvez pas créer de clusters de version 1.12 qui utilisent l'environnement d'exécution de conteneur Docker Engine.
- Vous pouvez mettre à niveau un cluster 1.11 qui utilise Docker vers un cluster 1.12 qui utilise Docker. Toutefois, nous vous recommandons vivement de passer à containerd avant de procéder à la mise à niveau.
L'installation de Docker que vous utilisez en développement pour créer des images n'est pas liée à l'environnement d'exécution de conteneurs Docker Engine dans votre cluster Kubernetes. Vous pouvez toujours utiliser Docker pour créer des images et des conteneurs d'application. Ces conteneurs continueront de fonctionner dans votre cluster.
Docker doit être installé sur votre poste de travail administrateur.
La commande bmctl
nécessite Docker pour certaines opérations comme la création de cluster.
Cette utilisation de Docker n'est pas affectée par l'abandon de dockershim
.
Pour obtenir des instructions détaillées sur la spécification de l'environnement d'exécution du conteneur utilisé dans votre cluster, consultez les sections suivantes.
Avant de commencer
Identifiez l'environnement d'exécution du conteneur que vos clusters doivent utiliser. Vous ne pouvez modifier la valeur du champ d'environnement d'exécution du conteneur que lors de la mise à niveau ou de l'installation d'un cluster.
Assurez-vous que votre déploiement est compatible avec la version 1.4.6 de
containerd
ou une version ultérieure. Anthos clusters on Bare Metal installe cette version par-dessus toutes celles précédemment installées decontainerd
.Assurez-vous qu'Anthos clusters on Bare Metal peut installer les fichiers suivants, qui sont installés pour les deux environnements d'exécution :
Fichiers binaires
/usr/bin/containerd
/usr/bin/containerd-shim
/usr/bin/containerd-shim-runc-v1
/usr/bin/containerd-shim-runc-v2
/usr/bin/crictl
/usr/bin/ctr
/usr/local/sbin/runc
Fichiers de configuration
/etc/crictl.yaml
/etc/systemd/system/containerd.service
/etc/containerd/config.toml
/etc/containerd/certs.d/
/etc/systemd/system/containerd.service.d/09-proxy.conf
Ce fichier n'est installé que si vous configurez un proxy HTTP.
Assurez-vous qu'Anthos clusters on Bare Metal peut installer les certificats suivants sur vos nœuds en fonction de l'environnement d'exécution choisi :
- Pour
containerd
:/etc/docker/certs.d/
/etc/containerd/certs.d/
- Pour Docker :
/etc/docker/certs.d/
- Pour
Configurer l'environnement d'exécution du conteneur pour un nouveau cluster
Pour définir votre environnement d'exécution de conteneur pour un nouveau cluster, définissez le champ containerRuntime
dans la section nodeConfig
de la rubrique spec
de votre fichier de configuration de cluster. Anthos clusters on Bare Metal accepte les valeurs suivantes :
containerd
docker
Si le champ est vide ou s'il n'est pas défini, Anthos clusters on Bare Metal utilise containerd
par défaut.
Pour utiliser Docker, le contenu de votre configuration doit ressembler à l'exemple suivant :
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: cluster1
namespace: cluster-cluster1
spec:
nodeConfig:
containerRuntime: docker
Configurer l'environnement d'exécution de conteneur lors de la mise à niveau d'un cluster
Vous pouvez configurer des clusters Anthos sur Bare Metal pour qu'ils utilisent un environnement d'exécution de conteneur différent lors de la mise à niveau. Vous ne pouvez modifier la valeur du champ d'environnement d'exécution du conteneur que lors de la mise à niveau ou de l'installation d'un cluster.
Conditions requises
- Mettez à niveau les clusters d'administrateur avant des clusters d'utilisateur.
- Définissez la valeur du champ
containerRuntime
dans votre fichier de configuration avant de mettre à niveau vos clusters.
Remplacer l'environnement d'exécution par Docker
Pour définir votre environnement d'exécution de conteneur lors d'une mise à niveau, définissez le champ containerRuntime
dans la section nodeConfig
de la rubrique spec
de votre fichier de configuration de cluster. Anthos clusters on Bare Metal accepte les valeurs suivantes :
containerd
docker
Pour utiliser Docker, modifiez votre fichier de configuration pour qu'il ressemble à l'exemple suivant :
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
name: cluster1
namespace: cluster-cluster1
spec:
nodeConfig:
containerRuntime: docker
Pour définir l'environnement d'exécution du conteneur des nœuds de cluster sur docker
lors de leur mise à niveau, exécutez la commande suivante pour mettre à jour vos clusters :
bmctl upgrade cluster
Mettre à jour des clusters où Docker est défini comme environnement d'exécution
Si vous définissez l'environnement d'exécution de conteneur sur docker
, la commande suivante met à jour les certificats du registre d'images dans /etc/containerd/certs.d/
.
bmctl update cluster
Réinitialiser les clusters qui utilisent containerd en tant qu'environnement d'exécution
Si vous utilisez l'environnement d'exécution de conteneurs par défaut, la commande suivante ne supprime pas les configurations, les fichiers binaires ni les répertoires :
bmctl reset cluster
Lors de la réinitialisation, le service containerd
continue de s'exécuter, mais les conteneurs programmés par Kubernetes sont arrêtés et supprimés de l'environnement d'exécution containerd.
Supprimez les fichiers binaires et les répertoires suivants pour terminer la réinitialisation :
/etc/crictl.yaml
/etc/systemd/system/containerd.service
/etc/systemd/system/containerd.service.d/
/etc/containerd/config.toml
/etc/containerd/certs.d/
Si vous utilisez Docker comme environnement d'exécution, aucun nettoyage n'est effectué pendant la réinitialisation.
Vérifier l'état de l'environnement d'exécution
Pour vérifier l'état de l'environnement d'exécution lors de la vérification de l'état de la machine, exécutez la commande suivante :
systemctl status RUNTIME
Remplacez RUNTIME
par l'environnement d'exécution choisi : containerd
ou docker
.