From bdbc808d3cea85c5017cdd02a6c40df632befe33 Mon Sep 17 00:00:00 2001
From: Enrique Medina Montenegro <enrique@medinamontenegro.es>
Date: Sun, 7 Apr 2019 16:54:53 +0200
Subject: [PATCH] Spanish translation

---
 .../es/docs/tasks/tools/install-kubectl.md    | 430 ++++++++++++++++++
 1 file changed, 430 insertions(+)
 create mode 100644 content/es/docs/tasks/tools/install-kubectl.md

diff --git a/content/es/docs/tasks/tools/install-kubectl.md b/content/es/docs/tasks/tools/install-kubectl.md
new file mode 100644
index 0000000000000..2dfaa96f4c444
--- /dev/null
+++ b/content/es/docs/tasks/tools/install-kubectl.md
@@ -0,0 +1,430 @@
+---
+reviewers:
+- bgrant0607
+- mikedanese
+title: Instalar y Configurar kubectl
+content_template: templates/task
+weight: 10
+card:
+  name: tasks
+  weight: 20
+  title: Instalar kubectl
+---
+
+{{% capture overview %}}
+Usa la herramienta de línea de comandos de Kubernetes, [kubectl](/docs/user-guide/kubectl/), para desplegar y gestionar aplicaciones en Kubernetes. Usando kubectl, puedes inspeccionar recursos del clúster; crear, eliminar, y actualizar componentes; mirar tu nuevo clúster; y arrancar aplicaciones de ejemplo.
+{{% /capture %}}
+
+{{% capture prerequisites %}}
+Debes usar una versión de kubectl que esté a menos de una versión menor de diferencia con tu clúster. Por ejemplo, un cliente v1.2 debería funcionar con un máster v1.1, v1.2, y v1.3. Usar la última versión de kubectl ayuda a evitar problemas inesperados.
+{{% /capture %}}
+
+
+{{% capture steps %}}
+
+## Instalar kubectl
+
+Aquí hay unos pocos métodos para instalar kubectl.
+
+## Instalar el binario de kubectl usando gestión nativa de paquetes
+
+{{< tabs name="kubectl_install" >}}
+{{< tab name="Ubuntu, Debian o HypriotOS" codelang="bash" >}}
+sudo apt-get update && sudo apt-get install -y apt-transport-https
+curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
+echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list
+sudo apt-get update
+sudo apt-get install -y kubectl
+{{< /tab >}}
+{{< tab name="CentOS, RHEL o Fedora" codelang="bash" >}}cat <<EOF > /etc/yum.repos.d/kubernetes.repo
+[kubernetes]
+name=Kubernetes
+baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
+enabled=1
+gpgcheck=1
+repo_gpgcheck=1
+gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
+EOF
+yum install -y kubectl
+{{< /tab >}}
+{{< /tabs >}}
+
+
+## Instalar con snap en Ubuntu
+
+Si estás en Ubuntu o alguna de las otras distribuciones de Linux que soportan el gestor de paquetes [snap](https://snapcraft.io/docs/core/install), kubectl está disponible como una aplicación [snap](https://snapcraft.io/).
+
+1. Cambia al usuario de snap y ejecuta el comando de instalación:
+
+    ```
+    sudo snap install kubectl --classic
+    ```
+
+2. Prueba para asegurar que la versión que has instalado está suficientemente actualizada (puesta al día):
+
+    ```
+    kubectl version
+    ```
+
+## Instalar con Homebrew en macOS
+
+Si estás en macOS y usando el gestor de paquetes [Homebrew](https://brew.sh/), puedes instalar kubectl con Homebrew.
+
+1. Ejecuta el comando de instalación:
+
+    ```
+    brew install kubernetes-cli
+    ```
+
+2. Prueba para asegurar que la versión que has instalado está suficientemente actualizada (puesta al día):
+
+    ```
+    kubectl version
+    ```
+
+## Instalar con Macports en macOS
+
+Si estás en macOS y usando el gestor de paquetes [Macports](https://macports.org/), puedes instalar kubectl con Macports.
+
+1. Ejecuta los comandos de instalación:
+
+    ```
+    sudo port selfupdate
+    sudo port install kubectl
+    ```
+    
+2. Prueba para asegurar que la versión que has instalado está suficientemente actualizada (puesta al día):
+
+    ```
+    kubectl version
+    ```
+
+## Instalar con Powershell desde PSGallery
+
+Si estás en Windows y usando el gestor de paquetes [Powershell Gallery](https://www.powershellgallery.com/), puedes instalar y actualizar kubectl con Powershell.
+
+1. Ejecuta los comandos de instalación (asegurándote de especificar una `DownloadLocation`):
+
+    ```
+    Install-Script -Name install-kubectl -Scope CurrentUser -Force
+    install-kubectl.ps1 [-DownloadLocation <path>]
+    ```
+    
+    {{< note >}}Si no especificas una `DownloadLocation`, `kubectl` se instalará en el dicrectorio temporal del usuario.{{< /note >}}
+    
+    El instalador crea `$HOME/.kube` e instruye a crear un fichero de configuración
+
+2. Prueba para asegurar que la versión que has instalado está suficientemente actualizada (puesta al día):
+
+    ```
+    kubectl version
+    ```
+
+    {{< note >}}Actualizar la instalación se realiza mediante la re-ejecución de los dos comandos listados en el paso 1.{{< /note >}}
+
+## Instalar en Windows usando Chocolatey o scoop
+
+Para instalar kubectl en Windows puedes usar bien el gestor de paquetes [Chocolatey](https://chocolatey.org) o el instalador de línea de comandos [scoop](https://scoop.sh).
+{{< tabs name="kubectl_win_install" >}}
+{{% tab name="choco" %}}
+
+    choco install kubernetes-cli
+
+{{% /tab %}}
+{{% tab name="scoop" %}}
+
+    scoop install kubectl
+
+{{% /tab %}}
+{{< /tabs >}}
+2. Prueba para asegurar que la versión que has instalado está suficientemente actualizada (puesta al día):
+
+    ```
+    kubectl version
+    ```
+
+3. Navega a tu directorio de inicio:
+
+    ```
+    cd %USERPROFILE%
+    ```
+4. Crea el directorio `.kube`:
+
+    ```
+    mkdir .kube
+    ```
+
+5. Cambia al directorio `.kube` que acabas de crear:
+
+    ```
+    cd .kube
+    ```
+
+6. Configura kubectl para usar un clúster remoto de Kubernetes:
+
+    ```
+    New-Item config -type file
+    ```
+    
+    {{< note >}}Edita el fichero de configuración con un editor de texto de tu elección, como Notepad.{{< /note >}}
+
+## Descarga como parte del Google Cloud SDK
+
+Puedes instalar kubectl como parte del Google Cloud SDK.
+
+1. Instala el [Google Cloud SDK](https://cloud.google.com/sdk/).
+2. Ejecuta el comando de instalación de `kubectl`:
+
+    ```
+    gcloud components install kubectl
+    ```
+    
+3. Prueba para asegurar que la versión que has instalado está suficientemente actualizada (puesta al día):
+
+    ```
+    kubectl version
+    ```
+
+## Instalar el binario de kubectl usando curl
+
+{{< tabs name="kubectl_install_curl" >}}
+{{% tab name="macOS" %}}
+1. Descarga la última entrega:
+
+    ```		 
+    curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl
+    ```
+
+    Para descargar una versión específica, remplaza el trozo del comando `$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)` con la versión específica.
+
+    Por ejemplo, para descargar la versión {{< param "fullversion" >}} en macOS, teclea:
+		  
+    ```
+    curl -LO https://storage.googleapis.com/kubernetes-release/release/{{< param "fullversion" >}}/bin/darwin/amd64/kubectl
+    ```
+
+2. Haz el binario de kubectl ejecutable.
+
+    ```
+    chmod +x ./kubectl
+    ```
+
+3. Mueve el binario dentro de tu PATH.
+
+    ```
+    sudo mv ./kubectl /usr/local/bin/kubectl
+    ```
+{{% /tab %}}
+{{% tab name="Linux" %}}
+
+1. Descarga la última entrega con el comando:
+
+    ```
+    curl -LO https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl
+    ```
+
+    Para descargar una versión específica, remplaza el trozo del comando `$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)` con la versión específica.
+
+    Por ejemplo, para descargar la versión {{< param "fullversion" >}} en Linux, teclea:
+    
+    ```
+    curl -LO https://storage.googleapis.com/kubernetes-release/release/{{< param "fullversion" >}}/bin/linux/amd64/kubectl
+    ```
+
+2. Haz el binario de kubectl ejecutable.
+
+    ```
+    chmod +x ./kubectl
+    ```
+
+3. Mueve el binario dentro de tu PATH.
+
+    ```
+    sudo mv ./kubectl /usr/local/bin/kubectl
+    ```
+{{% /tab %}}
+{{% tab name="Windows" %}}
+1. Descarga la última entrega {{< param "fullversion" >}} desde [este enlace](https://storage.googleapis.com/kubernetes-release/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe).
+
+    O si tienes `curl` instalado, usa este comando:
+
+    ```
+    curl -LO https://storage.googleapis.com/kubernetes-release/release/{{< param "fullversion" >}}/bin/windows/amd64/kubectl.exe
+    ```
+
+    Para averiguar la última versión estable (por ejemplo, para secuencias de comandos), echa un vistazo a [https://storage.googleapis.com/kubernetes-release/release/stable.txt](https://storage.googleapis.com/kubernetes-release/release/stable.txt).
+
+2. Añade el binario a tu PATH.
+{{% /tab %}}
+{{< /tabs >}}
+
+
+
+## Configurar kubectl
+
+Para que kubectl pueda encontrar y acceder a un clúster de Kubernetes, necesita un [fichero kubeconfig](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/), que se crea de forma automática cuando creas un clúster usando kube-up.sh o despliegas de forma satisfactoria un clúster de Minikube. Mira las [guías para comenzar](/docs/setup/) para más información acerca de crear clústers. Si necesitas acceso a un clúster que no has creado, ver el [documento de Compartir Acceso a un Clúster](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/).
+Por defecto, la configuración de kubectl se encuentra en `~/.kube/config`.
+
+## Comprobar la configuración kubectl
+Comprueba que kubectl está correctamente configurado obteniendo el estado del clúster:
+
+```shell
+kubectl cluster-info
+```
+Si ves una respuesta en forma de URL, kubectl está correctamente configurado para acceder a tu clúster.
+
+Si ves un mensaje similar al siguiente, kubectl no está correctamente configurado o no es capaz de conectar con un clúster de Kubernetes.
+
+```shell
+The connection to the server <server-name:port> was refused - did you specify the right host or port?
+```
+
+Por ejemplo, si intentas ejecutar un clúster de Kubernetes en tu portátil (localmente), necesitarás una herramienta como minikube que esté instalada primero y entonces volver a ejecutar los comandos indicados arriba.
+
+Si kubectl cluster-info devuelve la respuesta en forma de url, pero no puedes acceder a tu clúster, para comprobar si está configurado adecuadamente, usa:
+
+```shell
+kubectl cluster-info dump
+```
+
+## Habilitar el auto-completado en el intérprete de comandos
+
+kubectl provee de soporte para auto-completado para Bash y Zsh, ¡que te puede ahorrar mucho uso del teclado!
+
+Abajo están los procedimientos para configurar el auto-completado para Bash (incluyendo la diferencia entre Linux y macOS) y Zsh.
+
+{{< tabs name="kubectl_autocompletion" >}}
+
+{{% tab name="Bash en Linux" %}}
+
+### Introducción
+
+La secuencia de comandos de completado de kubectl para Bash puede ser generado con el comando `kubectl completion bash`. Corriendo la secuencia de comandos de completado en tu intérprete de comandos habilita el auto-completado de kubectl.
+
+Sin embargo, la secuencia de comandos de completado depende de [*bash-completion**](https://github.com/scop/bash-completion), lo que significa que tienes que instalar primero este programa (puedes probar si ya tienes bash-completion instalado ejecutando `type _init_completion`).
+
+### Instalar bash-completion
+
+bash-completion es ofrecido por muchos gestores de paquetes (ver [aquí](https://github.com/scop/bash-completion#installation)). Puedes instalarlo con `apt-get install bash-completion` o `yum install bash-completion`, etc.
+
+Los comandos de arriba crean `/usr/share/bash-completion/bash_completion`, que es la secuencia de comandos principal de bash-completion. Dependiendo de tu gestor de paquetes, tienes que correr manualmente este archivo en tu `~/.bashrc`.
+
+Para averiguarlo, recarga tu intérprete de comandos y ejecuta `type _init_completion`. Si el comando tiene éxito, ya has terminado; si no, añade lo siguiente a tu `~/.bashrc`:
+
+```shell
+source /usr/share/bash-completion/bash_completion
+```
+
+recarga tu intérprete de comandos y verifica que bash-completion está correctamente instalado tecleando `type _init_completion`.
+
+### Habilitar el auto-completado de kubectl
+
+Debes asegurarte que la secuencia de comandos de completado de kubectl corre en todas tus sesiones de tu intérprete de comenados. Hay dos formas en que puedes hacer esto:
+
+- Corre la secuencia de comandos de completado en tu `~/.bashrc`:
+
+    ```shell
+    echo 'source <(kubectl completion bash)' >>~/.bashrc
+    ```
+
+- Añade la secuencia de comandos de completado al directorio `/etc/bash_completion.d`:
+
+    ```shell
+    kubectl completion bash >/etc/bash_completion.d/kubectl
+    ```
+
+{{< note >}}
+bash-completion corre todas las secuencias de comandos de completado en `/etc/bash_completion.d`.
+{{< /note >}}
+
+Ambas estrategias son equivalentes. Tras recargar tu intérprete de comandos, el auto-completado de kubectl debería estar funcionando.
+
+{{% /tab %}}
+
+
+{{% tab name="Bash en macOS" %}}
+
+{{< warning>}}
+macOS incluye Bash 3.2 por defecto. La secuencia de comandos de completado de kubectl requiere Bash 4.1+ y no funciona con Bash 3.2. Una posible alternativa es instalar una nueva versión de Bash en macOS (ver instrucciones [aquí](https://itnext.io/upgrading-bash-on-macos-7138bd1066ba)). Las instrucciones de abajo sólo funcionan si estás usando Bash 4.1+.
+{{< /warning >}}
+
+### Introducción
+
+La secuencia de comandos de completado de kubectl para Bash puede generarse con el comando `kubectl completion bash`. Corriendo la secuencia de comandos de completado en tu intérprete de comandos habilita el auto-completado de kubectl.
+
+Sin embargo, la secuencia de comandos de completado depende de [*bash-completion**](https://github.com/scop/bash-completion), lo que significa que tienes que instalar primero este programa (puedes probar si ya tienes bash-completion instalado ejecutando `type _init_completion`).
+
+### Instalar bash-completion
+
+Puedes instalar bash-completion con Homebrew:
+
+```shell
+brew install bash-completion@2
+```
+
+{{< note >}}
+El `@2` simboliza bash-completion 2, que es requerido por la secuencia de comandos de completado de kubectl (no funciona con bash-completion 1). Luego, bash-completion 2 requiere Bash 4.1+, eso es por lo que necesitabas actualizar Bash.
+{{< /note >}}
+
+Como se indicaba en la salida de `brew install` (sección "Caveats"), añade las siguientes líneas a tu `~/.bashrc` o `~/.bash_profile`:
+
+```shell
+export BASH_COMPLETION_COMPAT_DIR=/usr/local/etc/bash_completion.d
+[[ -r /usr/local/etc/profile.d/bash_completion.sh ]] && . /usr/local/etc/profile.d/bash_completion.sh
+```
+
+Recarga tu intérprete de comandos y verifica que bash-completion está correctamente instalado tecleando `type _init_completion`.
+
+### Habilitar el auto-completado de kubectl
+
+Debes asegurarte que la secuencia de comandos de completado de kubectl corre en todas tus sesiones de tu intérprete de comenados. Hay múltiples formas en que puedes hacer esto:
+
+- Corre la secuencia de comandos de completado en tu `~/.bashrc`:
+
+    ```shell
+    echo 'source <(kubectl completion bash)' >>~/.bashrc
+
+    ```
+
+- Añade la secuencia de comandos de completado al directorio `/usr/local/etc/bash_completion.d`:
+
+    ```shell
+    kubectl completion bash >/usr/local/etc/bash_completion.d/kubectl
+    ```
+
+- Si has instalado kubectl con Homebrew (como se explica [aquí](#install-with-homebrew-on-macos)), entonces la secuencia de comandos de completado se instaló automáticamente en `/usr/local/etc/bash_completion.d/kubectl`. En este caso, no tienes que hacer nada.
+
+{{< note >}}
+bash-completion (si se instaló con Homebrew) corre todas las secuencias de comandos de completado en el directorio que se ha puesto en la variable de entorno `BASH_COMPLETION_COMPAT_DIR`.
+{{< /note >}}
+
+Todas las estrategias son equivalentes. Tras recargar tu intérprete de comandos, el auto-completado de kubectl debería funcionar.
+{{% /tab %}}
+
+{{% tab name="Zsh" %}}
+
+La secuencia de comandos de completado de kubectl para Zsh puede ser generada con el comando `kubectl completion zsh`. Corriendo la secuencia de comandos de completado en tu intérprete de comandos habilita el auto-completado de kubectl.
+
+Para hacerlo en todas tus sesiones de tu intérprete de comandos, añade lo siguiente a tu `~/.zshrc`:
+
+```shell
+source <(kubectl completion zsh)
+```
+
+Tras recargar tu intérprete de comandos, el auto-completado de kubectl debería funcionar.
+
+Si obtienes un error como `complete:13: command not found: compdef`, entonces añade lo siguiente al principio de tu `~/.zshrc`:
+
+```shell
+autoload -Uz compinit
+compinit
+```
+{{% /tab %}}
+{{< /tabs >}}
+
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+[Aprender cómo lanzar y exponer tu aplicación.](/docs/tasks/access-application-cluster/service-access-application-cluster/)
+{{% /capture %}}
+