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.
Configuración de kubectl y eksctl
Después de instalar AWS CLI, conviene instalar otras dos herramientas para crear y administrar los clústeres de Kubernetes:
-
kubectl: la herramienta de la línea de comandoskubectles la principal que utilizará para administrar los recursos del clúster de Kubernetes. Esta página describe cómo descargar y configurar el binariokubectlque coincide con la versión del clúster de Kubernetes. Consulte Instalación o actualización de kubectl. -
eksctl: la herramienta de la línea de comandoseksctlestá diseñada para crear clústeres de EKS en la nube de AWS o en las instalaciones (con EKS Anywhere), así como para modificar y eliminar esos clústeres. Consulte Instalación de eksctl.
Instalación o actualización de kubectl
Este tema le ayuda a descargar e instalar o actualizar, el kubectl binario en su dispositivo. El dato binario es idéntico a las versiones de comunidad ascendentekubectlque necesita, aunque muchos creadores simplemente ejecutan brew install kubectl para instalarla.
nota
Debe utilizar una versión de kubectl con una diferencia de versión de menos de un número que el plano del control del clúster de Amazon EKS. Por ejemplo, un cliente de kubectl 1.32 trabaja con los clústeres 1.31, 1.32 y 1.33 de Kubernetes.
Paso 1: compruebe si kubectl está instalado
Determine si ya tiene kubectl instalado en su dispositivo.
kubectl version --client
Si tiene kubectl instalado en la ruta de su dispositivo, el resultado de ejemplo incluye información similar a la siguiente. Si desea actualizar la versión que tiene instalada actualmente con una versión posterior, complete el siguiente paso y asegúrese de instalar la nueva versión en la misma ubicación en la que se encuentra la versión actual.
Client Version: v1.31.X-eks-1234567
Si no recibe un resultado, entonces no tiene kubectl instalado o no está instalado en una ubicación que esté en la ruta de acceso del dispositivo.
Paso 2: instalación o actualización de kubectl
Instalación o actualización de kubectl en uno de los siguientes sistemas operativos:
nota
Si las descargas desde las regiones de AWS mencionadas en esta sección son lentas en su región de AWS, considere la posibilidad de configurar CloudFront para distribuir el contenido. Para obtener más información, consulte Introducción a una distribución básica de CloudFront.
macOS
Siga los pasos que se indican a continuación para instalar kubectl en macOS. Estos pasos incluyen:
-
Elegir y descargar el binario para la versión de Kubernetes que desee.
-
Opcionalmente, comprobar la suma de comprobación del binario.
-
Agregar ejecución a los permisos del binario.
-
Copiar el binario en una carpeta en la RUTA.
-
Opcionalmente, agregar el directorio del binario a la RUTA.
Procedimiento:
-
Descargue el dato binario de para la versión de Kubernetes del clúster de Amazon S3.
-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/darwin/amd64/kubectl -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2025-01-10/bin/darwin/amd64/kubectl -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/darwin/amd64/kubectl
-
-
(Opcional) Compruebe el dato binario descargado con la suma de comprobación de
SHA-256de su dato binario.-
Descargue la suma de comprobación de
SHA-256de la versión de Kubernetes de su clúster.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2025-01-10/bin/darwin/amd64/kubectl.sha256 -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/darwin/amd64/kubectl.sha256
-
-
Verifique la suma de comprobación de
SHA-256del dato binario descargado.openssl sha1 -sha256 kubectl -
Asegúrese de que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivo de
kubectl.sha256descargado.
-
-
Aplique permisos de ejecución al binario.
chmod +x ./kubectl -
Copie el binario en una carpeta en
PATH. Si ya ha instalado una versión dekubectl, recomendamos que cree un$HOME/bin/kubectly se asegure de que$HOME/binvenga en primer lugar en su$PATH.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH -
(Opcional) Agregue la ruta
$HOME/bina su archivo de inicialización del shell para que se configure cuando abra un shell.echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
Linux (amd64)
Siga los pasos que se indican a continuación para instalar kubectl en Linux (amd64). Estos pasos incluyen:
-
Elegir y descargar el binario para la versión de Kubernetes que desee.
-
Opcionalmente, comprobar la suma de comprobación del binario.
-
Agregar ejecución a los permisos del binario.
-
Copiar el binario en una carpeta en la RUTA.
-
Opcionalmente, agregar el directorio del binario a la RUTA.
Procedimiento:
-
Descargue el dato binario de
kubectlpara la versión de Kubernetes del clúster de Amazon S3.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/amd64/kubectl -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/amd64/kubectl -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/amd64/kubectl
-
-
(Opcional) Compruebe el dato binario descargado con la suma de comprobación de
SHA-256de su dato binario.-
Descargue la suma de comprobación de
SHA-256para la versión de Kubernetes del clúster desde Amazon S3, mediante el comando de la plataforma de hardware de su dispositivo.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/amd64/kubectl.sha256 -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/amd64/kubectl.sha256
-
-
Controle la suma de comprobación de
SHA-256del archivo binario descargado con uno de los siguientes comandos.sha256sum -c kubectl.sha256o
openssl sha1 -sha256 kubectl -
Para la primera, debería ver
kubectl: OK, para la segunda, puede comprobar que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivokubectl.sha256descargado.
-
-
Aplique permisos de ejecución al binario.
chmod +x ./kubectl -
Copie el binario en una carpeta en
PATH. Si ya ha instalado una versión dekubectl, recomendamos que cree un$HOME/bin/kubectly se asegure de que$HOME/binvenga en primer lugar en su$PATH.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH -
(Opcional) Agregue la ruta
$HOME/bina su archivo de inicialización del shell para que se configure cuando abra un shell.nota
En este paso, se presupone que usa el shell Bash; si utiliza otro shell, cambie el comando para utilizar su archivo de inicialización del shell específico.
echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
Linux (arm64)
Siga los pasos que se indican a continuación para instalar kubectl en Linux (arm64). Estos pasos incluyen:
-
Elegir y descargar el binario para la versión de Kubernetes que desee.
-
Opcionalmente, comprobar la suma de comprobación del binario.
-
Agregar ejecución a los permisos del binario.
-
Copiar el binario en una carpeta en la RUTA.
-
Opcionalmente, agregar el directorio del binario a la RUTA.
Procedimiento:
-
Descargue el dato binario de
kubectlpara la versión de Kubernetes del clúster de Amazon S3.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/arm64/kubectl -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/arm64/kubectl -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/arm64/kubectl
-
-
(Opcional) Compruebe el dato binario descargado con la suma de comprobación de
SHA-256de su dato binario.-
Descargue la suma de comprobación de
SHA-256para la versión de Kubernetes del clúster desde Amazon S3, mediante el comando de la plataforma de hardware de su dispositivo.-
Kubernetes
1.33curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.32curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.31curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.30curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.29curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.28curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.27curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/arm64/kubectl.sha256 -
Kubernetes
1.26curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/arm64/kubectl.sha256
-
-
Controle la suma de comprobación de
SHA-256del archivo binario descargado con uno de los siguientes comandos.sha256sum -c kubectl.sha256o
openssl sha1 -sha256 kubectl -
Para la primera, debería ver
kubectl: OK, para la segunda, puede comprobar que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivokubectl.sha256descargado.
-
-
Aplique permisos de ejecución al binario.
chmod +x ./kubectl -
Copie el binario en una carpeta en
PATH. Si ya ha instalado una versión dekubectl, recomendamos que cree un$HOME/bin/kubectly se asegure de que$HOME/binvenga en primer lugar en su$PATH.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH -
(Opcional) Agregue la ruta
$HOME/bina su archivo de inicialización del shell para que se configure cuando abra un shell.nota
En este paso, se presupone que usa el shell Bash; si utiliza otro shell, cambie el comando para utilizar su archivo de inicialización del shell específico.
echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
Windows
Siga los pasos que se indican a continuación para instalar kubectl en Windows. Estos pasos incluyen:
-
Elegir y descargar el binario para la versión de Kubernetes que desee.
-
Opcionalmente, comprobar la suma de comprobación del binario.
-
Copiar el binario en una carpeta en la RUTA.
-
Opcionalmente, agregar el directorio del binario a la RUTA.
Procedimiento:
-
Abra un terminal de PowerShell.
-
Descargue el dato binario de
kubectlpara la versión de Kubernetes del clúster de Amazon S3.-
Kubernetes
1.33curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.32curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.31curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.30curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.29curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.28curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/windows/amd64/kubectl.exe -
Kubernetes
1.27curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/windows/amd64/kubectl.exe -
Kubernetes
1.26curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/windows/amd64/kubectl.exe
-
-
(Opcional) Compruebe el dato binario descargado con la suma de comprobación de
SHA-256de su dato binario.-
Descargue la suma de comprobación de
SHA-256para la versión de Kubernetes del clúster para Windows.-
Kubernetes
1.33curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.3/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.32curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.7/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.31curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.11/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.30curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.29curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.28curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-08-03/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.27curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/windows/amd64/kubectl.exe.sha256 -
Kubernetes
1.26curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/windows/amd64/kubectl.exe.sha256
-
-
Verifique la suma de comprobación de
SHA-256del dato binario descargado.Get-FileHash kubectl.exe -
Asegúrese de que la suma de comprobación generada en la salida coincida con la suma de comprobación del archivo de
kubectl.sha256descargado. La salida de PowerShell debe ser una cadena de caracteres equivalente en mayúsculas.
-
-
Copie el binario en una carpeta en
PATH. Si tiene un directorio existente en suPATHque utiliza para utilidades de línea de comandos, copie el binario en ese directorio. De lo contrario, lleve a cabo los pasos que figuran a continuación.-
Cree un nuevo directorio para los binarios de línea de comandos, como
C:\bin. -
Copie el binario
kubectl.exeen el nuevo directorio. -
Edite la variable de entorno
PATHdel usuario o sistema para agregar el nuevo directorio a suPATH. -
Cierre el terminal de PowerShell y abra uno nuevo para obtener la nueva variable
PATH.
-
-
Una vez que instale
kubectl, puede comprobar la versión.kubectl version --client -
Al instalar por primera vez
kubectl, aún no está configurado para comunicarse con ningún servidor. Trataremos esta configuración según sea necesario en otros procedimientos. Si alguna vez necesita actualizar la configuración para comunicarse con un clúster en particular, puede ejecutar el siguiente comando. Reemplaceregion-codepor la región de AWS en la que se encuentra el clúster. Reemplacemy-clusterpor el nombre de su clúster.aws eks update-kubeconfig --region region-code --name my-cluster -
Considere configurar el autocompletado, que le permite usar la tecla de tabulación para completar los subcomandos de
kubectldespués de escribir las primeras letras. Consulte Kubectl autocompleteen la documentación de Kubernetes para obtener más información.
Instalar eksctl
La CLI de eksctl se usa para trabajar con clústeres de EKS. Automatiza muchas tareas individuales. Consulte Instalacióneksctl para obtener instrucciones sobre cómo instalar eksctl. En el caso de Linux, utilice las instrucciones de UNIX.
Al usar eksctl, la entidad principal de seguridad de IAM que está utilizando debe contar con permisos para trabajar con los roles de IAM de Amazon EKS, los roles vinculados al servicio, AWS CloudFormation, además de una VPC y recursos relacionados. Para obtener más información, consulte Acciones y Uso de roles vinculados a servicios en la Guía del usuario de IAM. Debe completar todos los pasos de esta guía como el mismo usuario. Ejecute el siguiente comando para comprobar el usuario actual:
aws sts get-caller-identity