**Ayude a mejorar esta página** Para contribuir a esta guía del usuario, elija el enlace **Edit this page on GitHub** que se encuentra en el panel derecho de cada página. # Cómo crear un clúster con el modo automático de Amazon EKS En este capítulo se describe cómo crear un clúster de Amazon EKS con el modo automático habilitado mediante diversas herramientas e interfaces. El modo automático simplifica la creación de clústeres al configurar y administrar automáticamente la infraestructura de computación, redes y almacenamiento del clúster. Aprenderá a crear un clúster del modo automático mediante la AWS CLI, la Consola de administración de AWS o la herramienta de línea de comandos eksctl. **nota** El modo automático de EKS requiere la versión 1.29 o superior de Kubernetes. Elija la herramienta que mejor se adapte a sus necesidades: la Consola de administración de AWS proporciona una interfaz visual ideal para explorar las características del modo automático de EKS y crear clústeres individuales. AWS CLI es ideal para tareas de creación de scripts y automatización, especialmente al integrar la creación de clústeres en flujos de trabajo existentes o en canalizaciones de CI/CD. La CLI de eksctl ofrece una experiencia nativa de Kubernetes y se recomienda para usuarios familiarizados con las herramientas de Kubernetes que deseen realizar operaciones simplificadas en la línea de comandos con configuraciones predeterminadas adecuadas. Antes de comenzar, asegúrese de tener instalados y configurados los requisitos previos necesarios, incluidos los permisos de IAM correspondientes para crear clústeres de EKS. Para obtener información sobre cómo instalar herramientas de CLI, como `kubectl``aws` y `eksctl`, consulte [Configuración para usar Amazon EKS](setting-up.md). Puede usar la AWS CLI, la Consola de administración de AWS o la CLI de eksctl para crear un clúster con el modo automático de Amazon EKS. **Topics** + [Creación de un clúster de modo automático de EKS con la CLI de eksctl](automode-get-started-eksctl.md) + [Cómo crear un clúster de modo automático de EKS con AWS CLI](automode-get-started-cli.md) + [Creación de un clúster del modo automático de EKS con la Consola de administración de AWS](automode-get-started-console.md) # Creación de un clúster de modo automático de EKS con la CLI de eksctl En este tema se muestra cómo crear un clúster de modo automático de Amazon EKS mediante la interfaz de la línea de comandos (CLI) de eksctl. Puede crear un clúster de modo automático o bien mediante la ejecución de un único comando de la CLI o a través de la aplicación de un archivo de configuración YAML. Ambos métodos ofrecen la misma funcionalidad, aunque el enfoque YAML ofrece un control más detallado de la configuración del clúster. La CLI de eksctl simplifica el proceso de creación y administración de clústeres de modo automático de EKS al encargarse de la creación y configuración de los recursos de AWS subyacentes. Antes de continuar, asegúrese de que cuenta con las credenciales y permisos de AWS necesarios configurados en la máquina local. En esta guía se presupone que conoce los conceptos básicos de Amazon EKS y que ya ha instalado las herramientas de la CLI necesarias. **nota** Debe instalar la versión `0.195.0` o superior de eksctl. Para obtener más información, consulte [Versiones de eksctl](https://github.com/eksctl-io/eksctl/releases) en GitHub. ## Creación de un clúster de modo automático de EKS con un comando de la CLI Debe tener las herramientas `aws` y `eksctl` instaladas. Debe iniciar sesión en AWS CLI con permisos suficientes para administrar recursos de AWS, incluidos: instancias de EC2, redes de EC2, clústeres de EKS y roles de IAM. Para obtener más información, consulte [Configuración para usar Amazon EKS](setting-up.md). Ejecute el siguiente comando para crear un nuevo clúster de modo automático de EKS con ``` eksctl create cluster --name= --enable-auto-mode ``` ## Creación de un clúster de modo automático de EKS con un archivo YAML Debe tener las herramientas `aws` y `eksctl` instaladas. Debe iniciar sesión en AWS CLI con permisos suficientes para administrar recursos de AWS, incluidos: instancias de EC2, redes de EC2, clústeres de EKS y roles de IAM. Para obtener más información, consulte [Configuración para usar Amazon EKS](setting-up.md). Revise las opciones de configuración del modo automático de EKS en el recurso ClusterConfig de ejemplo que aparece a continuación. Para conocer la especificación completa de ClusterConfig, consulte la [documentación de eksctl](https://eksctl.io/usage/creating-and-managing-clusters/). AWS sugiere habilitar el modo automático de EKS. Si es la primera vez que crea un clúster de modo automático de EKS, deje el `nodeRoleARN` sin especificar para crear un rol de IAM de nodo para el modo automático de EKS. Si ya tiene un rol de IAM de nodo en la cuenta de AWS, AWS sugiere que se vuelva a utilizar. AWS sugiere no especificar ningún valor para `nodePools`. El modo automático de EKS creará grupos de nodos predeterminados. Puede utilizar la API de Kubernetes para crear grupos de nodos adicionales. ``` # cluster.yaml apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: region: iam: # ARN of the Cluster IAM Role # optional, eksctl creates a new role if not supplied # suggested to use one Cluster IAM Role per account serviceRoleARN: autoModeConfig: # defaults to false enabled: boolean # optional, defaults to [general-purpose, system]. # suggested to leave unspecified # To disable creation of nodePools, set it to the empty array ([]). nodePools: []string # optional, eksctl creates a new role if this is not supplied # and nodePools are present. nodeRoleARN: string ``` Guarde el archivo `ClusterConfig` como `cluster.yaml` y use el siguiente comando para crear el clúster: ``` eksctl create cluster -f cluster.yaml ``` # Cómo crear un clúster de modo automático de EKS con AWS CLI Los clústeres del modo automático de EKS automatizan las tareas rutinarias de administración de clústeres para computación, almacenamiento y redes. Por ejemplo, los clústeres del modo automático de EKS detectan automáticamente cuándo se necesitan nodos adicionales y aprovisionan nuevas instancias de EC2 a fin de satisfacer las demandas de la carga de trabajo. En este tema se ofrece orientación para crear un nuevo clúster de modo automático de EKS mediante AWS CLI y, opcionalmente, implementar una carga de trabajo de muestra. ## Requisitos previos + La versión más reciente de la Interfaz de Línea de Comandos de AWS (AWS CLI) instalada y configurada en el dispositivo. Para comprobar su versión actual, utilice `aws --version`. Para instalar la versión más reciente, consulte [Instalación](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) y [Configuración rápida con aws configure](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-configure-quickstart-config) en la Guía del usuario de la interfaz de la línea de comandos de AWS. + Inicie sesión en la CLI con permisos de IAM suficientes para crear recursos de AWS, como políticas de IAM, roles de IAM y clústeres de EKS. + La herramienta de línea de comandos kubectl instalada en el dispositivo. AWS sugiere que utilice la misma versión de kubectl que la versión de Kubernetes del clúster de EKS. Para instalar o actualizar kubectl, consulte [Configuración de `kubectl` y `eksctl`](install-kubectl.md). ## Cómo especificar las subredes de la VPC El modo automático de Amazon EKS implementa nodos en las subredes de la VPC. Al crear un clúster de EKS, debe especificar las subredes de la VPC en las que se implementarán los nodos. Puede utilizar las subredes de la VPC predeterminadas en la cuenta de AWS o crear una VPC dedicada para cargas de trabajo críticas. + AWS sugiere crear una VPC dedicada para el clúster. Información sobre cómo [Creación de una Amazon VPC para su clúster de Amazon EKS](creating-a-vpc.md). + La consola de EKS ayuda a crear una nueva VPC. Información sobre cómo [Creación de un clúster del modo automático de EKS con la Consola de administración de AWS](automode-get-started-console.md). + Como alternativa, puede utilizar la VPC predeterminada de la cuenta de AWS. Siga las siguientes instrucciones para encontrar los ID de subred. ### Para encontrar los ID de subred de la VPC predeterminada **Uso de AWS CLI:** 1. Ejecute el siguiente comando para enumerar la VPC predeterminada y sus subredes: ``` aws ec2 describe-subnets --filters "Name=vpc-id,Values=$(aws ec2 describe-vpcs --query 'Vpcs[?IsDefault==`true`].VpcId' --output text)" --query 'Subnets[*].{ID:SubnetId,AZ:AvailabilityZone}' --output table ``` 1. Guarde el resultado y anote los **ID de subred**. Código de salida de ejemplo: ``` ---------------------------------------- | DescribeSubnets | ---------------------------------------- | SubnetId | AvailabilityZone | |--------------------|---------------------| | subnet-012345678 | us-west-2a | | subnet-234567890 | us-west-2b | | subnet-345678901 | us-west-2c | ---------------------------------------- ``` ## Roles de IAM para clústeres de modo automático de EKS ### Rol de IAM de clúster El modo automático de EKS requiere un rol de IAM de clúster para realizar acciones en la cuenta de AWS, como el aprovisionamiento de nuevas instancias de EC2. Debe crear este rol para conceder a EKS los permisos necesarios. AWS recomienda asociar las siguientes políticas administradas de AWS al rol de IAM del clúster: + [AmazonEKSComputePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSComputePolicy) + [AmazonEKSBlockStoragePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSBlockStoragePolicy) + [AmazonEKSLoadBalancingPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSLoadBalancingPolicy) + [AmazonEKSNetworkingPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSNetworkingPolicy) + [AmazonEKSClusterPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-amazoneksclusterpolicy) ### Rol de IAM del nodo Al crear un clúster de modo automático de EKS, se especifica un rol de IAM del nodo. Cuando el modo automático de EKS crea nodos para procesar cargas de trabajo pendientes, a cada nuevo nodo de instancia de EC2 se le asigna el rol de IAM del nodo. Este rol permite que el nodo se comunique con EKS, pero generalmente las cargas de trabajo que se ejecutan en el nodo no acceden a este. Si desea conceder permisos a las cargas de trabajo que se ejecutan en un nodo, utilice EKS Pod Identity. Para obtener más información, consulte [Más información sobre cómo Pod Identity de EKS concede a los pods acceso a los servicios de AWS](pod-identities.md). Debe crear este rol y asociar la siguiente política administrada de AWS: + [AmazonEKSWorkerNodeMinimalPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSWorkerNodeMinimalPolicy) + [AmazonEC2ContainerRegistryPullOnly](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonEC2ContainerRegistryPullOnly) El modo automático de EKS también requiere un rol vinculado al servicio, que AWS crea y configura automáticamente. Para obtener más información, consulte [AWSServiceRoleForAmazonEKS](using-service-linked-roles-eks.md). ## Cómo crear un rol de IAM de clúster de modo automático de EKS ### Paso 1: Creación de la política de confianza Cree una política de confianza que permita al servicio de Amazon EKS asumir el rol. Guarde la política como `trust-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "eks.amazonaws.com" }, "Action": [ "sts:AssumeRole", "sts:TagSession" ] } ] } ``` ### Paso 2: Creación del rol de IAM Utilice la política de confianza para crear el rol de IAM del clúster: ``` aws iam create-role \ --role-name AmazonEKSAutoClusterRole \ --assume-role-policy-document file://trust-policy.json ``` ### Paso 3: Cómo anotar el ARN del rol Recupere y guarde el ARN del nuevo rol para utilizarlo en pasos posteriores: ``` aws iam get-role --role-name AmazonEKSAutoClusterRole --query "Role.Arn" --output text ``` ### Paso 4: Asociación de las políticas requeridas Asocie las siguientes políticas administradas por AWS al rol de IAM del clúster para conceder los permisos necesarios: **AmazonEKSClusterPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSClusterPolicy ``` **AmazonEKSComputePolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSComputePolicy ``` **AmazonEKSBlockStoragePolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSBlockStoragePolicy ``` **AmazonEKSLoadBalancingPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSLoadBalancingPolicy ``` **AmazonEKSNetworkingPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSNetworkingPolicy ``` ## Cómo crear un rol de IAM de nodo del modo automático de EKS ### Paso 1: Creación de la política de confianza Cree una política de confianza que permita al servicio de Amazon EKS asumir el rol. Guarde la política como `node-trust-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` #### Paso 2: Creación del rol de IAM del nodo Utilice el archivo **node-trust-policy.json** del paso anterior para definir qué entidades pueden asumir el rol. Ejecute el siguiente comando para crear el rol de IAM del nodo: ``` aws iam create-role \ --role-name AmazonEKSAutoNodeRole \ --assume-role-policy-document file://node-trust-policy.json ``` #### Paso 3: Cómo anotar el ARN del rol Después de crear el rol, recupere y guarde el ARN del rol de IAM del nodo. Necesitará este ARN en los pasos siguientes. Utilice el siguiente comando para obtener el ARN: ``` aws iam get-role --role-name AmazonEKSAutoNodeRole --query "Role.Arn" --output text ``` #### Paso 4: Asociación de las políticas requeridas Asocie las siguientes políticas administradas por AWS al rol de IAM del nodo para proporcionar los permisos necesarios: **AmazonEKSWorkerNodeMinimalPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoNodeRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSWorkerNodeMinimalPolicy ``` **AmazonEC2ContainerRegistryPullOnly**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoNodeRole \ --policy-arn arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryPullOnly ``` ## Cómo crear un clúster de modo automático de EKS ### Descripción general Para crear un clúster de modo automático de EKS mediante AWS CLI, necesitará los siguientes parámetros: + `cluster-name`: el nombre del clúster. + `k8s-version`: la versión de Kubernetes (p. ej., 1.31). + `subnet-ids`: los ID de subred identificados en los pasos anteriores. + `cluster-role-arn`: ARN del rol de IAM del clúster. + `node-role-arn`: ARN del rol de IAM del nodo. #### Configuraciones de clúster predeterminadas Revise las características y los valores predeterminados antes de crear el clúster: + `nodePools`: el modo automático de EKS incluye grupos de nodos de uso general y predeterminados del sistema. Más información sobre los [grupos de nodos](create-node-pool.md). **Nota:** Los grupos de nodos del modo automático de EKS se diferencian de los grupos de nodos administrados de Amazon EKS, pero pueden coexistir en el mismo clúster. + `computeConfig.enabled`: automatiza las tareas de computación rutinarias, como la creación y eliminación de instancias de EC2. + `kubernetesNetworkConfig.elasticLoadBalancing.enabled`: automatiza las tareas de equilibrio de carga, incluida la creación y eliminación de equilibradores de carga elásticos. + `storageConfig.blockStorage.enabled`: automatiza las tareas de almacenamiento, como la creación y eliminación de volúmenes de Amazon EBS. + `accessConfig.authenticationMode`: requiere entradas de acceso de EKS. Más información sobre los [modos de autenticación de EKS](grant-k8s-access.md). #### Ejecute el comando Utilice el siguiente comando para crear el clúster: ``` aws eks create-cluster \ --region ${AWS_REGION} \ --cli-input-json \ "{ \"name\": \"${CLUSTER_NAME}\", \"version\": \"${K8S_VERSION}\", \"roleArn\": \"${CLUSTER_ROLE_ARN}\", \"resourcesVpcConfig\": { \"subnetIds\": ${SUBNETS_JSON}, \"endpointPublicAccess\": true, \"endpointPrivateAccess\": true }, \"computeConfig\": { \"enabled\": true, \"nodeRoleArn\":\"${NODE_ROLE_ARN}\", \"nodePools\": [\"general-purpose\", \"system\"] }, \"kubernetesNetworkConfig\": { \"elasticLoadBalancing\": { \"enabled\": true } }, \"storageConfig\": { \"blockStorage\": { \"enabled\": true } }, \"accessConfig\": { \"authenticationMode\": \"API\" } }" ``` ### Cómo comprobar el estado del clúster #### Paso 1: Comprobación de la creación del clúster Ejecute el siguiente comando para comprobar el estado del clúster. La creación del clúster generalmente tarda unos 15 minutos: ``` aws eks describe-cluster --name "${CLUSTER_NAME}" --output json ``` #### Paso 2: Actualización de kubeconfig Una vez que el clúster esté listo, actualice el archivo kubeconfig local para permitir que `kubectl` se comunique con el clúster. Esta configuración utiliza AWS CLI para la autenticación. ``` aws eks update-kubeconfig --name "${CLUSTER_NAME}" ``` #### Paso 3: Verificación de los grupos de nodos Enumere los grupos de nodos del clúster con el siguiente comando: ``` kubectl get nodepools ``` ## Siguientes pasos + Aprenda a [implementar una carga de trabajo de muestra](automode-workload.md) en el nuevo clúster de modo automático de EKS. # Creación de un clúster del modo automático de EKS con la Consola de administración de AWS La creación de un clúster del modo automático de EKS en la Consola de administración de AWS requiere menos configuración que otras opciones. EKS se integra con AWS IAM y las redes de VPC para ayudar a crear los recursos asociados a un clúster de EKS. Existen dos opciones para crear un clúster en la consola: + Configuración rápida (con el modo automático de EKS) + Configuración personalizada En este tema, aprenderá a crear un clúster de modo automático de EKS mediante la opción de configuración rápida. ## Creación de un modo automático de EKS mediante la opción de configuración rápida Debe iniciar sesión en la Consola de administración de AWS con permisos suficientes para administrar recursos de AWS, incluidos los siguientes: instancias de EC2, redes de EC2, clústeres de EKS y roles de IAM. 1. Vaya a la consola de EKS 1. Haga clic en **Crear clúster** 1. **Confirme que la opción de configuración rápida esté seleccionada** 1. Determine los siguientes valores o utilice los valores predeterminados para un clúster de prueba. + **Nombre** del clúster + Versión de Kubernetes 1. Seleccione el rol IAM del clúster. Si es la primera vez que crea un clúster de modo automático de EKS, utilice la opción **Crear rol recomendado**. + Opcionalmente, puede volver a utilizar un único rol de IAM de clúster en la cuenta de AWS para todos los clústeres de modo automático de EKS. + El rol de IAM de clúster incluye los permisos necesarios para que el modo automático de EKS administre los recursos, incluidas las instancias de EC2, los volúmenes de EBS y los equilibradores de carga de EC2. + La opción **Crear rol recomendado** completa previamente todos los campos con valores recomendados. Seleccione **Siguiente** y, a continuación, **Crear**. El rol usará el nombre de `AmazonEKSAutoClusterRole` sugerido. + Si ha creado recientemente un nuevo rol, utilice el icono **Actualizar** para recargar el menú desplegable de selección de roles. 1. Seleccione el rol de IAM del nodo. Si es la primera vez que crea un clúster de modo automático de EKS, utilice la opción **Crear rol recomendado**. + Opcionalmente, puede volver a utilizar un único rol de IAM de nodo en la cuenta de AWS para todos los clústeres de modo automático de EKS. + El rol de IAM de nodo incluye los permisos necesarios para que los nodos del modo automático se conecten al clúster. El rol de IAM del nodo debe incluir permisos para recuperar imágenes de ECR para los contenedores. + La opción **Crear rol recomendado** completa previamente todos los campos con valores recomendados. Seleccione **Siguiente** y, a continuación, **Crear**. El rol usará el nombre de `AmazonEKSAutoNodeRole` sugerido. + Si ha creado recientemente un nuevo rol, utilice el icono **Actualizar** para recargar el menú desplegable de selección de roles. 1. Seleccione la VPC para el clúster de modo automático de EKS. Elija **Crear VPC** para crear una nueva VPC para EKS, o elija una VPC que haya creado previamente para EKS. + Si utiliza la Consola de la VPC para crear una nueva VPC, AWS sugiere crear al menos una puerta de enlace NAT por zona de disponibilidad. De lo contrario, puede utilizar todos los demás valores predeterminados. + Para obtener más información y detalles sobre los requisitos del clúster de IPv6, consulte [Creación de una Amazon VPC para su clúster de Amazon EKS](creating-a-vpc.md). 1. (opcional) El modo automático de EKS completa automáticamente las subredes privadas de la VPC seleccionada. Puede eliminar las subredes no deseadas. + EKS selecciona automáticamente las subredes privadas de la VPC según las prácticas recomendadas. Opcionalmente, puede seleccionar subredes adicionales de la VPC, como subredes públicas. 1. (opcional) Seleccione **Ver valores predeterminados de configuración rápida** para revisar todos los valores de configuración del nuevo clúster. En la tabla se indica que algunos valores no se pueden editar una vez creado el clúster. 1. Seleccione **Create cluster (Crear clúster)**. Tenga en cuenta que la creación del clúster puede tardar quince minutos en completarse. ## Siguientes pasos + Aprenda a [Implementar una carga de trabajo de muestra en el clúster de modo automático de EKS](sample-storage-workload.md)