Nodeadm-Referenz für Hybridknoten

Die Amazon EKS Hybrid Nodes CLI (nodeadm) vereinfacht die Installation, Konfiguration, Registrierung und Deinstallation der Hybridknoten-Komponenten. Sie können nodeadm in Ihre Betriebssystem-Images einbinden, um das Bootstrapping von Hybridknoten zu automatisieren. Weitere Informationen finden Sie unter Vorbereitung des Betriebssystems für Hybridknoten.

Die nodeadm-Version für Hybridknoten unterscheidet sich von der nodeadm-Version, die zum Bootstrapping von Amazon-EC2-Instances als Knoten in Amazon-EKS-Clustern verwendet wird. Befolgen Sie die Dokumentation und Referenzen für die entsprechende nodeadm-Version. Diese Dokumentationsseite bezieht sich auf die nodeadm-Version für Hybridknoten.

Der Quellcode für die Hybridknoten nodeadm wird im https://github.com/aws/eks-hybrid GitHub Repository veröffentlicht.

"msg":"Command failed","error":"failed to install ssm installer: validating ssm-setup-cli signature: Signature Verification Error: No matching signature"

Laden Sie nodeadm herunter

Die Hybrid-Node-Version von nodeadm wird in Amazon S3 gehostet, das von Amazon betrieben wird. CloudFront Um die Installation auf jedem On-Premises-Host nodeadm durchzuführen, können Sie den folgenden Befehl von Ihren On-Premises-Hosts aus ausführen.

Für x86_64-Hosts

curl -OL 'https://hybrid-assets.eks.amazonaws.com/releases/latest/bin/linux/amd64/nodeadm'

Für ARM-Hosts

curl -OL 'https://hybrid-assets.eks.amazonaws.com/releases/latest/bin/linux/arm64/nodeadm'

Fügen Sie der heruntergeladenen Binärdatei auf jedem Host die Berechtigung zum Ausführen von Dateien hinzu.

chmod +x nodeadm

nodeadm-Installation

Der nodeadm install-Befehl wird verwendet, um die Artefakte und Abhängigkeiten zu installieren, die zum Ausführen und Verbinden von Hybridknoten mit einem Amazon-EKS-Cluster erforderlich sind. Der nodeadm install-Befehl kann einzeln auf jedem Hybridknoten oder während Image-Entwicklungs-Pipelines ausgeführt werden, um die Abhängigkeiten der Hybridknoten in Betriebssystem-Images vorzuinstallieren.

Usage

nodeadm install [KUBERNETES_VERSION] [flags]

Positionelle Argumente

(Erforderlich) KUBERNETES_VERSION Die zu installierende Haupt- und Nebenversion von EKS Kubernetes, zum Beispiel 1.32

Flags

Beispiele

Installieren Sie die Kubernetes-Version 1.32 mit AWS Systems Manager (SSM) als Anbieter von Anmeldeinformationen

nodeadm install 1.32 --credential-provider ssm

Installieren Sie die Kubernetes-Version 1.32 mit AWS Systems Manager (SSM) als Anmeldeinformationsanbieter, Docker als Container-Quelle, mit einem Download-Timeout von 20 Minuten.

nodeadm install 1.32 --credential-provider ssm --containerd-source docker --timeout 20m

Installieren Sie die Kubernetes-Version mit IAM Roles Anywhere als Anbieter für Anmeldeinformationen 1.32 AWS

nodeadm install 1.32 --credential-provider iam-ra

Überprüfung der Nodeadm-Konfiguration

Der nodeadm config check-Befehl überprüft die angegebene Knotenkonfiguration auf Fehler. Mit diesem Befehl kann die Richtigkeit einer Hybridknoten-Konfigurationsdatei überprüft und validiert werden.

Usage

nodeadm config check [flags]

Flags

Beispiele

nodeadm config check -c file://nodeConfig.yaml

nodeadm init

Der nodeadm init-Befehl startet und verbindet den Hybridknoten mit dem konfigurierten Amazon-EKS-Cluster. Einzelheiten zur Konfiguration der nodeConfig.yaml-Datei finden Sie unter Knotenkonfiguration für SSM-Hybridaktivierungen oder Knotenkonfiguration für IAM Roles Anywhere.

Usage

nodeadm init [flags]

Flags

Beispiele

nodeadm init -c file://nodeConfig.yaml

Nodeadm-Aktualisierung

Der nodeadm upgrade-Befehl aktualisiert alle installierten Artefakte auf die neueste Version und führt einen Bootstrapping des Knotens durch, um die aktualisierten Artefakte zu konfigurieren und dem EKS-Cluster in AWS beizutreten. Ein Upgrade ist ein Befehl zur Unterbrechung der auf dem Knoten ausgeführten Workloads. Verschieben Sie Ihre Workloads vor dem Upgrade auf einen anderen Knoten.

Usage

nodeadm upgrade [KUBERNETES_VERSION] [flags]

Positionelle Argumente

(Erforderlich) KUBERNETES_VERSION Die zu installierende Haupt- und Nebenversion von EKS Kubernetes, zum Beispiel 1.32

Flags

Beispiele

nodeadm upgrade 1.32 -c file://nodeConfig.yaml

nodeadm upgrade 1.32 -c file://nodeConfig.yaml --timeout 20m

Nodeadm-Deinstallation

Der nodeadm uninstall-Befehl stoppt und entfernt die während nodeadm install installierten Artefakte nodeadm, einschließlich kubelet und containerd. Beachten Sie, dass der Deinstallations-Befehl Ihre Hybridknoten nicht aus Ihrem Cluster entfernt oder löscht. Sie müssen die Entleerungs- und Löschvorgänge separat ausführen. Weitere Informationen finden Sie unter Hybridknoten entfernen. Standardmäßig wird nodeadm uninstall nicht fortgesetzt, wenn auf dem Knoten noch Pods vorhanden sind. Ebenso entfernt nodeadm uninstall keine CNI-Abhängigkeiten oder Abhängigkeiten anderer Kubernetes-Add-Ons, die Sie in Ihrem Cluster ausführen. Informationen zum vollständigen Entfernen der CNI-Installation von Ihrem Host finden Sie in den Anweisungen unter CNI für Hybridknoten konfigurieren. Wenn Sie AWS SSM-Hybrid-Aktivierungen als Ihren lokalen Anmeldeinformationsanbieter verwenden, deregistriert der nodeadm uninstall Befehl Ihre Hosts als von SSM verwaltete Instances. AWS

Usage

nodeadm uninstall [flags]

Flags

Beispiele

nodeadm uninstall

nodeadm uninstall --skip node-validation,pod-validation

nodeadm debug

Der nodeadm debug-Befehl kann zur Fehlerbehebung bei fehlerhaften oder falsch konfigurierten Hybridknoten verwendet werden. Es bestätigt, dass die folgenden Anforderungen erfüllt sind.

Wenn Fehler gefunden werden, werden in der Ausgabe des Befehls Schritte zur Fehlerbehebung vorgeschlagen. Bestimmte Validierungsschritte zeigen untergeordnete Prozesse an. Wenn diese fehlschlagen, wird die Ausgabe in einem stderr-Abschnitt unter dem Validierungsfehler angezeigt.

Usage

nodeadm debug [flags]

Flags

Beispiele

nodeadm debug -c file://nodeConfig.yaml

Speicherorte für Nodeadm-Dateien

nodeadm-Installation

Bei der Ausführung von nodeadm install werden die folgenden Dateien und Dateispeicherorte konfiguriert.

nodeadm init

Bei der Ausführung von nodeadm init werden die folgenden Dateien und Dateispeicherorte konfiguriert.

Knotenkonfiguration für SSM-Hybridaktivierungen

Das Folgende ist ein Beispiel für die nodeConfig.yaml Verwendung von AWS SSM-Hybrid-Aktivierungen für Hybrid-Node-Anmeldeinformationen.

apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
  cluster:
    name:             # Name of the EKS cluster
    region:           # AWS Region where the EKS cluster resides
  hybrid:
    ssm:
      activationCode: # SSM hybrid activation code
      activationId:   # SSM hybrid activation id

Knotenkonfiguration für IAM Roles Anywhere

Im Folgenden finden Sie ein Beispiel nodeConfig.yaml für AWS IAM Roles Anywhere für Anmeldeinformationen für Hybridknoten.

Wenn nodeName Sie AWS IAM Roles Anywhere als Ihren lokalen Anmeldeinformationsanbieter verwenden, müssen die in Ihrer nodeadm Konfiguration verwendeten Berechtigungen mit den Berechtigungen übereinstimmen, die Sie für Ihre IAM-Rolle für Hybridknoten festgelegt haben. Wenn Ihre Berechtigungen für die IAM-Rolle Hybrid Nodes IAM IAM beispielsweise nur zulassen, dass AWS IAM Roles Anywhere die Rolle übernimmt, wenn der Rollensitzungsname dem CN des Hostzertifikats entspricht, dann muss der nodeName in Ihrer nodeadm Konfiguration mit dem CN Ihrer Zertifikate übereinstimmen. Der von Ihnen verwendete nodeName kann nicht länger als 64 Zeichen sein. Weitere Informationen finden Sie unter Vorbereitung der Anmeldeinformationen für Hybridknoten.

apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
  cluster:
    name:              # Name of the EKS cluster
    region:            # AWS Region where the EKS cluster resides
  hybrid:
    iamRolesAnywhere:
      nodeName:        # Name of the node
      trustAnchorArn:  # ARN of the IAM Roles Anywhere trust anchor
      profileArn:      # ARN of the IAM Roles Anywhere profile
      roleArn:         # ARN of the Hybrid Nodes IAM role
      certificatePath: # Path to the certificate file to authenticate with the IAM Roles Anywhere trust anchor
      privateKeyPath:  # Path to the private key file for the certificate

Knotenkonfiguration zur Anpassung von kubelet (optional)

Sie können die kubelet-Konfiguration und Flags in Ihrer nodeadm-Konfiguration übergeben. Im folgenden Beispiel erfahren Sie, wie Sie ein zusätzliches Knotenlabel hinzufügen abc.example.com/test-label und die Kubelet-Konfiguration shutdownGracePeriod auf 30 Sekunden festlegen. Weitere Informationen zu Kubelet-Konfigurationsoptionen finden Sie in der Kubelet-Konfigurationsreferenz (v1beta1) in der Kubernetes-Dokumentation. Weitere Informationen zu Kubelet-Befehlszeilen-Flags finden Sie in der Kubelet-CLI-Referenz in der Kubernetes-Dokumentation. https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/

apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
  cluster:
    name:             # Name of the EKS cluster
    region:           # AWS Region where the EKS cluster resides
  kubelet:
    config:           # Map of kubelet config and values
       shutdownGracePeriod: 30s
    flags:            # List of kubelet flags
       - --node-labels=abc.example.com/test-label=true
  hybrid:
    ssm:
      activationCode: # SSM hybrid activation code
      activationId:   # SSM hybrid activation id

Knotenkonfiguration zur Anpassung von containerd (optional)

Sie können eine benutzerdefinierte containerd-Konfiguration in Ihrer nodeadm-Konfiguration übergeben. Die containerd-Konfiguration für nodeadm akzeptiert Inline-TOML. Im folgenden Beispiel erfahren Sie, wie Sie containerd konfigurieren, um das Löschen entpackter Image-Ebenen im containerd-Inhaltsspeicher zu deaktivieren.

apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
  cluster:
    name:             # Name of the EKS cluster
    region:           # AWS Region where the EKS cluster resides
  containerd:
    config: |         # Inline TOML containerd additional configuration
       [plugins."io.containerd.grpc.v1.cri".containerd]
       discard_unpacked_layers = false
  hybrid:
    ssm:
      activationCode: # SSM hybrid activation code
      activationId:   # SSM hybrid activation id

Sie können die containerd-Konfiguration auch verwenden, um den SELinux-Support zu aktivieren. Wenn SELinux auf Containerd aktiviert ist, stellen Sie sicher, dass die auf dem Knoten geplanten Pods den richtigen SecurityContext haben und wir aktiviert sind. LinuxOptions Weitere Informationen für die Konfiguration eines Sicherheitskontexts finden Sie in der Kubernetes-Dokumentation.

apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
  cluster:
    name:             # Name of the EKS cluster
    region:           # AWS Region where the EKS cluster resides
  containerd:
    config: |         # Inline TOML containerd additional configuration
       [plugins."io.containerd.grpc.v1.cri"]
       enable_selinux = true
  hybrid:
    ssm:
      activationCode: # SSM hybrid activation code
      activationId:   # SSM hybrid activation id