From 4a04fe49c6032f630819a20c1e9067dea934ae0f Mon Sep 17 00:00:00 2001 From: Paul Lee Date: Tue, 13 Oct 2020 11:36:02 -0700 Subject: [PATCH 1/2] add feature state --- content/es/docs/concepts/workloads/pods/podpreset.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/content/es/docs/concepts/workloads/pods/podpreset.md b/content/es/docs/concepts/workloads/pods/podpreset.md index 87cd6bb83f..5975e9fede 100644 --- a/content/es/docs/concepts/workloads/pods/podpreset.md +++ b/content/es/docs/concepts/workloads/pods/podpreset.md @@ -7,6 +7,8 @@ weight: 50 --- +{{< feature-state for_k8s_version="v1.6" state="alpha" >}} + 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, From 5c2873a5523e1caa22604225a2f84dd9c6ec0228 Mon Sep 17 00:00:00 2001 From: Paul Lee Date: Tue, 13 Oct 2020 11:58:29 -0700 Subject: [PATCH 2/2] initial pass with moving around content, capitalization, formats --- .../docs/concepts/workloads/pods/podpreset.md | 67 +++++++++---------- 1 file changed, 32 insertions(+), 35 deletions(-) diff --git a/content/es/docs/concepts/workloads/pods/podpreset.md b/content/es/docs/concepts/workloads/pods/podpreset.md index 5975e9fede..d4406f56ea 100644 --- a/content/es/docs/concepts/workloads/pods/podpreset.md +++ b/content/es/docs/concepts/workloads/pods/podpreset.md @@ -9,7 +9,7 @@ weight: 50 {{< feature-state for_k8s_version="v1.6" state="alpha" >}} -Esta página provee una descripción general de los Pod Presets, los cuales son +Esta página provee una descripción general de los PodPresets, 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. @@ -19,16 +19,35 @@ montajes de volúmenes y variables de entorno. ## Entendiendo los Pod Presets -Un `Pod Preset` es un recurso de la API utilizado para poder inyectar requerimientos +Un PodPreset 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. +para especificar los Pods a los que se aplica un PodPreset determinado. -El uso de un Pod Preset permite a los autores de plantillas de Pods no tener que proporcionar +El uso de un PodPreset 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). + +## Habilitando un PodPreset en su clúster + +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. + ## Cómo funciona @@ -48,51 +67,29 @@ Cuando se realiza una solicitud de creación de Pods, el sistema hace lo siguien indicar que ha sido modificada por un `PodPreset`. La nota descriptiva presenta la forma `podpreset.admission.kubernetes.io/podpreset-: ""`. -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`, +Cada Pod puede ser correspondido por cero o más Pod Presets; y cada `PodPreset` puede ser +aplicado a cero o más Pods. Cuando se aplica un `PodPreset` 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. +para los cambios a `volumes`, 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). +- El campo `.spec.initContainers` {{< /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á. - +`.spec` de la siguiente forma: `podpreset.admission.kubernetes.io/exclude: "true"`. ## {{% heading "whatsnext" %}} -* [Inyectando datos en un Pod usando PodPreset](/docs/tasks/inject-data-application/podpreset/) - +Ver [Inyectando datos en un Pod usando PodPreset](/docs/tasks/inject-data-application/podpreset/) +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).