Skip to content

Commit cb49ff1

Browse files
raelgak8s-ci-robot
raelga
authored and
k8s-ci-robot
committed
Add es/docs index tree (#13809)
* 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
1 parent 3d9dcfc commit cb49ff1

File tree

76 files changed

+767
-4
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

76 files changed

+767
-4
lines changed

‎content/es/docs/concepts/_index.md

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
---
2+
title: Conceptos
3+
main_menu: true
4+
content_template: templates/concept
5+
weight: 40
6+
---
7+
8+
{{% capture overview %}}
9+
10+
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.
11+
12+
{{% /capture %}}
13+
14+
{{% capture body %}}
15+
16+
## Introducción
17+
18+
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.
19+
20+
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:
21+
22+
* 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/).
23+
24+
* Los restantes nodos no master contenidos en tu clúster, ejecutan los siguientes dos procesos:
25+
* **[kubelet](/docs/admin/kubelet/)**, el cual se comunica con el Master de Kubernetes.
26+
* **[kube-proxy](/docs/admin/kube-proxy/)**, un proxy de red que implementa los servicios de red de Kubernetes en cada nodo.
27+
28+
## Objetos de Kubernetes
29+
30+
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.
31+
32+
Los objetos básicos de Kubernetes incluyen:
33+
34+
* [Pod](/docs/concepts/workloads/pods/pod-overview/)
35+
* [Service](/docs/concepts/services-networking/service/)
36+
* [Volume](/docs/concepts/storage/volumes/)
37+
* [Namespace](/docs/concepts/overview/working-with-objects/namespaces/)
38+
39+
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:
40+
41+
* [ReplicaSet](/docs/concepts/workloads/controllers/replicaset/)
42+
* [Deployment](/docs/concepts/workloads/controllers/deployment/)
43+
* [StatefulSet](/docs/concepts/workloads/controllers/statefulset/)
44+
* [DaemonSet](/docs/concepts/workloads/controllers/daemonset/)
45+
* [Job](/docs/concepts/workloads/controllers/jobs-run-to-completion/)
46+
47+
48+
## Plano de Control de Kubernetes
49+
50+
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.
51+
52+
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.
53+
54+
### El Master de Kubernetes
55+
56+
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.
57+
58+
> 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.
59+
60+
### Kubernetes Nodes
61+
62+
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.
63+
64+
#### Metadatos de los Objectos
65+
66+
67+
* [Annotations](/docs/concepts/overview/working-with-objects/annotations/)
68+
69+
{{% /capture %}}
70+
71+
{{% capture whatsnext %}}
72+
73+
Si estás interesado en escribir una página sobre conceptos,
74+
revisa [Usando Templates de Páginas](/docs/home/contribute/page-templates/)
75+
para obtener información sobre el tipo de página conceptos y la plantilla conceptos.
76+
77+
{{% /capture %}}

‎content/es/docs/concepts/architecture/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Arquitectura de Kubernetes"
3+
weight: 30
4+
---

‎content/es/docs/concepts/cluster-administration/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Administración del Clúster"
3+
weight: 100
4+
---

‎content/es/docs/concepts/configuration/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Configuración"
3+
weight: 80
4+
---

‎content/es/docs/concepts/containers/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Contenedores"
3+
weight: 40
4+
---

‎content/es/docs/concepts/extend-kubernetes/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: Extendiendo Kubernetes
3+
weight: 110
4+
---

‎content/es/docs/concepts/extend-kubernetes/api-extension/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: Extendiendo la API de Kubernetes
3+
weight: 20
4+
---

‎content/es/docs/concepts/extend-kubernetes/compute-storage-net/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: Extensiones de computación, almacenamiento y redes
3+
weight: 30
4+
---

‎content/es/docs/concepts/overview/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Introducción"
3+
weight: 20
4+
---

‎content/es/docs/concepts/overview/object-management-kubectl/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Gestión de objetos usando kubectl"
3+
weight: 50
4+
---

‎content/es/docs/concepts/overview/working-with-objects/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Objetos de Kubernetes"
3+
weight: 40
4+
---

‎content/es/docs/concepts/policy/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Políticas"
3+
weight: 90
4+
---

‎content/es/docs/concepts/services-networking/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Servicios, balanceo de carga y redes"
3+
weight: 60
4+
---

‎content/es/docs/concepts/storage/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Almacenamiento"
3+
weight: 70
4+
---

‎content/es/docs/concepts/workloads/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Cargas de trabajo"
3+
weight: 50
4+
---

‎content/es/docs/concepts/workloads/controllers/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Controladores"
3+
weight: 20
4+
---

‎content/es/docs/concepts/workloads/pods/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: "Pods"
3+
weight: 10
4+
---

‎content/es/docs/contribute/_index.md

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
content_template: templates/concept
3+
title: Contribuir a la documentación de Kubernetes
4+
linktitle: Contribuir
5+
main_menu: true
6+
weight: 80
7+
---
8+
9+
{{% capture overview %}}
10+
11+
Kubernetes es posible gracias a la participación de la comunidad y la
12+
documentación es vital para facilitar el acceso al proyecto.
13+
14+
Cualquiera puede contribuir en el proyecto de Kubernetes, tanto si acabas de
15+
descubrir la plataforma como si lleves años involucrado. Tampoco importa si
16+
eres desarrollador, usuario final o alguien que simplemente no soporta ver
17+
errores tipográficos. **¡Cualquier contribución será bien recibida!**
18+
19+
Para conocer más formas de involucrarse en la comunidad de Kubernetes o de
20+
aprender sobre nosotros, visite la sección [comunidad de Kubernetes](/community/).
21+
22+
Para obtener información cómo escribir documentación de Kubernetes,
23+
consulte la [guía de estilo](/docs/contribute/style/style-guide/).
24+
25+
{{% capture body %}}
26+
27+
## Tipos de contribuidores
28+
29+
- _**Kubernetes Member**_, un miembro de la organziación de Kubernetes que ha
30+
[firmado el CLA](/docs/contribute/start#sign-the-cla) y contribuido al projecto.
31+
Puedes consultar más información en el documento sobre los requisitos para ser
32+
miembro de Kubernetes en el documento _[Community membership](https://github.com/kubernetes/community/blob/master/community-membership.md)_.
33+
34+
- _**SIG Docs reviewer**_, un revisor del grupo de interés de documentación es
35+
un miembro de la organización Kubernetes que tiene interés en revisar las
36+
_pull requests_ relacionadas con el site y la documentación. Para poder ser
37+
revisor, un aprobador de SIG Docs debe añadirlo al grupo adecuado de GitHub y
38+
al fichero `OWNERS` del contenido que está interesado en revisar.
39+
40+
- _**SIG Docs approver**_, un aprobador del grupo de interés de documentación
41+
es un miembro de la organización de Kubernetes con buena reputación y que ha
42+
mostrado una compromiso continuado con el proyecto.
43+
Un aprobador se responsabiliza de mergear las _pull requests_ y publicar
44+
contenido en nombre de la organización Kubernetes. Los aprobadores también
45+
pueden representar a SIG Docs en la comunidad de Kubernetes en general.
46+
Algunas de las responsabilidades de un aprobador de SIG Docs, como por ejemplo
47+
coordinar una _release_, requieren un compromiso de tiempo significativo.
48+
49+
## Cómo contribuir
50+
51+
La siguiente lista está organizada por el nivel de implicación con la comunidad,
52+
desde las contribuciones que cualquiera puede hacer hasta las que requieren un
53+
compromiso con el equipo de documentación y estar familiarizado con los procesos
54+
de SIG Docs. Contribuir consistentemente a lo largo del tiempo puede ayudarte a
55+
comprender algunas de las herramientas y decisiones organizativas que se han ido
56+
tomando a lo largo del proyecto.
57+
58+
La lista no contiene todas las formas de contribución posibles, está pensada
59+
para proporcionar un punto de partida.
60+
61+
- [Todo el mundo](/docs/contribute/start/)
62+
- Abrir issues accionables para que el equipo pueda trabajar en ello
63+
- [Miembro](/docs/contribute/start/)
64+
- Mejorar la documetanción existente
65+
- 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)
66+
- Mejorar la accesibilidad de la documentación
67+
- Proporcionar comentarios no vinculantes sobre PRs
68+
- Escribir una entrada para el blog o un caso de estudio
69+
- [Revisor](/docs/contribute/intermediate/)
70+
- Documentar nuevas funcionalidades
71+
- Selección y clasificacion de nuevos Issues
72+
- Revisar PRs
73+
- Crear diagramas, material gráfico y screencasts / videos
74+
- Localización del contenido
75+
- Contribuye a otros repos como representante del equipo de documentación
76+
- Edit user-facing strings in code
77+
- Mejorar los comentarios de código, Godoc
78+
- [Aprobador](/docs/contribute/advanced/)
79+
- Publicar el contenido de colaboradores aprobando y mergeando las PRs
80+
- Participar en el equipo de Release de Kubernetes como representeante del equipo de Docs
81+
- Proponer mejoras a la guía de estilo
82+
- Proponer mejoras a los tests de la documentación
83+
- Proponer mejoras al sitio web de Kubernetes y otras herramientas
84+
85+
{{% /capture %}}

‎content/es/docs/contribute/generate-ref-docs/_index.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
title: Documentación de referencia
3+
main_menu: true
4+
weight: 80
5+
---
6+
7+
Gran parte de la documentación de referencia de **Kubernetes** se genera a
8+
partir del propio **código fuente de Kubernetes** utilizando scripts.
9+
10+
Los temas de esta sección documentan cómo generar este tipo de contenido.

‎content/es/docs/contribute/style/_index.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
title: Cómo escribir documentación
3+
main_menu: true
4+
weight: 80
5+
---
6+
7+
Los temas de esta sección proporcionan información sobre como **escribir**,
8+
**formatear** y **organizar** el contenido de la documentación de Kubernetes.
9+
10+
También se explican las funciones, templates, variables y otras configuraciones
11+
de **[Hugo](https://gohugo.io/)** utilizadas para generar y dar formato a
12+
[kubernetes.io](https://kubernetes.io).

‎content/es/docs/getting-started-guides/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: Guías de iniciación
3+
weight: 50
4+
---

‎content/es/docs/getting-started-guides/fedora/_index.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
---
2+
title: Fedora
3+
weight: 60
4+
---

‎content/es/docs/home/_index.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
---
2+
title: Documentación de Kubernetes
3+
noedit: true
4+
cid: docsHome
5+
layout: docsportal_home
6+
class: gridPage
7+
linkTitle: "Home"
8+
main_menu: true
9+
weight: 10
10+
hide_feedback: true
11+
menu:
12+
main:
13+
title: "Documentación"
14+
weight: 20
15+
post: >
16+
<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>
17+
overview: >
18+
Kubernetes es una plataforma de código abierto para automatizar la implementación, el escalado y la administración de aplicaciones en contenedores.
19+
El proyecto está amparado por la Cloud Native Computing Foundation (<a href="https://www.cncf.io/about">CNCF</a>).
20+
cards:
21+
- name: concepts
22+
title: Entiende los conceptos básicos
23+
description: Aprender sobre Kubernetes y sus conceptos fundamentales.
24+
button: Aprender conceptos
25+
button_path: "/docs/concepts"
26+
- name: tutorials
27+
title: Prueba Kubernetes
28+
description: Sigue los tutoriales para aprender a implementar aplicaciones en Kubernetes.
29+
button: Ver tutoriales
30+
button_path: "/docs/tutorials"
31+
- name: setup
32+
title: Configura un clúster
33+
description: Configura un clúster de Kubernetes en función de sus recursos y necesidades.
34+
button: Configurar Kubernetes
35+
button_path: "/docs/setup"
36+
- name: tasks
37+
title: Aprenda a usar Kubernetes
38+
description: Busca tareas comunes y aprende cómo llevarlas a cabo siguiendo un procedimiento.
39+
button: Ver tareas
40+
button_path: "/docs/tasks"
41+
- name: reference
42+
title: Busque información de referencia
43+
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.
44+
button: Ver información de referencia
45+
button_path: /docs/reference
46+
- name: contribute
47+
title: Contribuye a la documentación
48+
description: Cualquiera puede contribuir, ya sea nuevo en el proyecto o si lleva tiempo participando.
49+
button: Contribuir
50+
button_path: /docs/contribute
51+
- name: download
52+
title: Descargar Kubernetes
53+
description: Si está instalando Kubernetes o está actualizando a la versión más reciente, consulte las notas de la versión actual.
54+
- name: about
55+
title: Sobre la documentacion
56+
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.
57+
---

0 commit comments

Comments
 (0)