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

Quando ricorrere a un passo della pipeline

Una FeatureRecipe offre due modi per modellare l’output a cui contribuisce una Feature: una FeatureRecipe basata su template che genera i propri documenti, e un passo della pipeline (pipeline:) che esegue un plugin Wasm sull’output renderizzato. Risolvono problemi diversi. Questa pagina è la guida alla scelta: ricorri a un passo della pipeline in presenza di esattamente due trigger, e usa una FeatureRecipe basata su template per tutto il resto.

I due strumenti

Una FeatureRecipe basata su template è locale e generativa. Produce i propri documenti a partire dai propri valori tramite un template Go — la ConfigMap di un sidecar, una CRD di policy, un oggetto di autoscaling. Tutto ciò che emette è funzione dei values: e degli infra: della Feature e del contesto di rendering passato ai suoi template. Non entra mai nell’output di un’altra entità; aggiunge documenti propri. Se ciò che devi produrre può essere scritto a partire da ciò che la Feature già sa, una FeatureRecipe basata su template è lo strumento giusto e più semplice — nessun plugin, nessuna pipeline.

Un passo della pipeline è globale e trasformativo. Viene eseguito dopo il rendering, sull’insieme reale di documenti che la build ha già emesso. L’host passa al passo quell’insieme di documenti indicizzato per chiave, per intero; il passo legge il contenuto effettivo, seleziona i documenti a cui è destinato e restituisce patch RFC 6902 mirate alla loro struttura — oppure emette nuovi documenti come effetti collaterali. Un passo ragiona su ciò che è stato renderizzato, non soltanto su ciò che la Feature ha dichiarato. Questa portata è la sua intera ragion d’essere, ed è anche il motivo per cui va usato con parsimonia.

I due trigger per un passo della pipeline

Ricorri a un passo della pipeline solo quando vale uno di questi casi. Se non vale nessuno dei due, genera invece il documento con una FeatureRecipe basata su template.

  1. Patch nell’ambito dell’host — devi entrare nella struttura di un’altra entità già renderizzata. Il caso classico è l’iniezione di una variabile d’ambiente, di un mount di volume o di un container sidecar nel carico di lavoro del componente che la consuma — un documento che la Feature stessa non ha scritto. Una FeatureRecipe basata su template non può farlo: produce i propri documenti, non modifica quelli di altri. Un passo della pipeline può farlo, perché opera sull’insieme renderizzato e può indirizzare per chiave i documenti del componente host.

  2. Emissione o patch dipendente dal contenuto — l’output dipende da ciò che contiene l’insieme renderizzato. Quando la risorsa che emetti, o la patch che applichi, è funzione del contenuto prodotto dalla build — le porte effettive dichiarate da un Deployment, i nomi dei container finiti nel manifest, le risorse in cui si è espanso un chart — la decisione richiede di avere in mano il contenuto renderizzato. Una FeatureRecipe basata su template esegue il rendering a partire dai valori propri della Feature e non vede mai l’insieme finito, quindi non può fare una scelta dipendente dal contenuto; un passo della pipeline prima legge il contenuto, poi agisce.

Entrambi i trigger hanno la stessa forma: richiedono informazioni che esistono solo dopo il rendering — la struttura di un’altra entità, o il contenuto emesso stesso. La generazione locale non ne ha mai bisogno, quindi la generazione locale non ha mai bisogno di un passo della pipeline.

Un passo trasforma; una policy valida

Un passo della pipeline è un trasformatore: modifica l’insieme renderizzato. Non è il luogo in cui verificare se un risultato è accettabile. Per validare una build — per affermare che un carico di lavoro modificato ha il sidecar, che nessun secret in chiaro è arrivato nell’output, che un’etichetta richiesta è presente — associa una policy della fase di rendering: un plugin di governance nel ruolo render-verdict, che viene eseguito dopo il rendering sugli artefatti emessi e restituisce un verdetto. Un verdetto halt arresta la build; un verdetto warn o info segnala senza bloccare.

Tieni separate le due cose. Non inserire logica di validazione in un passo della pipeline, e non ricorrere a una policy per modificare l’output — un plugin di governance associato a un ruolo di verdetto restituisce verdetti e non applica mai patch, e l’host legge l’output di un ruolo di verdetto solo come una decisione. Un passo modella l’output; una policy render-verdict lo giudica. La pagina del socket di governance tratta tutti e quattro i ruoli di governance e le severità dei verdetti.

I passi si compongono

Un passo della pipeline può dichiarare un contratto tipizzato di input e output, così che il suo input with: e gli output che restituisce siano forme validate anziché blob liberi. Un passo restituisce anche outputs con nome, e un passo dichiarato più avanti nella stessa pipeline legge gli output di un passo precedente dal proprio template with: come .steps.<id>.outputs.<key>. È così che un pattern in due parti si compone senza accoppiamento: un passo Fetcher emette una risorsa di credenziali e pubblica come output il nome del Secret risultante; un passo Injector legge quel nome e applica una patch al carico di lavoro che lo consuma per montarlo. Ogni passo si occupa di un solo aspetto, e la pipeline fa passare i loro output nell’ordine dichiarato.

Riferimenti incrociati