Instalar y Configurar kubectl

Usa la herramienta de línea de comandos de Kubernetes, kubectl, para desplegar y gestionar aplicaciones en Kubernetes. Usando kubectl, puedes inspeccionar recursos del clúster; crear, eliminar, y actualizar componentes; explorar tu nuevo clúster; y arrancar aplicaciones de ejemplo. Para ver la lista completa de operaciones de kubectl, se puede ver el resumen de kubectl.

Antes de empezar

Debes usar una versión de kubectl que esté a menos de una versión menor de diferencia con tu clúster. Por ejemplo, un cliente v1.2 debería funcionar con un máster v1.1, v1.2, y v1.3. Usar la última versión de kubectl ayuda a evitar problemas inesperados.

Instalar kubectl en Linux

Instalar el binario de kubectl con curl en Linux

1. Descargar la última entrega:

   curl -LO "https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl"
   

Para descargar una versión específica, remplaza el comando $(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt) con la versión específica.

Por ejemplo, para descarga la versión v1.20.15 en Linux, teclea:

```
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.15/bin/linux/amd64/kubectl
```

2. Habilita los permisos de ejecución del binario kubectl.

   chmod +x ./kubectl
   

3. Mueve el binario dentro de tu PATH.

   sudo mv ./kubectl /usr/local/bin/kubectl
   

4. Comprueba que la versión que se ha instalado es la más reciente.

   kubectl version --client
   

Instalar mediante el gestor de paquetes del sistema

• Ubuntu, Debian or HypriotOS
• CentOS, RHEL or Fedora

sudo apt-get update && sudo apt-get install -y apt-transport-https gnupg2 curl
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
sudo apt-get install -y kubectl

cat <<EOF > /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
yum install -y kubectl

Instalar usando otro gestor de paquetes

• Snap
• Homebrew

snap install kubectl --classic

kubectl version --client

brew install kubectl

kubectl version --client

Instalar kubectl en macOS

Instalar el binario de kubectl usando curl en macOS

1. Descarga la última entrega:

   curl -LO "https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl"
   

   Para descargar una versión específica, remplaza el comando $(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt) con la versión específica.

   Por ejemplo, para descargar la versión v1.20.15 en macOS, teclea:

 curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.15/bin/darwin/amd64/kubectl

2. Habilita los permisos de ejecución del binario kubectl.

   chmod +x ./kubectl
   

3. Mueve el binario dentro de tu PATH.

   sudo mv ./kubectl /usr/local/bin/kubectl
   

4. Para asegurar que la versión utilizada sea la más actual puedes probar:

   kubectl version --client
   

Instalar con Homebrew en macOS

Si estás usando macOS y el gestor de paquetes es Homebrew, puedes instalar kubectl con brew.

1. Ejecuta el comando de instalación:

   brew install kubectl
   

   o

   brew install kubernetes-cli
   

2. Para asegurar que la versión utilizada sea la más actual, puedes ejecutar:

   kubectl version --client
   

Instalar con Macports en macOS

Si estás en macOS y utilizas el gestor de paquetes Macports, puedes instalar kubectl con port.

1. Ejecuta los comandos de instalación:

   sudo port selfupdate
   sudo port install kubectl
   

2. Para asegurar que la versión utilizada sea la más actual puedes ejecutar:

   kubectl version --client
   

Instalar kubectl en Windows

Instalar el binario de kubectl con curl en Windows

1. Descargar la última entrega v1.20.15 de [este link]((https://storage.googleapis.com/kubernetes-release/release/v1.20.15/bin/windows/amd64/kubectl.exe).

   o si tiene curl instalada, utiliza este comando:

   curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.20.15/bin/windows/amd64/kubectl.exe
   

   Para averiguar la última versión estable (por ejemplo, para secuencias de comandos), echa un vistazo a https://storage.googleapis.com/kubernetes-release/release/stable.txt.

2. Añade el binario a tu PATH.

3. Para asegurar que la versión utilizada sea la más actual, puedes ejecutar:

   kubectl version --client
   

Nota:

Docker Desktop para Windows añade su propia versión de kubectl a PATH.

Si tienes Docker Desktop instalado, es posible que tengas que modificar tu PATH al PATH añadido por Docker Desktop o eliminar la versión de kubectl proporcionada por Docker Desktop.

Instalar con Powershell desde PSGallery

Si estás en Windows y utilizas el gestor de paquetes Powershell Gallery, puedes instalar y actualizar kubectl con Powershell.

1. Ejecuta los comandos de instalación (asegurándote de especificar una DownloadLocation):

   Install-Script -Name 'install-kubectl' -Scope CurrentUser -Force
   install-kubectl.ps1 [-DownloadLocation <path>]
   

   Nota: Si no especificas una DownloadLocation, kubectl se instalará en el directorio temporal del usuario.

   El instalador crea $HOME/.kube y crea un archivo de configuración

2. Para asegurar que la versión utilizada sea la más actual puedes probar:

   kubectl version --client
   

Nota: Actualizar la instalación se realiza mediante la re-ejecución de los dos comandos listados en el paso 1.

Instalar en Windows usando Chocolatey o scoop

1. Para instalar kubectl en Windows puedes usar el gestor de paquetes Chocolatey o el instalador de línea de comandos scoop.

   • choco
   • scoop

   Using Chocolatey.

   ```powershell
   choco install kubernetes-cli
   ```
   

   Using scoop.

   ```powershell
   scoop install kubectl
   ```
   

2. Para asegurar que la versión utilizada sea la más actual puedes probar:

   kubectl version --client
   

3. Navega a tu directorio de inicio:

   # Si estas usando cmd.exe, ejecuta: cd %USERPROFILE%
   cd ~
   

4. Crea el directorio .kube:

   mkdir .kube
   

5. Cambia al directorio .kube que acabas de crear:

   cd .kube
   

6. Configura kubectl para usar un clúster remoto de Kubernetes:

   New-Item config -type file
   

Nota: Edita el fichero de configuración con un editor de texto de tu elección, como Notepad.

Descarga como parte del Google Cloud SDK

Puedes instalar kubectl como parte del Google Cloud SDK.

1. Instala el Google Cloud SDK.

2. Ejecuta el comando de instalación de kubectl:

   gcloud components install kubectl
   

3. Para asegurar que la versión utilizada sea la más actual puedes probar:

   kubectl version --client
   

Comprobar la configuración kubectl

Para que kubectl pueda encontrar y acceder a un clúster de Kubernetes, necesita un fichero kubeconfig, que se crea de forma automática cuando creas un clúster usando kube-up.sh o despliegas de forma satisfactoria un clúster de Minikube. Revisa las guías para comenzar para más información acerca de crear clústers. Si necesitas acceso a un clúster que no has creado, ver el documento de Compartir Acceso a un Clúster. Por defecto, la configuración de kubectl se encuentra en ~/.kube/config.

Comprueba que kubectl está correctamente configurado obteniendo el estado del clúster:

kubectl cluster-info

Si ves una respuesta en forma de URL, kubectl está correctamente configurado para acceder a tu clúster.

Si ves un mensaje similar al siguiente, kubectl no está correctamente configurado o no es capaz de conectar con 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 intentas ejecutar un clúster de Kubernetes en tu portátil (localmente), necesitarás una herramienta como minikube que esté instalada primero y entonces volver a ejecutar los comandos indicados arriba.

Si kubectl cluster-info devuelve la respuesta en forma de url, pero no puedes acceder a tu clúster, para comprobar si está configurado adecuadamente, usa:

kubectl cluster-info dump

kubectl configuraciones opcionales

Habilitar el auto-completado en el intérprete de comandos

kubectl provee de soporte para auto-completado para Bash y Zsh, ¡que te puede ahorrar mucho uso del teclado!

Abajo están los procedimientos para configurar el auto-completado para Bash (incluyendo la diferencia entre Linux y macOS) y Zsh.

• Bash en Linux
• Bash en macOS
• Zsh

source /usr/share/bash-completion/bash_completion

echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -F __start_kubectl k' >>~/.bashrc

echo $BASH_VERSION

brew install bash

echo $BASH_VERSION $SHELL

brew install bash-completion@2

export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"

source <(kubectl completion zsh)

echo 'alias k=kubectl' >>~/.zshrc
echo 'complete -F __start_kubectl k' >>~/.zshrc

autoload -Uz compinit
compinit

Siguientes pasos

• Instalar Minikube
• Ver las guías para ver mas información sobre como crear clusteres.
• Aprender cómo lanzar y exponer tu aplicación..
• Si necesita acceso a un clúster que no se creó, ver el documento de compartiendo acceso a clúster.
• Leer ´la documentación de kubectl reference](/docs/reference/kubectl/kubectl/)