# Instalar y configurar kubectl en Windows LLMS index: [llms.txt](/llms.txt) --- ## Antes de empezar Debes usar una versión de kubectl que esté dentro de una diferencia de versión menor de tu clúster. Por ejemplo, un cliente v1.36 puede comunicarse con versiones v1.35, v1.36, y v1.37 del plano de control. El uso de la última versión de kubectl ayuda a evitar problemas imprevistos. ## Instalar kubectl en Windows Existen los siguientes métodos para instalar kubectl en Windows: - [Instalar el binario de kubectl con curl en Windows](#install-kubectl-binary-with-curl-on-windows) - [Instalar en Windows usando Chocolatey, Scoop o winget](#install-on-windows-using-chocolatey-o-scoop) ### Instalar el binario de kubectl en Windows (mediante descarga directa o usando curl) 1. Tiene dos opciones para instalar kubectl en su dispositivo Windows: - Descarga directa: Descargue la última versión 1.36.0 del binario directamente según tu arquitectura visitando [Kubernetes release page](https://kubernetes.io/releases/download/#binaries). Asegúrese de seleccionar el binario correcto para tu arquitectura (e.g., amd64, arm64, etc.). - Usando curl: Si tiene `curl` instalado, use este comando: ```powershell curl.exe -LO https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl.exe ```

Nota:

Para conocer la última versión estable (por ejemplo, para secuencias de comandos), eche un vistazo a https://dl.k8s.io/release/stable.txt.
2. Validar el binario (opcional) Descargue el archivo de comprobación de kubectl: ```powershell curl.exe -LO https://dl.k8s.io/v1.36.0/bin/windows/amd64/kubectl.exe.sha256 ``` Valide el binario kubectl con el archivo de comprobación: - Usando la consola del sistema para comparar manualmente la salida de `CertUtil` con el archivo de comprobación descargado: ```cmd CertUtil -hashfile kubectl.exe SHA256 type kubectl.exe.sha256 ``` - Usando PowerShell puede automatizar la verificación usando el operador `-eq` para obtener un resultado de `True` o `False`: ```powershell $(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256) ``` 3. Agregue el binario `kubectl` a su `PATH` en las variables de entorno. 4. Para asegurar que la versión de `kubectl` es la misma que descargada, ejecute: ```cmd kubectl version --client ``` O para una vista detallada de la versión, ejecute: ```cmd kubectl version --client --output=yaml ```

Nota:

Docker Desktop para Windows agrega su propia versión de kubectl al PATH. Si ha instalado Docker Desktop antes, es posible que deba colocar su entrada del PATH antes de la agregada por el instalador de Docker Desktop o elimine el kubectl de Docker Desktop.
### Instalar en Windows usando Chocolatey, Scoop o winget {#install-nonstandard-package-tools} 1. Para instalar kubectl en Windows puede usar el gestor de paquetes [Chocolatey](https://chocolatey.org), el instalador por línea de comandos [Scoop](https://scoop.sh) o el gestor de paquetes [winget](https://docs.microsoft.com/en-us/windows/package-manager/winget/). 
choco install kubernetes-cli

scoop install kubectl

winget install -e --id Kubernetes.kubectl
2. Para asegurarse de que la versión que instaló esté actualizada, ejecute: ```powershell kubectl version --client ``` 3. Navegue a su directorio de inicio: ```powershell # Si estás usando cmd.exe, correr: cd %USERPROFILE% cd ~ ``` 4. Cree el directorio `.kube`: ```powershell mkdir .kube ``` 5. Cambie al directorio `.kube` que acaba de crear: ```powershell cd .kube ``` 6. Configure kubectl para usar un clúster de Kubernetes remoto: ```powershell New-Item config -type file ```

Nota:

Edite el archivo de configuración con un editor de texto de su elección, como el Bloc de notas.
## Verificar la configuración de kubectl

Para que kubectl encuentre y acceda a un clúster de Kubernetes, necesita un archivo kubeconfig, que se crea automáticamente cuando creas un clúster usando kube-up.sh o implementar con éxito un clúster de Minikube. De forma predeterminada, la configuración de kubectl se encuentra en ~/.kube/config.

Verifique que kubectl esté configurado correctamente obteniendo el estado del clúster:

kubectl cluster-info

Si ve una respuesta de URL, kubectl está configurado correctamente para acceder a su clúster.

Si ve un mensaje similar al siguiente, kubectl no está configurado correctamente o no puede conectarse a un clúster de Kubernetes.

The connection to the server <server-name:port> was refused - did you specify the right host or port?

Por ejemplo, si tiene la intención de ejecutar un clúster de Kubernetes en su computadora portátil (localmente), primero necesitará instalar una herramienta como Minikube y luego volver a ejecutar los comandos indicados anteriormente.

Si kubectl cluster-info devuelve la respuesta de la URL pero no puede acceder a su clúster, para verificar si está configurado correctamente, use:

kubectl cluster-info dump
## Plugins y configuraciones opcionales de kubectl ### Habilitar el autocompletado de shell kubectl proporciona soporte de autocompletado para Bash, Zsh, Fish, y PowerShell, lo que puede ahorrarle mucho tiempo de escritura. A continuación se muestran los procedimientos para configurar el autocompletado para PowerShell.

El script de autocompletado de kubectl para PowerShell se puede generar con el comando kubectl completion powershell.

Para hacerlo en todas tus sesiones de shell, agrega la siguiente línea a tu archivo $PROFILE:

kubectl completion powershell | Out-String | Invoke-Expression

Este comando agregará el script de autocompletado en cada sesión de PowerShell. También puedes añadir el script generado directamente en tu archivo $PROFILE.

Para agregar el script generado a tu archivo $PROFILE, ejecute el siguiente comando en el prompt de tu PowerShell:

kubectl completion powershell >> $PROFILE

Después de recargar tu shell, el autocompletado de kubectl debería funcionar.

### Instalar el plugin `kubectl-convert` 1. Descargue la última versión con el comando: ```powershell curl.exe -LO "https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl-convert.exe" ``` 2. Validar el binario (opcional) Descargue el archivo de comprobación `kubectl-convert`: ```powershell curl.exe -LO "https://dl.k8s.io/v1.36.0/bin/windows/amd64/kubectl-convert.exe.sha256" ``` Valide el binario `kubectl-convert` con el archivo de comprobación: - Usando la consola del sistema puede comparar manualmente la salida de `CertUtil` con el archivo de comprobación descargado: ```cmd CertUtil -hashfile kubectl-convert.exe SHA256 type kubectl-convert.exe.sha256 ``` - Usando PowerShell puede automatizar la verificación usando el operador `-eq` para obtener un resultado de `True` o `False`: ```powershell $($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256) ``` 3. Agregue el binario a su `PATH`. 4. Verifique que el plugin se haya instalado correctamente ```shell kubectl convert --help ``` Si no ve un error, significa que el plugin se instaló correctamente. 5. Después de instalar el plugin, elimine los archivos de instalación: ```powershell del kubectl-convert.exe del kubectl-convert.exe.sha256 ``` ## ¿Qué sigue?