add es pages

pull/21359/head
Karen Bradshaw 2020-05-30 15:30:50 -04:00
parent e5825ea8f9
commit 6a9c673a92
34 changed files with 244 additions and 221 deletions

View File

@ -1,17 +1,17 @@
---
title: Conceptos
main_menu: true
content_template: templates/concept
content_type: concept
weight: 40
---
{{% capture overview %}}
<!-- overview -->
La sección de conceptos te ayudará a conocer los componentes de Kubernetes así como las abstracciones que utiliza para representar tu cluster. Además, te ayudará a obtener un conocimiento más profundo sobre cómo funciona Kubernetes.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Introducción
@ -66,12 +66,13 @@ En un clúster de Kubernetes, los nodos son las máquinas (máquinas virtuales,
* [Annotations](/docs/concepts/overview/working-with-objects/annotations/)
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Si estás interesado en escribir una página sobre conceptos,
revisa [Usando Templates de Páginas](/docs/home/contribute/page-templates/)
para obtener información sobre el tipo de página conceptos y la plantilla conceptos.
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: Conceptos subyacentes del Cloud Controller Manager
content_template: templates/concept
content_type: concept
weight: 30
---
{{% capture overview %}}
<!-- overview -->
El concepto del Cloud Controller Manager (CCM) (no confundir con el ejecutable) fue creado originalmente para permitir que Kubernetes y el código específico de proveedores de servicios en la nube evolucionasen de forma independiente. El Cloud Controller Manager se ejecuta a la par con otros componentes maestros como el Kubernetes Controller Manager, el API Server y el planificador. También puede ejecutarse como un extra, en cuyo caso se ejecuta por encima de Kubernetes.
@ -16,10 +16,10 @@ En la siguiente imagen, se puede ver la arquitectura de un cluster de Kubernetes
![Arquitectura previa a CCM](/images/docs/pre-ccm-arch.png)
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Diseño
@ -235,4 +235,4 @@ Los siguientes proveedores de servicios en la nube han implementado CCMs:
Instrucciones para configurar y ejecutar el CCM pueden encontrarse [aquí](/docs/tasks/administer-cluster/running-cloud-controller/#cloud-controller-manager).
{{% /capture %}}

View File

@ -2,17 +2,17 @@
reviewers:
- glo-pena
title: Comunicación Nodo-Maestro
content_template: templates/concept
content_type: concept
weight: 20
---
{{% capture overview %}}
<!-- overview -->
Este documento cataloga las diferentes vías de comunicación entre el nodo máster (en realidad el apiserver) y el clúster de Kubernetes. La intención es permitir a los usuarios personalizar sus instalaciones para proteger sus configuraciones de red de forma que el clúster pueda ejecutarse en una red insegura. (o en un proveedor de servicios en la nube con direcciones IP públicas)
{{% /capture %}}
{{% capture body %}}
<!-- body -->
### Clúster a Máster
@ -56,4 +56,3 @@ Kubernetes ofrece soporte para túneles SSH que protegen la comunicación Mást
Los túneles SSH se consideran obsoletos, y no deberían utilizarse a menos que se sepa lo que se está haciendo. Se está diseñando un reemplazo para este canal de comunicación.
{{% /capture %}}

View File

@ -2,18 +2,18 @@
reviewers:
- glo-pena
title: Nodos
content_template: templates/concept
content_type: concept
weight: 10
---
{{% capture overview %}}
<!-- overview -->
Un nodo es una máquina de trabajo en Kubernetes, previamente conocida como `minion`. Un nodo puede ser una máquina virtual o física, dependiendo del tipo de clúster. Cada nodo está gestionado por el componente máster y contiene los servicios necesarios para ejecutar [pods](/docs/concepts/workloads/pods/pod). Los servicios en un nodo incluyen el [container runtime](/docs/concepts/overview/components/#node-components), kubelet y el kube-proxy. Accede a la sección [The Kubernetes Node](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md#the-kubernetes-node) en el documento de diseño de arquitectura para más detalle.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Estado del Nodo
@ -180,4 +180,4 @@ Para reservar explícitamente recursos en la máquina huésped para procesos no
Un nodo es un recurso principal dentro de la REST API de Kubernetes. Más detalles sobre el objeto en la API se puede encontrar en: [Object Node API](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#node-v1-core).
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: Organizar el acceso a los clústeres utilizando archivos kubeconfig
content_template: templates/concept
content_type: concept
weight: 60
---
{{% capture overview %}}
<!-- overview -->
Utilice los archivos kubeconfig para organizar la información acerca de los clústeres, los
usuarios, los Namespaces y los mecanismos de autenticación. La herramienta de
@ -26,9 +26,9 @@ Para obtener instrucciones paso a paso acerca de cómo crear y especificar los a
consulte el recurso
[Configurar El Acceso A Múltiples Clústeres](/docs/tasks/access-application-cluster/configure-access-multiple-clusters).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Compatibilidad con múltiples clústeres, usuarios y mecanismos de autenticación
@ -143,11 +143,12 @@ Las referencias de un archivo en la línea de comandos son relativas al director
Dentro de `$HOME/.kube/config`, las rutas relativas se almacenan de manera relativa a la ubicación del archivo kubeconfig , al igual que las rutas absolutas
se almacenan absolutamente.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Configurar el acceso a multiples Clústeres](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/)
* [`kubectl config`](/docs/reference/generated/kubectl/kubectl-commands#config)
{{% /capture %}}

View File

@ -3,18 +3,18 @@ reviewers:
- astuky
- raelga
title: Variables de entorno de un Container
content_template: templates/concept
content_type: concept
weight: 20
---
{{% capture overview %}}
<!-- overview -->
Esta página explica los recursos disponibles para Containers dentro del entorno de un Container.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Entorno del Container
@ -50,11 +50,12 @@ FOO_SERVICE_PORT=<El puerto dónde está funcionando el servicio>
Los servicios tienen direcciones IP dedicadas y están disponibles para el Container a través de DNS,
si el [complemento para DNS](http://releases.k8s.io/{{< param "githubbranch" >}}/cluster/addons/dns/) está habilitado.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Más información sobre cómo ejecutar código en respuesta a los cambios de etapa durante ciclo de vida de un contenedor la puedes encontrar en [Container lifecycle hooks](/docs/concepts/containers/container-lifecycle-hooks/).
* Practica [añadiendo handlers a los lifecycle events de un Container ](/docs/tasks/configure-pod-container/attach-handler-lifecycle-event/).
{{% /capture %}}

View File

@ -1,18 +1,18 @@
---
title: Container Lifecycle Hooks
content_template: templates/concept
content_type: concept
weight: 30
---
{{% capture overview %}}
<!-- overview -->
Esta página describe como los contenedores gestionados por kubelet pueden utilizar el framework _Container lifecycle hook_ (hook del ciclo de vida del contenedor)
para ejecutar código disparado por eventos durante la gestión de su ciclo de vida (lifecycle).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Introducción
@ -109,12 +109,13 @@ Events:
1m 22s 2 {kubelet gke-test-cluster-default-pool-a07e5d30-siqd} spec.containers{main} Warning FailedPostStartHook
```
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Aprende más sobre [variables de entorno de contenedores](/docs/concepts/containers/container-environment-variables/).
* Practica
[adjuntando controladores a los eventos de lifecycle de los contenedores](/docs/tasks/configure-pod-container/attach-handler-lifecycle-event/).
{{% /capture %}}

View File

@ -2,18 +2,18 @@
reviewers:
- raelga
title: ¿Qué es Kubernetes?
content_template: templates/concept
content_type: concept
weight: 10
card:
name: concepts
weight: 10
---
{{% capture overview %}}
<!-- overview -->
Esta página ofrece una visión general sobre Kubernetes.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
Kubernetes es una plataforma portable y extensible de código abierto para
administrar cargas de trabajo y servicios. Kubernetes facilita la automatización
y la configuración declarativa. Tiene un ecosistema grande y en rápido crecimiento.
@ -154,11 +154,12 @@ En resumen, los beneficios de usar contenedores incluyen:
El nombre **Kubernetes** proviene del griego y significa *timonel* o *piloto*. Es la raíz de *gobernador* y de [cibernética](http://www.etymonline.com/index.php?term=cybernetics). *K8s*
es una abrevación que se obtiene al reemplazar las ocho letras "ubernete" con el número 8.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* ¿Estás listo para [empezar](/docs/setup/)?
* Para saber más, visita el resto de la [documentación de Kubernetes](/docs/home/).
{{% /capture %}}

View File

@ -1,14 +1,14 @@
---
title: Anotaciones
content_template: templates/concept
content_type: concept
weight: 50
---
{{% capture overview %}}
<!-- overview -->
Puedes usar las anotaciones de Kubernetes para adjuntar metadatos arbitrarios a los objetos, de tal forma que clientes como herramientas y librerías puedan obtener fácilmente dichos metadatos.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Adjuntar metadatos a los objetos
Puedes usar las etiquetas o anotaciones para adjuntar metadatos a los objetos de Kubernetes.
@ -68,10 +68,11 @@ Si se omite el prefijo, la clave de la anotación se entiende que es privada par
Los prefijos `kubernetes.io/` y `k8s.io/` se reservan para el uso exclusivo de los componentes principales de Kubernetes.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Aprende más acerca de las [Etiquetas y Selectores](/docs/concepts/overview/working-with-objects/labels/).
{{% /capture %}}

View File

@ -1,9 +1,9 @@
---
title: Etiquetas recomendadas
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
Puedes visualizar y gestionar los objetos de Kubernetes con herramientas adicionales a kubectl
y el propio tablero de control. Un conjunto común de etiquetas permite a dichas herramientas
trabajar de forma interoperable, describiendo los objetos de una forma común que todas las
@ -11,9 +11,9 @@ herramientas puedan entender.
Además del soporte a herramientas, las etiquetas recomendadas describen las aplicaciones
de forma que puedan ser consultadas.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
Los metadatos se organizan en torno al concepto de una _aplicación_. Kubernetes no es
una plataforma como servicio (PaaS) y ni tiene o restringe la definición formal de una aplicación.
Al contrario, las aplicaciones son informales y se describen mediante el uso de los metadatos.
@ -171,4 +171,3 @@ metadata:
Con los objetos `StatefulSet` y `Service` de MySQL te darás cuenta que se incluye la información acerca de MySQL y Wordpress, la aplicación global.
{{% /capture %}}

View File

@ -1,17 +1,17 @@
---
title: Entender los Objetos de Kubernetes
content_template: templates/concept
content_type: concept
weight: 10
card:
name: concepts
weight: 40
---
{{% capture overview %}}
<!-- overview -->
Esta página explica cómo se representan los objetos de Kubernetes en la API de Kubernetes, y cómo puedes definirlos en formato `.yaml`.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Entender los Objetos de Kubernetes
Los *Objetos de Kubernetes* son entidades persistentes dentro del sistema de Kubernetes. Kubernetes utiliza estas entidades para representar el estado de tu clúster. Específicamente, pueden describir:
@ -69,10 +69,11 @@ Por ejemplo, el formato de la `spec` para un objeto de tipo `Pod` lo puedes enco
y el formato de la `spec` para un objeto de tipo `Deployment` lo puedes encontrar
[aquí](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#deploymentspec-v1-apps).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Aprender más acerca de los objetos básicos más importantes de Kubernetes, como el [Pod](/docs/concepts/workloads/pods/pod-overview/).
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: Etiquetas y Selectores
content_template: templates/concept
content_type: concept
weight: 40
---
{{% capture overview %}}
<!-- overview -->
Las _etiquetas_ son pares de clave/valor que se asocian a los objetos, como los pods.
El propósito de las etiquetas es permitir identificar atributos de los objetos que son relevantes y significativos para los usuarios, pero que no tienen significado para el sistema principal.
@ -22,10 +22,10 @@ Cada objeto puede tener un conjunto de etiquetas clave/valor definidas, donde ca
Las etiquetas permiten consultar y monitorizar los objetos de forma más eficiente y son ideales para su uso en UIs y CLIs. El resto de información no identificada debe ser registrada usando [anotaciones](/docs/concepts/overview/working-with-objects/annotations/).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Motivación
@ -201,4 +201,4 @@ selector:
Un caso de uso de selección basada en etiquetas es la posibilidad de limitar los nodos en los que un pod puede desplegarse.
Ver la documentación sobre [selección de nodo](/docs/concepts/configuration/assign-pod-node/) para más información.
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: Nombres
content_template: templates/concept
content_type: concept
weight: 20
---
{{% capture overview %}}
<!-- overview -->
Todos los objetos de la API REST de Kubernetes se identifica de forma inequívoca mediante un Nombre y un UID.
@ -12,10 +12,10 @@ Para aquellos atributos provistos por el usuario que no son únicos, Kubernetes
Echa un vistazo al [documento de diseño de identificadores](https://git.k8s.io/community/contributors/design-proposals/architecture/identifiers.md) para información precisa acerca de las reglas sintácticas de los Nombres y UIDs.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Nombres
@ -27,4 +27,4 @@ Por regla general, los nombres de los recursos de Kubernetes no deben exceder la
{{< glossary_definition term_id="uid" length="all" >}}
{{% /capture %}}

View File

@ -1,18 +1,18 @@
---
title: Espacios de nombres
content_template: templates/concept
content_type: concept
weight: 30
---
{{% capture overview %}}
<!-- overview -->
Kubernetes soporta múltiples clústeres virtuales respaldados por el mismo clúster físico.
Estos clústeres virtuales se denominan espacios de nombres (namespaces).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Cuándo Usar Múltiple Espacios de Nombre
@ -112,4 +112,4 @@ kubectl api-resources --namespaced=true
kubectl api-resources --namespaced=false
```
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: CronJob
content_template: templates/concept
content_type: concept
weight: 80
---
{{% capture overview %}}
<!-- overview -->
Un _Cron Job_ ejecuta tareas, [Jobs](/docs/concepts/workloads/controllers/jobs-run-to-completion/), a intervalos regulares.
@ -19,10 +19,10 @@ Para instrucciones sobre cómo crear y trabajar con trabajos programados,
incluyendo definiciones de ejemplo,
puedes consultar [Ejecutar tareas automatizadas con trabajos programados](/docs/tasks/job/automated-tasks-with-cron-jobs).
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Limitaciones de las tareas programados
@ -58,4 +58,4 @@ Esto ocurre porque el controlador en este caso comprueba cuántas programaciones
El CronJob es únicamente responsable de crear los Jobs que coinciden con su programación, y
el Job por otro lado es el responsable de gestionar los Pods que representa.
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: DaemonSet
content_template: templates/concept
content_type: concept
weight: 50
---
{{% capture overview %}}
<!-- overview -->
Un _DaemonSet_ garantiza que todos (o algunos) de los nodos ejecuten una copia de un Pod. Conforme se añade más nodos
al clúster, nuevos Pods son añadidos a los mismos. Conforme se elimina nodos del clúster, dichos Pods se destruyen.
@ -26,10 +26,10 @@ De forma básica, se debería usar un DaemonSet, cubriendo todos los nodos, por
En configuraciones más complejas se podría usar múltiples DaemonSets para un único tipo de proceso,
pero con diferentes parámetros y/o diferentes peticiones de CPU y memoria según el tipo de hardware.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Escribir una especificación de DaemonSet
@ -235,4 +235,4 @@ del número de réplicas y las actualizaciones continuas son mucho más importan
Utiliza un DaemonSet cuando es importante que una copia de un Pod siempre se ejecute en cada uno de los nodos,
y cuando se necesite que arranque antes que el resto de Pods.
{{% /capture %}}

View File

@ -8,11 +8,11 @@ feature:
mata los contenedores que no responden a tus pruebas de salud definidas,
y no los expone a los clientes hasta que no están listo para servirse.
content_template: templates/concept
content_type: concept
weight: 20
---
{{% capture overview %}}
<!-- overview -->
{{< note >}}
hoy en día la forma recomendada de configurar la replicación es con un [`Deployment`](/docs/concepts/workloads/controllers/deployment/) que configura un [`ReplicaSet`](/docs/concepts/workloads/controllers/replicaset/).
@ -22,10 +22,10 @@ Un _ReplicationController_ garantiza que un número determinado de réplicas se
en todo momento. En otras palabras, un ReplicationController se asegura que un pod o un conjunto homogéneo de pods
siempre esté arriba y disponible.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Cómo Funciona un ReplicationController
@ -327,6 +327,6 @@ terminarlo cuando el servidor está listo para reiniciarse/apagarse.
Lee [Ejecutar Aplicaciones sin Estado con un ReplicationController](/docs/tutorials/stateless-application/run-stateless-ap-replication-controller/).
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: StatefulSets
content_template: templates/concept
content_type: concept
weight: 40
---
{{% capture overview %}}
<!-- overview -->
Un StatefulSet es el objeto de la API workload que se usa para gestionar aplicaciones con estado.
@ -13,9 +13,9 @@ Los StatefulSets son estables (GA) en la versión 1.9.
{{< /note >}}
{{< glossary_definition term_id="statefulset" length="all" >}}
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Usar StatefulSets
@ -257,11 +257,12 @@ Antes de revertir la plantilla, debes también eliminar cualquier Pod que el Sta
intentando ejecutar con la configuración incorrecta.
El StatefulSet comenzará entonces a recrear los Pods usando la plantilla revertida.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Sigue el ejemplo de cómo [desplegar un aplicación con estado](/docs/tutorials/stateful-application/basic-stateful-set/).
* Sigue el ejemplo de cómo [desplegar Cassandra con StatefulSets](/docs/tutorials/stateful-application/cassandra/).
{{% /capture %}}

View File

@ -1,10 +1,10 @@
---
title: Controlador TTL para Recursos Finalizados
content_template: templates/concept
content_type: concept
weight: 65
---
{{% capture overview %}}
<!-- overview -->
{{< feature-state for_k8s_version="v1.12" state="alpha" >}}
@ -19,12 +19,12 @@ Descargo de responsabilidad Alpha: esta característica está actualmente en ver
`TTLAfterFinished`.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Controlador TTL
@ -74,12 +74,13 @@ En Kubernetes, se necesita ejecutar NTP en todos los nodos
para evitar este problema. Los relojes no siempre son correctos, pero la diferencia debería ser muy pequeña.
Ten presente este riesgo cuando pongas un valor distinto de cero para el TTL.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
[Limpiar Jobs automáticamente](/docs/concepts/workloads/controllers/jobs-run-to-completion/#clean-up-finished-jobs-automatically)
[Documento de diseño](https://github.com/kubernetes/community/blob/master/keps/sig-apps/0026-ttl-after-finish.md)
{{% /capture %}}

View File

@ -3,11 +3,11 @@ reviewers:
- astuky
- raelga
title: Containers Efímeros
content_template: templates/concept
content_type: concept
weight: 80
---
{{% capture overview %}}
<!-- overview -->
{{< feature-state state="alpha" >}}
@ -24,9 +24,9 @@ Deprecación de Kubernetes](/docs/reference/using-api/deprecation-policy/), esta
alfa puede variar significativamente en el futuro o ser eliminada por completo.
{{< /warning >}}
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Entendiendo los Containers efímeros
@ -211,4 +211,4 @@ PID USER TIME COMMAND
29 root 0:00 ps auxww
```
{{% /capture %}}

View File

@ -2,19 +2,19 @@
reviewers:
- raelga
title: Pod Preset
content_template: templates/concept
content_type: concept
weight: 50
---
{{% capture overview %}}
<!-- overview -->
Esta página provee una descripción general de los Pod Presets, los cuales son
los objetos que se utilizan para inyectar cierta información en los Pods en
el momento de la creación. Esta información puede incluir secretos, volúmenes,
montajes de volúmenes y variables de entorno.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Entendiendo los Pod Presets
Un `Pod Preset` es un recurso de la API utilizado para poder inyectar requerimientos
@ -86,10 +86,11 @@ Con el fin de utilizar los Pod Presets en un clúster debe asegurarse de lo sigu
3. Que se han definido los Pod Presets mediante la creación de objetos `PodPreset` en el
namespace que se utilizará.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Inyectando datos en un Pod usando PodPreset](/docs/tasks/inject-data-application/podpreset/)
{{% /capture %}}

View File

@ -1,12 +1,12 @@
---
content_template: templates/concept
content_type: concept
title: Contribuir a la documentación de Kubernetes
linktitle: Contribuir
main_menu: true
weight: 80
---
{{% capture overview %}}
<!-- overview -->
Kubernetes es posible gracias a la participación de la comunidad y la
documentación es vital para facilitar el acceso al proyecto.
@ -22,7 +22,7 @@ aprender sobre nosotros, visite la sección [comunidad de Kubernetes](/community
Para obtener información cómo escribir documentación de Kubernetes,
consulte la [guía de estilo](/docs/contribute/style/style-guide/).
{{% capture body %}}
<!-- body -->
## Tipos de contribuidores
@ -82,4 +82,4 @@ para proporcionar un punto de partida.
- Proponer mejoras a los tests de la documentación
- Proponer mejoras al sitio web de Kubernetes y otras herramientas
{{% /capture %}}

View File

@ -5,16 +5,16 @@ approvers:
linkTitle: "Referencia"
main_menu: true
weight: 70
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
Esta sección de la documentación de Kubernetes contiene información de referencia.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Información de referencia sobre la API
@ -61,4 +61,4 @@ Un archivo de los documentos de diseño para la funcionalidad de Kubernetes.
Puedes empezar por [Arquitectura de Kubernetes](https://git.k8s.io/community/contributors/design-proposals/architecture/architecture.md) y [Vista general del diseño de Kubernetes](https://git.k8s.io/community/contributors/design-proposals).
{{% /capture %}}

View File

@ -3,10 +3,10 @@ no_issue: true
title: Setup
main_menu: true
weight: 30
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
En esta sección encontrarás toda la información necesaria para poder identificar
**la solución que mejor se adapta a tus necesidades**.
@ -23,9 +23,9 @@ desplegar una solución parcialmente automatizada que te ofrezca un poco más de
control o directamente crear tu propio clúster de forma completamente manual
personalizando y controlando cada componente.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Soluciones para la máquina en local
@ -82,4 +82,4 @@ Deberías elegir una solución de este tipo si:
Una solución personalizadas proporciona total libertad sobre los clústeres
pero requiere más conocimiento y experiencia.
{{% /capture %}}

View File

@ -2,7 +2,7 @@
reviewers:
- seomago
title: Compilando desde código fuente
content_template: templates/concept
content_type: concept
card:
name: download
weight: 20
@ -10,13 +10,13 @@ card:
---
{{% capture overview %}}
<!-- overview -->
Se puede o bien crear una release desde el código fuente o bien descargar una versión pre-built. Si no se pretende hacer un desarrollo de Kubernetes en sí mismo, se sugiere usar una version pre-built de la release actual, que se puede encontrar en [Release Notes](/docs/setup/release/notes/).
El código fuente de Kubernetes se puede descargar desde el repositorio [kubernetes/kubernetes](https://github.com/kubernetes/kubernetes) .
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Compilar desde código fuente
@ -34,4 +34,4 @@ Para más detalles sobre el proceso de compilación de una release, visita la ca
{{% /capture %}}

View File

@ -2,20 +2,20 @@
title: Tareas
main_menu: true
weight: 50
content_template: templates/concept
content_type: concept
---
{{< toc >}}
{{% capture overview %}}
<!-- overview -->
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 %}}
<!-- body -->
## Interfaz Web de Usuario (Tablero de Control)
@ -77,11 +77,12 @@ COnfigura y planifica GPUs de NVIDIA para hacerlas disponibles como recursos a l
Configura y planifica HugePages como un recurso planificado en un clúster.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
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

@ -1,24 +1,25 @@
---
title: Configura un Pod para Usar un Volume como Almacenamiento
content_template: templates/task
content_type: task
weight: 50
---
{{% capture overview %}}
<!-- overview -->
En esta página se muestra cómo configurar un Pod para usar un Volume (volumen) como almacenamiento.
El sistema de ficheros de un Contenedor existe mientras el Contenedor exista. Por tanto, cuando un Contenedor es destruido o reiniciado, los cambios realizados en el sistema de ficheros se pierden. Para un almacenamiento más consistente que sea independiente del ciclo de vida del Contenedor, puedes usar un [Volume](/docs/concepts/storage/volumes/). Esta característica es especialmente importante para aplicaciones que deben mantener un estado, como motores de almacenamiento clave-valor (por ejemplo Redis) y bases de datos.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Configura un Volume para un Pod
@ -116,9 +117,10 @@ de `Always` (siempre).
kubectl delete pod redis
```
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Revisa [Volume](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#volume-v1-core).
@ -126,6 +128,6 @@ de `Always` (siempre).
* Además del almacenamiento local proporcionado por `emptyDir`, Kubernetes soporta diferentes tipos de soluciones de almacenamiento por red, incluyendo los discos gestionados de los diferentes proveedores cloud, como por ejemplo los *Persistent Disks* en Google Cloud Platform o el *Elastic Block Storage* de Amazon Web Services. Este tipo de soluciones para volúmenes son las preferidas para el almacenamiento de datos críticos. Kubernetes se encarga de todos los detalles, tal como montar y desmontar los dispositivos en los nodos del clúster. Revisa [Volumes](/docs/concepts/storage/volumes/) para obtener más información.
{{% /capture %}}

View File

@ -2,20 +2,20 @@
reviewers:
- raelga
title: Pipeline de métricas de recursos
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
Desde Kubernetes 1.8, las métricas de uso de recursos, tales como el uso de CPU y memoria del contenedor,
están disponibles en Kubernetes a través de la API de métricas. Estas métricas son accedidas directamente
por el usuario, por ejemplo usando el comando `kubectl top`, o usadas por un controlador en el cluster,
por ejemplo el Horizontal Pod Autoscaler, para la toma de decisiones.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## La API de Métricas
@ -54,4 +54,4 @@ El servidor de métricas se añadió a la API de Kubernetes utilizando el
Puedes aprender más acerca del servidor de métricas en el [documento de diseño](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/instrumentation/metrics-server.md).
{{% /capture %}}

View File

@ -1,24 +1,25 @@
---
title: Especificando un presupuesto de disrupción para tu aplicación
content_template: templates/task
content_type: task
weight: 110
---
{{% capture overview %}}
<!-- overview -->
Ésta pagina enseña como limitar el numero de disrupciones concurrentes que afectan a tu aplicación definiendo presupuestos de disrupción de pods, Pod Disruption Budgets (PDB) en inglés. Estos presupuestos definen el mínimo número de pods que deben estar ejecutándose en todo momento para asegurar la disponibilidad de la aplicación durante operaciones de mantenimiento efectuadas sobre los nodos por los administradores del cluster.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
* Tener permisos de administrador sobre la aplicación que esta corriendo en Kubernetes y requiere alta disponibilidad
* Deberías saber como desplegar [Múltiples réplicas de aplicaciones stateless](/docs/tasks/run-application/run-stateless-application-deployment/)
y/o [Múltiples réplicas de aplicaciones stateful](/docs/tasks/run-application/run-replicated-stateful-application/).
* Deberías haber leido acerca de [Disrupciones de un Pod](/docs/concepts/workloads/pods/disruptions/).
* Deberías confirmar con el propietario del cluster o proveedor de servicio que respetan Presupuestos de Disrupción para Pods.
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Protegiendo una aplicación con un PodDisruptionBudget
@ -27,9 +28,9 @@ weight: 110
3. Crea un PDB usando un archivo YAML.
4. Crea el objecto PDB desde el archivo YAML.
{{% /capture %}}
{{% capture discussion %}}
<!-- discussion -->
## Identifica la applicación que quieres proteger
@ -225,6 +226,6 @@ Puedes utilizar un PDB con pods controlados por otro tipo de controlador, por un
Puedes usar un selector que selecciona un subconjunto o superconjunto de los pods que pertenecen a un controlador incorporado. Sin embargo, cuando hay varios PDB en un namespace, debes tener cuidado de no
crear PDBs cuyos selectores se superponen.
{{% /capture %}}

View File

@ -1,34 +1,36 @@
---
title: Corre una aplicación stateless usando un Deployment
min-kubernetes-server-version: v1.9
content_template: templates/tutorial
content_type: tutorial
weight: 10
---
{{% capture overview %}}
<!-- overview -->
Ésta página enseña como correr una aplicación stateless usando un `deployment` de Kubernetes.
{{% /capture %}}
{{% capture objectives %}}
## {{% heading "objectives" %}}
* Crear un `deployment` de nginx.
* Usar kubectl para obtener información acerca del `deployment`.
* Actualizar el `deployment`.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
{{% /capture %}}
{{% capture lessoncontent %}}
<!-- lessoncontent -->
## Creando y explorando un nginx deployment
@ -141,11 +143,12 @@ Elimina el `deployment` por el nombre:
La manera preferida de crear una aplicación con múltiples instancias es usando un Deployment, el cual usa un ReplicaSet. Antes de que Deployment y ReplicaSet fueran introducidos en Kubernetes, aplicaciones con múltiples instancias eran configuradas usando un
[ReplicationController](/docs/concepts/workloads/controllers/replicationcontroller/).
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Aprende más acerca de [Deployments](/docs/concepts/workloads/controllers/deployment/).
{{% /capture %}}

View File

@ -2,7 +2,7 @@
reviewers:
- mikedanese
title: Instalar y Configurar kubectl
content_template: templates/task
content_type: task
weight: 10
card:
name: tasks
@ -10,16 +10,17 @@ card:
title: Instalar kubectl
---
{{% capture overview %}}
<!-- 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 %}}
## {{% heading "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 %}}
<!-- steps -->
## Instalar kubectl
@ -421,9 +422,10 @@ compinit
{{% /tab %}}
{{< /tabs >}}
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
[Aprender cómo lanzar y exponer tu aplicación.](/docs/tasks/access-application-cluster/service-access-application-cluster/)
{{% /capture %}}

View File

@ -1,28 +1,29 @@
---
title: Instalar Minikube
content_template: templates/task
content_type: task
weight: 20
card:
name: tasks
weight: 10
---
{{% capture overview %}}
<!-- overview -->
Esta página muestra cómo instalar [Minikube](/docs/tutorials/hello-minikube), una herramienta que despliega un clúster de Kubernetes con un único nodo en una máquina virtual.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
La virtualización VT-x o AMD-v debe estar habilitada en la BIOS de tu ordenador. En Linux, puedes comprobar si la tienes habilitada buscando 'vmx' o 'svm' en el fichero `/proc/cpuinfo`:
```shell
egrep --color 'vmx|svm' /proc/cpuinfo
```
{{% /capture %}}
{{% capture steps %}}
<!-- steps -->
## Instalar un Hipervisor
@ -106,13 +107,14 @@ Para instalar Minikube manualmente en Windows, descarga [`minikube-windows-amd64
Para instalar Minikube manualmente en Windows usando [Windows Installer](https://docs.microsoft.com/en-us/windows/desktop/msi/windows-installer-portal), descarga [`minikube-installer.exe`](https://github.com/kubernetes/minikube/releases/latest) y ejecuta el instalador.
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* [Ejecutar Kubernetes Localmente via Minikube](/docs/setup/minikube/)
{{% /capture %}}
## Limpiar todo para comenzar de cero

View File

@ -2,10 +2,10 @@
title: Tutoriales
main_menu: true
weight: 60
content_template: templates/concept
content_type: concept
---
{{% capture overview %}}
<!-- overview -->
Esta sección de la documentación de Kubernetes contiene tutoriales.
@ -15,9 +15,9 @@ una de ellas contiene un procedimiento.
Antes de recorrer cada tutorial, recomendamos añadir un marcador a
[Glosario de términos](/docs/reference/glossary/) para poder consultarlo fácilmente.
{{% /capture %}}
{{% capture body %}}
<!-- body -->
## Esenciales
@ -67,10 +67,11 @@ Antes de recorrer cada tutorial, recomendamos añadir un marcador a
* [Using Source IP](/docs/tutorials/services/source-ip/)
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
Si quieres escribir un tutorial, revisa [utilizando templates](/docs/home/contribute/page-templates/) para obtener información sobre el tipo de página y la plantilla de los tutotriales.
{{% /capture %}}

View File

@ -1,6 +1,6 @@
---
title: Hello Minikube
content_template: templates/tutorial
content_type: tutorial
weight: 5
menu:
main:
@ -13,7 +13,7 @@ card:
weight: 10
---
{{% capture overview %}}
<!-- overview -->
Este tutorial muestra como ejecutar una aplicación Node.js Hola Mundo en Kubernetes utilizando
[Minikube](/docs/setup/learning-environment/minikube) y Katacoda.
@ -23,17 +23,19 @@ Katacoda provee un ambiente de Kubernetes desde el navegador.
También se puede seguir este tutorial si se ha instalado [Minikube localmente](/docs/tasks/tools/install-minikube/).
{{< /note >}}
{{% /capture %}}
{{% capture objectives %}}
## {{% heading "objectives" %}}
* Desplegar una aplicación Hola Mundo en Minikube.
* Ejecutar la aplicación.
* Ver los logs de la aplicación.
{{% /capture %}}
{{% capture prerequisites %}}
## {{% heading "prerequisites" %}}
Este tutorial provee una imagen de contenedor construida desde los siguientes archivos:
@ -43,9 +45,9 @@ Este tutorial provee una imagen de contenedor construida desde los siguientes ar
Para más información sobre el comando `docker build`, lea la [documentación de Docker ](https://docs.docker.com/engine/reference/commandline/build/).
{{% /capture %}}
{{% capture lessoncontent %}}
<!-- lessoncontent -->
## Crear un clúster Minikube
@ -264,12 +266,13 @@ Opcional, eliminar la máquina virtual de Minikube:
minikube delete
```
{{% /capture %}}
{{% capture whatsnext %}}
## {{% heading "whatsnext" %}}
* Leer más sobre [Deployments](/docs/concepts/workloads/controllers/deployment/).
* Leer más sobre [Desplegando aplicaciones](/docs/tasks/run-application/run-stateless-application-deployment/).
* Leer más sobre [Services](/docs/concepts/services-networking/service/).
{{% /capture %}}