協助改進此頁面

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

若要為本使用者指南貢獻內容，請點選每個頁面右側面板中的在 GitHub 上編輯此頁面連結。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

混合節點 nodeadm 參考

Amazon EKS 混合節點 CLI (nodeadm) 可簡化混合節點元件的安裝、組態、註冊和解除安裝。您可以在作業系統映像中包含 nodeadm，以自動化混合節點引導，如需詳細資訊，請參閱 準備混合節點的作業系統。

混合節點的 nodeadm 版本與用於將 Amazon EC2 執行個體引導為 Amazon EKS 叢集中節點的 nodeadm 版本不同。遵循相應 nodeadm 版本的文件和參考。本文件頁面適用於混合節點 nodeadm 版本。

混合節點的原始程式碼 nodeadm 會發布在 https://github.com/aws/eks-hybrid GitHub 儲存庫中。

下載 nodeadm

nodeadm 的混合節點版本託管於前端為 Amazon CloudFront 的 Amazon S3 中。若要在每個內部部署主機上安裝 nodeadm，您可以從內部部署主機執行下列命令。

對於 x86_64 主機

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

對於 ARM 主機

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

在每個主機上，為下載的二進位檔新增可執行檔許可。

chmod +x nodeadm

nodeadm install

nodeadm install 命令可用於安裝執行混合節點並將其加入 Amazon EKS 叢集所需的成品和相依性。nodeadm install 命令可在每個混合節點上分別執行，也可以在映像建置管道期間執行，進而在作業系統映像中預先安裝混合節點相依性。

用途

nodeadm install [KUBERNETES_VERSION] [flags]

位置引數

(必要) KUBERNETES_VERSION 要安裝的 EKS Kubernetes major.minor 版本，例如 1.32

Flags

範例

1.32 使用 AWS Systems Manager (SSM) 做為登入資料提供者來安裝 Kubernetes 版本

nodeadm install 1.32 --credential-provider ssm

1.32 使用 AWS Systems Manager (SSM) 作為登入資料提供者安裝 Kubernetes 版本，Docker 作為容器化來源，下載逾時為 20 分鐘。

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

1.32 使用 AWS IAM Roles Anywhere 做為登入資料提供者來安裝 Kubernetes 版本

nodeadm install 1.32 --credential-provider iam-ra

nodeadm config check

nodeadm config check 命令會檢查提供的節點組態是否存在錯誤。此命令可用於確認和驗證混合節點組態檔案的正確性。

用途

nodeadm config check [flags]

Flags

範例

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

nodeadm init

nodeadm init 命令會啟動混合節點並將其與設定的 Amazon EKS 叢集進行連接。如需如何設定 nodeConfig.yaml 檔案的詳細資訊，請參閱 SSM 混合啟用的節點組態 或 IAM Roles Anywhere 的節點組態。

用途

nodeadm init [flags]

Flags

範例

nodeadm init -c file://nodeConfig.yaml

nodeadm upgrade

nodeadm upgrade 命令會將所有已安裝的成品升級到最新版本，並引導節點來設定升級的成品，並在 AWS上加入 EKS 叢集。升級是對節點上執行的工作負載的干擾命令。請先將工作負載移至另一個節點，然後再執行升級。

用途

nodeadm upgrade [KUBERNETES_VERSION] [flags]

位置引數

(必要) KUBERNETES_VERSION 要安裝的 EKS Kubernetes major.minor 版本，例如 1.32

Flags

範例

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

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

nodeadm uninstall

nodeadm uninstall 命令會停止並移除 nodeadm 在 nodeadm install 期間安裝的成品，包括 kubelet 和 containerd。請注意，解除安裝命令不會耗盡或刪除叢集中的混合節點。您必須分別執行耗盡和刪除操作，如需詳細資訊，請參閱 移除混合節點。根據預設，如果節點上還有剩餘的 Pod，則 nodeadm uninstall 不會繼續。同樣地，nodeadm uninstall 不會移除 CNI 相依性或您在叢集上執行的其他 Kubernetes 附加元件的相依性。若要從主機完全移除 CNI 安裝，請參閱 設定混合節點的 CNI 中的指示。如果您使用 AWS SSM 混合啟用做為內部部署憑證提供者，nodeadm uninstall命令會將您的主機取消註冊為 AWS SSM 受管執行個體。

用途

nodeadm uninstall [flags]

Flags

範例

nodeadm uninstall

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

nodeadm debug

nodeadm debug 命令可用於對運作狀態不佳或設定錯誤的混合節點進行故障診斷。它會驗證下列需求是否已就位。

如果發現錯誤，命令的輸出會建議故障診斷步驟。某些驗證步驟會顯示子程序。如果失敗，輸出會顯示在驗證錯誤下的 stderr 區段中。

用途

nodeadm debug [flags]

Flags

範例

nodeadm debug -c file://nodeConfig.yaml

Nodeadm 檔案位置

nodeadm 安裝

執行 nodeadm install 時，會設定下列檔案和檔案位置。

nodeadm init

執行 nodeadm init 時，會設定下列檔案和檔案位置。

SSM 混合啟用的節點組態

以下是針對混合節點登入資料使用 AWS SSM 混合啟用nodeConfig.yaml的範例。

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

IAM Roles Anywhere 的節點組態

以下是混合節點登入nodeConfig.yaml資料 AWS IAM Roles Anywhere 的範例。

使用 AWS IAM Roles Anywhere 做為內部部署憑證提供者時，nodeName您在nodeadm組態中使用的 必須符合您為混合節點 IAM 角色設定範圍的許可。例如，如果您的混合節點 IAM 角色許可僅允許 AWS IAM Roles Anywhere 在角色工作階段名稱等於主機憑證的 CN 時擔任角色，則nodeadm組態nodeName中的 必須與您憑證的 CN 相同。您使用的 nodeName 不可超過 64 個字元。如需詳細資訊，請參閱準備混合節點的憑證。

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

用於自訂 kubelet 的節點組態 (選用)

您可以在 nodeadm 組態中傳遞 kubelet 組態和旗標。請參閱以下範例，了解如何新增額外的節點標籤 abc.amazonaws.com/test-label 以及將 shutdownGracePeriod 設定為 30 秒的組態。

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.company.com/test-label=true
  hybrid:
    ssm:
      activationCode: # SSM hybrid activation code
      activationId:   # SSM hybrid activation id

用於自訂 containerd 的節點組態 (選用)

您可以在 nodeadm 組態中傳遞自訂 containerd 組態。nodeadm 的 containerd 組態接受內嵌 TOML。請參閱以下範例，了解如何設定 containerd 以停用刪除 containerd 內容存放區中已解壓縮的映像層。

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

您也可以使用 containerd 組態來啟用 SELinux 支援。在 containerd 上啟用 SELinux 後，請確保在節點上排程的 Pod 已啟用適當的 securityContext 和 seLinuxOptions。如需設定安全性內容的詳細資訊，請參閱 Kubernetes 文件。

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