如何對 Amazon EKS 中，受管節點群組的自訂啟動範本問題進行疑難排解？

簡短說明

當您在 Amazon EKS 叢集中使用具有受管節點群組的自訂啟動範本時，可能會收到以下其中一個錯誤：

• "Client.InternalError: Client error on launch"
• "SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found"
• "Node group entered a DEGRADED status"

解決方法

啟動時用戶端出現錯誤

當您在自訂啟動範本中使用不正確權限的加密 Amazon Elastic Block Store (Amazon EBS) 磁碟區時，會發生此錯誤。若要檢查加密狀態以及 AWS Identity and Access Management (IAM) 權限或政策，請完成下列任務：

• 啟用用來加密磁碟區的 AWS Key Management Service (KMS) 金鑰。
• 確定 AAWS KMS key具有正確的金鑰政策。若要允許更多 IAM 角色使用加密的 Amazon EBS 磁碟區，請修改金鑰政策。如需詳細資訊，請參閱允許金鑰使用者使用 KMS key。

找不到啟動範本

當您透過節點的 Auto Scaling 群組而不是 Amazon EKS 手動變更自訂啟動範本版本時，就會發生此錯誤。若要解決此問題，您必須使用 Amazon EKS 更新啟動範本版本。

**注意：**如果您在執行 AWS Command Line Interface (AWS CLI) 命令時收到錯誤訊息，請參閱對 AWS CLI 錯誤進行疑難排解。此外，請確定您使用的是最新的 AWS CLI 版本。

若要從受管節點群組更新 Amazon Elastic Compute Cloud (Amazon EC2) 啟動範本，請完成下列步驟：

1. 開啟 Amazon EKS console (Amazon EKS 主控台)。
2. 在導覽窗格中，請選取 Clusters (叢集)。
3. 在 Cluster name (叢集名稱) 下，選取包含要更新節點群組的叢集。
4. 選擇 Compute (計算) 索引標籤。
5. 在 Node groups (節點群組) 下，選取您的節點，然後選擇 Change version (變更版本)。
   **注意：**只有當有新的啟動範本版本可用時，您才會看到此選項。如果您看不到該選項，請使用 aws eks update-nodegroup-version AWS CLI 命令修改節點群組的啟動範本版本。
6. 選取要套用至節點群組的版本。請確定更新策略已設定為持續更新。
7. 選擇更新。

如果您在使用自訂啟動範本建立節點群組時刪除參考範本，也會發生此錯誤。如果您使用自訂啟動範本，則 Amazon EKS 會複寫該範本。如果刪除原始範本，則必須重新建立節點群組。

若要重新建立節點群組，請完成下列步驟：

1. 啟動新節點群組。

2. 執行下列命令以確認所有節點的運行都正常、處於就緒狀態，並且已加入叢集：

   $ kubectl get nodes

3. 耗盡您的工作節點。

4. 刪除原始節點群組。

節點群組進入「降級」狀態

在 Amazon EKS 建立啟動範本後，節點群組可能會進入降級狀態，並顯示類似以下內容的錯誤訊息：

"The Amazon EC2 Launch Template : lt-xxxxxxxxxxxxxxxxx has a new version associated with your Autoscaling group, which is not managed by Amazon EKS. Expected Launch Template version: x"。

當受管節點群組的 Amazon EC2 啟動範本版本與 Amazon EKS 建立的版本不符時，就會發生此錯誤。您只能直接更新使用自訂啟動範本的現有節點群組。若要解決此錯誤，請使用您偏好的設定建立啟動範本和版本。然後，使用啟動範本建立節點群組。如果新節點群組是從您的自訂範本啟動，請建立該範本的新版本。您可以使用此範本，而無需將節點群組置於降級狀態。

相關資訊

使用啟動範本自訂受管節點

啟動範本組態基礎知識