Add content/es/docs/concepts/workloads/pods/podpreset.md (#17265)
* added podpreset.md * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Rael Garcia <rael@rael.io> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com> * Update content/es/docs/concepts/workloads/pods/podpreset.md Co-Authored-By: Victor Morales <chipahuac@hotmail.com>
This commit is contained in:
Carlos Almeida
Kubernetes Prow Robot
parent
31970ef6f9
commit
5a562997a8
|
|
@ -0,0 +1,95 @@
|
|||
---
|
||||
reviewers:
|
||||
- raelga
|
||||
title: Pod Preset
|
||||
content_template: templates/concept
|
||||
weight: 50
|
||||
---
|
||||
|
||||
{{% capture 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 %}}
|
||||
## Entendiendo los Pod Presets
|
||||
|
||||
Un `Pod Preset` es un recurso de la API utilizado para poder inyectar requerimientos
|
||||
adicionales de tiempo de ejecución en un Pod en el momento de la creación.
|
||||
Se utilizan los [selectores de etiquetas](/docs/concepts/overview/working-with-objects/labels/#label-selectors)
|
||||
para especificar los Pods a los que se aplica un Pod Preset determinado.
|
||||
|
||||
El uso de un Pod Preset permite a los autores de plantillas de Pods no tener que proporcionar
|
||||
explícitamente toda la información de cada Pod. De esta manera, los autores de plantillas de
|
||||
Pods que consuman un determinado servicio no tendrán que conocer todos los detalles de ese servicio.
|
||||
|
||||
Para más información sobre los detalles de los trasfondos, consulte la [propuesta de diseño de PodPreset](https://git.k8s.io/community/contributors/design-proposals/service-catalog/pod-preset.md).
|
||||
|
||||
## Cómo funciona
|
||||
|
||||
Kubernetes provee un controlador de admisión (`PodPreset`) que, cuando está habilitado,
|
||||
aplica los Pod Presets a las peticiones de creación de Pods entrantes.
|
||||
Cuando se realiza una solicitud de creación de Pods, el sistema hace lo siguiente:
|
||||
|
||||
1. Obtiene todos los `PodPresets` disponibles para usar.
|
||||
2. Verifica si los selectores de etiquetas de cualquier `PodPreset` correspondan
|
||||
con las etiquetas del Pod que se está creando.
|
||||
3. Intenta fusionar los diversos recursos definidos por el `PodPreset` dentro del Pod
|
||||
que se está creando.
|
||||
4. Si se llegase a producir un error al intentar fusionar los recursos dentro del Pod,
|
||||
lanza un evento que documente este error, luego crea el Pod _sin_ ningún recurso que se
|
||||
inyecte desde el `PodPreset`.
|
||||
5. Escribe una nota descriptiva de la especificación de Pod modificada resultante para
|
||||
indicar que ha sido modificada por un `PodPreset`. La nota descriptiva presenta la forma
|
||||
`podpreset.admission.kubernetes.io/podpreset-<pod-preset name>: "<resource version>"`.
|
||||
|
||||
Cada Pod puede ser correspondido por cero o más Pod Presets; y cada `Pod Preset` puede ser
|
||||
aplicado a cero o más Pods. Cuando se aplica un `Pod Preset` a una o más Pods, Kubernetes
|
||||
modifica la especificación del Pod. Para los cambios a `Env`, `EnvFrom`, y `VolumeMounts`,
|
||||
Kubernetes modifica la especificación del Container para todos los Containers en el Pod;
|
||||
para los cambios a `Volume`, Kubernetes modifica la especificación del Pod.
|
||||
|
||||
{{< note >}}
|
||||
Un Pod Preset es capaz de modificar los siguientes campos en las especificaciones de un Pod
|
||||
en caso de ser necesario:
|
||||
- El campo `.spec.containers`.
|
||||
- El campo `initContainers` (requiere Kubernetes versión 1.14.0 o posterior).
|
||||
{{< /note >}}
|
||||
|
||||
### Deshabilitar un Pod Preset para un Pod específico
|
||||
|
||||
Puede haber casos en los que se desee que un Pod no se vea alterado por ninguna posible
|
||||
modificación del Pod Preset. En estos casos, se puede añadir una observación en el Pod
|
||||
Spec de la siguiente forma: `podpreset.admission.kubernetes.io/exclude: "true"`.
|
||||
|
||||
## Habilitando un Pod Preset
|
||||
|
||||
Con el fin de utilizar los Pod Presets en un clúster debe asegurarse de lo siguiente:
|
||||
|
||||
1. Que se ha configurado el tipo de API `settings.k8s.io/v1alpha1/podpreset`. Esto se puede hacer,
|
||||
por ejemplo, incluyendo `settings.k8s.io/v1alpha1=true` como valor de la opción `--runtime-config`
|
||||
en el servidor API. En minikube se debe añadir el flag
|
||||
`--extra-config=apiserver.runtime-config=settings.k8s.io/v1alpha1=true` cuando el clúster
|
||||
se está iniciando.
|
||||
2. Que se ha habilitado el controlador de admisión `PodPreset`. Una forma de hacer esto es incluir
|
||||
`PodPreset` como valor de la opción `--enable-admission-plugins` especificada
|
||||
para el servidor API. En minikube se debe añadir el flag
|
||||
|
||||
```shell
|
||||
--extra-config=apiserver.enable-admission-plugins=NamespaceLifecycle,LimitRanger,ServiceAccount,DefaultStorageClass,DefaultTolerationSeconds,NodeRestriction,MutatingAdmissionWebhook,ValidatingAdmissionWebhook,ResourceQuota,PodPreset
|
||||
```
|
||||
|
||||
cuando el clúster se está iniciando.
|
||||
3. Que se han definido los Pod Presets mediante la creación de objetos `PodPreset` en el
|
||||
namespace que se utilizará.
|
||||
|
||||
{{% /capture %}}
|
||||
|
||||
{{% capture whatsnext %}}
|
||||
|
||||
* [Inyectando datos en un Pod usando PodPreset](/docs/tasks/inject-data-application/podpreset/)
|
||||
|
||||
{{% /capture %}}
|
||||
Loading…
Reference in New Issue