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.35 puede comunicarse con versiones v1.34, v1.35, y v1.36 del plano de control.
El uso de la última versión de kubectl ayuda a evitar problemas imprevistos.
Existen los siguientes métodos para instalar kubectl en Windows:
Tiene dos opciones para instalar kubectl en su dispositivo Windows:
Descarga directa: Descargue la última versión 1.35.0 del binario directamente según tu arquitectura visitando Kubernetes release page. Asegúrese de seleccionar el binario correcto para tu arquitectura (e.g., amd64, arm64, etc.).
Usando curl:
Si tiene curl instalado, use este comando:
curl.exe -LO https://dl.k8s.io/release/v1.35.0/bin/windows/amd64/kubectl.exe
Validar el binario (opcional)
Descargue el archivo de comprobación de kubectl:
curl.exe -LO https://dl.k8s.io/v1.35.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:
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:
$(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256)
Agregue el binario kubectl a su PATH en las variables de entorno.
Para asegurar que la versión de kubectl es la misma que descargada, ejecute:
kubectl version --client
O para una vista detallada de la versión, ejecute:
kubectl version --client --output=yaml
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.Para instalar kubectl en Windows puede usar el gestor de paquetes Chocolatey, el instalador por línea de comandos Scoop o el gestor de paquetes winget.
choco install kubernetes-cli
scoop install kubectl
winget install -e --id Kubernetes.kubectl
Para asegurarse de que la versión que instaló esté actualizada, ejecute:
kubectl version --client
Navegue a su directorio de inicio:
# Si estás usando cmd.exe, correr: cd %USERPROFILE%
cd ~
Cree el directorio .kube:
mkdir .kube
Cambie al directorio .kube que acaba de crear:
cd .kube
Configure kubectl para usar un clúster de Kubernetes remoto:
New-Item config -type file
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
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.
kubectl-convertDescargue la última versión con el comando:
curl.exe -LO "https://dl.k8s.io/release/v1.35.0/bin/windows/amd64/kubectl-convert.exe"
Validar el binario (opcional)
Descargue el archivo de comprobación kubectl-convert:
curl.exe -LO "https://dl.k8s.io/v1.35.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:
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:
$($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)
Agregue el binario a su PATH.
Verifique que el plugin se haya instalado correctamente
kubectl convert --help
Si no ve un error, significa que el plugin se instaló correctamente.
Después de instalar el plugin, elimine los archivos de instalación:
del kubectl-convert.exe
del kubectl-convert.exe.sha256