Customize containerd parameters for a node pool - Container Service for Kubernetes

Si la configuration par défaut de containerd ne répond pas aux exigences de vos charges de travail, personnalisez les paramètres containerd pour un pool de nœuds. Par exemple, configurez plusieurs miroirs de registre pour un registre d'images spécifique ou désactivez la validation des certificats pour un registre d'images.

Limites

Cette fonctionnalité est disponible uniquement pour les pools de nœuds utilisant containerd 1.6.20 ou une version ultérieure comme moteur de conteneurisation. Si votre pool de nœuds utilise une version antérieure, mettez-le à niveau.

Précautions

Les paramètres containerd personnalisés s'appliquent aux nœuds par lots. Ces modifications prennent effet immédiatement sur les nœuds existants et sont automatiquement appliquées aux nouveaux nœuds.
Ne modifiez pas les paramètres containerd personnalisables pris en charge depuis la ligne de commande. Container Service for Kubernetes (ACK) bloque ces modifications. Annulez toute modification effectuée de cette manière.
Le système corrige automatiquement la syntaxe non standard lors de l'application des paramètres containerd personnalisés.

Paramètres containerd personnalisables pris en charge

Configuration personnalisée du moteur de conteneurisation

Paramètre	Remarque	Type	Valeur
`max_concurrent_downloads`	Nombre maximal de téléchargements simultanés de couches d'images. L'augmentation de cette valeur peut accélérer le tirage d'images multicouches, mais augmente également la charge réseau et les opérations d'E/S.	Int	Plage valide : [1, 20] Valeur par défaut : Dépend de la version de containerd. containerd 2.x et versions ultérieures : `3`. containerd 1.x et versions antérieures : Le comportement de tirage est déterminé par la logique interne du moteur d'exécution.
`ignore_image_defined_volumes`	Indique s'il faut ignorer les volumes anonymes définis dans une image avec l'instruction `VOLUME`. Définissez ce paramètre sur `true` pour empêcher les conteneurs de créer automatiquement des volumes anonymes.	Bool	Valeur par défaut : true
`limitCore`	Taille maximale en octets d'un fichier core pouvant être généré lorsqu'un processus conteneurisé effectue un vidage mémoire (core dump). Valeurs clés : `0` : Désactive la génération des fichiers de vidage mémoire. `infinity` : Aucune limite de taille.	Int	Plage valide : Entier non négatif Valeur par défaut : `infinity`
`limitNoFile`	Nombre maximal de descripteurs de fichiers pouvant être ouverts au sein d'un conteneur.	Int	Plage valide : ≥ 1024 Valeur par défaut : 1048576
`limitMemLock`	Quantité maximale de mémoire en octets qu'un processus dans un conteneur peut verrouiller.	Int	Plage valide : ≥ 65536 Valeur par défaut : Généralement `65536`, cohérente avec le système d'exploitation hôte. Pour les nœuds Lingjun ou les nœuds où des périphériques RDMA ou EDMA sont détectés lors de l'initialisation, la valeur par défaut est automatiquement définie sur `infinity`. Ce comportement n'est pas déclenché si des périphériques sont attachés après que le nœud est prêt.

Registry Mirror Configuration

Description

Recommandation

Configurez des miroirs de registre pour un registre d'images afin que le moteur de conteneurisation puisse tirer des images depuis des registres alternatifs, ce qui accélère le tirage des images.

Chaque miroir de registre prend en charge le mappage de chemin personnalisé via override_path.

Cette modification ne nécessite pas le redémarrage des conteneurs.

Utilisez un registre d'images local pour accélérer le tirage des images.
Configurez plusieurs miroirs de registre pour assurer une haute disponibilité et une tolérance aux pannes.

Image Registries Skipping Certificate Authentication (Insecure Registries)

Description

Recommandation

Permet au moteur de conteneurisation d'ignorer la validation des certificats pour les registres d'images spécifiés lors du tirage des images. Ce paramètre est destiné aux environnements de test pour tirer des images depuis des registres utilisant des certificats auto-signés.

Cette modification ne nécessite pas le redémarrage des conteneurs.

L'ignorance de la validation des certificats présente des risques de sécurité. Utilisez cette option uniquement dans les environnements de développement et de test.
Configurez ce paramètre uniquement pour un registre privé qui utilise un certificat auto-signé ou qui ne peut pas obtenir de certificat valide.

Procédure

La modification des configurations containerd n'affecte pas les conteneurs existants. Pour garantir la stabilité du cluster, effectuez cette opération pendant les heures creuses.

Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.
Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Nodes > Node Pools.
Sur la page Node Pools, localisez le pool de nœuds souhaité, puis dans la colonne Actions, choisissez > Containerd Configuration.
Lisez les précautions, suivez les instructions à l'écran pour ajouter des paramètres, spécifier les nœuds cibles et définir la stratégie de lot, puis cliquez sur Submit.

Consultez les exemples de configuration ci-dessous.
- Si vous supprimez la configuration personnalisée du moteur de conteneurisation, elle revient automatiquement à la valeur par défaut.
- Après soumission, les paramètres sont appliqués aux nœuds par lots, ce qui prend du temps. Surveillez la progression et gérez la mise à jour dans la zone Event Records, par exemple en la mettant en pause, en la reprenant ou en l'annulant. Si la mise à jour d'un nœud échoue, résolvez le problème et cliquez sur Continue pour réessayer.
  
  La mise en pause de la mise à jour vous permet de valider les modifications sur les nœuds déjà mis à jour. Lorsqu'elle est en pause, les nœuds en cours de mise à jour termineront l'opération, mais les nouvelles mises à jour sont reportées jusqu'à ce que vous repreniez la tâche. Nous vous recommandons de terminer la tâche de configuration dès que possible. Les tâches en pause sont automatiquement annulées après sept jours, supprimant tous les enregistrements et journaux associés.

Exemples de configuration

Miroir pour docker.io	Registre privé non sécurisé	Registre privé HTTP
Dans la section Registry mirrors, saisissez `docker.io` pour Image registry, entrez l'adresse du miroir (par exemple, `https://example.com`) pour Registry mirror, et sélectionnez `false` pour override_path.	Dans la section Insecure registries, saisissez l'adresse du registre privé dans le champ Image registry, au format `IP address:Port` (par exemple, `192.xxx.xxx.xxx:443`), et définissez skip_verify sur `true` pour ignorer la validation du certificat.	Dans la section Registry mirrors, saisissez l'adresse du registre privé (par exemple, `192.xxx.1`) pour Image registry, entrez l'adresse HTTP correspondante (par exemple, `http://192.xxx.1`) pour Registry mirror, et sélectionnez `false` pour override_path. Vous pouvez cliquer sur + Add pour ajouter d'autres mappages de miroirs de registre.

FAQ

Les paramètres containerd personnalisés affectent-ils les services en cours d'exécution ?

Non. Les modifications n'affectent pas les Pods en cours d'exécution et s'appliquent uniquement aux Pods créés après la mise à jour. Nous vous recommandons d'effectuer cette opération pendant les heures creuses.

Pour appliquer les nouveaux paramètres aux Pods existants, recréez-les manuellement.

Erreur contenant `not match XXX` ou erreurs `must be between XXX`

Cette erreur se produit généralement pour les raisons suivantes :

must be between XXX : La valeur saisie n'est pas valide. Vérifiez que la valeur est correctement formatée et qu'elle se situe dans la plage autorisée.
not match XXX : Vous avez utilisé une méthode de modification non prise en charge. ACK bloque les modifications directes apportées au fichier de configuration depuis la ligne de commande. Rétablissez la valeur d'origine du paramètre dans le fichier.

Rubriques connexes

Pour plus d'informations sur les capacités d'exploitation et de maintenance (O&M) automatisées prises en charge par les pools de nœuds, consultez les Capacités d'O&M automatisées.
Si vous rencontrez des erreurs ou un comportement anormal avec vos nœuds, Pods, containerd ou kubelet, consultez les guides de dépannage suivants : Dépannage des problèmes de nœuds, Dépannage des problèmes de Pod et FAQ sur les nœuds et les pools de nœuds.