**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 auf**, 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 Liste von CIDRs , um die Konnektivität zwischen dem Cluster und Ihren lokalen Netzwerken zu aktivieren. 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“ wählen, wird der Amazon EKS Kubernetes API-Serverendpunkt IPs für Hybridknoten, die außerhalb Ihrer VPC laufen, immer öffentlich aufgelöst, wodurch verhindert werden kann, dass Ihre Hybridknoten dem Cluster beitreten. 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 entweder die `remoteNodeNetworks` oder `remotePodNetworks` -Listen von ändern CIDRs, müssen Sie die vollständige Liste der gewünschten CIDRs Optionen in Ihrer endgültigen Konfiguration angeben. 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 innerhalb eines der IPv4 RFC-1918-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. Keine Überschneidungen miteinander, mit CIDRs der gesamten VPC für Ihren Amazon EKS-Cluster oder mit Ihrem Kubernetes-Service CIDR. IPv4 ## 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 Remotenetzwerke konfigurieren, um Hybridknoten zu aktivieren**, und geben Sie Ihren lokalen 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) ### Aktualisieren Sie die Hybridkonfiguration in einem vorhandenen Cluster - 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** Nehmen Sie bei der Aktualisierung `RemoteNodeNetworks` von `RemotePodNetworks` CIDR-Listen alle CIDRs (neue und bestehende) auf. 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. ### Hybridkonfiguration in einem vorhandenen Cluster aktualisieren — AWS CLI 1. Führen Sie den folgenden Befehl aus CIDRs, um das Remote-Netzwerk zu ändern. 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** Wenn Sie `remotePodNetworks` CIDR-Listen aktualisieren`remoteNodeNetworks`, sollten Sie alle CIDRs (neue und bestehende) einbeziehen. 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 nach `Remote pod networks - Optional` 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) ### Deaktivieren Sie EKS-Hybridknoten in einem vorhandenen Cluster - 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 **Remotenetzwerke konfigurieren, um Hybridknoten zu aktivieren** und alle CIDRs Unter `Remote node networks` - und zu entfernen`Remote pod networks - Optional`. 1. Wählen Sie **Änderungen speichern**, um den Vorgang abzuschließen. Warten Sie, bis der Cluster-Status wieder auf **Aktiv** zurückgesetzt ist.