Patrones avanzados
Esta página explica una idea, el Manifest y la FeatureRecipe como los lugares que deciden qué escribe una compilación más allá de la Recipe propia de un componente, y no es un workspace ejecutable. Sustitución de receta por instancia muestra la mitad del Manifest en un workspace que compilas; escríbelo en una carpeta propia con:
aggrega scaffold --example per-instance-recipe-overrideDespués imprime los comandos que hay que ejecutar a continuación:
cd per-instance-recipe-overrideaggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlUna instancia, una Recipe propia
El nivel type del Manifest asocia cada instancia de un tipo de componente a una sola Recipe. Su nivel name asocia una instancia concreta, por su nombre en el Aggregate, a otra, y la instancia nombrada allí la toma mientras todas las demás instancias del tipo conservan la asociación type. Del manifest.yaml del ejemplo:
spec: mappings: components: type: example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 name: greeter-special: compose/greeter-green:1.0.0Gana la entrada más específica:
- la entrada
namepara el nombre de la instancia; - la entrada
typeque nombra el tipo en la versión de la instancia, comoexample/compute/greeter:1.0.0; - la entrada
typeque nombra el tipo sin versión; - sin ninguna entrada, la compilación se detiene nombrando la instancia sin asignar.
Un Manifest es YAML ordinario, así que un valor que repite puede escribirse una vez con un ancla y referenciarse con un alias.
Una Feature que aporta recursos propios
Una FeatureRecipe puede renderizar recursos junto a los del componente, a partir de un chart propio nombrado por source: y alimentado por su valuesMapping, en lugar de cambiar lo que renderiza la Recipe del componente. El core/public-ingress de la biblioteca estándar se realiza así en Kubernetes, mediante helm/public-ingress, que renderiza un Ingress para el componente al que está vinculado.
La ruta de solicitud que sirve un componente forma parte de lo que es la aplicación, así que la Feature la recibe en values; el nombre de host es el nombre que el entorno da al componente, así que es infra, junto a los ajustes que describen el clúster. En Un agente, un enrutador y dos modelos upstream, el desarrollador la vincula en el Aggregate y escribe la ruta:
features: published: type: core/public-ingress values: path: /y la Release da a la misma vinculación su host, y afirma que en el clúster de destino se ejecuta un controlador de ingress, afirmación sin la cual la compilación se detiene, de release.yaml sin sus comentarios:
published: infra: host: assistant.example.internal control_plane_present: trueLa FeatureRecipe nombra los recursos que renderiza según .context.rendered_name, el nombre del componente anfitrión tal como lo informa su proveedor, de modo que el Ingress apunta al Service que renderiza la Recipe propia del componente. Un host escrito en los values del Aggregate, o un path en la infra de la Release, se rechaza nombrando el campo: cada pilar está cerrado, y el campo pertenece al otro. Una ruta que difiere entre entornos es un parámetro que declara el Aggregate y que cumple cada Release.