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

reviewers	title	content_type	weight	card
	Instalar y configurar kubectl en macOS	task	10	name weight title tasks 20 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
• Instalar con Homebrew en macOS
• Instalar con Macports en 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:

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

   Y para macOS en Apple Silicon, escriba:

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

   {{< /note >}}

2. 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:

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

   Si es válido, la salida es:

   kubectl: OK
   

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

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

3. Hacer ejecutable el binario de kubectl.

   chmod +x ./kubectl
   

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

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

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

   kubectl version --client
   

Instalar con Homebrew en macOS

Si está en macOS y usa Homebrew como administrador de paquetes, puede instalar kubectl con Homebrew.

1. Ejecute el comando de instalación:

   brew install kubectl 
   

   or

   brew install kubernetes-cli
   

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

   kubectl version --client
   

Instalar con Macports en macOS

Si está en macOS y usa Macports como administrador de paquetes, puede instalar kubectl con Macports.

1. Ejecute el comando de instalación:

   sudo port selfupdate
   sudo port install kubectl
   

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

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

2. 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:

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

   Si es válido, la salida es:

   kubectl-convert: OK
   

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

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

3. Hacer ejecutable el binario de kubectl-convert

   chmod +x ./kubectl-convert
   

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

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

5. Verifique que el complemento se haya instalado correctamente

   kubectl convert --help
   

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

{{% heading "whatsnext" %}}

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