diff --git a/content/es/docs/tasks/tools/included/optional-kubectl-configs-fish.md b/content/es/docs/tasks/tools/included/optional-kubectl-configs-fish.md index a23b3dcbc37b3..dcac17b4844db 100644 --- a/content/es/docs/tasks/tools/included/optional-kubectl-configs-fish.md +++ b/content/es/docs/tasks/tools/included/optional-kubectl-configs-fish.md @@ -1,6 +1,6 @@ --- -title: "autocompletado con fish" -description: "Configuración opcional para habilitar el autocompletado en la shell fish." +title: "Autocompletado con Fish" +description: "Configuración opcional para habilitar el autocompletado de la shell Fish" headless: true _build: list: never @@ -9,12 +9,12 @@ _build: --- {{< note >}} -El autocompletado para Fish necesita de kubectl versión 1.23 o superior. +Se requiere kubectl 1.23 o superior para utilizar el autocompletado de Fish. {{< /note >}} -El script de autocompletado de Fish para kubectl puede ser generado con el comando `kubectl completion fish`. Ejecutando este comando en tu shell habilitará el autocompletado de kubectl para Fish. +El script de autocompletado de Fish puede ser generado con el comando `kubectl completion fish`. Leyendo este archivo en su Shell habilita el autocompletado de kubectl. -Para qué funcione en sus futuras sesiones shell, debes agregar la siguiente línea al archivo `~/.config/fish/config.fish`: +Para hacer esto en todas sus sesiones agregue la siguiente linea a su archivo `~/.config/fish/config.fish`: ```shell kubectl completion fish | source diff --git a/content/es/docs/tasks/tools/install-kubectl-macos.md b/content/es/docs/tasks/tools/install-kubectl-macos.md new file mode 100644 index 0000000000000..82fcdf6916f27 --- /dev/null +++ b/content/es/docs/tasks/tools/install-kubectl-macos.md @@ -0,0 +1,301 @@ +--- +title: Instalar y Configurar kubectl en macOS +content_type: task +weight: 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](#instalar-kubectl-en-macos) + - [Instalación del binario para macOS con Curl](#instalación-del-binario-para-macos-de-kubectl-con-curl) + - [Instalar con Homebrew en macOS](#instalar-utilizando-homebrew-en-macos) + - [Instalar con Macports en macOS](#instalar-con-macports-en-macos) +- [Verificar la configuración de kubectl](#verificar-la-configuración-de-kubectl) +- [Configuraciones y plugins opcionales para kubectl](#configuraciones-opcionales-y-plugins-de-kubectl) + - [Habilitar el autocompletado de la shell](#habilitar-el-autocompletado-en-la-shell) + - [Instalar el plugin `kubectl convert`](#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: + + ```bash + curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/amd64/kubectl" + ``` + + Para macOS con procesador Apple Silicon, ejecuta: + + ```bash + curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/arm64/kubectl" + ``` + + {{< /note >}} + +1. 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: + + ```bash + echo "$(cat kubectl.sha256) kubectl" | shasum -a 256 --check + ``` + + Si es válido, vas a obtener la siguiente respuesta: + + ```console + kubectl: OK + ``` + + En caso de falla, `sha256` terminará con un estado diferente a cero con una salida similar a: + + ```console + kubectl: FAILED + shasum: WARNING: 1 computed checksum did NOT match + ``` + + {{< note >}} + Descargue la misma versión del binario y el checksum. + {{< /note >}} + +1. Dar permisos de ejecución al binario. + + ```bash + chmod +x ./kubectl + ``` + +1. Mover el binario de kubectl al `PATH` de tu sistema. + + ```bash + 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 >}} + +1. Test para asegurar que la versión instalada está actualizada: + + ```bash + kubectl version --client + ``` + + Se puede utilizar lo siguiente para una vista detallada de la versión: + + ```cmd + kubectl version --client --output=yaml + ``` + +1. Luego de instalar el plugin puede eliminar los archivos de instalación: + + ```bash + rm kubectl kubectl.sha256 + ``` + +### Instalar utilizando Homebrew en macOS + +Si está utilizando [Homebrew](https://brew.sh/) en macOS, +puede instalar kubectl con Homebrew. + +1. Ejecute el comando para instalar: + + ```bash + brew install kubectl + ``` + + ó + + ```bash + brew install kubernetes-cli + ``` + +1. Test para asegurar que la versión instalada está actualizada: + + ```bash + kubectl version --client + ``` + +### Instalar con Macports en macOS + +Si esta en macOS y utiliza [Macports](https://macports.org/), +puedes instalar kubectl con Macports. + +1. Ejecute el comando para instalar: + + ```bash + sudo port selfupdate + sudo port install kubectl + ``` + +1. Test para asegurar que la versión instalada está actualizada: + + ```bash + 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 >}} + +1. 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: + + ```bash + echo "$(cat kubectl-convert.sha256) kubectl-convert" | shasum -a 256 --check + ``` + + Si es válido, la salida será: + + ```console + kubectl-convert: OK + ``` + + En caso de falla, `sha256` terminará con un estado diferente a cero con una salida similar a esta: + + ```console + kubectl-convert: FAILED + shasum: WARNING: 1 computed checksum did NOT match + ``` + + {{< note >}} + Descargue la misma versión del binario y del checksum. + {{< /note >}} + +1. Dar permisos de ejecución al binario. + + ```bash + chmod +x ./kubectl-convert + ``` + +1. Mover el binario de kubectl al `PATH` de su sistema. + + ```bash + 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 >}} + +1. Verificar si el plugin fue instalado correctamente + + ```shell + kubectl convert --help + ``` + + Si no visualiza ningún error quiere decir que el plugin fue instalado correctamente. + +1. Después de instalar el plugin elimine los archivos de instalación: + + ```bash + 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: + + ```bash + which kubectl + ``` + +1. Elimine el binario de `kubectl`: + + ```bash + sudo rm + ``` + Reemplace `` 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: + +```bash +brew remove kubectl +``` + +## {{% heading "whatsnext" %}} + +{{< include "included/kubectl-whats-next.md" >}}