---
reviewers:
title: Instalar y configurar kubectl en macOS
content_type: task
weight: 10
card:
  name: tasks
  weight: 20
  title: Instalar kubectl en macOS
---

## {{% heading "prerequisites" %}}

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 v{{< skew latestVersion >}} puede comunicarse con v{{< skew prevMinorVersion >}}, v{{< skew latestVersion >}}, y v{{< skew nextMinorVersion >}} del plano de control.
El uso de la última versión de kubectl ayuda a evitar problemas imprevistos.

## Instalar kubectl en macOS

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

- [Instalar el binario de kubectl con curl en macOS](#install-kubectl-binary-with-curl-on-macos)
- [Instalar con Homebrew en macOS](#install-with-homebrew-on-macos)
- [Instalar con Macports en macOS](#install-with-macports-on-macos)

### Instalar el binario de kubectl con curl en macOS

1. Descargue la última versión:

   {{< 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, reemplace el `$(curl -L -s https://dl.k8s.io/release/stable.txt)` parte del comando con la versión específica.

   Por ejemplo, para descargar la versión {{< param "fullversion" >}} en Intel macOS, escriba:

   ```bash
   curl -LO "https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/darwin/amd64/kubectl"
   ```

   Y para macOS en Apple Silicon, escriba:

   ```bash
   curl -LO "https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/darwin/arm64/kubectl"
   ```

   {{< /note >}}

1. Validar el binario (opcional)

   Descargue el archivo de comprobación de kubectl:

   {{< 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 >}}

   Valide el binario kubectl con el archivo de comprobación:

   ```bash
   echo "$(<kubectl.sha256)  kubectl" | shasum -a 256 --check
   ```

   Si es válido, la salida es:

   ```console
   kubectl: OK
   ```

   Si la verificación falla, `shasum` arroja un valor distinto de cero e imprime una salida similar a:

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

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

1. Hacer ejecutable el binario de kubectl.

   ```bash
   chmod +x ./kubectl
   ```

1. Mueva el binario kubectl a una ubicación de archivo en su sistema `PATH`.

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

   {{< note >}}
   Asegúrese de que `/usr/local/bin` se encuentre definida en su variable de entorno PATH.
   {{< /note >}}

1. Para asegurarse de que la versión que instaló se encuentra actualizada, ejecute:

   ```bash
   kubectl version --client
   ```

### Instalar con Homebrew en macOS

Si está en macOS y usa [Homebrew](https://brew.sh/) como administrador de paquetes, puede instalar kubectl con Homebrew.

1. Ejecute el comando de instalación:

   ```bash
   brew install kubectl 
   ```

   or

   ```bash
   brew install kubernetes-cli
   ```

1. Para asegurarse de que la versión que instaló se encuentra actualizada, ejecute:

   ```bash
   kubectl version --client
   ```

### Instalar con Macports en macOS

Si está en macOS y usa [Macports](https://macports.org/) como administrador de paquetes, puede instalar kubectl con Macports.

1. Ejecute el comando de instalación:

   ```bash
   sudo port selfupdate
   sudo port install kubectl
   ```

1. Para asegurarse de que la versión que instaló se encuentra actualizada, ejecute:

   ```bash
   kubectl version --client
   ```

## Verificar la configuración de kubectl

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

## Plugins y configuraciones opcionales de kubectl

### Habilitar el autocompletado de shell

kubectl proporciona soporte de autocompletado para Bash y Zsh, lo que puede ahorrarle mucho tiempo al escribir.

A continuación, se muestran los procedimientos para configurar el autocompletado para Bash y Zsh.

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

### Instalar el plugin `kubectl-convert`

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

1. Descargue la última versión con el 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 >}}

1. Validar el binario (opcional)

   Descargue el archivo de comprobación de kubectl:

   {{< 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 >}}

   Valide el binario kubectl-convert con el archivo de comprobación:

   ```bash
   echo "$(<kubectl-convert.sha256)  kubectl-convert" | shasum -a 256 --check
   ```

   Si es válido, la salida es:

   ```console
   kubectl-convert: OK
   ```

   Si la verificación falla, `shasum` arroja un valor distinto de cero e imprime una salida similar a:

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

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

1. Hacer ejecutable el binario de kubectl-convert

   ```bash
   chmod +x ./kubectl-convert
   ```

1. Mueva el binario kubectl-convert a una ubicación de archivo en su sistema `PATH`.

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

   {{< note >}}
   Asegúrese de que `/usr/local/bin` se encuentre definida en su variable de entorno PATH.
   {{< /note >}}

1. Verifique que el complemento se haya instalado correctamente

   ```shell
   kubectl convert --help
   ```

   Si no ve algun error, significa que el complemento se instaló correctamente.

## {{% heading "whatsnext" %}}

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