Un chart contenuto in un repository git
Un chart Helm non deve per forza provenire da un registry di chart. Questo esempio ne prende uno che si trova in un repository git — il chart di esempio hello-world del progetto Helm stesso — e ne esegue il build in manifest Kubernetes.
L’Aggregate dello sviluppatore non dice nulla di tutto questo. Dichiara un core/compute/server, e da dove provenga il packaging di quel server viene deciso nella Recipe e vincolato dal Manifest.
Il blocco source
source: kind: git-repository url: https://github.com/helm/examples.git ref: hello-world-0.1.0 module_subdir: charts/hello-worldTre coordinate, e ciascuna risponde a una domanda diversa:
url— il repository da clonare.https://,ssh://egit://sono tutti accettati. Un repository privato si raggiunge via SSH tramite l’agente SSH, oppure via HTTPS con una voce per il suo host nel tuo file netrc —machine github.com login <user> password <token>. Una credenziale scritta nell’URL stesso viene rifiutata, come descrive Autenticazione.ref— il riferimento a cui leggere il repository: un tag, un branch o un commit. È qualsiasi nome abbiano scelto gli autori del repository, che non sempre è una versione nuda — qui il tag porta anche il nome del chart.module_subdir— la directory all’interno del repository che costituisce il chart. Il repository contiene un chart sotto questo percorso anziché esserlo, e la directory fa parte di ciò che rende distinto l’artefatto: due directory di un repository allo stesso commit sono due artefatti, non uno.
Il tipo di source nomina il trasporto e la posizione, non il formato. Lo stesso tipo scarica un chart, un modulo Terraform o qualsiasi altra directory di file; ciò che la directory contiene è affare del provider che la consuma.
Che cosa registra il lockfile
Solo un commit nomina un contenuto che non può cambiare a tua insaputa. Un tag o un branch è un nome che il repository può ripuntare a un commit diverso, quindi aggrega pull risolve il riferimento e registra entrambi — il riferimento che hai scritto e il commit a cui si è risolto:
# release-chart.locksource_artifacts: - kind: git-repository url: https://github.com/helm/examples.git module_subdir: charts/hello-world pinned_version: f3dc419e558e6ccebce2ed447384e5d2e11de2f9 digest: sha256:2bee62cfc2efccc61d8e17efeb72f9f77ad7bd87f3ea4e50b1e4219c8d5a2c78 mediatype: application/gzip referenced_by: - entity: recipe uri: helm/hello-world-git:1.0.0 field: spec.source requested_ref: hello-world-0.1.0Entrambe le metà si guadagnano il loro posto. Il commit è ciò che il build scarica, quindi il build è riproducibile. Il riferimento è ciò con cui il build cerca la voce, ed è questo che ti permette di continuare a scrivere ref: hello-world-0.1.0 nella Recipe e di risolvere comunque al commit esatto su cui si trovava quel tag quando il lockfile è stato scritto.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example chart-from-git-repositoryPoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd chart-from-git-repositoryBuild
aggrega build --release release-chart.yaml --auto-pullQuesto esempio include due release, quindi si nomina quella di cui eseguire il build. Il primo build ha bisogno di un lockfile, ed è per questo che qui si passa --auto-pull; eseguire una volta in anticipo aggrega pull --release release-chart.yaml fa lo stesso e permette a ogni build successivo di girare senza alcun flag.
Il Deployment renderizzato porta i valori forniti dalla Release, mappati sui nomi di valore propri del chart:
apiVersion: apps/v1kind: Deploymentmetadata: name: web-hello-world [… omitted: the chart's own labels, and the labels and annotations every rendered document carries]spec: replicas: 2 [… omitted: the selector and the pod template's own labels] spec: serviceAccountName: web-hello-world securityContext: {} containers: - name: hello-world securityContext: {} image: "nginx:1.27.3" imagePullPolicy: IfNotPresent [… omitted: the container port and the two probes]Ogni build stampa un avviso:
warning: node "web": .infra key "compute" is read by no template in recipe "hello-world-git" — correct the spelling, or remove the keyÈ corretto, e vale la pena leggerlo anziché silenziarlo. Il Component core/compute/server offre una manopola di dimensionamento di CPU e memoria; questo chart in particolare non espone valori per essa, quindi la Recipe non vi mappa nulla. Una Recipe sourced mappa ciò che il chart da cui attinge accetta davvero, e il compilatore segnala il valore che non ha raggiunto nulla invece di fingere che sia arrivato a destinazione.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu stesso alcuna cartella. Se la cartella del workspace non contiene ancora una cartella `chart-from-git-repository`, chiama una sola volta lo strumento `scaffold` con `example` impostato su `chart-from-git-repository` e senza `dir`: scrive l’esempio in una nuova cartella `chart-from-git-repository`. Poi chiama lo strumento `build` con `workspace_root` impostato su `chart-from-git-repository`, `release` impostato su `release-chart.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `chart-from-git-repository/dist/`.Quando il riferimento si sposta
Un tag può essere ripuntato nel repository. Quando succede, il successivo aggrega pull ordinario trova il riferimento che si risolve in un punto diverso dal commit registrato, e si arresta invece di adottarlo:
# aggrega pull --release release-chart.yaml## [E0130]# lockfile: out of date; it no longer matches what its Release resolves to# ---# source-artifact kind=git-repository url=https://github.com/helm/examples.git# module_subdir=charts/hello-world: reference "hello-world-0.1.0" moved — the# lockfile pins 03f4a18d3c2b77b7ecd91d0324a95910d4f04152, and it now resolves to# f3dc419e558e6ccebce2ed447384e5d2e11de2f9; adopt where it now points with# `aggrega pull --upgrade --release <release>`Nomina entrambi i commit, così puoi vedere esattamente che cosa si è spostato prima di decidere. Il lockfile resta com’era — l’arresto avviene prima che venga scritto qualsiasi cosa — e adottare il nuovo commit è un atto deliberato:
aggrega pull --upgrade --pin-sources --release release-chart.yamlUn riferimento spostato è il caso per cui esiste --upgrade: un pull ordinario mantiene il commit registrato dal lockfile, e solo un upgrade adotta il punto a cui il riferimento punta ora. Un --upgrade nudo scarta ogni fissaggio registrato, quindi prima chiede conferma. Serve anche --pin-sources, perché questa Recipe registra anche il commit della sua source nell’entity.lock accanto a essa: l’upgrade riscrive quel fissaggio al nuovo commit, mentre senza il flag il pull si arresta sul lock e nomina aggrega pin. Esegui il commit dell’entity.lock riscritto insieme alla Recipe.
Una modifica fatta in questo workspace, all’Aggregate o alla Release per esempio, è una deriva di un altro tipo: il build successivo la segnala, e un aggrega pull --release release-chart.yaml ordinario la elimina.
Fissare un commit in ref: invece di un tag è l’altro modo per ottenere la stessa garanzia, al prezzo di una coordinata che nessun essere umano sa leggere.
La release di guardrail
release-negative.yaml è destinato a fallire, ed è qui perché un percorso di fetch esercitato solo nel suo caso felice non ti dice nulla sulle sue protezioni. Distribuisce lo stesso Aggregate tramite manifest-negative.yaml, che vincola una Recipe identica a quella funzionante tranne che per il riferimento — nomina un tag che il repository non contiene:
aggrega build --release release-negative.yaml --auto-pull# exits non-zero# [E0137]# auto-pull: resolving the source of each Recipe and FeatureRecipe the Release# uses: resolve: resolve source for recipe# "helm/hello-world-git-missing-ref:1.0.0": sourceresolver: kind=git-repository# url=https://github.com/helm/examples.git version=: oci: artifact not found at# remote source (cause: reference not found)[… omitted: the rest of that line, a remediation naming the URL and version to check]Il repository è raggiungibile e il clone riesce; semplicemente non contiene un riferimento simile, quindi non c’è alcun commit da fissare e nulla da archiviare.
Che cosa serve a questo esempio dalla rete
A differenza della maggior parte dei workspace qui, questo clona un repository reale al suo primo build, quindi quel build ha bisogno di accesso in uscita all’host nominato in url. Una volta che esistono il lockfile e la cache di risoluzione, i build successivi leggono dalla cache e girano senza alcuna rete — aggrega build --release release-chart.yaml --offline ricostruisce gli stessi byte.