Pattern avanzati
Questa pagina spiega un’idea, il Manifest e la FeatureRecipe come i punti che decidono che cosa scrive un build oltre alla Recipe propria di un componente, e non è un workspace eseguibile. Override della ricetta per istanza mostra la metà relativa al Manifest in un workspace di cui esegui il build; scrivilo in una cartella tua con:
aggrega scaffold --example per-instance-recipe-overridePoi stampa i prossimi comandi da eseguire:
cd per-instance-recipe-overrideaggrega pull --release release.yaml # writes release.lock, which the build readsaggrega build --release release.yamlUn’istanza, una Recipe tutta sua
Il livello type del Manifest collega ogni istanza di un tipo di componente a una sola Recipe. Il suo livello name collega una singola istanza, tramite il suo nome nell’Aggregate, a un’altra, e l’istanza lì indicata la riceve mentre ogni altra istanza del tipo mantiene il collegamento type. Dal manifest.yaml dell’esempio:
spec: mappings: components: type: example/compute/greeter:1.0.0: compose/greeter-blue:1.0.0 name: greeter-special: compose/greeter-green:1.0.0Vince la voce più specifica:
- la voce
nameper il nome dell’istanza; - la voce
typeche nomina il tipo alla versione dell’istanza, comeexample/compute/greeter:1.0.0; - la voce
typeche nomina il tipo senza versione; - in assenza di qualunque voce, il build si arresta nominando l’istanza non mappata.
Un Manifest è YAML ordinario, quindi un valore che vi si ripete può essere scritto una sola volta con un’ancora e richiamato con un alias.
Una Feature che porta risorse proprie
Una FeatureRecipe può renderizzare risorse accanto a quelle del componente, da un chart proprio indicato da source: e alimentato dal suo valuesMapping, anziché modificare ciò che la Recipe del componente renderizza. Il core/public-ingress della libreria standard è realizzato in questo modo su Kubernetes, da helm/public-ingress, che renderizza un Ingress per il componente a cui è associato.
Il percorso della richiesta che un componente serve fa parte di ciò che l’applicazione è, quindi la Feature lo riceve in values; l’hostname è il nome che l’ambiente dà al componente, quindi è infra, accanto alle impostazioni che descrivono il cluster. In Un agente, un router e due modelli upstream, lo sviluppatore la associa nell’Aggregate e scrive il percorso:
features: published: type: core/public-ingress values: path: /e la Release dà alla stessa associazione il suo host e afferma che nel cluster di destinazione è in esecuzione un controller di ingress, affermazione senza la quale il build si arresta, dal release.yaml con i commenti omessi:
published: infra: host: assistant.example.internal control_plane_present: trueLa FeatureRecipe dà alle risorse che renderizza nomi derivati da .context.rendered_name, il nome del componente ospite così come lo riporta il suo provider, così l’Ingress punta al Service che la Recipe propria del componente renderizza. Un host scritto nei values dell’Aggregate, o un path nell’infra della Release, viene rifiutato nominando il campo: ogni pilastro è chiuso, e il campo appartiene all’altro. Un percorso che differisce tra gli ambienti è un parametro che l’Aggregate dichiara e che ogni Release soddisfa.