Skip to content

Commit

Permalink
Add es/docs index tree (#13809)
Browse files Browse the repository at this point in the history
* Add es/docs/concepts index tree

* Add es/docs/contribute index tree

* Add es/docs/setup index tree

* Add es/docs/tutorials index tree

* Add es/docs/reference index tree

* Add es/docs/tasks index tree

* Add es/docs/reference landing page

* Add es/docs/home landing page

* Add es/docs/tutoriales landing page

* Add es/docs/getting-started-guides index tree

* Add es/docs/concepts landing page

* Add es/docs/contribute landing page

* Add es/docs/setup landing page

* Apply review requests and fixes
  • Loading branch information
raelga authored and k8s-ci-robot committed Apr 16, 2019
1 parent 3d9dcfc commit cb49ff1
Show file tree
Hide file tree
Showing 76 changed files with 767 additions and 4 deletions.
77 changes: 77 additions & 0 deletions content/es/docs/concepts/_index.md
@@ -0,0 +1,77 @@
---
title: Conceptos
main_menu: true
content_template: templates/concept
weight: 40
---

{{% capture 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 %}}

## Introducción

En Kubernetes se utilizan objetos *objetos de la API de Kubernetes* para describir el *estado deseado* del clúster: qué aplicaciones u otras cargas de trabajo se quieren ejecutar, qué imagenes de contendores usan, el número de replicas, qué red y qué recursos de almacenamiento quieres que tengan disponibles, etc. Se especifica el estado deseado del clúster mediante la creación de objetos usando la API de Kubernetes, típicamente mediante la interfaz de línea de comandos, `kubectl`. También se puede usar la API de Kubernetes directamente para interactuar con el clúster y especificar o modificar tu estado deseado.

Una vez que se especifica el estado deseado, el *Plano de Control de Kubernetes* realizará las acciones necesarias para que el estado actual del clúster coincida con el estado deseado. Para ello, Kubernetes realiza diferentes tareas de forma automática, como pueden ser: parar o arrancar contenedores, escalar el número de réplicas de una aplicación dada, etc. El Plano de Control de Kubernetes consiste en un grupo de procesos que corren en tu clúster:

* El **Master de Kubernetes** es un conjunto de tres procesos que se ejecutan en un único nodo del clúster, que se denomina nodo master. Estos procesos son: [kube-apiserver](/docs/admin/kube-apiserver/), [kube-controller-manager](/docs/admin/kube-controller-manager/) y [kube-scheduler](/docs/admin/kube-scheduler/).

* Los restantes nodos no master contenidos en tu clúster, ejecutan los siguientes dos procesos:
* **[kubelet](/docs/admin/kubelet/)**, el cual se comunica con el Master de Kubernetes.
* **[kube-proxy](/docs/admin/kube-proxy/)**, un proxy de red que implementa los servicios de red de Kubernetes en cada nodo.

## Objetos de Kubernetes

Kubernetes tiene diferentes abstracciones que representan el estado de tu sistema: aplicaciones contenerizadas desplegadas y cargas de trabajo, sus recursos de red y almacenamiento asociados e información adicional acerca de lo que el clúster está haciendo en un momento dado. Estas abstracciones están representadas por objetos de la API de Kubernetes. Puedes revisar [Entendiendo los Objetos de Kubernetes] (/docs/concepts/overview/working-with-objects/kubernetes-objects/) para obtener más detalles.

Los objetos básicos de Kubernetes incluyen:

* [Pod](/docs/concepts/workloads/pods/pod-overview/)
* [Service](/docs/concepts/services-networking/service/)
* [Volume](/docs/concepts/storage/volumes/)
* [Namespace](/docs/concepts/overview/working-with-objects/namespaces/)

Además, Kubernetes contiene abstracciónes de nivel superior llamadas Controladores. Los Controladores se basan en los objetos básicos y proporcionan funcionalidades adicionales sobre ellos. Incluyen:

* [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/)
* [Deployment](/docs/concepts/workloads/controllers/deployment/)
* [StatefulSet](/docs/concepts/workloads/controllers/statefulset/)
* [DaemonSet](/docs/concepts/workloads/controllers/daemonset/)
* [Job](/docs/concepts/workloads/controllers/jobs-run-to-completion/)


## Plano de Control de Kubernetes

Los distintos componentes del Plano de Control de Kubernetes, tales como el Master de Kubernetes y el proceso kubelet, gobiernan cómo Kubernetes se comunica con el clúster. El Plano de Control mantiene un registro de todos los Objetos de Kubernetes presentes en el sistema y ejecuta continuos bucles de control para gestionar el estado de los mismos. En un momento dado, los bucles del Plano de Control responderán a los cambios que se realicen en el clúster y ejecutarán las acciones necesarias para hacer que el estado actual de todos los objetos del sistema converjan hacia el estado deseado que has proporcionado.

Por ejemplo, cuando usas la API de Kubernetes para crear un Deployment, estás proporcionando un nuevo estado deseado para el sistema. El Plano de Control de Kubernetes registra la creación del objeto y lleva a cabo tus instrucciones ejecutando las aplicaciones requeridas en los nodos del clúster, haciendo de esta manera que el estado actual coincida con el estado deseado.

### El Master de Kubernetes

El Master de Kubernetes es el responsable de mantener el estado deseado de tu clúster. Cuando interactuas con Kubernetes, como por ejemplo cuando utilizas la interfaz de línea de comandos `kubectl`, te estás comunicando con el master de tu clúster de Kubernetes.

> Por "master" entendemos la colección de procesos que gestionan el estado del clúster. Típicamente, estos procesos se ejecutan todos en un único nodo del clúster, y este nodo recibe por tanto la denominación de master. El master puede estar replicado por motivos de disponibilidad y redundancia.
### Kubernetes Nodes

En un clúster de Kubernetes, los nodos son las máquinas (máquinas virtuales, servidores físicos, etc) que ejecutan tus aplicaciones y flujos de trabajo en la nube. El master de Kubernetes controla cada nodo, por lo que en raras ocasiones interactuarás con los nodos directamente.

#### Metadatos de los Objectos


* [Annotations](/docs/concepts/overview/working-with-objects/annotations/)

{{% /capture %}}

{{% capture 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 %}}
4 changes: 4 additions & 0 deletions content/es/docs/concepts/architecture/_index.md
@@ -0,0 +1,4 @@
---
title: "Arquitectura de Kubernetes"
weight: 30
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/cluster-administration/_index.md
@@ -0,0 +1,4 @@
---
title: "Administración del Clúster"
weight: 100
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/configuration/_index.md
@@ -0,0 +1,4 @@
---
title: "Configuración"
weight: 80
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/containers/_index.md
@@ -0,0 +1,4 @@
---
title: "Contenedores"
weight: 40
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/extend-kubernetes/_index.md
@@ -0,0 +1,4 @@
---
title: Extendiendo Kubernetes
weight: 110
---
@@ -0,0 +1,4 @@
---
title: Extendiendo la API de Kubernetes
weight: 20
---
@@ -0,0 +1,4 @@
---
title: Extensiones de computación, almacenamiento y redes
weight: 30
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/overview/_index.md
@@ -0,0 +1,4 @@
---
title: "Introducción"
weight: 20
---
@@ -0,0 +1,4 @@
---
title: "Gestión de objetos usando kubectl"
weight: 50
---
@@ -0,0 +1,4 @@
---
title: "Objetos de Kubernetes"
weight: 40
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/policy/_index.md
@@ -0,0 +1,4 @@
---
title: "Políticas"
weight: 90
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/services-networking/_index.md
@@ -0,0 +1,4 @@
---
title: "Servicios, balanceo de carga y redes"
weight: 60
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/storage/_index.md
@@ -0,0 +1,4 @@
---
title: "Almacenamiento"
weight: 70
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/workloads/_index.md
@@ -0,0 +1,4 @@
---
title: "Cargas de trabajo"
weight: 50
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/workloads/controllers/_index.md
@@ -0,0 +1,4 @@
---
title: "Controladores"
weight: 20
---
4 changes: 4 additions & 0 deletions content/es/docs/concepts/workloads/pods/_index.md
@@ -0,0 +1,4 @@
---
title: "Pods"
weight: 10
---
85 changes: 85 additions & 0 deletions content/es/docs/contribute/_index.md
@@ -0,0 +1,85 @@
---
content_template: templates/concept
title: Contribuir a la documentación de Kubernetes
linktitle: Contribuir
main_menu: true
weight: 80
---

{{% capture overview %}}

Kubernetes es posible gracias a la participación de la comunidad y la
documentación es vital para facilitar el acceso al proyecto.

Cualquiera puede contribuir en el proyecto de Kubernetes, tanto si acabas de
descubrir la plataforma como si lleves años involucrado. Tampoco importa si
eres desarrollador, usuario final o alguien que simplemente no soporta ver
errores tipográficos. **¡Cualquier contribución será bien recibida!**

Para conocer más formas de involucrarse en la comunidad de Kubernetes o de
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 %}}

## Tipos de contribuidores

- _**Kubernetes Member**_, un miembro de la organziación de Kubernetes que ha
[firmado el CLA](/docs/contribute/start#sign-the-cla) y contribuido al projecto.
Puedes consultar más información en el documento sobre los requisitos para ser
miembro de Kubernetes en el documento _[Community membership](https://github.com/kubernetes/community/blob/master/community-membership.md)_.

- _**SIG Docs reviewer**_, un revisor del grupo de interés de documentación es
un miembro de la organización Kubernetes que tiene interés en revisar las
_pull requests_ relacionadas con el site y la documentación. Para poder ser
revisor, un aprobador de SIG Docs debe añadirlo al grupo adecuado de GitHub y
al fichero `OWNERS` del contenido que está interesado en revisar.

- _**SIG Docs approver**_, un aprobador del grupo de interés de documentación
es un miembro de la organización de Kubernetes con buena reputación y que ha
mostrado una compromiso continuado con el proyecto.
Un aprobador se responsabiliza de mergear las _pull requests_ y publicar
contenido en nombre de la organización Kubernetes. Los aprobadores también
pueden representar a SIG Docs en la comunidad de Kubernetes en general.
Algunas de las responsabilidades de un aprobador de SIG Docs, como por ejemplo
coordinar una _release_, requieren un compromiso de tiempo significativo.

## Cómo contribuir

La siguiente lista está organizada por el nivel de implicación con la comunidad,
desde las contribuciones que cualquiera puede hacer hasta las que requieren un
compromiso con el equipo de documentación y estar familiarizado con los procesos
de SIG Docs. Contribuir consistentemente a lo largo del tiempo puede ayudarte a
comprender algunas de las herramientas y decisiones organizativas que se han ido
tomando a lo largo del proyecto.

La lista no contiene todas las formas de contribución posibles, está pensada
para proporcionar un punto de partida.

- [Todo el mundo](/docs/contribute/start/)
- Abrir issues accionables para que el equipo pueda trabajar en ello
- [Miembro](/docs/contribute/start/)
- Mejorar la documetanción existente
- Proponer ideas de mejora en [Slack](http://slack.k8s.io/) o en [SIG docs mailing list](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
- Mejorar la accesibilidad de la documentación
- Proporcionar comentarios no vinculantes sobre PRs
- Escribir una entrada para el blog o un caso de estudio
- [Revisor](/docs/contribute/intermediate/)
- Documentar nuevas funcionalidades
- Selección y clasificacion de nuevos Issues
- Revisar PRs
- Crear diagramas, material gráfico y screencasts / videos
- Localización del contenido
- Contribuye a otros repos como representante del equipo de documentación
- Edit user-facing strings in code
- Mejorar los comentarios de código, Godoc
- [Aprobador](/docs/contribute/advanced/)
- Publicar el contenido de colaboradores aprobando y mergeando las PRs
- Participar en el equipo de Release de Kubernetes como representeante del equipo de Docs
- Proponer mejoras a la guía de estilo
- Proponer mejoras a los tests de la documentación
- Proponer mejoras al sitio web de Kubernetes y otras herramientas

{{% /capture %}}
10 changes: 10 additions & 0 deletions content/es/docs/contribute/generate-ref-docs/_index.md
@@ -0,0 +1,10 @@
---
title: Documentación de referencia
main_menu: true
weight: 80
---

Gran parte de la documentación de referencia de **Kubernetes** se genera a
partir del propio **código fuente de Kubernetes** utilizando scripts.

Los temas de esta sección documentan cómo generar este tipo de contenido.
12 changes: 12 additions & 0 deletions content/es/docs/contribute/style/_index.md
@@ -0,0 +1,12 @@
---
title: Cómo escribir documentación
main_menu: true
weight: 80
---

Los temas de esta sección proporcionan información sobre como **escribir**,
**formatear** y **organizar** el contenido de la documentación de Kubernetes.

También se explican las funciones, templates, variables y otras configuraciones
de **[Hugo](https://gohugo.io/)** utilizadas para generar y dar formato a
[kubernetes.io](https://kubernetes.io).
4 changes: 4 additions & 0 deletions content/es/docs/getting-started-guides/_index.md
@@ -0,0 +1,4 @@
---
title: Guías de iniciación
weight: 50
---
4 changes: 4 additions & 0 deletions content/es/docs/getting-started-guides/fedora/_index.md
@@ -0,0 +1,4 @@
---
title: Fedora
weight: 60
---
57 changes: 57 additions & 0 deletions content/es/docs/home/_index.md
@@ -0,0 +1,57 @@
---
title: Documentación de Kubernetes
noedit: true
cid: docsHome
layout: docsportal_home
class: gridPage
linkTitle: "Home"
main_menu: true
weight: 10
hide_feedback: true
menu:
main:
title: "Documentación"
weight: 20
post: >
<p>Aprenda cómo usar Kubernetes con la documentación, los tutoriales y revisando la información de referencia. También puedes <a href="/editdocs/" data-auto-burger-exclude>contribuir con la documentación</a>!</p>
overview: >
Kubernetes es una plataforma de código abierto para automatizar la implementación, el escalado y la administración de aplicaciones en contenedores.
El proyecto está amparado por la Cloud Native Computing Foundation (<a href="https://www.cncf.io/about">CNCF</a>).
cards:
- name: concepts
title: Entiende los conceptos básicos
description: Aprender sobre Kubernetes y sus conceptos fundamentales.
button: Aprender conceptos
button_path: "/docs/concepts"
- name: tutorials
title: Prueba Kubernetes
description: Sigue los tutoriales para aprender a implementar aplicaciones en Kubernetes.
button: Ver tutoriales
button_path: "/docs/tutorials"
- name: setup
title: Configura un clúster
description: Configura un clúster de Kubernetes en función de sus recursos y necesidades.
button: Configurar Kubernetes
button_path: "/docs/setup"
- name: tasks
title: Aprenda a usar Kubernetes
description: Busca tareas comunes y aprende cómo llevarlas a cabo siguiendo un procedimiento.
button: Ver tareas
button_path: "/docs/tasks"
- name: reference
title: Busque información de referencia
description: Examine la terminología, la sintaxis de la línea de comandos, los tipos de recursos API y la documentación de las herramientas de configuración.
button: Ver información de referencia
button_path: /docs/reference
- name: contribute
title: Contribuye a la documentación
description: Cualquiera puede contribuir, ya sea nuevo en el proyecto o si lleva tiempo participando.
button: Contribuir
button_path: /docs/contribute
- name: download
title: Descargar Kubernetes
description: Si está instalando Kubernetes o está actualizando a la versión más reciente, consulte las notas de la versión actual.
- name: about
title: Sobre la documentacion
description: Este sitio web contiene documentación para las 4 versiones actuales y anteriores de Kubernetes. La documentación en castellano está en progreso y, por ese motivo, muchas de las páginas llevan a la versión inglesa.
---

0 comments on commit cb49ff1

Please sign in to comment.