website/content/es/docs/tasks/tools/install-kubectl-macos.md

title	content_type	weight
Instalar y Configurar kubectl en macOS	task	10

{{% heading "prerequisites" %}}

Se debe utilizar la versión de kubectl con la menor diferencia de versión de respecto de su clúster. Por ejemplo, un cliente con versión v{{< skew currentVersion >}} se puede comunicar con los siguientes versiones de plano de control v{{< skew currentVersionAddMinor -1 >}}, v{{< skew currentVersionAddMinor 0 >}}, and v{{< skew currentVersionAddMinor 1 >}}. Utilizar la última versión compatible de kubectl evita posibles errores.

Instalar kubectl en macOS

Existen los siguientes métodos para instalar kubectl en macOS:

• Instalar kubectl en macOS
  • Instalación del binario para macOS con Curl
  • Instalar con Homebrew en macOS
  • Instalar con Macports en macOS
• Verificar la configuración de kubectl
• Configuraciones y plugins opcionales para kubectl
  • Habilitar el autocompletado de la shell
  • Instalar el plugin kubectl convert

Instalación del binario para macOS de kubectl con Curl

1. Descargar la última versión con el siguiente comando:

   {{< tabs name="download_binary_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl" {{< /tab >}} {{< /tabs >}}

   {{< note >}} Para descargar una versión específica, reemplaza la siguiente parte del comando con la versión que deseas instalar $(curl -L -s https://dl.k8s.io/release/stable.txt)

   Por ejemplo, para descargar la versión {{< skew currentPatchVersion >}} en macOS:

   curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/amd64/kubectl"
   

   Para macOS con procesador Apple Silicon, ejecuta:

   curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/arm64/kubectl"
   

   {{< /note >}}

2. Validación del binario (paso opcional)

   Descargar el archivo checksum:

   {{< tabs name="download_checksum_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256" {{< /tab >}} {{< /tabs >}}

   Validar el binario de kubectl contra el archivo checksum:

   echo "$(cat kubectl.sha256)  kubectl" | shasum -a 256 --check
   

   Si es válido, vas a obtener la siguiente respuesta:

   kubectl: OK
   

   En caso de falla, sha256 terminará con un estado diferente a cero con una salida similar a:

   kubectl: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

   {{< note >}} Descargue la misma versión del binario y el checksum. {{< /note >}}

3. Dar permisos de ejecución al binario.

   chmod +x ./kubectl
   

4. Mover el binario de kubectl al PATH de tu sistema.

   sudo mv ./kubectl /usr/local/bin/kubectl
   sudo chown root: /usr/local/bin/kubectl
   

   {{< note >}} Asegúrate que el PATH /usr/local/bin forme parte de las variables de entorno. {{< /note >}}

5. Test para asegurar que la versión instalada está actualizada:

   kubectl version --client
   

   Se puede utilizar lo siguiente para una vista detallada de la versión:

   kubectl version --client --output=yaml
   

6. Luego de instalar el plugin puede eliminar los archivos de instalación:

   rm kubectl kubectl.sha256
   

Instalar utilizando Homebrew en macOS

Si está utilizando Homebrew en macOS, puede instalar kubectl con Homebrew.

1. Ejecute el comando para instalar:

   brew install kubectl
   

   ó

   brew install kubernetes-cli
   

2. Test para asegurar que la versión instalada está actualizada:

   kubectl version --client
   

Instalar con Macports en macOS

Si esta en macOS y utiliza Macports, puedes instalar kubectl con Macports.

1. Ejecute el comando para instalar:

   sudo port selfupdate
   sudo port install kubectl
   

2. Test para asegurar que la versión instalada está actualizada:

   kubectl version --client
   

Verificar la configuración de kubectl

{{< include "included/verify-kubectl.md" >}}

Configuraciones opcionales y plugins de kubectl

Habilitar el autocompletado en la shell

Kubectl tiene soporte para autocompletar en Bash, Zsh, Fish y Powershell, lo que puede agilizar el tipeo.

A continuación están los procedimientos para configurarlo en Bash, Fisch y Zsh.

{{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-mac.md" />}} {{< tab name="Fish" include="included/optional-kubectl-configs-fish.md" />}} {{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}} {{< /tabs >}}

Instalar el plugin kubectl convert

{{< include "included/kubectl-convert-overview.md" >}}

1. Descarga la última versión con el siguiente comando:

   {{< tabs name="download_convert_binary_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert" {{< /tab >}} {{< /tabs >}}

2. Valide el binario (opcional)

   Descargue el checksum de kubectl-convert:

   {{< tabs name="download_convert_checksum_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256" {{< /tab >}} {{< /tabs >}}

   Ahora se puede validar el binario utilizando el checksum:

   echo "$(cat kubectl-convert.sha256)  kubectl-convert" | shasum -a 256 --check
   

   Si es válido, la salida será:

   kubectl-convert: OK
   

   En caso de falla, sha256 terminará con un estado diferente a cero con una salida similar a esta:

   kubectl-convert: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

   {{< note >}} Descargue la misma versión del binario y del checksum. {{< /note >}}

3. Dar permisos de ejecución al binario.

   chmod +x ./kubectl-convert
   

4. Mover el binario de kubectl al PATH de su sistema.

   sudo mv ./kubectl-convert /usr/local/bin/kubectl-convert
   sudo chown root: /usr/local/bin/kubectl-convert
   

   {{< note >}} Asegúrese que el PATH /usr/local/bin forme parte de las variables de entorno. {{< /note >}}

5. Verificar si el plugin fue instalado correctamente

   kubectl convert --help
   

   Si no visualiza ningún error quiere decir que el plugin fue instalado correctamente.

6. Después de instalar el plugin elimine los archivos de instalación:

   rm kubectl-convert kubectl-convert.sha256
   

Eliminar kubectl en macOS

Dependiendo de como haya instalado kubectl puede utilizar uno de los siguientes métodos.

Eliminar kubectl usando la linea de comandos

1. Ubique el binario de kubectl en su sistema:

   which kubectl
   

2. Elimine el binario de kubectl:

   sudo rm <path>
   

   Reemplace <path> con el path que apunta al binario de kubectl del paso anterior. Por ejemplo, sudo rm /usr/local/bin/kubectl

Eliminar kubectl utilizando homebrew

Si instaló kubectl utilizando Homebrew ejecute el siguiente comando:

brew remove kubectl

{{% heading "whatsnext" %}}

{{< include "included/kubectl-whats-next.md" >}}