Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

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:

Terminal window
aggrega scaffold --example per-instance-recipe-override

Después imprime los comandos que hay que ejecutar a continuación:

Terminal window
cd per-instance-recipe-override
aggrega pull --release release.yaml # writes release.lock, which the build reads
aggrega build --release release.yaml

Una 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.0

Gana la entrada más específica:

  1. la entrada name para el nombre de la instancia;
  2. la entrada type que nombra el tipo en la versión de la instancia, como example/compute/greeter:1.0.0;
  3. la entrada type que nombra el tipo sin versión;
  4. 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: true

La 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.