Índice de referencia de Provider
Cada uno de los proveedores de la biblioteca estándar de Aggrega acepta un subconjunto distinto de los tres tipos de entrada de la Recipe (con fuente, sintetizado, artefactos). La matriz de capacidades canónica está en ../../architecture/16-recipe-input-composition.md bajo «Matriz de capacidades por Provider». Lee esa sección para la cuadrícula de referencia, y el texto por proveedor que la sigue para saber qué combinaciones de tipos de entrada acepta cada proveedor — una cuadrícula indica cada tipo por sí solo y no puede decir que dos de ellos se pueden declarar juntos.
Esta página es una señal indicadora. Indica lo que produce cada proveedor de la biblioteca estándar y te dirige a la página que lo trata; qué tipos de entrada acepta un proveedor, y en qué combinaciones, lo responden las secciones enlazadas arriba.
Los proveedores de la biblioteca estándar
helm— produce manifiestos de Kubernetes planos. Consulta helm.md.helm-chart— empaqueta los componentes de un límite en un único chart paraguas de Helm. Consulta helm-chart.md.compose— produce servicios de Docker Compose, combinados en un único archivo compose por límite. Consulta compose.md.terraform— produce configuración de Terraform. Emite configuración y nunca ejecuta Terraform. Consulta terraform.md.cloudformation— produce plantillas de stack de CloudFormation, una por límite. Emite configuración y nunca ejecuta CloudFormation. Consulta cloudformation.md.
Qué hace el syncWave de un límite en cada proveedor
El valor syncWave: del límite de una Release lo lee cada proveedor de la biblioteca estándar, y lo que ordena — y en qué términos — difiere según el proveedor; en helm-chart ordena solo los recursos que llevan su anotación:
| Provider | Qué hace la oleada |
|---|---|
helm | Ordena los recursos que aplica un controlador de GitOps o Helm. Donde la oleada no es 0, cada recurso renderizado lleva argocd.argoproj.io/sync-wave, y un recurso hook generado por una plantilla del chart lleva además helm.sh/hook-weight. |
helm-chart | Ordena los recursos que llevan la anotación. Las plantillas de un chart de origen se copian tal como las escribió su autor, así que llevan argocd.argoproj.io/sync-wave solo donde el chart lo escribe; un artefacto cargado con $import: que añade el proveedor lo lleva, y ningún helm.sh/hook-weight — consulta helm-chart.md. |
compose | Ordena los servicios dentro del archivo compose en el que se renderiza el límite, mediante depends_on entre ellos, y además registra el valor en cada servicio emitido como la etiqueta aggrega.ai/sync-wave. El orden entre dos archivos compose no es expresable — consulta compose.md. |
terraform | Ordena los bloques module de la configuración raíz en la que se ensambla el límite, mediante depends_on entre ellos. Es el orden en que Terraform realiza sus acciones y no la disponibilidad — una configuración no tiene noción de que un recurso esté operativo — y no se promete ningún orden de desmantelamiento. El orden entre dos configuraciones raíz no es expresable, y el valor también se registra con la procedencia de compilación del nodo — consulta terraform.md. |
cloudformation | Ordena el aprovisionamiento del stack en el que se ensambla el límite, mediante DependsOn entre recursos. Es el orden de creación, y a la inversa el de eliminación, y no la disponibilidad — una plantilla de stack no tiene noción de que un recurso esté operativo. El orden entre dos stacks no es expresable — consulta cloudformation.md. |
La escritura de un syncWave: por límite se trata en la página de la entidad Release; las etiquetas y anotaciones exactas que emite cada proveedor están en well-known-annotations.md.
Dónde buscar qué
| Si quieres saber… | Consulta |
|---|---|
| Qué proveedor admite qué tipo de entrada | ../../architecture/16-recipe-input-composition.md sección Matriz de capacidades por Provider |
| Qué combinaciones de tipos de entrada acepta un proveedor, y qué imprime un rechazo | ../../architecture/16-recipe-input-composition.md «Qué acepta cada provider, en detalle» |
| Cómo el socket de plugin de un proveedor recibe la entrada y devuelve la salida | architecture.md |
| Forma de autoría por proveedor (estructura del chart, claves de nivel superior de compose, cuerpos de Terraform, fragmentos de CloudFormation) | La página por proveedor correspondiente (helm.md, helm-chart.md, compose.md, terraform.md, cloudformation.md) |
| Qué anotaciones de límite consume cada proveedor y sus valores predeterminados | well-known-annotations.md |
Qué hace el syncWave de un límite en cada proveedor | La tabla anterior |
| Si un proveedor informa del nombre que da a los recursos que renderiza, y qué leer donde no lo hace | ../templates/rendered-resource-names.md |
| La superficie de autoría del tipo Workload | ../entities/workload.md |
| El modelo de composición de tres tipos de entrada, a nivel conceptual | ../../architecture/16-recipe-input-composition.md |