-
Notifications
You must be signed in to change notification settings - Fork 14.6k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* 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
1 parent
3d9dcfc
commit cb49ff1
Showing
76 changed files
with
767 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 %}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Arquitectura de Kubernetes" | ||
weight: 30 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Administración del Clúster" | ||
weight: 100 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Configuración" | ||
weight: 80 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Contenedores" | ||
weight: 40 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: Extendiendo Kubernetes | ||
weight: 110 | ||
--- |
4 changes: 4 additions & 0 deletions
4
content/es/docs/concepts/extend-kubernetes/api-extension/_index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: Extendiendo la API de Kubernetes | ||
weight: 20 | ||
--- |
4 changes: 4 additions & 0 deletions
4
content/es/docs/concepts/extend-kubernetes/compute-storage-net/_index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: Extensiones de computación, almacenamiento y redes | ||
weight: 30 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Introducción" | ||
weight: 20 | ||
--- |
4 changes: 4 additions & 0 deletions
4
content/es/docs/concepts/overview/object-management-kubectl/_index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Gestión de objetos usando kubectl" | ||
weight: 50 | ||
--- |
4 changes: 4 additions & 0 deletions
4
content/es/docs/concepts/overview/working-with-objects/_index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Objetos de Kubernetes" | ||
weight: 40 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Políticas" | ||
weight: 90 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Servicios, balanceo de carga y redes" | ||
weight: 60 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Almacenamiento" | ||
weight: 70 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Cargas de trabajo" | ||
weight: 50 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Controladores" | ||
weight: 20 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: "Pods" | ||
weight: 10 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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 %}} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: Guías de iniciación | ||
weight: 50 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,4 @@ | ||
--- | ||
title: Fedora | ||
weight: 60 | ||
--- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -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. | ||
--- |
Oops, something went wrong.