Esquema de la base de infraestructura de Aggrega (Recipe)
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/recipe-v1beta1.schema.json
Capa de punteros y de mapeo escrita por Ops que conecta la intención Dev con un proveedor de infraestructura específico. Estrictamente 1:1 con un proveedor físico y un componente del catálogo.
Consulta la referencia de autoría de la Recipe para obtener orientación en prosa sobre cómo escribir entidades Recipe; esta página documenta el esquema estructural que describe esa referencia.
Tipo de nivel superior: object
Propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sí | Constante: "aggrega.ai/v1beta1" |
kind | const “Recipe” | sí | Constante: "Recipe" |
metadata | object | sí | |
spec | object | sí | El enlace con el proveedor, la fuente, la asignación de values y el pipeline de una Recipe. Admite tres tipos de entrada que se componen por adición: con fuente (source más la superposición de valuesMapping), sintetizado (workload) y artifacts (archivos de salida con nombre). Aparte de estos, una Recipe puede aportar archivos a la salida compartida del límite en el que se renderiza, bajo ‘boundary’. |
No se permiten propiedades adicionales.
recipe.metadata
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | Al menos 1 carácter de longitud. |
version | string | sí | Versionado semántico estricto de la receta de implementación (p. ej., 2.1.0). Patrón: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | no | Qué es esta entidad y para qué sirve, escrito para quien está decidiendo si usarla. Empieza con una frase que nombre la cosa y luego añade lo que un lector necesita para elegirla y usarla correctamente — qué espera de la Release que la despliega, y cualquier cosa sorprendente sobre su comportamiento. Un párrafo corto es la extensión habitual. |
maintainers | object[] | no | Lista de mantenedores responsables de esta entidad. |
license | string | no | Identificador SPDX de la licencia del software que describe esta entidad, como MIT o AGPL-3.0. Registra las condiciones de ese software, no las de este archivo. |
repository | string | no | La URL del repositorio Git donde se encuentran los archivos fuente. |
home | string | no | La URL de la página de inicio, la wiki o la documentación de esta entidad. |
keywords | string[] | no | Una lista de palabras clave descriptivas para facilitar el descubrimiento en la interfaz de usuario. |
No se permiten propiedades adicionales.
recipe.metadata.maintainers[]
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | |
email | string | no | |
url | string | no |
No se permiten propiedades adicionales.
recipe.spec
El enlace con el proveedor, la fuente, la asignación de values y el pipeline de una Recipe. Admite tres tipos de entrada que se componen por adición: con fuente (source más la superposición de valuesMapping), sintetizado (workload) y artifacts (archivos de salida con nombre). Aparte de estos, una Recipe puede aportar archivos a la salida compartida del límite en el que se renderiza, bajo ‘boundary’.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
capability | string | sí | La capacidad explícita del proveedor a la que se enlaza esta receta (p. ej., ‘helm’, ‘terraform’, ‘compose’) — el tipo de proveedor que la renderiza. Acepta una fijación de versión opcional, en las mismas tres formas que ‘implements’: sin versión (‘helm’), exacta (‘helm:1.0.0’) o rango compatible con la versión mayor (‘helm:^1.0.0’). El nombre simple selecciona el tipo de proveedor; la fijación, cuando está presente, selecciona qué versión del plugin de renderizado del proveedor que sirve esa capacidad renderiza esta receta — la más alta disponible sin fijación, la exacta para una fijación exacta, la más alta dentro del rango para un acento circunflejo. Una fijación que ninguna versión del plugin que sirve la capacidad satisface detiene la compilación de forma explícita. Todo lo que queda aguas abajo de la selección del proveedor — agrupación de la salida, segmentos de ruta, compatibilidad del pipeline y elección del códec — se basa en la capacidad simple, de modo que dos recetas que fijan versiones distintas del plugin de la misma capacidad coexisten en una misma compilación. |
implements | string | sí | Declara qué tipo de componente del catálogo es capaz de implementar esta receta (versión exacta ‘core/api-server:1.0.0’, rango compatible con la versión mayor ‘core/api-server:^1.0.0’ o sin versión ‘core/api-server’). El compilador lo usa para verificar las asignaciones del Manifest y para sugerir candidatos en los diagnósticos y en el autocompletado del editor; nunca resuelve una compilación. aggrega lint también lo lee, para localizar el Component cuyo contrato provides declarado es aquel con el que se comparan las claves publicadas de una Recipe. La asignación del Manifest es la elección explícita de implementación del usuario, fijada en el archivo de bloqueo de la Release. |
source | string u object | no | La ubicación del código de infraestructura. Acepta una cadena URI o un objeto estructurado abierto cuyas claves definidas por el proveedor se exponen a las plantillas de la Recipe como ‘.source.*’. |
locals | mapa de string | no | El estado privado de Ops. Resultados de cálculo internos disponibles dentro de las plantillas de esta Recipe como ‘.locals.*’. Cada entrada es en sí misma una plantilla Go, evaluada con respecto a un contexto autónomo local al nodo: ‘.context.instance_id’, ‘.values’, ‘.infra’ y las entradas de este mismo bloque resueltas hasta ese momento. Las entradas se resuelven en el orden en que están escritas, y una entrada PUEDE leer una entrada hermana definida ENCIMA de ella, recibiendo el valor resuelto de esa entrada en lugar del texto de su plantilla. El orden del autor forma parte del contrato siempre que una entrada lea otra: mover una definición por debajo de la entrada que la lee rompe la compilación, y el bloque nunca se reordena para que una referencia se resuelva. Una referencia ‘.locals. |
provides | mapa de string o number o boolean | no | La API pública del Desarrollador. Variables de salida contractuales disponibles para la resolución del inject del Invocador aguas abajo. El compilador evalúa las plantillas de provides con respecto a un contexto autónomo, en cualquier orden entre ellas — ninguna entrada de provides lee otra. Los locals del nodo se resuelven en el preámbulo de locals, antes que sus provides, por lo que una plantilla de provides puede leer ‘.locals’ y recibe valores resueltos; nombrar una clave que el bloque locals no declara provoca una detención. Los Invocadores resuelven las claves de inject con respecto a estos valores durante la hidratación del inject. Los valores son escalares — el pipe los transporta tal cual y los convierte en cadenas de forma determinista en el límite de la inyección. |
valuesMapping | string u object | no | Contenido de la asignación de values con tres modos de autoría mediante despacho según la forma del contenido. Modo 1 (inline): un escalar de cadena de plantilla Go (normalmente YAML de escalar de bloque |) que produce el formato de values que espera el proveedor a partir del contexto de Aggrega (.values, .features, .infra). Modo 2 (importación de archivo): un mapa YAML de exactamente una clave, $import: ./relative/path.tmpl, que apunta a un archivo de plantilla Go local. Modo 3 (importación de biblioteca): un mapa YAML de exactamente una clave, $import: <Library>#/mappings/<entry>, que hace referencia a una entrada de una MappingLibrary por identidad de nombre simple (la versión la suministra el archivo de bloqueo de cada Release; ningún host de registro aparece en la referencia). En la forma de objeto, $import no debe coincidir con ^oci://; un valor que coincide se rechaza. |
workload | string u object | no | Productor de YAML de Workload con tres modos de autoría mediante despacho según la forma del contenido. Modo 1 (inline): un escalar de cadena de plantilla Go cuya salida se analiza como ‘aggrega.ai/v1beta1 Workload’. Modo 2 (importación de archivo): un mapa YAML de exactamente una clave, $import: ./relative/path.yaml, que apunta a un archivo de plantilla Go local. Modo 3 (importación de biblioteca): un mapa YAML de exactamente una clave, $import: <Library>#/workloads/<entry>, que hace referencia a una entrada de una WorkloadLibrary por identidad de nombre simple (la versión la suministra el archivo de bloqueo de cada Release; ningún host de registro aparece en la referencia). El Provider de destino debe admitir la síntesis de cargas de trabajo; el catálogo de la biblioteca estándar declara workloadSchema en esos proveedores como el contrato documentado. Una Recipe con workload: enlazada a un proveedor que no puede sintetizar se detiene de forma explícita en tiempo de renderizado. En la forma de objeto, $import no debe coincidir con ^oci://; un valor que coincide se rechaza. |
artifacts | mapa de string u object | no | Mapa del nombre de entrada a la autoría del contenido del artefacto. El valor de cada entrada lleva uno de tres modos mediante despacho según la forma del contenido. Modo 1 (inline): un escalar de cadena de plantilla Go cuya salida es el cuerpo del artefacto. Modo 2 (importación de archivo): un mapa YAML de exactamente una clave, $import: ./relative/path.yaml, que apunta a un archivo de plantilla Go local. Modo 3 (importación de biblioteca): un mapa YAML de exactamente una clave, $import: <Library>#/artifacts/<entry>, que hace referencia a un bundle de una ArtifactLibrary por identidad de nombre simple (la versión la suministra el archivo de bloqueo de cada Release; ningún host de registro aparece en la referencia). Un bundle se expande en una salida por archivo, cada una anidada bajo la clave de la entrada como <key>/<filename>. La clave nombra la salida de la entrada: la clave de una entrada de modo 1 o 2 es su nombre de archivo de salida, usado tal como está escrito, y el archivo importado de una entrada de modo 2 suministra el contenido sin nombrar la salida, de modo que dos entradas que importan archivos distintos que comparten un nombre son dos salidas distintas. Las colisiones entre entradas de artefactos, archivos de bundle, salida de la fuente y síntesis de cargas de trabajo detienen la compilación cuando se renderiza el nodo. El bloque artifacts se escribe de forma idéntica en una Recipe y en una FeatureRecipe — los mismos tres modos, la misma regla de clave a salida y el mismo comportamiento ante colisiones — y por eso esa parte de esta descripción se lee igual en ambos tipos; un ejemplo escrito para uno se traslada al otro sin cambios. En la forma de objeto, $import no debe coincidir con ^oci://; un valor que coincide se rechaza. Claves: la clave nombra la salida de la entrada, por lo que está restringida a un único nombre de archivo: comienza con una letra o un dígito y continúa con letras, dígitos, puntos, guiones o guiones bajos. Los puntos después del primer carácter conservan las extensiones que llevan las claves de artefacto (main.tf, template.yaml, serviceaccount.yaml). Una / haría que una clave nombrara una ruta en lugar de un archivo, y un . inicial admitiría .., que nombra una ubicación fuera del directorio de salida — la clase del primer carácter rechaza ambos. Para una importación de biblioteca, la clave nombra el directorio bajo el que se anidan los archivos del bundle, por lo que se aplica la misma restricción. Patrón: ^[A-Za-z0-9][A-Za-z0-9._-]*$. |
omits | object[] | no | Qué excluir de lo que renderiza la fuente de esta Recipe — para una fuente tomada tal cual que renderiza algo que la Release no debe entregar: un documento que renderiza un chart descargado, como un Secret que contiene una clave que el chart genera de nuevo en cada renderizado, un servicio, un volumen o una configuración que incluye un archivo compose descargado, o un recurso que declara una plantilla de CloudFormation descargada. La mayoría de las Recipes nunca lo necesitan. Cada entrada nombra una unidad que renderiza la fuente por su tipo, su nombre y, cuando la entrada los indica, su namespace y el subchart del que procede, cada uno en el vocabulario del proveedor que renderiza la fuente — para un chart, un documento por su propio kind y su metadata.name; para un archivo compose, un service, un volume o un config por su clave bajo services:, volumes: o configs:; para una plantilla de CloudFormation, un recurso por su Type y su ID lógico. Ese proveedor excluye cada unidad con la que coincide una entrada, y con qué coincide una entrada, y qué rechaza el proveedor a causa de una entrada, es el contrato documentado propio de ese proveedor. Un proveedor que no puede excluir nada rechaza una Recipe que declara esta clave antes de que se renderice nada. Solo se filtra lo que renderiza source: — una entrada de workload: o de artifacts: nunca —, por lo que la clave requiere source. Cada valor es una plantilla, evaluada con respecto al contexto con el que se evalúa valuesMapping. El when de una entrada se evalúa primero, y una entrada cuyo when renderiza un valor falsy se descarta. Cada entrada que permanece activa debe excluir algo: una entrada activa que no coincide con nada de lo que renderizó la fuente detiene la compilación, nombrando la entrada. La fuente se sigue renderizando por completo — cada plantilla de un chart se sigue ejecutando, por lo que una plantilla que falla sigue haciendo fallar la compilación — y solo se excluye su salida. Al menos 1 entrada. |
boundary | object | no | Lo que esta Recipe aporta a la salida compartida del límite en el que se renderiza, en lugar de a la salida de su propio componente. La mayoría de las Recipes nunca lo necesitan: sirve para un archivo que el destino lee una sola vez para todo el límite — una configuración de proveedor de Terraform, por ejemplo, que Terraform solo acepta en la configuración raíz de un límite y nunca dentro del módulo de un solo componente. Un proveedor solo acepta esos archivos donde su contrato declara boundaryArtifacts, y una Recipe que declara este bloque para un proveedor que no lo hace se rechaza antes de que se renderice nada. Una FeatureRecipe no lleva ningún bloque de este tipo. |
outputLabels | mapa de string | no | Etiquetas declaradas por el autor de la Recipe que se estampan en cada objeto que produce la salida renderizada de esta receta, traducidas por el proveedor a la superficie de etiquetas de cada proveedor (metadata.labels de Kubernetes para la síntesis de helm, el renderizado de la fuente y los artefactos; etiquetas de servicio de Compose; tags por recurso en los cuerpos de artefactos .tf.json de Terraform). Viajan por el mismo carril que las etiquetas de procedencia fijas, pero pertenecen al autor en lugar de al compilador. Los namespaces aggrega.ai/ y app.kubernetes.io/ están reservados para la procedencia nativa de la plataforma y se rechazan al cargar. Una clave o un valor que no es una etiqueta válida para el proveedor de destino es responsabilidad del autor de la receta; el núcleo no controla el juego de caracteres de las etiquetas más allá de la regla de los namespaces reservados. |
outputComponentLabels | string[] | no | Claves de etiquetas de identidad del Component que esta receta promueve a su salida renderizada. Cada entrada nombra una clave de etiqueta; el valor se toma de las etiquetas de la instancia de componente que renderiza esta receta, de modo que la etiqueta estampada lleva el valor declarado de ese componente en lugar de uno repetido aquí. Las etiquetas promovidas llegan a la misma superficie de etiquetas que outputLabels, que en cambio lleva pares clave-valor literales escritos en el lugar. Una clave declarada en ambos bloques se rechaza al cargar, de modo que cada clave estampada tiene una única fuente. Los namespaces aggrega.ai/ y app.kubernetes.io/ están reservados para la procedencia nativa de la plataforma y se rechazan al cargar; una clave con ámbito como component.aggrega.ai/hosting queda fuera de esas raíces reservadas y puede promoverse. |
pipeline | object[] | no | Lista secuencial de pasos de pipeline Wasm que se ejecutan después del renderizado sobre el conjunto de documentos renderizados, cada uno de los cuales devuelve parches RFC 6902 y efectos secundarios. |
assertions | mapa de string | no | Validación entre campos en tiempo de compilación. Cada entrada es una aserción con nombre: la clave es un identificador de regla estable que aparece en los mensajes de error; el valor es una cadena de plantilla Go con semántica de detención {{ fail "message" }}. Varias aserciones con nombre por entidad se evalúan por instancia en el orden declarado por el autor; la primera aserción que falla detiene la compilación. Las aserciones de Recipe se evalúan después del enlace de la receta y después de evaluar los provides, antes del renderizado, y expresan invariantes de implementación del chart o módulo concreto que la Recipe usa como fuente. Contexto de la plantilla: .values / .infra / .uses / .features / .metadata más .provides / .locals / .recipe. El evaluador usa missingkey=error: las referencias a claves no definidas provocan una detención con un diagnóstico no-such-key. Como la referencia simple provoca la detención antes de que pueda ejecutarse cualquier valor alternativo, un default simple no proporciona un valor alternativo para un campo opcional en esta superficie — protege la referencia con hasKey, o usa la función auxiliar optional, que realiza directamente la comprobación de presencia. Leer la clave mediante index tampoco proporciona uno: index provoca una detención ante una clave de mapa que el mapa no contiene, nombrando la clave. |
No se permiten propiedades adicionales.
recipe.spec.omits[]
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
kind | string | sí | El tipo de la unidad que se excluye, en el vocabulario del proveedor que renderiza la fuente: para un chart, el kind propio de un documento renderizado, como Secret; para un archivo compose, service, volume o config; para una plantilla de CloudFormation, el Type de un recurso, como AWS::S3::Bucket. Nombra un tipo que la fuente renderiza y no tiene relación con el kind: que lleva un source: estructurado. Una plantilla. |
name | string | sí | El nombre de la unidad que se excluye, en el vocabulario del proveedor que renderiza la fuente: para un chart, el metadata.name propio de un documento renderizado; para un archivo compose, la clave de la unidad bajo services:, volumes: o configs:; para una plantilla de CloudFormation, el ID lógico del recurso, su clave bajo Resources. Una plantilla. |
namespace | string | no | El namespace en el que está la unidad que se excluye, cuando la entrada debe coincidir solo con una unidad de ese namespace — para un proveedor cuya salida tiene namespaces, como ocurre con los documentos renderizados de un chart. Si está ausente, o si se renderiza como la cadena vacía, la entrada coincide con una unidad de su tipo y nombre sea cual sea su namespace. Un archivo compose y una plantilla de CloudFormation no tienen namespaces, y sus proveedores rechazan una entrada que nombre uno. Una plantilla. |
subchart | string | no | El subchart del que procede la unidad que se excluye, cuando la entrada debe coincidir solo con la copia que renderiza un subchart — para una fuente ensamblada a partir de fuentes anidadas, como lo está un chart a partir de sus subcharts. Para un chart, el nombre propio del subchart, o el alias que le da la dependencia de su padre, con los nombres de un subchart anidado unidos por / desde el más externo: operator, o operator/webhooks. La entrada coincide entonces con un documento renderizado desde los templates/ o los crds/ propios de ese subchart, y no con uno que renderiza el propio chart ni con uno que renderiza un subchart anidado dentro de él. Si está ausente, o si se renderiza como la cadena vacía, la entrada coincide con una unidad de su tipo y nombre sea cual sea su procedencia. Un chart que no renderiza ningún subchart con ese nombre detiene la compilación, nombrando la entrada. Un archivo compose y una plantilla de CloudFormation no tienen subcharts, y sus proveedores rechazan una entrada que nombre uno. Una plantilla. |
when | string | no | Plantilla Go inline que se evalúa antes de los demás campos de la entrada. Cuando renderiza un valor falsy, la entrada se descarta: sus demás campos no se evalúan, no se excluye nada por su causa y no está obligada a coincidir con nada. Un when vacío o ausente conserva la entrada. La veracidad sigue la convención estándar para la salida de plantillas de tipo booleano: las cadenas true/True/TRUE, cualquier número distinto de cero y cualquier otra cadena no vacía son verdaderos, mientras que false/False/FALSE, la cadena vacía y el cero son falsos. Un when cuyo renderizado falla detiene la compilación. |
No se permiten propiedades adicionales.
recipe.spec.boundary
Lo que esta Recipe aporta a la salida compartida del límite en el que se renderiza, en lugar de a la salida de su propio componente. La mayoría de las Recipes nunca lo necesitan: sirve para un archivo que el destino lee una sola vez para todo el límite — una configuración de proveedor de Terraform, por ejemplo, que Terraform solo acepta en la configuración raíz de un límite y nunca dentro del módulo de un solo componente. Un proveedor solo acepta esos archivos donde su contrato declara boundaryArtifacts, y una Recipe que declara este bloque para un proveedor que no lo hace se rechaza antes de que se renderice nada. Una FeatureRecipe no lleva ningún bloque de este tipo.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
artifacts | mapa de string u object | sí | Mapa del nombre de archivo a la autoría del contenido del archivo, con la misma forma que los artifacts propios de esta Recipe: los mismos tres modos — una cadena de plantilla Go inline, un $import: de un archivo de plantilla Go local o un $import: de un bundle de una ArtifactLibrary, cuyos archivos se anidan bajo la clave de la entrada como <key>/<filename> —, la misma regla de clave a nombre de archivo y el mismo contexto de plantilla, de modo que una entrada puede leer .values, .infra, .locals y el resto exactamente como lo hace una entrada de artifacts. Lo que cambia es dónde se escribe cada archivo: una sola vez, en el directorio que contiene la salida ensamblada del límite, junto a los archivos que el ensamblado propio del proveedor escribe allí, en lugar de en el directorio propio de este componente. Cada entrada se evalúa para cada componente que esta Recipe renderiza en el límite, y los archivos que producen esas evaluaciones se fusionan por nombre: un mismo nombre evaluado a bytes idénticos por varios componentes, o por varias Recipes, es un solo archivo, mientras que un mismo nombre evaluado a bytes distintos detiene la compilación nombrando el archivo y a cada contribuyente, igual que un nombre que el ensamblado propio del proveedor ya escribe. En un archivo así no se estampa nada que indique qué componente lo escribió, porque pertenece a cada componente que lo declaró. Una entrada cuya plantilla no renderiza nada no escribe ningún archivo. Las entradas no se entregan al proveedor, que escribe el resto de la salida del límite sin leerlas. En la forma de objeto, $import no debe coincidir con ^oci://; un valor que coincide se rechaza. Claves: la clave nombra el archivo, por lo que está restringida a un único nombre de archivo, según la regla que sigue una clave de artifacts: comienza con una letra o un dígito y continúa con letras, dígitos, puntos, guiones o guiones bajos. Una / haría que una clave nombrara una ruta en lugar de un archivo, y un . inicial admitiría .., que nombra una ubicación fuera del directorio de salida del límite — la clase del primer carácter rechaza ambos. Para una importación de biblioteca, la clave nombra el directorio bajo el que se anidan los archivos del bundle, por lo que se aplica la misma restricción. Patrón: ^[A-Za-z0-9][A-Za-z0-9._-]*$. Al menos 1 entrada. |
No se permiten propiedades adicionales.
recipe.spec.pipeline[]
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
id | string | sí | Un identificador programático para este paso, único entre los pasos de este pipeline: un documento que declara un mismo id en dos de sus pasos se rechaza cuando se lee. Un paso posterior del mismo pipeline lee las salidas de este paso como .steps.<id>.outputs. Patrón: ^[a-zA-Z0-9_]+$. |
plugin | string | sí | La referencia a la entidad Plugin que ejecuta este paso, siempre calificada por el tipo de socket propio del plugin: <pluginType>/<name> con una versión opcional, como en parser/yaml o parser/yaml:1.0.0. La calificación es obligatoria y no una forma entre varias — un name:version sin calificar se rechaza, porque dos sockets pueden contener un plugin con el mismo nombre y la calificación es lo que hace que la entidad pueda resolverse. La compilación resuelve la entidad en su artefacto .wasm direccionado por contenido — localizado a partir de la identidad del plugin y del registro configurado, con su digest fijado en el archivo de bloqueo — y carga los bytes. Aquí no se acepta una simple referencia a un .wasm o a un artefacto. |
function | string | sí | La función Wasm exportada que se invoca. |
with | string | no | Plantilla Go inline que se evalúa como un mapa JSON/YAML que satisface estrictamente el esquema de entrada explícito de este plugin. |
optional | booleano | no | Cuando es true, un fallo de este paso (un trap del guest, un parche dirigido a un documento que no está en el conjunto, un parche mal formado o un diagnóstico con gravedad de detención) se rebaja a una advertencia bien visible: se restaura el conjunto de documentos anterior al paso, se descarta la salida de este paso y el pipeline continúa. Cuando es false o está ausente, cualquier fallo de un paso detiene la compilación después de restaurar el conjunto de documentos anterior al paso. |
when | string | no | Plantilla Go inline que se evalúa al recorrer el pipeline. Cuando renderiza un valor falsy, el paso se salta — una transferencia directa: el conjunto de documentos pasa sin cambios al siguiente paso, sin aportar parches, efectos secundarios ni registro del paso. Un when vacío o ausente siempre ejecuta el paso. La veracidad sigue la convención estándar para la salida de plantillas de tipo booleano: las cadenas true/True/TRUE, cualquier número distinto de cero y cualquier otra cadena no vacía son verdaderos, mientras que false/False/FALSE, la cadena vacía y el cero son falsos. when y optional son independientes: un paso puede declarar ambos. |
No se permiten propiedades adicionales.