Add an edge node - Container Service for Kubernetes - Centre de documentation Alibaba Cloud

Prérequis

Un ACK Edge cluster a été créé.

Limites

Vérifiez que votre cluster dispose d'un quota de nœuds suffisant. Pour ajouter davantage de nœuds, soumettez une demande d'augmentation de quota dans le Quota Center. Consultez la rubrique Quotas et limites pour connaître les limites de quota applicables aux ACK Edge cluster.
Lorsque vous ajoutez un nœud périphérique, configurez son groupe de sécurité afin d'autoriser l'accès aux noms de domaine requis. Reportez-vous à la section Configuration de l'accès au réseau public.
Sélectionnez un système d'exploitation pris en charge pour le nœud périphérique.
|
**Architecture système**
|
**Version du système**
|
**Version du noyau**
|
**Version du cluster**
| | --- | --- | --- | --- | |
AMD64/x86_64
|
Anolis 7.9 et Anolis 8.6
|
4,19.X
|
≥ 1.16.9-aliyunedge.1
| |
AMD64/x86_64
|
Alibaba Cloud Linux 2.1903
|
4,19.X
|
≥ 1.20.11-aliyunedge.1
| |
AMD64/x86_64
|
Alibaba Cloud Linux 3
|
5,10.X
|
≥ 1.20.11-aliyunedge.1
| |
AMD64/x86_64
|
CentOS 7.4, CentOS 7.5, CentOS 7.6, CentOS 7.7, CentOS 7.8 et CentOS 7.9
|
3,10.X
|
1.12.6-aliyunedge.1 ≤ version du cluster ≤ 1.30.7-aliyun.1
| |
AMD64/x86_64
|
CentOS 8.0 et CentOS 8.2
|
4,18.X
|
1.18.8-aliyunedge.1 ≤ version du cluster ≤ 1.30.7-aliyun.1
| |
AMD64/x86_64
|
Ubuntu 16.04
|
4,4.X
|
1.18.8-aliyunedge.1 ≤ version du cluster ≤ 1.30.7-aliyun.1
| |
AMD64/x86_64
|
Ubuntu 18.04
|
4,15.X
|
1.12.6-aliyunedge.1 ≤ version du cluster ≤ 1.30.7-aliyun.1
| |
AMD64/x86_64
|
Ubuntu 18.04
|
5,4.X
|
≥ 1.16.9-aliyunedge.1
| |
AMD64/x86_64
|
Ubuntu 18.04
|
5,11.X
|
≥ 1.18.8-aliyunedge.1
| |
AMD64/x86_64
|
Ubuntu 20.04
|
5,4.X
|
≥ 1.18.8-aliyunedge.1
| |
AMD64/x86_64
|
Ubuntu 20.04 et Ubuntu 22.04
|
5,15.X
|
≥ 1.26.3-aliyun.1
| |
AMD64/x86_64
|
Ubuntu 24.04
|
6,8.X
|
≥ 1.30.7-aliyun.1
| |
AMD64/x86_64
|
Red Hat Enterprise Linux 8.8 et Red Hat Enterprise Linux 8.10
|
4,18.X
|
1.26.3-aliyun.1 ≤ version du cluster ≤ 1.30.7-aliyun.1
| |
AMD64/x86_64
|
Kylin V10
|
4,19.X
|
≥ 1.26.3-aliyun.1
| |
AMD64/x86_64
|
UnionTech OS Server 20
|
4,19.X
|
≥ 1.26.3-aliyun.1
| |
AMD64/x86_64
|
Red Hat Enterprise Linux 9.3
|
5,14.X
|
≥ 1.30.7-aliyun.1
| |
Arm64
|
CentOS 8.0
|
4,19.X
|
≥ 1.14.8-aliyunedge.1
| |
Arm64
|
Ubuntu 18.04
|
4,9.X
|
1.14.8-aliyunedge.1 ≤ version du cluster ≤ 1.30.7-aliyun.1
| |
Arm64
|
Ubuntu 18.04
|
4,19.X
|
≥ 1.14.8-aliyunedge.1
| |
Arm64
|
Ubuntu 20.04
|
5,10.X
|
≥ 1.22.15-aliyunedge.1
|
Pour ajouter des nœuds GPU, consultez la rubrique Ajouter des nœuds GPU.

Ajouter un nœud

Kubernetes 1.26 et versions ultérieures

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, sélectionnez Nodes > Node Pools.
Sur la page Node Pools, sélectionnez ** > Add Existing Node** dans la colonne Actions située à droite du groupe de nœuds cible.

Sur la page Add Existing Edge Node, configurez cloud-edge communication ainsi que les options avancées.

Remarque

Si les paramètres de la console ne répondent pas à vos besoins, modifiez les paramètres edgeadm dans le script généré. Consultez la section Liste des paramètres.

Catégorie	Paramètre	Description
Communication cloud-périphérie	Période de validité du jeton	Durée de validité du script. Valeur par défaut : 1 heure. Spécifiez une période plus longue pour réutiliser le même script lors de l'ajout groupé de nœuds.

	Activer le mode silencieux	Indique s'il faut activer le mode silencieux. Lors de l'ajout d'un nœud périphérique, certaines étapes nécessitent une confirmation, comme la réinstallation éventuelle d'un runtime existant. Par défaut, toutes les invites reçoivent automatiquement la réponse `yes`.
Avancé	Libellés de nœud	Ajoute des libellés au nouveau nœud. Si une `clé de libellé` entre en conflit avec une `clé de libellé` du groupe de nœuds, le `libellé` du groupe de nœuds est prioritaire.
	Taints	Ajoute des taints au nouveau nœud.
	Annotations	Ajoute des annotations au nouveau nœud. Si les `annotations` entrent en conflit avec les `annotations` du groupe de nœuds, ces dernières sont prioritaires.
	Synchronisation automatique de l'heure	Lorsqu'elle est activée, edgeadm effectue automatiquement la synchronisation de l'heure.
	Interface réseau du nœud	Interface réseau hôte utilisée pour l'adresse IP du nœud et la communication du réseau de conteneurs. Si ce champ est vide, l'interface réseau de la route par défaut est utilisée.
	Télécharger les modules complémentaires depuis	Source de téléchargement des images des modules complémentaires système. Valeur par défaut : Public Network. Pour télécharger les images via le réseau interne, ajoutez le nœud à un groupe de nœuds de ligne louée.
	Répertoire de travail du runtime	Répertoire de travail du runtime. Ce paramètre prend effet uniquement lorsque `manageRuntime` est défini sur `true`. Chemin par défaut pour containerd : /var/lib/containerd.

Une fois la configuration terminée, cliquez sur OK. Sur la page de résultat, cliquez sur Copy, puis collez et exécutez le script sur le nœud périphérique.

Une fois que le nœud périphérique a rejoint le cluster, des journaux s'affichent dans le terminal. La dernière ligne de sortie confirme l'ajout réussi du nœud.

I0410 10:54:25.801554    19419 join-node.go:241] [join-node] Config the kubelet service configuration successfully.
I0410 10:54:25.801590    19419 join-node.go:246] [join-node] Adding edge hub static yaml
I0410 10:54:25.801662    19419 join-node.go:279] [join-node] Add edge hub static yaml is ok
I0410 10:54:25.801666    19419 join-node.go:384] [join-node] Start to joining node to cluster.
I0410 10:54:27.338166    19419 join-node.go:393] [join-node] Join node to cluster successfully.
I0410 10:54:27.338214    19419 install.go:151] [install-edgehub] Checking edgehub status
I0410 10:54:37.357405    19419 install.go:156] [install-edgehub] Edgehub is ok
I0410 10:54:37.357421    19419 install.go:86] [install-edgehub] Reconfiguring the kubelet configuration files.
I0410 10:54:37.364387    19419 install.go:103] [install-edgehub] Reconfigure the kubelet configuration files successfully.
I0410 10:54:37.364400    19419 install.go:104] [install-edgehub] Restarting the kubelet.
I0410 10:54:52.626540    19419 install.go:127] [install-edgehub] Restart the kubelet successfully.
I0410 10:54:52.626613    19419 postcheck.go:77] [post-check] Checking docker status
I0410 10:54:52.629194    19419 postcheck.go:86] [post-check] docker is ok
I0410 10:54:52.629208    19419 postcheck.go:92] [post-check] Checking kubelet status
I0410 10:54:52.631661    19419 postcheck.go:100] [post-check] Kubelet is ok
I0410 10:54:52.631671    19419 postcheck.go:106] [post-check] Checking edgehub status
I0410 10:54:52.642345    19419 postcheck.go:113] [post-check] Edgehub is ok
I0410 10:54:52.642356    19419 postcheck.go:129] [post-check] Checking addon kube-proxy status.
I0410 10:54:52.683227    19419 postcheck.go:133] [post-check] kube-proxy is OK.
I0410 10:54:52.683243    19419 postcheck.go:129] [post-check] Checking addon flannel status.
I0410 10:54:52.724501    19419 postcheck.go:133] [post-check] flannel is OK.
I0410 10:54:52.724518    19419 postcheck.go:129] [post-check] Checking addon coredns status.
I0410 10:54:52.764745    19419 postcheck.go:133] [post-check] coredns is OK.
I0410 10:54:52.764763    19419 postcheck.go:165] [post-check] Callback to the OpenAPI.
I0410 10:54:53.014706    19419 postcheck.go:178] [post-check] Callback to the OpenAPI successfully.
I0410 10:54:53.014760    19419 postcheck.go:66] This node joined into the cluster successfully.

Kubernetes antérieur à 1.26

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, sélectionnez Nodes > Node Pools.
Sur la page Node Pools, dans la colonne Actions correspondant au groupe de nœuds cible, choisissez > Add Existing Node.
Sur la page Add Node, l'option Manual est sélectionnée par défaut pour ajouter une instance existante.
Remarque
En mode manuel, vous pouvez ajouter des nœuds ECS sur le cloud, des nœuds Edge Node Service (ENS) et des nœuds sur site.
1. Cliquez sur Next pour configurer les paramètres d'accès au nœud sur la page suivante. Consultez la section Liste des paramètres.
  
  Définissez Architecture sur AMD64/X86_64 ou ARM64, sélectionnez Use Lightweight Access Mode, puis spécifiez les paramètres d'accès dans l'éditeur JSON. Par exemple, définissez enableIptables, quiet et manageRuntime sur true, et indiquez kube-proxy, flannel et coredns dans allowedClusterAddons.
  
  Remarque
  La durée de validité du script par défaut est de 1 heure. Spécifiez une durée plus longue pour réutiliser le script lors de l'ajout groupé de nœuds. Définissez la durée de validité du script sur 0 heure pour obtenir un script sans expiration.
2. Une fois la configuration terminée, cliquez sur Next. Sur la page Complete, cliquez sur Copy, puis collez et exécutez le script sur le nœud périphérique.

Liste des paramètres

Si les paramètres de la console ne répondent pas à vos besoins, modifiez les paramètres edgeadm dans le script généré comme décrit ci-dessous.

Paramètre	Paramètre correspondant dans la console	Description	Valeur
`quiet`	Activer le mode silencieux	Indique s'il faut activer le mode silencieux. Lors de l'enregistrement du nœud, certaines étapes nécessitent une confirmation, comme la réinstallation éventuelle d'un runtime existant.	`true` (par défaut) : Répond automatiquement `yes` à toutes les invites. `false` : L'enregistrement s'interrompt pour attendre une confirmation et peut être interrompu.
`manageRuntime`	N/A	Indique si `edgeadm` détecte et installe le runtime.	`true` (par défaut) : Détecte et installe le runtime. `false` : N'installe pas le runtime. Installez le runtime sur le nœud au préalable.
`nodeNameOverride`	N/A	Nom du nœud.	`""` : Valeur par défaut. Le nom d'hôte est utilisé. `"XXX"` : Le nom du nœud est XXX. `""` : Une chaîne aléatoire de 6 caractères est générée. `".XXX"` : Une chaîne aléatoire de 6 caractères avec le suffixe XXX est générée.
`allowedClusterAddons`	N/A	Modules complémentaires à installer. Valeur par défaut pour un nœud standard : ["kube-proxy","flannel","coredns"].	Valeur par défaut : `["kube-proxy","flannel","coredns"]`.
`gpuVersion`	N/A	Indique si le nœud est un nœud GPU. Valeur par défaut : vide. Consultez les modèles GPU pour connaître les versions GPU prises en charge.	`""` (par défaut) : Le nœud n'est pas ajouté en tant que nœud GPU. Les clusters ACK Edge exécutant Kubernetes 1.26 ou une version ultérieure peuvent ajouter des nœuds NVIDIA GPU sans configurer `gpuVersion`. L'outil détecte automatiquement le modèle GPU et installe les modules complémentaires requis.
`labels`	Libellés de nœud	Libellé à ajouter lors de l'enregistrement du nœud. Si cette `clé de libellé` entre en conflit avec une `clé de libellé` du groupe de nœuds, le `libellé` du groupe de nœuds est prioritaire.	`{}` : Aucun libellé n'est ajouté.
`annotations`	Annotations	Annotations à ajouter lors de l'enregistrement du nœud. Si ces `annotations` entrent en conflit avec les `annotations` du groupe de nœuds, ces dernières sont prioritaires.	`{}` : Aucune annotation n'est ajoutée.
`taints`	Taints	Taints à ajouter au nœud.	`[]`
`nodeIface`	N/A	Interface réseau hôte, utilisée pour : Obtenir les informations d'adresse IP du nœud à partir de l'interface réseau spécifiée. Définir l'interface réseau utilisée par le plug-in de réseau de conteneurs Flannel.	`""` : Si vide, kubelet obtient l'adresse IP du nœud selon l'ordre suivant : Recherche dans /etc/hosts un enregistrement correspondant au nom d'hôte. Adresse IP de l'interface réseau de la route par défaut. Flannel utilise l'interface réseau de la route par défaut.
`runtimeRootDir`	Répertoire de travail du runtime	Répertoire de travail du runtime. Ce paramètre prend effet uniquement lorsque `manageRuntime` est défini sur `true`.	`""` : Valeur par défaut. Si le runtime est Docker, le chemin par défaut est /var/lib/docker. Si le runtime est Containerd, le chemin par défaut est /var/lib/containerd.
`imageRepoType`	Télécharger les composants depuis	Source à partir de laquelle le nœud télécharge les images des modules complémentaires système.	`""` (par défaut) : Les nœuds d'un groupe de nœuds de ligne louée téléchargent les images depuis le réseau interne ; les nœuds d'un groupe de nœuds classique téléchargent depuis le réseau public. `public` : Télécharge les images depuis le réseau public. `private` : Télécharge les images depuis le réseau interne. Le nœud doit appartenir à un groupe de nœuds de ligne louée.
`selfHostNtpServer`	Synchronisation automatique de l'heure	Indique si la synchronisation de l'heure a été effectuée manuellement.	`false` (par défaut) : edgeadm effectue automatiquement la synchronisation de l'heure. `true` : Ignore la synchronisation automatique de l'heure car elle a été effectuée manuellement.
`flannelIface`	Interface réseau du nœud	Interface réseau utilisée par Flannel. Utilisez plutôt le paramètre nodeIface.	`""` (par défaut) : Flannel utilise l'interface réseau de la route par défaut.
`enableIptables`	N/A	Indique si edgehub active l'optimisation iptables. Obsolète depuis la v1.22 et les versions ultérieures. Non recommandé.	`false` : L'optimisation iptables est désactivée.

Références

Si vous rencontrez des problèmes lors de l'ajout d'un nœud périphérique, consultez la rubrique Résoudre les problèmes liés aux nœuds périphériques.
Pour supprimer un nœud périphérique inutilisé, consultez la rubrique Supprimer un nœud périphérique.
Consultez la rubrique Configurer l'autonomie des nœuds périphériques pour activer l'autonomie des nœuds périphériques. Les charges de travail sur les nœuds périphériques continuent de s'exécuter même lorsque les nœuds sont déconnectés du cloud.