Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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:

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

Poi stampa i prossimi comandi da eseguire:

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

Un’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.0

Vince la voce più specifica:

  1. la voce name per il nome dell’istanza;
  2. la voce type che nomina il tipo alla versione dell’istanza, come example/compute/greeter:1.0.0;
  3. la voce type che nomina il tipo senza versione;
  4. 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: true

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