**Unterstützung für die Verbesserung dieser Seite beitragen** Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. Um zu diesem Benutzerhandbuch beizutragen, wählen Sie den GitHub ** Link Diese Seite ** bearbeiten unter, der sich im rechten Bereich jeder Seite befindet. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Hybridknoten in einem vorhandenen Amazon-EKS-Cluster aktivieren oder die Konfiguration ändern Dieses Thema bietet einen Überblick über die verfügbaren Optionen und beschreibt, was zu beachten ist, wenn Sie die Hybridknoten-Konfiguration für einen Amazon-EKS-Cluster hinzufügen, ändern oder entfernen. Um einem Amazon-EKS-Cluster die Verwendung von Hybridknoten zu ermöglichen, fügen Sie der `RemoteNetworkConfig`-Konfiguration die CIDR-Bereiche der IP-Adressen Ihres On-Premises-Knotens und optional des Pod-Netzwerks hinzu. EKS verwendet diese CIDR-Liste, um die Konnektivität zwischen dem Cluster und Ihren On-Premises-Netzwerken zu ermöglichen. Eine vollständige Liste der Optionen bei der Aktualisierung Ihrer Cluster-Konfiguration finden Sie [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)in der *Amazon EKS API-Referenz*. Sie können für die Netzwerkkonfiguration der EKS-Hybridknoten in einem Cluster die folgenden Aktionen ausführen: + [Fügen Sie eine Fern-Netzwerkkonfiguration hinzu, um EKS-Hybridknoten in einem vorhandenen Cluster zu aktivieren.](#hybrid-nodes-cluster-enable-existing) + [Fügen Sie die Fern-Knotennetzwerke oder die Pod-Netzwerke aus der Ferne in einem vorhandenen Cluster hinzu, ändern oder entfernen Sie sie.](#hybrid-nodes-cluster-update-config) + [Entfernen Sie alle CIDR-Bereiche des Knotennetzwerks aus der Ferne, um EKS-Hybridknoten in einem vorhandenen Cluster zu deaktivieren.](#hybrid-nodes-cluster-disable) ## Voraussetzungen + Bevor Sie Ihren Amazon-EKS-Cluster für Hybridknoten aktivieren, stellen Sie sicher, dass Ihre Umgebung die unter [Voraussetzungen für die Einrichtung von Hybridknoten](hybrid-nodes-prereqs.md) beschriebenen und unter [Vorbereitung der Vernetzung für Hybridknoten](hybrid-nodes-networking.md), [Vorbereitung des Betriebssystems für Hybridknoten](hybrid-nodes-os.md) und [Vorbereitung der Anmeldeinformationen für Hybridknoten](hybrid-nodes-creds.md) ausführlich beschriebenen Anforderungen erfüllt. + Ihr Cluster muss die IPv4-Adressfamilie verwenden. + Ihr Cluster muss entweder `API` oder `API_AND_CONFIG_MAP` für den Cluster-Authentifizierungsmodus verwenden. Der Vorgang zum Ändern des Cluster-Authentifizierungsmodus wird unter [Ändern des Authentifizierungsmodus, um Zugriffseinträge zu verwenden](setting-up-access-entries.md) beschrieben. + Wir empfehlen, entweder den öffentlichen oder den privaten Endpunktzugriff für den API-Server-Endpunkt für Amazon EKS Kubernetes zu verwenden, jedoch nicht beide gleichzeitig. Wenn Sie „Öffentlich und Privat“ auswählen, wird der API-Serverendpunkt für Amazon EKS Kubernetes immer auf die öffentlichen IP-Adressen für Hybridknoten aufgelöst, die außerhalb Ihrer VPC ausgeführt werden. Dies kann dazu führen, dass Ihre Hybridknoten nicht dem Cluster beitreten können. Der Vorgang zum Ändern des Netzwerkzugriffs in Ihren Cluster wird unter [Cluster-API-Server-Endpunkt](cluster-endpoint.md) beschrieben. + Die neueste Version der AWS Befehlszeilenschnittstelle (AWS CLI) ist auf Ihrem Gerät installiert und konfiguriert. Um Ihre aktuelle Version zu überprüfen, verwenden Sie `aws --version`. Paketmanager wie yum, apt-get oder Homebrew für macOS liegen oft mehrere Versionen hinter der neuesten Version der CLI. AWS Informationen zur Installation der neuesten Version finden Sie unter [Installation oder Aktualisierung auf die neueste Version der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) und [Konfigurieren von Einstellungen für die AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) im Benutzerhandbuch für die AWS Befehlszeilenschnittstelle. + Ein [IAM-Principal](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles#iam-term-principal) mit der Berechtigung, Ihren [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)Amazon EKS-Cluster aufzurufen. + Aktualisieren Sie Add-Ons in Versionen, die mit Hybridknoten kompatibel sind. Die mit Hybridknoten kompatiblen Add-Ons-Versionen finden Sie unter [Konfiguration von Add-Ons für Hybridknoten](hybrid-nodes-add-ons.md). + Wenn Sie Add-Ons ausführen, die nicht mit Hybridknoten kompatibel sind, stellen Sie sicher, dass für das Add-On [DaemonSet](https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/)oder die [Bereitstellung](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/) die folgende Affinitätsregel gilt, um die Bereitstellung auf Hybridknoten zu verhindern. Fügen Sie die folgende Affinitätsregel hinzu, falls sie noch nicht vorhanden ist. ``` affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: eks.amazonaws.com/compute-type operator: NotIn values: - hybrid ``` ## Überlegungen Das `remoteNetworkConfig`-JSON-Objekt weist während einer Aktualisierung folgendes Verhalten auf: + Alle vorhandenen Teile der Konfiguration, die Sie nicht angeben, bleiben unverändert. Wenn Sie weder `remoteNodeNetworks` noch `remotePodNetworks` angeben, bleibt dieser Teil unverändert. + Wenn Sie die CIDR-Liste `remoteNodeNetworks` oder `remotePodNetworks` ändern, müssen Sie die vollständige Liste der CIDRs angeben, die Sie in Ihrer endgültigen Konfiguration haben möchten. Wenn Sie eine Änderung an der CIDR-Liste `remoteNodeNetworks` oder `remotePodNetworks` angeben, ersetzt EKS während der Aktualisierung die ursprüngliche Liste. + Ihre On-Premises-Knoten- und Pod-CIDR-Blöcke müssen die folgenden Anforderungen erfüllen: 1. Sie müssen sich in einem der RFC-1918 IPv4-Bereiche befinden: 10.0.0. 0/8, 172.16.0. 0/12, oder 192.168.0. 0/16 , oder innerhalb des durch RFC 6598 definierten CGNAT-Bereichs: `100.64.0.0/10` 1. Alle CIDRs der VPC für Ihren Amazon-EKS-Cluster oder Ihr Kubernetes-Service-IPv4-CIDR dürfen sich nicht überschneiden. ## Aktivierung von Hybridknoten in einem vorhandenen Cluster Sie können EKS-Hybridknoten in einem vorhandenen Cluster aktivieren, indem Sie Folgendes verwenden: + [AWS CloudFormation](#hybrid-nodes-cluster-enable-cfn) + [AWS CLI](#hybrid-nodes-cluster-enable-cli) + [AWS-Managementkonsole](#hybrid-nodes-cluster-enable-console) ### Aktivieren Sie EKS-Hybridknoten in einem vorhandenen Cluster - AWS CloudFormation 1. Um EKS-Hybridknoten in Ihrem Cluster zu aktivieren, fügen Sie Ihrer CloudFormation Vorlage das `RemoteNodeNetwork` und (optional) `RemotePodNetwork` hinzu und aktualisieren Sie den Stack. Beachten Sie, dass `RemoteNodeNetwork` eine Liste mit maximal einem `Cidrs`-Element ist und `Cidrs` eine Liste mehrerer IP-CIDR-Bereiche ist. ``` RemoteNetworkConfig: RemoteNodeNetworks: - Cidrs: [RemoteNodeCIDR] RemotePodNetworks: - Cidrs: [RemotePodCIDR] ``` 1. Fahren Sie fort mit [Vorbereitung des Cluster-Zugriffs für Hybridknoten](hybrid-nodes-cluster-prep.md). ### Aktivieren Sie EKS-Hybridknoten in einem vorhandenen Cluster - AWS CLI 1. Führen Sie den folgenden Befehl aus, um `RemoteNetworkConfig` für EKS-Hybridknoten für Ihren EKS-Cluster zu aktivieren. Ersetzen Sie vor dem Ausführen des Befehls Folgendes durch Ihre Einstellungen. Eine vollständige Liste der Einstellungen finden Sie [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)in der *Amazon EKS API-Referenz*. 1. `CLUSTER_NAME`: Name des zu aktualisierenden EKS-Clusters. 1. `AWS_REGION`: AWS Region, in der der EKS-Cluster ausgeführt wird. 1. `REMOTE_NODE_CIDRS`: das On-Premises-Knoten-CIDR für Ihre Hybridknoten. 1. `REMOTE_POD_CIDRS` (optional): das On-Premises-Pod-CIDR für Workloads, die in Hybridknoten ausgeführt werden. ``` aws eks update-cluster-config \ --name CLUSTER_NAME \ --region AWS_REGION \ --remote-network-config '{"remoteNodeNetworks":[{"cidrs":["REMOTE_NODE_CIDRS"]}],"remotePodNetworks":[{"cidrs":["REMOTE_POD_CIDRS"]}]}' ``` 1. Die Aktualisierung des Clusters dauert mehrere Minuten. Sie können den Status Ihres Clusters mit dem folgenden Befehl überprüfen. `CLUSTER_NAME`Ersetzen Sie durch den Namen des Clusters, den Sie ändern, und `AWS_REGION` durch die AWS Region, in der der Cluster ausgeführt wird. Fahren Sie nicht mit dem nächsten Schritt fort, bis die zurückgegebene Ausgabe `ACTIVE` ist. ``` aws eks describe-cluster \ --name CLUSTER_NAME \ --region AWS_REGION \ --query "cluster.status" ``` 1. Fahren Sie fort mit [Vorbereitung des Cluster-Zugriffs für Hybridknoten](hybrid-nodes-cluster-prep.md). ### Aktivieren Sie EKS-Hybridknoten in einem vorhandenen Cluster - AWS-Managementkonsole 1. Öffnen Sie die Amazon-EKS-Konsole unter [Amazon-EKS-Konsole](https://console.aws.amazon.com/eks/home#/clusters). 1. Wählen Sie den Namen des Clusters aus, um Ihre Cluster-Informationen anzuzeigen. 1. Wählen Sie die Registerkarte **Netzwerk** und dann **Verwalten** aus. 1. Wählen Sie in der Dropdownliste **Fern-Netzwerke** aus. 1. **Wählen Sie „Fern-Netzwerke konfigurieren“, um Hybridknoten zu aktivieren**, und geben Sie Ihre On-Premises-Knoten- und Pod-CIDRs für Hybridknoten an. 1. Wählen Sie **Änderungen speichern**, um den Vorgang abzuschließen. Warten Sie, bis der Cluster-Status wieder auf **Aktiv** zurückgesetzt ist. 1. Fahren Sie fort mit [Vorbereitung des Cluster-Zugriffs für Hybridknoten](hybrid-nodes-cluster-prep.md). ## Konfiguration der Hybridknoten in einem vorhandenen Cluster aktualisieren Sie können `remoteNetworkConfig` in einem vorhandenen Hybrid-Cluster mithilfe einer der folgenden Optionen ändern: + [AWS CloudFormation](#hybrid-nodes-cluster-update-cfn) + [AWS CLI](#hybrid-nodes-cluster-update-cli) + [AWS-Managementkonsole](#hybrid-nodes-cluster-update-console) ### Hybridkonfiguration in einem vorhandenen Cluster aktualisieren - AWS CloudFormation 1. Aktualisieren Sie Ihre CloudFormation Vorlage mit den neuen Netzwerk-CIDR-Werten. ``` RemoteNetworkConfig: RemoteNodeNetworks: - Cidrs: [NEW_REMOTE_NODE_CIDRS] RemotePodNetworks: - Cidrs: [NEW_REMOTE_POD_CIDRS] ``` **Anmerkung** Berücksichtigen Sie beim Aktualisieren der CIDR-Listen `RemoteNodeNetworks` oder `RemotePodNetworks` alle CIDRs (neue und vorhandene). EKS ersetzt bei Aktualisierungen die gesamte Liste. Durch das Weglassen dieser Felder aus der Aktualisierungsanforderung werden ihre vorhandenen Konfigurationen beibehalten. 1. Aktualisieren Sie Ihren CloudFormation Stack mit der geänderten Vorlage und warten Sie, bis das Stack-Update abgeschlossen ist. ### Aktualisieren Sie die Hybridkonfiguration in einem vorhandenen Cluster - AWS CLI 1. Um die CIDRs des Fern-Netzwerks zu ändern, führen Sie den folgenden Befehl aus. Ersetzen Sie die Werte durch Ihre Einstellungen: ``` aws eks update-cluster-config --name CLUSTER_NAME --region AWS_REGION --remote-network-config '{"remoteNodeNetworks":[{"cidrs":["NEW_REMOTE_NODE_CIDRS"]}],"remotePodNetworks":[{"cidrs":["NEW_REMOTE_POD_CIDRS"]}]}' ``` **Anmerkung** Berücksichtigen Sie beim Aktualisieren der CIDR-Listen `remoteNodeNetworks` oder `remotePodNetworks` alle CIDRs (neue und vorhandene). EKS ersetzt bei Aktualisierungen die gesamte Liste. Durch das Weglassen dieser Felder aus der Aktualisierungsanforderung werden ihre vorhandenen Konfigurationen beibehalten. 1. Warten Sie, bis der Cluster-Status wieder auf „AKTIV“ zurückkehrt, bevor Sie fortfahren. ### Hybridkonfiguration in einem vorhandenen Cluster aktualisieren - AWS-Managementkonsole 1. Öffnen Sie die Amazon-EKS-Konsole unter [Amazon-EKS-Konsole](https://console.aws.amazon.com/eks/home#/clusters). 1. Wählen Sie den Namen des Clusters aus, um Ihre Cluster-Informationen anzuzeigen. 1. Wählen Sie die Registerkarte **Netzwerk** und dann **Verwalten** aus. 1. Wählen Sie in der Dropdownliste **Fern-Netzwerke** aus. 1. Aktualisieren Sie die CIDRs unter `Remote node networks` und `Remote pod networks - Optional` nach Bedarf. 1. Wählen Sie **Änderungen speichern** und warten Sie, bis der Cluster-Status wieder auf **Aktiv** wechselt. ## Hybridknoten in einem vorhandenen Cluster deaktivieren Sie können EKS-Hybridknoten in einem vorhandenen Cluster deaktivieren, indem Sie Folgendes verwenden: + [AWS CloudFormation](#hybrid-nodes-cluster-disable-cfn) + [AWS CLI](#hybrid-nodes-cluster-disable-cli) + [AWS-Managementkonsole](#hybrid-nodes-cluster-disable-console) ### EKS-Hybridknoten in einem vorhandenen Cluster deaktivieren - AWS CloudFormation 1. Um EKS-Hybridknoten in Ihrem Cluster `RemotePodNetworks` zu deaktivieren, legen Sie Arrays in Ihrer CloudFormation Vorlage fest `RemoteNodeNetworks` und leeren Sie sie und aktualisieren Sie den Stack. ``` RemoteNetworkConfig: RemoteNodeNetworks: [] RemotePodNetworks: [] ``` ### Deaktivieren Sie EKS-Hybridknoten in einem vorhandenen Cluster - AWS CLI 1. Führen Sie den folgenden Befehl aus, um `RemoteNetworkConfig` aus Ihrem EKS-Cluster zu entfernen. Ersetzen Sie vor dem Ausführen des Befehls Folgendes durch Ihre Einstellungen. Eine vollständige Liste der Einstellungen finden Sie [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)in der *Amazon EKS API-Referenz*. 1. `CLUSTER_NAME`: Name des zu aktualisierenden EKS-Clusters. 1. `AWS_REGION`: AWS Region, in der der EKS-Cluster ausgeführt wird. ``` aws eks update-cluster-config \ --name CLUSTER_NAME \ --region AWS_REGION \ --remote-network-config '{"remoteNodeNetworks":[],"remotePodNetworks":[]}' ``` 1. Die Aktualisierung des Clusters dauert mehrere Minuten. Sie können den Status Ihres Clusters mit dem folgenden Befehl überprüfen. `CLUSTER_NAME`Ersetzen Sie durch den Namen des Clusters, den Sie ändern, und `AWS_REGION` durch die AWS Region, in der der Cluster ausgeführt wird. Fahren Sie nicht mit dem nächsten Schritt fort, bis die zurückgegebene Ausgabe `ACTIVE` ist. ``` aws eks describe-cluster \ --name CLUSTER_NAME \ --region AWS_REGION \ --query "cluster.status" ``` ### Deaktivieren Sie EKS-Hybridknoten in einem vorhandenen Cluster - AWS-Managementkonsole 1. Öffnen Sie die Amazon-EKS-Konsole unter [Amazon-EKS-Konsole](https://console.aws.amazon.com/eks/home#/clusters). 1. Wählen Sie den Namen des Clusters aus, um Ihre Cluster-Informationen anzuzeigen. 1. Wählen Sie die Registerkarte **Netzwerk** und dann **Verwalten** aus. 1. Wählen Sie in der Dropdownliste **Fern-Netzwerke** aus. 1. Wählen Sie **Fern-Netzwerke zur Aktivierung von Hybridknoten konfigurieren** und alle CIDRs unter `Remote node networks` und `Remote pod networks - Optional` zu entfernen. 1. Wählen Sie **Änderungen speichern**, um den Vorgang abzuschließen. Warten Sie, bis der Cluster-Status wieder auf **Aktiv** zurückgesetzt ist.