```
如需 的詳細資訊`eksctl`，請參閱 [eksctl 文件](https://eksctl.io/usage/creating-and-managing-clusters/)。
+ 叢集的 AWS Identity and Access Management (IAM) OpenID Connect (OIDC) 提供者。如需詳細資訊，請參閱[為您的叢集建立 IAM OIDC 提供者](https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html)。
**限制**
+ 您必須使用支援 Amazon EKS 服務的 AWS 區域。
**產品版本**
+ Kubernetes 1.20 版或更新版本
+ `eksctl` 0.107.0 版或更新版本
+ AWS CDK 2.27.0 版或更新版本
## Architecture
**目標技術堆疊**
+ 虛擬私有雲端 (VPC)
+ EKS 叢集
+ Amazon Simple Queue Service (Amazon SQS)
+ IAM
+ Kubernetes
**目標架構******
下圖顯示節點終止開始時end-to-end步驟的高階檢視。
![\[具有 Auto Scaling 群組的 VPC、具有 Node Termination Handler 的 EKS 叢集，以及 SQS 佇列。\]](http://docs.aws.amazon.com/zh_tw/prescriptive-guidance/latest/patterns/images/pattern-img/970dfb73-9526-4942-a974-e8eef6416596/images/9e0125ae-d55b-49dd-ae70-ccaedf03832a.png)
圖表中顯示的工作流程包含下列高階步驟：
1. 自動擴展 EC2 執行個體終止事件會傳送至 SQS 佇列。
1. NTH Pod 會監控 SQS 佇列中的新訊息。
1. NTH Pod 會收到新訊息並執行下列動作：
+ 繫結節點，讓新的 Pod 不會在節點上執行。
+ 耗盡節點，以清空現有的 Pod
+ 將生命週期掛鉤訊號傳送至 Auto Scaling 群組，以便終止節點。
**自動化和擴展**
+ 程式碼由 AWS CDK 管理和部署，並由 AWS CloudFormation 巢狀堆疊提供支援。
+ [Amazon EKS 控制平面](https://docs.aws.amazon.com/eks/latest/userguide/disaster-recovery-resiliency.html)跨多個可用區域執行，以確保高可用性。
+ 對於[自動擴展](https://docs.aws.amazon.com/eks/latest/userguide/autoscaling.html)，Amazon EKS 支援 Kubernetes [Cluster Autoscaler](https://github.com/kubernetes/autoscaler/tree/master/cluster-autoscaler) 和 [Karpenter](https://karpenter.sh/)。
## 工具
**AWS 服務**
+ [AWS 雲端開發套件 (AWS CDK)](https://docs.aws.amazon.com/cdk/latest/guide/home.html) 是一種軟體開發架構，可協助您在程式碼中定義和佈建 AWS 雲端基礎設施。
+ [AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html) 是一項全受管建置服務，可協助您編譯原始程式碼、執行單元測試，並產生準備好部署的成品。
+ [AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/welcome.html) 是一種版本控制服務，可協助您私下存放和管理 Git 儲存庫，而無需管理您自己的來源控制系統。
+ [AWS CodePipeline](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html) 可協助您快速建模和設定軟體版本的不同階段，並自動化持續發行軟體變更所需的步驟。
+ [Amazon Elastic Kubernetes Service (Amazon EKS)](https://docs.aws.amazon.com/eks/latest/userguide/getting-started.html) 可協助您在 AWS 上執行 Kubernetes，而無需安裝或維護您自己的 Kubernetes 控制平面或節點。
+ [Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html) 可協助您維持應用程式的可用性，並可讓您根據您定義的條件自動新增或移除 Amazon EC2 執行個體。
+ [Amazon Simple Queue Service (Amazon SQS)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html) 提供安全、耐用且可用的託管佇列，可協助您整合和分離分散式軟體系統和元件。
**其他工具**
+ [kubectl](https://kubernetes.io/docs/reference/kubectl/kubectl/) 是針對 Kubernetes 叢集執行命令的 Kubernetes 命令列工具。您可以使用 kubectl 來部署應用程式、檢查和管理叢集資源，以及檢視日誌。
**Code**
此模式的程式碼可在 GitHub.com 的 [deploy-nth-to-eks](https://github.com/aws-samples/deploy-nth-to-eks) 儲存庫中取得。 GitHub.com. 程式碼儲存庫包含下列檔案和資料夾。
+ `nth folder` – 用於掃描和部署節點終止處理常式之 AWS CloudFormation 範本的 Helm Chart、值檔案和指令碼。
+ `config/config.json` – 應用程式的組態參數檔案。此檔案包含部署 CDK 所需的所有參數。
+ `cdk` – AWS CDK 原始碼。
+ `setup.sh` – 用來部署 AWS CDK 應用程式的指令碼，用來建立必要的 CI/CD 管道和其他必要的資源。
+ `uninstall.sh` – 用來清除資源的指令碼。
若要使用範例程式碼，請遵循 *Epics* 區段中的指示。
## 最佳實務
如需自動化 AWS Node Termination Handler 時的最佳實務，請參閱下列各項：
+ [EKS 最佳實務指南](https://aws.github.io/aws-eks-best-practices/)
+ [節點終止處理常式 - 組態](https://github.com/aws/aws-node-termination-handler/tree/main/config/helm/aws-node-termination-handler)
## 史詩
### 設定您的環境
| 任務 | Description | 所需的技能 |
| --- | --- | --- |
| 複製儲存庫。 | 若要使用 SSH （安全殼層） 複製儲存庫，請執行下列命令。git clone git@github.com:aws-samples/deploy-nth-to-eks.git
若要使用 HTTPS 複製儲存庫，請執行下列命令。git clone https://github.com/aws-samples/deploy-nth-to-eks.git
複製儲存庫會建立名為 的資料夾`deploy-nth-to-eks`。變更為該目錄。cd deploy-nth-to-eks
| 應用程式開發人員、AWS DevOps、DevOps 工程師 |
| 設定 kubeconfig 檔案。 | 在終端機中設定您的 AWS 登入資料，並確認您有權擔任叢集角色。您可以使用下列範例程式碼。aws eks update-kubeconfig --name --region --role-arn
| AWS DevOps、DevOps 工程師、應用程式開發人員 |
### 部署 CI/CD 管道
| 任務 | Description | 所需的技能 |
| --- | --- | --- |
| 設定參數。 | 在 `config/config.json`檔案中，設定下列必要參數。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/prescriptive-guidance/latest/patterns/automate-deployment-of-node-termination-handler-in-amazon-eks-by-using-a-ci-cd-pipeline.html) | 應用程式開發人員、AWS DevOps、DevOps 工程師 |
| 建立 CI/CD 管道以部署 NTH。 | 執行 setup.sh 指令碼。./setup.sh
指令碼將部署 AWS CDK 應用程式，該應用程式將根據`config/config.json`檔案中的使用者輸入參數，使用範例程式碼、管道和 CodeBuild 專案來建立 CodeCommit 儲存庫。此指令碼會在使用 sudo 命令安裝 npm 套件時要求密碼。 | 應用程式開發人員、AWS DevOps、DevOps 工程師 |
| 檢閱 CI/CD 管道。 | 開啟 AWS 管理主控台，並檢閱在堆疊中建立的下列資源。[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/prescriptive-guidance/latest/patterns/automate-deployment-of-node-termination-handler-in-amazon-eks-by-using-a-ci-cd-pipeline.html)管道成功執行後，Helm Release `aws-node-termination-handler` 會安裝在 EKS 叢集中。此外，名為 的 Pod `aws-node-termination-handler` 正在叢集的`kube-system`命名空間中執行。 | 應用程式開發人員、AWS DevOps、DevOps 工程師 |
### 測試 NTH 部署
| 任務 | Description | 所需的技能 |
| --- | --- | --- |
| 模擬 Auto Scaling 群組縮減事件。 | 若要模擬自動擴展縮減事件，請執行下列動作：[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/prescriptive-guidance/latest/patterns/automate-deployment-of-node-termination-handler-in-amazon-eks-by-using-a-ci-cd-pipeline.html) | |
| 檢閱日誌。 | 在縮減事件期間，NTH Pod 會封鎖並耗盡對應的工作者節點 （將在縮減事件中終止的 EC2 執行個體）。若要檢查日誌，請使用*其他資訊*區段中的程式碼。 | 應用程式開發人員、AWS DevOps、DevOps 工程師 |
### 清除
| 任務 | Description | 所需的技能 |
| --- | --- | --- |
| 清除所有 AWS 資源。 | 若要清除此模式建立的資源，請執行下列命令。./uninstall.sh
這將透過刪除 CloudFormation 堆疊來清除在此模式中建立的所有資源。 | DevOps 工程師 |
## 疑難排解
| 問題 | 解決方案 |
| --- | --- |
| npm 登錄檔設定不正確。 | 在此解決方案的安裝期間，指令碼會安裝 npm 安裝以下載所有必要的套件。如果在安裝期間，您看到一則訊息，指出「找不到模組」npm 登錄檔可能設定不正確。若要查看目前的登錄設定，請執行下列命令。npm config get registry
若要使用 設定登錄檔`https://registry.npmjs.org/`，請執行下列命令。npm config set registry https://registry.npmjs.org
|
| 延遲 SQS 訊息傳遞。 | 在疑難排解過程中，如果您想要延遲 SQS 訊息交付至 NTH Pod，您可以調整 SQS 交付延遲參數。如需詳細資訊，請參閱 [Amazon SQS 延遲佇列](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-delay-queues.html)。 |
## 相關資源
+ [AWS 節點終止處理常式原始碼](https://github.com/aws/aws-node-termination-handler)
+ [EC2 研討會](https://ec2spotworkshops.com/using_ec2_spot_instances_with_eks/070_selfmanagednodegroupswithspot/deployhandler.html)
+ [AWS CodePipeline](https://aws.amazon.com/codepipeline/)
+ [Amazon Elastic Kubernetes Service (Amazon EKS)](https://aws.amazon.com/eks/)
+ [AWS 雲端開發套件](https://aws.amazon.com/cdk/)
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
## 其他資訊
1. 尋找 NTH Pod 名稱。
```
kubectl get pods -n kube-system |grep aws-node-termination-handler
aws-node-termination-handler-65445555-kbqc7 1/1 Running 0 26m
kubectl get pods -n kube-system |grep aws-node-termination-handler
aws-node-termination-handler-65445555-kbqc7 1/1 Running 0 26m
```
2. 檢查日誌。範例日誌如下所示。它顯示節點已在傳送 Auto Scaling 群組生命週期掛鉤完成訊號之前封鎖並耗盡。
```
kubectl -n kube-system logs aws-node-termination-handler-65445555-kbqc7
022/07/17 20:20:43 INF Adding new event to the event store event={"AutoScalingGroupName":"eksctl-my-cluster-target-nodegroup-ng-10d99c89-NodeGroup-ZME36IGAP7O1","Description":"ASG Lifecycle Termination event received. Instance will be interrupted at 2022-07-17 20:20:42.702 +0000 UTC \n","EndTime":"0001-01-01T00:00:00Z","EventID":"asg-lifecycle-term-33383831316538382d353564362d343332362d613931352d383430666165636334333564","InProgress":false,"InstanceID":"i-0409f2a9d3085b80e","IsManaged":true,"Kind":"SQS_TERMINATE","NodeLabels":null,"NodeName":"ip-192-168-75-60.us-east-2.compute.internal","NodeProcessed":false,"Pods":null,"ProviderID":"aws:///us-east-2c/i-0409f2a9d3085b80e","StartTime":"2022-07-17T20:20:42.702Z","State":""}
2022/07/17 20:20:44 INF Requesting instance drain event-id=asg-lifecycle-term-33383831316538382d353564362d343332362d613931352d383430666165636334333564 instance-id=i-0409f2a9d3085b80e kind=SQS_TERMINATE node-name=ip-192-168-75-60.us-east-2.compute.internal provider-id=aws:///us-east-2c/i-0409f2a9d3085b80e
2022/07/17 20:20:44 INF Pods on node node_name=ip-192-168-75-60.us-east-2.compute.internal pod_names=["aws-node-qchsw","aws-node-termination-handler-65445555-kbqc7","kube-proxy-mz5x5"]
2022/07/17 20:20:44 INF Draining the node
2022/07/17 20:20:44 ??? WARNING: ignoring DaemonSet-managed Pods: kube-system/aws-node-qchsw, kube-system/kube-proxy-mz5x5
2022/07/17 20:20:44 INF Node successfully cordoned and drained node_name=ip-192-168-75-60.us-east-2.compute.internal reason="ASG Lifecycle Termination event received. Instance will be interrupted at 2022-07-17 20:20:42.702 +0000 UTC \n"
2022/07/17 20:20:44 INF Completed ASG Lifecycle Hook (NTH-K8S-TERM-HOOK) for instance i-0409f2a9d3085b80e
```