Ajouter des instances ECS existantes en tant que nœuds de travail ACK - Container Service for Kubernetes

Ajoutez des instances ECS existantes en tant que nœuds de travail ou réajoutez des nœuds supprimés afin de réutiliser les ressources de calcul sans interrompre les charges de travail.

ACK prend en charge les modes automatique et manuel pour l'ajout de nœuds. La méthode de facturation et le type d'instance restent inchangés après l'ajout d'une instance.

Élément

Mode automatique

Mode manuel

Réinitialisation du système d'exploitation

Le système d'exploitation est réinitialisé et initialisé selon la configuration du pool de nœuds.

Le disque système est libéré et ses données sont perdues.
Les snapshots manuels du disque système sont conservés. La conservation des snapshots automatiques dépend de l'activation du paramètre Delete Automatic Snapshots While Releasing Disk.

Pour configurer ce paramètre, connectez-vous à la console ECS et consultez la rubrique Définir l'attribut « Delete Automatic Snapshots While Releasing Disk ».
Le disque de données est conservé et ses données sont préservées, mais l'ID du disque change.

Le système d'exploitation d'origine est préservé pour une plus grande flexibilité.

Cas d'utilisation

Vous souhaitez que la configuration de l'instance corresponde à celle du pool de nœuds pour une gestion standardisée.

Vous devez préserver le système d'exploitation de l'instance ou des configurations spécifiques.

Limitations

Assurez-vous que votre environnement et vos instances répondent aux exigences suivantes.

Catégorie	Élément	Description
Instance et pool de nœuds	Quota de nœuds du cluster	Le nombre de nœuds du cluster ne peut pas dépasser le quota. Pour augmenter le quota, accédez au Quota Center. Le quota de nœuds par défaut pour un cluster ACK Basic est de 10.
	Propriété de l'instance	L'instance et le cluster doivent appartenir au même compte Alibaba Cloud, à la même région et au même VPC. Dans le cas contraire, migratez l'instance ou créez une instance ou un cluster répondant aux exigences. Vous ne pouvez pas ajouter une instance ECS située à l'autre extrémité d'une connexion d'appairage VPC.
	Propriété du cluster	Vous ne pouvez pas ajouter une instance appartenant à un autre cluster ACK. Commencez par supprimer le nœud du cluster d'origine, puis ajoutez-le au nouveau cluster.
	Propriété du groupe de mise à l'échelle (ESS)	Vous ne pouvez pas ajouter une instance appartenant à un autre groupe de mise à l'échelle. Commencez par la supprimer du groupe de mise à l'échelle.
	Type de pool de nœuds	Vous ne pouvez pas ajouter des nœuds existants à un pool de nœuds en mode automatique. Vous ne pouvez pas ajouter des nœuds existants à un pool de nœuds avec Auto Scaling activé. Après avoir ajouté un nœud existant, vous ne pouvez pas activer Auto Scaling pour ce pool de nœuds.
	Système d'exploitation	La fonction Swap doit être désactivée sur le système d'exploitation. En mode manuel, vous ne pouvez pas ajouter d'instances exécutant Windows ou ContainerOS. Consultez la rubrique Systèmes d'exploitation.
	Type d'instance	L'instance ne doit pas être d'un type d'instance ECS non pris en charge. Pour les instances GPU Bare Metal ECS (familles d'instances ECS ebmgn7 et ebmgn7e), le nettoyage automatique Multi-Instance GPU (MIG) n'est pas pris en charge. Lorsque vous ajoutez une telle instance, ses paramètres MIG sont réinitialisés. Cette réinitialisation peut prendre beaucoup de temps et entraîner l'échec de l'ajout automatique du nœud. Pour résoudre les problèmes, consultez la rubrique Que faire si l'ajout d'un nœud d'instance bare metal échoue ?.
Réseau	Accès à l'API Server	L'adresse IP de l'instance doit figurer dans la liste d'autorisation d'accès à l'API Server. Dans le cas contraire, le nœud ne peut pas communiquer avec le plan de contrôle. Consultez la rubrique Configurer le contrôle d'accès pour l'API Server.
	Groupe de sécurité	Cohérence du type : le type de groupe de sécurité de l'instance (basique ou entreprise) doit correspondre à celui du pool de nœuds. Compatibilité des règles : le groupe de sécurité de l'instance doit autoriser l'accès au point de terminaison interne de l'API Server sur le port 6443, et ses règles ne doivent pas entrer en conflit avec celles du cluster ou du pool de nœuds. Recherchez le point de terminaison interne de l'API Server dans l'onglet Basic Information de la page Cluster Information. Quota : une instance ne peut pas rejoindre plus de groupes de sécurité que ne l'autorise le quota de groupes de sécurité. Pour modifier le type de groupe de sécurité d'une instance ou ajouter une instance au groupe de sécurité du pool de nœuds à l'avance, consultez la rubrique Associer un groupe de sécurité à une instance (ENI principale). Pour augmenter le quota de groupes de sécurité, consultez la rubrique Afficher ou augmenter les quotas ECS.
	Terway - Nombre maximal de pods	Le nombre maximal de pods pris en charge par l'instance doit répondre aux exigences suivantes : Le nombre maximal de pods pris en charge dans différents modes d'interface réseau élastique (ENI) dépend du nombre maximal d'ENI pris en charge par le type d'instance. Pour calculer cette limite, consultez la rubrique Comment calculer le quota de pods pour un nœud. Pour le mode ENI partagé, le nombre maximal de pods pris en charge doit être supérieur à 10. Pour le mode ENI exclusif, le nombre maximal de pods pris en charge doit être supérieur à 5. Si cette exigence n'est pas respectée, mettez à niveau ou rétrogradez les ressources du nœud ou achetez une nouvelle instance.
	Terway - Configuration vSwitch	Si l'instance et le pool de nœuds se trouvent dans des zones de disponibilité différentes, mettez à jour la configuration vSwitch Terway. Dans le cas contraire, Terway alloue les adresses IP des pods à partir du vSwitch de l'ENI principale, ce qui peut provoquer des erreurs d'allocation d'adresses IP de pod. Consultez la rubrique Modifier les vSwitch de pod.
	Terway - ENI	Lorsque vous ajoutez l'instance, ses ENI liées sont conservées et les adresses IP des pods sont allouées à partir des vSwitch associés à ces ENI. Assurez-vous que l'instance ne possède qu'une seule ENI principale. Si une adresse IP de pod n'appartient pas à un vSwitch configuré, supprimez le nœud du cluster, supprimez toutes les ENI secondaires, puis rajoutez le nœud.
	Terway - Rôle RAM Worker	L'instance doit être liée au rôle RAM Worker du pool de nœuds afin d'éviter les problèmes d'autorisations susceptibles de provoquer un calcul incorrect de MaxPod. Sur la page Node Pools, cliquez sur le nom d'un pool de nœuds pour afficher son rôle RAM Worker dans l'onglet Basic Information. Pour accorder le rôle RAM, consultez la rubrique Accorder un rôle RAM à une instance ECS.
	Terway - Double pile IPv6	Si la double pile IPv6 est activée pour le cluster, attribuez une adresse IPv6 à l'ENI principale de l'instance. Consultez la rubrique Communication IPv6.
	Flannel	Le nombre d'entrées de routage personnalisées dans la table de routage système du VPC du cluster ne peut pas dépasser le quota de la table de routage. Pour augmenter le quota, accédez au Quota Center.

Remarques sur l'utilisation

Sauvegarde des données : avant de commencer, créez un snapshot manuel des disques système et de données afin d'éviter toute perte de données.

Pour vous assurer de disposer d'un quota de snapshots suffisant, supprimez les snapshots manuels et automatiques inutiles pour éviter les échecs de création.
Libération des instances et facturation : pour les pools de nœuds dont le nombre de nœuds attendu n'est pas activé, les instances ajoutées au pool de nœuds ne sont pas libérées lorsque vous supprimez le cluster ou le pool de nœuds. Vous devez supprimer manuellement les nœuds. Surveillez la facturation ECS pour éviter des frais imprévus.

Procédure

Durée requise : l'ajout d'un nœud, y compris le remplacement du disque système (mode automatique uniquement) et l'initialisation du nœud, prend environ 5 minutes. La durée réelle varie en fonction des conditions réseau, de la taille de l'image du système d'exploitation et d'autres facteurs.

L'ajout d'un nœud existant n'affecte pas les nœuds ou les applications existants du cluster. N'initialisez pas une instance ECS qui exécute déjà des services en tant que nœud de travail afin d'éviter les problèmes de compatibilité.

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 cible, cliquez sur dans la colonne Actions, puis cliquez sur Add Existing Node.

Si l'instance ECS cible ne figure pas dans la liste des serveurs, elle ne répond pas aux exigences d'ajout au cluster. Sélectionnez Show Unavailable Instances pour afficher les instances ECS indisponibles et les raisons correspondantes. Consultez les Limitations et les Remarques sur l'utilisation .
Lisez les remarques affichées à l'écran et sélectionnez une méthode pour ajouter le nœud.

Ajout manuel

Obtenez une commande d'installation et exécutez-la sur l'instance cible. Vous ne pouvez ajouter qu'une seule instance ECS à la fois.

Définissez Method sur Manual. Sélectionnez l'instance ECS à ajouter dans la liste des serveurs cloud existants, puis cliquez sur Next.

Sur la page Specify Instance Information, confirmez les détails du cluster et de l'instance. Configurez le disque de données et le nom de l'instance, puis cliquez sur Next.

Paramètre	Description
Data Disk	Indique s'il faut stocker les données des conteneurs et des images sur un disque de données, en séparant le disque système des disques de données pour une meilleure stabilité. Si l'instance ECS dispose d'un disque de données attaché et que le système de fichiers du dernier disque de données n'est pas initialisé, ACK formate automatiquement le dernier disque de données en ext4. Le disque stocke les données exclusivement dans /var/lib/containerd ou /var/lib/docker (répertoires par défaut du runtime de conteneur) et /var/lib/kubelet (répertoire kubelet par défaut). Important Le formatage efface les données existantes sur le disque de données. Créez un snapshot pour sauvegarder vos données au préalable. Si vous stockez les conteneurs et les images sur un disque de données, seuls les systèmes de fichiers ext4 et xfs sont pris en charge. Si l'instance ECS ne dispose d'aucun disque de données attaché, ACK n'attache pas de nouveau disque de données, que vous sélectionniez ou non cette option.
Retain Instance Name	Activé : utilise le nom de l'instance comme nom de nœud. Désactivé : ACK renomme le nœud selon les règles de nommage personnalisées des nœuds.

Sur la page Complete, copiez la commande de jonction de nœud générée par ACK, puis cliquez sur Finish.
Connectez-vous à la console ECS. Dans le volet de navigation de gauche, choisissez Instances & Images > Instance. Sélectionnez la région du cluster et l'instance cible.
Cliquez sur Connect pour l'instance cible et sélectionnez une méthode de connexion à distance.
Saisissez et exécutez le script que vous avez copié à l'étape 3 pour configurer et ajouter l'instance au cluster.

Une fois le script exécuté avec succès, un message de réussite s'affiche. Dans la liste des nœuds, attendez que le statut du nouveau nœud passe à Ready.
```
Worker node joined successfully
+ exit_code=0
+ set +x
```

Ajout automatique

Ajoutez des instances automatiquement depuis la console.

Définissez Method sur Auto. Sélectionnez les instances ECS à ajouter dans la liste des serveurs cloud existants, puis cliquez sur Next.

Sur la page Specify Instance Information, confirmez les détails du cluster et de l'instance. Configurez le disque de données et le nom de l'instance, puis cliquez sur Next.

Paramètre	Description
Data Disk	Indique s'il faut stocker les données des conteneurs et des images sur un disque de données, en séparant le disque système des disques de données pour une meilleure stabilité. Si l'instance ECS dispose d'un disque de données attaché et que le système de fichiers du dernier disque de données n'est pas initialisé, ACK formate automatiquement le dernier disque de données en ext4. Le disque stocke les données exclusivement dans /var/lib/containerd ou /var/lib/docker (répertoires par défaut du runtime de conteneur) et /var/lib/kubelet (répertoire kubelet par défaut). Important Le formatage efface les données existantes sur le disque de données. Créez un snapshot pour sauvegarder vos données au préalable. Si vous stockez les conteneurs et les images sur un disque de données, seuls les systèmes de fichiers ext4 et xfs sont pris en charge. Si l'instance ECS ne dispose d'aucun disque de données attaché, ACK n'attache pas de nouveau disque de données, que vous sélectionniez ou non cette option.
Méthode de connexion et mot de passe	Si le Logon Type du pool de nœuds est défini sur Password, réinitialisez le mot de passe de l'instance.
Retain Instance Name	Activé : utilise le nom de l'instance comme nom de nœud. Désactivé : ACK renomme le nœud selon les règles de nommage personnalisées des nœuds.

Dans la boîte de dialogue, lisez les remarques et cliquez sur OK.

Une fois le nœud ajouté, attendez son initialisation dans la liste des nœuds jusqu'à ce que son statut passe à Ready.

FAQ

L'ajout de nœuds affecte-t-il les charges de travail ?

L'ajout d'un nœud existant en mode manuel ou automatique n'affecte pas les charges de travail existantes du cluster.

Comment la mise à l'échelle des instances affecte-t-elle les charges de travail ?

La mise à niveau ou la rétrogradation d'une instance ECS peut modifier le type d'instance, la méthode de facturation de la bande passante publique, la bande passante publique ou la méthode de facturation des disques de données. Consultez la rubrique Présentation des modifications de configuration des instances. L'impact varie selon la méthode de mise à niveau ou de rétrogradation utilisée.

Opérations ne nécessitant pas de redémarrage : l'impact dépend de votre scénario.
Opérations nécessitant un redémarrage de l'instance ECS : les opérations telles que la mise à niveau ou la rétrogradation du type d'instance entraînent des interruptions de service. Avant une telle opération, par exemple lors de la mise à niveau ou rétrogradation des ressources des nœuds, vérifiez la charge de travail actuelle pour déterminer si des nœuds redondants sont nécessaires pour prendre en charge les pods. Drainez ensuite le nœud pour effectuer la mise à niveau ou la rétrogradation, puis retirez-le du groupe de mise à l'échelle et du cluster ACK. Consultez la rubrique Supprimer des nœuds.

Une fois la mise à niveau ou la rétrogradation terminée, rajoutez le nœud au cluster en suivant les instructions de cette rubrique.

Puis-je utiliser différents types d'instances ?

Oui. ACK vous permet de gérer des nœuds de plusieurs types d'instances au sein d'un même pool de nœuds, évitant ainsi les échecs de mise à l'échelle horizontale dus à l'indisponibilité d'un type d'instance ou à un stock insuffisant. Avant d'ajouter une instance ECS, assurez-vous que son type d'instance figure dans la liste des types d'instances du pool de nœuds. Procédez comme suit :

Modifiez ou créez un pool de nœuds et configurez les types d'instances de nœud requis. Consultez la rubrique Créer et gérer un pool de nœuds.
Drainez et supprimez le nœud cible. Ne libérez pas l'instance ECS. Consultez la rubrique Supprimer des nœuds.
Ajoutez des instances ECS de différents types au pool de nœuds en respectant les sections Limites et Procédure de cette rubrique.

Comment déplacer des nœuds entre des clusters ?

ACK ne prend pas en charge le déplacement direct de nœuds entre des clusters. Ajoutez plutôt un nœud existant. Procédez comme suit :

Drainez et supprimez le nœud cible du cluster source. Ne libérez pas l'instance ECS. Consultez la rubrique Supprimer des nœuds.
Ajoutez l'instance ECS cible à un pool de nœuds dans le cluster de destination en respectant les sections Limites et Procédure de cette rubrique.

Puis-je ajouter un nœud avec un système d'exploitation en fin de vie (EOL) ?

Mode manuel : vous pouvez ajouter une instance existant exécutant un système d'exploitation non pris en charge à un pool de nœuds, mais assurez-vous que la version du système d'exploitation de l'instance est compatible avec la version actuelle du cluster. Consultez la rubrique Systèmes d'exploitation.

Par exemple, CentOS 7 et Alibaba Cloud Linux 2 sont pris en charge uniquement dans les clusters de version 1.30 et antérieures.
Mode automatique : ACK initialise l'instance à l'aide de l'image du système d'exploitation spécifiée dans la configuration du pool de nœuds.

Les données utilisateur sont-elles écrasées lors de l'ajout de nœuds ?

Le fait que les données utilisateur originales de l'instance soient écrasées dépend de la méthode d'ajout.

Mode automatique : ACK initialise le disque système, écrasant les données utilisateur originales de l'instance par les données utilisateur configurées pour le pool de nœuds.
Mode manuel : les données utilisateur originales de l'instance ne sont pas écrasées. Une fois l'instance ajoutée au pool de nœuds, elle continue d'utiliser ses données utilisateur d'origine.

Comment résoudre les délais d'expiration lors de l'ajout de nœuds ?

Vérifiez la connectivité réseau entre le nœud et le CLB API Server. Commencez par vérifier que le groupe de sécurité répond aux exigences. Pour connaître les limitations relatives aux groupes de sécurité lors de l'ajout d'un nœud existant, consultez la section Limites. Pour les autres problèmes de connectivité réseau, consultez la rubrique FAQ sur la gestion du réseau.

L'ajout d'un nœud modifie-t-il le nombre attendu ?

Oui. Après avoir ajouté un nœud existant, le compteur Expected Nodes augmente du nombre de nœuds ajoutés. Par exemple, si Expected Nodes est défini sur 5 et que vous ajoutez une instance ECS, le compteur passe à 6.

Références

Outre la console, vous pouvez ajouter des instances ECS à un cluster ACK en appelant une opération API (Obtenir le script pour ajouter des nœuds existants à un pool de nœuds) ou en exécutant une commande CLI (Ajouter des instances ECS existantes).
Les anciens clusters créés avant l'introduction de la fonctionnalité de pool de nœuds peuvent contenir des nœuds libres (nœuds n'appartenant à aucun pool de nœuds). Migrez-les vers un pool de nœuds pour une gestion centralisée. Consultez la rubrique Migrer des nœuds libres vers un pool de nœuds.
Si un nœud, un pod ou un autre composant ne fonctionne pas comme prévu, résolvez le problème. Consultez les rubriques Résoudre les exceptions de nœud, Résoudre les exceptions de pod et FAQ sur les nœuds et les pools de nœuds.