```
Para obtener más información sobre `eksctl`, consulte la [documentación de eksctl](https://eksctl.io/usage/creating-and-managing-clusters/).
+ Proveedor de OpenID Connect (OIDC) de AWS Identity and Access Management (IAM) para su clúster. Para obtener más información, consulte [Creación de un proveedor OIDC de IAM para su clúster](https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html).
**Limitaciones**
+ Debe utilizar una región de AWS que sea compatible con el servicio Amazon EKS.
**Versiones de producto**
+ Versión de Kubernetes 1.20 o posterior
+ `eksctl` versión 0.107.0 o posterior
+ CDK de AWS, versión 2.27.0 o posterior
## Arquitectura
**Pila de tecnología de destino**
+ Una nube privada virtual (VPC)
+ Un Clúster de EKS
+ Amazon Simple Queue Service (Amazon SQS)
+ IAM
+ Kubernetes
**Arquitectura de destino**** **
El siguiente diagrama muestra una vista de alto nivel de los end-to-end pasos que se deben seguir cuando se inicia la terminación del nodo.
El flujo de trabajo que se muestra en el diagrama consta de los siguientes pasos de alto nivel:
1. El evento de finalización de la EC2 instancia de escalado automático se envía a la cola de SQS.
1. El NTH Pod supervisa los mensajes nuevos en la cola de SQS.
1. El NTH Pod recibe el nuevo mensaje y hace lo siguiente:
+ Acordona el nodo para que el nuevo pod no se ejecute en él.
+ Drena el nodo para evacuar el pod existente
+ Envía una señal de enlace de ciclo de vida al grupo de escalado automático para que se pueda terminar el nodo.
**Automatizar y escalar**
+ El código lo administra e implementa AWS CDK, con el respaldo de pilas CloudFormation anidadas de AWS.
+ El [plano de control de Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/disaster-recovery-resiliency.html) se ejecuta en varias zonas de disponibilidad para garantizar una alta disponibilidad.
+ Para el [escalado automático](https://docs.aws.amazon.com/eks/latest/userguide/autoscaling.html), Amazon EKS admite el [escalador automático de clústeres](https://github.com/kubernetes/autoscaler/tree/master/cluster-autoscaler) de Kubernetes y [Karpenter](https://karpenter.sh/).
## Tools (Herramientas)
**Servicios de AWS**
+ [AWS Cloud Development Kit (AWS CDK)](https://docs.aws.amazon.com/cdk/latest/guide/home.html) es un marco de desarrollo de software que le ayuda a definir y aprovisionar la infraestructura de la nube de AWS en código.
+ [AWS CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html) es un servicio de compilación totalmente gestionado que le ayuda a compilar código fuente, ejecutar pruebas unitarias y producir artefactos listos para su implementación.
+ [AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/welcome.html) es un servicio de control de versiones que le ayuda a almacenar y gestionar repositorios de Git de forma privada, sin necesidad de gestionar su propio sistema de control de código fuente.
+ [AWS](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html) le CodePipeline ayuda a modelar y configurar rápidamente las diferentes etapas de una versión de software y a automatizar los pasos necesarios para publicar cambios de software de forma continua.
+ [Amazon Elastic Kubernetes Service (Amazon EKS)](https://docs.aws.amazon.com/eks/latest/userguide/getting-started.html) lo ayuda a ejecutar Kubernetes en AWS sin necesidad de instalar ni mantener su propio plano de control o nodos de Kubernetes.
+ [Amazon EC2 Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/what-is-amazon-ec2-auto-scaling.html) le ayuda a mantener la disponibilidad de las aplicaciones y le permite añadir o eliminar automáticamente EC2 instancias de Amazon según las condiciones que defina.
+ [Amazon Simple Queue Service (Amazon SQS)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html) ofrece una cola alojada segura, duradera y disponible que le permite integrar y desacoplar sistemas y componentes de software distribuidos.
**Otras herramientas**
+ [kubectl](https://kubernetes.io/docs/reference/kubectl/kubectl/): es una herramienta de línea de comandos para la ejecución de comandos en clústeres de Kubernetes. Puede usar kubectl para implementar aplicaciones, inspeccionar y administrar los recursos del clúster y ver los registros.
**Código**
El código de este patrón está disponible en el [deploy-nth-to-eks](https://github.com/aws-samples/deploy-nth-to-eks)repositorio de GitHub .com. El repositorio de código contiene los siguientes archivos y carpetas.
+ `nth folder`— El diagrama de Helm, los archivos de valores y los scripts para escanear e implementar la CloudFormation plantilla de AWS para Node Termination Handler.
+ `config/config.json`: el archivo de parámetros de configuración de la aplicación. Este archivo contiene todos los parámetros necesarios para implementar el CDK.
+ `cdk`: el código fuente del CDK de AWS.
+ `setup.sh`— El script utilizado para implementar la aplicación AWS CDK para crear la CI/CD canalización requerida y otros recursos necesarios.
+ `uninstall.sh`: el script utilizado para limpiar los recursos.
Para usar el código de muestra, siga las instrucciones en la sección *Epics *.
## Prácticas recomendadas
Para conocer las prácticas recomendadas a la hora de automatizar AWS Node Termination Handler, consulte lo siguiente:
+ [Guías de prácticas recomendadas de EKS](https://aws.github.io/aws-eks-best-practices/)
+ [Node Termination Handler: configuración](https://github.com/aws/aws-node-termination-handler/tree/main/config/helm/aws-node-termination-handler)
## Epics
### Configure su entorno
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Clone el repositorio. | Para clonar el repositorio mediante SSH (Secure Shell), ejecute el siguiente comando.git clone git@github.com:aws-samples/deploy-nth-to-eks.git
Para clonar el repositorio mediante HTTPS, ejecute el siguiente comando.git clone https://github.com/aws-samples/deploy-nth-to-eks.git
Al clonar el repositorio se crea una carpeta llamada `deploy-nth-to-eks`.
Cambie a ese directorio.cd deploy-nth-to-eks
| Desarrollador de aplicaciones, AWS DevOps, DevOps ingeniero |
| Configure el archivo kubeconfig. | Configure sus credenciales de AWS en su terminal y confirme que tiene derechos para asumir el rol de clúster. Puede utilizar el siguiente código de ejemplo.aws eks update-kubeconfig --name --region --role-arn
| AWS DevOps, DevOps ingeniero, desarrollador de aplicaciones |
### Implemente la CI/CD canalización
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Establezca los parámetros. | Configure los siguientes parámetros obligatorios en el archivo `config/config.json`.[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/automate-deployment-of-node-termination-handler-in-amazon-eks-by-using-a-ci-cd-pipeline.html) | Desarrollador de aplicaciones, AWS DevOps, DevOps ingeniero |
| Cree la CI/CD canalización para implementar NTH. | Ejecute el script setup.sh../setup.sh
El script implementará la aplicación AWS CDK que creará el CodeCommit repositorio con el código de ejemplo, la canalización y los CodeBuild proyectos en función de los parámetros ingresados por el usuario en `config/config.json` el archivo.
Este script solicitará la contraseña cuando instale los paquetes npm con el comando sudo. | Desarrollador de aplicaciones, AWS DevOps, DevOps ingeniero |
| Revise la CI/CD canalización. | Abra la consola de administración de AWS y revise los siguientes recursos creados en la pila.[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/automate-deployment-of-node-termination-handler-in-amazon-eks-by-using-a-ci-cd-pipeline.html)
Una vez que la canalización se ejecute correctamente, la versión de Helm `aws-node-termination-handler` se instala en el clúster de EKS. Además, se está ejecutando un pod denominado `aws-node-termination-handler` en el espacio de nombres `kube-system` del clúster. | Desarrollador de aplicaciones, AWS DevOps, DevOps ingeniero |
### Pruebe la implementación de NTH
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Simule un evento de escalado de grupo de escalado automático. | Para simular un evento de reducción horizontal del escalado automático, haga lo siguiente:[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/prescriptive-guidance/latest/patterns/automate-deployment-of-node-termination-handler-in-amazon-eks-by-using-a-ci-cd-pipeline.html) | |
| Revise los registros. | Durante el evento de escalado, el NTH Pod acordonará y vaciará el nodo de trabajo correspondiente (la EC2 instancia que finalizará como parte del evento de escalado). Para comprobar los registros, utilice el código de la sección *Información adicional*. | Desarrollador de aplicaciones, AWS DevOps, DevOps ingeniero |
### Limpieza
| Tarea | Descripción | Habilidades requeridas |
| --- | --- | --- |
| Limpieza de todos los recursos de AWS. | Para limpiar los recursos creados por este patrón, ejecute el siguiente comando../uninstall.sh
Esto limpiará todos los recursos creados en este patrón al eliminar la CloudFormation pila. | DevOps ingeniero |
## Resolución de problemas
| Problema | Solución |
| --- | --- |
| El registro npm no está configurado correctamente. | Durante la instalación de esta solución, el script instala npm install para descargar todos los paquetes necesarios. Si, durante la instalación, ve un mensaje que dice “No se puede encontrar el módulo”, es posible que el registro npm no esté configurado correctamente. Para ver la configuración actual del registro, ejecute el siguiente comando.npm config get registry
Ejecute el siguiente comando para establecer el registro con `https://registry.npmjs.org/`.npm config set registry https://registry.npmjs.org
|
| Retrasar la entrega del mensaje SQS. | Como parte de la solución de problemas, si desea retrasar la entrega de los mensajes de SQS a NTH Pod, puede ajustar el parámetro de retraso de entrega de SQS. Para obtener más información, consulte [Colas de retraso de Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-delay-queues.html). |
## Recursos relacionados
+ [Código fuente de AWS Node Termination Handler](https://github.com/aws/aws-node-termination-handler)
+ [EC2 taller](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 Cloud Development Kit](https://aws.amazon.com/cdk/)
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
## Información adicional
1. Busque el nombre del 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. Consulte los registros. Un registro de ejemplo se ve del siguiente modo. Muestra que el nodo ha sido acordonado y drenado antes de enviar la señal de finalización del enlace de ciclo de vida del grupo de escalado automático.
```
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
```