Merge pull request #44325 from gamba47/41883

[es] localize content/en/docs/tasks/tools/install-kubectl-macos.md to Spanish

Author: k8s-ci-robot

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

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 <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:
+
+```bash
+brew remove kubectl
+```
+  
+## {{% heading "whatsnext" %}}
+
+{{< include "included/kubectl-whats-next.md" >}}