Entidades por rol
Cada tipo de entidad tiene un rol que normalmente lo escribe. Esta página es el mapa completo — recurre a ella cuando conozcas tu aspecto pero todavía no sepas a qué archivo pertenece. La asignación de roles es orientativa, no una imposición del compilador (consulta Personas); nombra quién es normalmente el propietario de un tipo en una configuración bien factorizada.
El mapa de un vistazo
| Rol | Tipos de entidad | Aspecto |
|---|---|---|
| Desarrollador | Aggregate | Intención de la aplicación: qué es la aplicación y qué necesita |
| Arquitecto de plataforma | Component, Feature | El contrato de catálogo reutilizable y versionado |
| Operaciones de plataforma | Recipe, FeatureRecipe, Plugin de renderizado de providers | Traducción específica del Provider a infraestructura renderizada |
| Operador de plataforma | Manifest, Release | Enrutamiento y cableado del despliegue |
| Soporte transversal | SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, Workload | Formas compartidas, código de extensión y el tipo del compilador propiedad de la plataforma |
Desarrollador
Aggregate — la única superficie de escritura del desarrollador y la única fuente de verdad de la topología de la aplicación. Declara los componentes de los que se compone la aplicación, los values que acepta cada uno, las Features cuyo comportamiento es intención de la aplicación (con sus values), los parameters expuestos para la variación por entorno y las aristas uses que conectan los componentes entre sí. Se mantiene deliberadamente agnóstico respecto a la infraestructura física: nada en el Aggregate nombra una nube, un clúster ni un provider. Ese agnosticismo respecto a las capacidades es lo que permite desplegar un Aggregate en cualquier lugar.
Arquitecto de plataforma
Component — un contrato reutilizable y versionado para un tipo de bloque de construcción. Declara, mediante un JSON Schema, los values que un desarrollador puede proporcionar; las salidas provides que canaliza hacia los consumidores; y los sockets usesSchema que expone para el cableado. Los Components llevan las etiquetas semánticas que dirigen las políticas y el renderizado. El arquitecto mantiene estable el contrato del Component para que los desarrolladores puedan depender de él.
Feature — una capacidad acoplable que un desarrollador o un operador puede añadir a un componente: un exportador de métricas, el enmascaramiento de texto sensible en una pasarela de IA, una vinculación de credenciales. Una Feature declara lo que necesita y aquello con lo que es incompatible; cómo se realiza — los recursos que genera, o los ajustes que escribe en lo que su componente ya renderiza — reside en su FeatureRecipe.
Operaciones de plataforma
Recipe — la realización específica de un provider de un Component. Asigna los valores declarados del Component a la salida de un provider concreto — una release de Helm, un servicio de Compose, un módulo de Terraform — mediante plantillas, y canaliza los valores provides hacia los consumidores. Una Recipe nunca cambia los valores orientados al desarrollador que declara un Component; solo decide cómo se renderizan.
FeatureRecipe — la realización específica de un provider de una Feature, aplicada en el momento de la vinculación. Genera los recursos que implica el acoplamiento de una Feature para un provider dado, o escribe los ajustes que implica en lo que el componente acoplado ya renderiza.
Plugin de renderizado de Provider — un provider es el invitado Wasm que convierte la entrada de una Recipe en manifiestos nativos del provider. Se entrega como un Plugin con pluginType: provider que declara el nombre o los nombres de provider que renderiza y su contrato de socket de provider. Operaciones (o un autor de plugins) suministra providers para que las Recipes tengan un provider contra el que renderizar. Consulta la Visión general de los Providers para los providers incluidos y sus contratos.
Leer una credencial de forma segura en una Recipe
Una credencial llega a una Recipe por la tubería de inyección, .context.inject.env, como cualquier texto que haya elegido su autor, así que puede contener caracteres que una plantilla no puede escribir en YAML tal cual. Dentro de un escalar entre comillas dobles, una comilla doble termina el valor antes de tiempo y una barra invertida inicia un escape: la compilación se detiene, o la barra invertida se pierde en silencio. Escapa ambos donde se escribe el valor:
variables: {{- $env := optional (default dict .context.inject) "env" dict }} DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"optional lee la clave del mapa de la tubería con un valor de reserva vacío, así que una contraseña que nada entregó se renderiza como texto vacío. Las dos llamadas a replace escapan primero la barra invertida y luego la comilla, en ese orden para que el escape propio de la comilla no vuelva a escaparse, y dejan cualquier otro carácter como estaba. Un valor leído mediante index, que se detiene cuando falta la clave, admite las mismas dos llamadas a replace tal cual.
Un carácter que esta forma no transporta es el salto de línea. YAML pliega un salto de línea dentro de un escalar entre comillas dobles en un espacio, así que una credencial que contenga uno se entrega con un espacio donde estaba el salto. Una FeatureRecipe que escribe una credencial en su injectMapping la escribe en cambio mediante toJson, que transporta por igual una comilla, una barra invertida y un salto de línea, como muestra la referencia de FeatureRecipe.
Esa FeatureRecipe escribe la credencial bajo el mecanismo desde el que la Recipe la lee — env: para .context.inject.env, file:, arg: o un mecanismo propio del componente bajo su propio nombre. .context.inject.all se construye a partir de esos mecanismos y nunca a partir de la salida de un mapeo, así que un mapeo que escribiera bajo all: no entregaría nada; en su lugar, la compilación se detiene en él, nombrando la asociación, la clave y la FeatureRecipe.
Operador de plataforma
Manifest — la capa de enrutamiento. Indica al compilador qué Recipe realiza cada Component para un destino dado, de modo que el mismo Aggregate puede dirigirse a implementaciones distintas según el entorno — una Recipe de nube para producción, una Recipe de Compose para pruebas locales — sin ningún cambio en el archivo del desarrollador.
Release — la única entrada de compilación, que registra lo que construye un entorno. Apunta al Aggregate y al Manifest, satisface los parameters que expuso el desarrollador, acopla las Features cuyas entradas son operativas, dimensiona con infra las que acopló el desarrollador y cablea aristas propias dentro de los sockets que declaró el arquitecto. Una Release satisface los puntos de variación expuestos; no puede introducir nuevos values de la aplicación ni nueva capacidad de cómputo — estos solo proceden del Aggregate.
Tipos de soporte transversales
Estos tipos sirven a autores de distintos roles en lugar de pertenecer a uno solo.
SchemaLibrary — una biblioteca compartida de formas de esquema que se repiten en muchos Components y Features. Cuando la misma estructura (por ejemplo, un bloque de recursos de pod) aparece en muchas entidades, un arquitecto la factoriza en una entrada de SchemaLibrary para que se defina y actualice una sola vez.
MappingLibrary — una biblioteca compartida de lógica de mapeo reutilizable de la que se sirven Recipes y FeatureRecipes, de modo que los patrones de traducción comunes tienen una única fuente en lugar de copiarse.
WorkloadLibrary — una biblioteca compartida de contenido Workload reutilizable, de modo que una forma de despliegue que se repite en muchas Recipes se declara una vez y se importa en cada bloque workload:.
ArtifactLibrary — una biblioteca compartida de bundles de artefactos reutilizables: conjuntos con nombre de archivos de salida auxiliares que van juntos, como una CRD con su RBAC. Una Recipe o una FeatureRecipe importa un bundle en una entrada de artifacts: y emite cada archivo que contiene.
Plugin — el tipo de extensión. Más allá del renderizado de providers, los Plugins empaquetan el código WebAssembly que aporta inteligencia específica del dominio — validación de políticas, mutación, linting y otros sockets. La escritura de un Plugin es una tarea del equipo de plataforma que da soporte a todos los demás roles.
Workload — un tipo del compilador propiedad de la plataforma, no un archivo que un desarrollador o un operador escriba a mano como entidad de nivel superior. Se consume dentro del bloque workload: de una Recipe, donde el provider con el que la Recipe renderiza traduce la forma de workload normalizada a su forma nativa. Los autores de Recipe interactúan con él a través de ese bloque; la referencia del Workload documenta la forma.
Siguiente
- Escribir archivos de Aggrega — el ciclo de escritura, de principio a fin.
- Personas — los roles detrás de este mapa.