Es/docs/tasks/tools/install kubectl.md (#13659)

* Spanish translation

* Spanish translation

* Spanish translation

* Spanish translation
pull/13810/head
Enrique Medina Montenegro 2019-04-13 11:44:03 +02:00 committed by Kubernetes Prow Robot
parent 365b8ae4ef
commit 04a8c62dc9
3 changed files with 470 additions and 36 deletions

View File

@ -1,5 +1,5 @@
---
title: Tasks
title: Tareas
main_menu: true
weight: 50
content_template: templates/concept
@ -9,79 +9,79 @@ content_template: templates/concept
{{% capture overview %}}
This section of the Kubernetes documentation contains pages that
show how to do individual tasks. A task page shows how to do a
single thing, typically by giving a short sequence of steps.
Esta sección de la documentación de Kubernetes contiene páginas que
muestran cómo acometer tareas individuales. Cada página de tarea muestra cómo
realizar una única cosa, típicamente proporcionando una pequeña secuencia de comandos.
{{% /capture %}}
{{% capture body %}}
## Web UI (Dashboard)
## Interfaz Web de Usuario (Tablero de Control)
Deploy and access the Dashboard web user interface to help you manage and monitor containerized applications in a Kubernetes cluster.
Despliega y accede al interfaz web de usuario del Tablero de Control para ayudarte en la gestión y monitorización de las aplicaciones en contenedores de tu clúster de Kubenertes.
## Using the kubectl Command-line
## Usar la línea de comandos con kubectl
Install and setup the `kubectl` command-line tool used to directly manage Kubernetes clusters.
Instala y configura la herramienta de línea de comandos `kubectl` para gestionar de forma directa tus clústers de Kubernetes.
## Configuring Pods and Containers
## Configurar Pods y Contenedores
Perform common configuration tasks for Pods and Containers.
Realiza tareas comunes de configuración para tus Pods y Contenedores.
## Running Applications
## Ejecutar Aplicaciones
Perform common application management tasks, such as rolling updates, injecting information into pods, and horizontal Pod autoscaling.
Realiza tareas comunes de gestión de aplicaciones, como actualizaciones de lanzamiento, inyectar información en los pods, y auto-escalado horizontal de pods.
## Running Jobs
## Ejecutar Jobs
Run Jobs using parallel processing.
Ejecuta Jobs usando procesado paralelo.
## Accessing Applications in a Cluster
## Acceder a las Aplicaciones de un Clúster
Configure load balancing, port forwarding, or setup firewall or DNS configurations to access applications in a cluster.
Configura el balanceo de carga, re-envío de puertos, o configura el cortafuegos o las configuraciones de DNS para acceder a las aplicaciones en un clúster.
## Monitoring, Logging, and Debugging
## Monitorización, Trazas, y Depuración
Setup monitoring and logging to troubleshoot a cluster or debug a containerized application.
Configura la monitorización y las trazas para identificar problemas en un clúster o depurar una aplicación en un contenedor.
## Accessing the Kubernetes API
## Acceder a la API de Kubernetes
Learn various methods to directly access the Kubernetes API.
Aprende varios métodos para acceder directamente a la API de Kubernetes.
## Using TLS
## Usar TLS
Configure your application to trust and use the cluster root Certificate Authority (CA).
Configura tu aplicación para que confíe y use el Certificado de Autoridad (CA) raíz de tu clúster.
## Administering a Cluster
## Administrar un Clúster
Learn common tasks for administering a cluster.
Aprende tareas comunes de administración de un clúster.
## Administering Federation
## Administrar la Federación
Configure components in a cluster federation.
Configura componentes en una federación de clústers.
## Managing Stateful Applications
## Gestionar Aplicaciones con Estado
Perform common tasks for managing Stateful applications, including scaling, deleting, and debugging StatefulSets.
Realiza tareas comunes de gestión de aplicaciones con estado, incluyendo escalado, borrado y depuración de StatefulSets.
## Cluster Daemons
## Demonios del Clúster
Perform common tasks for managing a DaemonSet, such as performing a rolling update.
Realiza tareas comunes de gestión de un DaemonSet, como llevar a cabo una actualización de lanzamiento.
## Managing GPUs
## Gestionar GPUs
Configure and schedule NVIDIA GPUs for use as a resource by nodes in a cluster.
COnfigura y planifica GPUs de NVIDIA para hacerlas disponibles como recursos a los nodos de un clúster.
## Managing HugePages
## Gestionar HugePages
Configure and schedule huge pages as a schedulable resource in a cluster.
Configura y planifica HugePages como un recurso planificado en un clúster.
{{% /capture %}}
{{% capture whatsnext %}}
If you would like to write a task page, see
[Creating a Documentation Pull Request](/docs/home/contribute/create-pull-request/).
Si quisieras escribir una página de Tareas, echa un vistazo a
[Crear una Petición de Subida de Documentación](/docs/home/contribute/create-pull-request/).
{{% /capture %}}

View File

@ -0,0 +1,4 @@
---
title: "Instalar herramientas"
weight: 10
---

View File

@ -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; explorar 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
Estos son algunos 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 usas 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. Para asegurar que la versión utilizada sea la más actual puedes probar:
```
kubectl version
```
## Instalar con Homebrew en macOS
Si estás usando macOS y el gestor de paquetes es [Homebrew](https://brew.sh/), puedes instalar kubectl con Homebrew.
1. Ejecuta el comando de instalación:
```
brew install kubernetes-cli
```
2. Para asegurar que la versión utilizada sea la más actual puedes probar:
```
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. Para asegurar que la versión utilizada sea la más actual puedes probar:
```
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 directorio temporal del usuario.{{< /note >}}
El instalador crea `$HOME/.kube` y crea un archivo de configuración
2. Para asegurar que la versión utilizada sea la más actual puedes probar:
```
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. Para asegurar que la versión utilizada sea la más actual puedes probar:
```
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. Para asegurar que la versión utilizada sea la más actual puedes probar:
```
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 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. Revisa 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 comandos. 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 %}}