Um chart mantido em um repositório git
Um chart Helm não precisa vir de um registro de charts. Este exemplo obtém um que fica em um repositório git — o chart de exemplo hello-world do próprio projeto Helm — e faz o build dele em manifestos do Kubernetes.
O Aggregate do desenvolvedor não diz nada sobre isso. Ele declara um core/compute/server, e de onde vem o empacotamento desse servidor é decidido na Recipe e vinculado pelo Manifest.
O bloco source
source: kind: git-repository url: https://github.com/helm/examples.git ref: hello-world-0.1.0 module_subdir: charts/hello-worldTrês coordenadas, e cada uma responde a uma pergunta diferente:
url— o repositório a clonar.https://,ssh://egit://são todos aceitos. Um repositório privado é acessado por SSH através do agente SSH, ou por HTTPS com uma entrada para o seu host no seu arquivo netrc —machine github.com login <user> password <token>. Uma credencial escrita na própria URL é recusada, como descreve Autenticação.ref— a referência na qual ler o repositório: uma tag, um branch ou um commit. É o que os próprios autores do repositório nomearam, o que nem sempre é uma versão simples — aqui a tag traz também o nome do chart.module_subdir— o diretório dentro do repositório que é o chart. O repositório contém um chart sob este caminho em vez de ser um, e o diretório faz parte do que torna o artefato distinto: dois diretórios de um repositório no mesmo commit são dois artefatos, não um.
O tipo de source nomeia o transporte e o local, não o formato. O mesmo tipo obtém um chart, um módulo Terraform ou qualquer outro diretório de arquivos; o que o diretório contém é assunto do provedor que o consome.
O que o lockfile registra
Só um commit nomeia um conteúdo que não pode mudar sem você saber. Uma tag ou um branch é um nome que o repositório pode reapontar para outro commit, então aggrega pull resolve a referência e registra os dois — a referência que você escreveu e o commit para o qual ela foi resolvida:
# 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.0As duas metades justificam o seu lugar. O commit é o que o build obtém, então o build é reproduzível. A referência é aquilo pelo qual o build procura a entrada, e é isso que permite que você continue escrevendo ref: hello-world-0.1.0 na Recipe e ainda assim resolva para o commit exato em que aquela tag estava quando o lockfile foi escrito.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example chart-from-git-repositoryEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd chart-from-git-repositoryBuild
aggrega build --release release-chart.yaml --auto-pullEste exemplo traz duas releases, então a que deve ser compilada é nomeada. O primeiro build precisa de um lockfile, e é por isso que --auto-pull é passado aqui; executar aggrega pull --release release-chart.yaml uma vez antes faz o mesmo e permite que todo build posterior rode sem flag.
O Deployment renderizado traz os valores que a Release forneceu, mapeados para os nomes de valores próprios do 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]Todo build imprime um aviso:
warning: node "web": .infra key "compute" is read by no template in recipe "hello-world-git" — correct the spelling, or remove the keyIsso é correto e vale a pena ler em vez de silenciar. O Component core/compute/server oferece um ajuste de dimensionamento de CPU e memória; este chart em particular não expõe valores para ele, então a Recipe não mapeia nada ali. Uma Recipe sourced mapeia o que o chart que ela obtém realmente aceita, e o compilador relata o valor que não chegou a lugar nenhum em vez de fingir que ele chegou.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace ainda não contiver uma pasta `chart-from-git-repository`, chame a ferramenta `scaffold` uma única vez com `example` definido como `chart-from-git-repository` e sem `dir`: ela escreve o exemplo em uma nova pasta `chart-from-git-repository`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `chart-from-git-repository`, `release` definido como `release-chart.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build escreveu; eles ficam em `chart-from-git-repository/dist/`.Quando a referência se move
Uma tag pode ser reapontada no repositório. Quando isso acontece, o próximo aggrega pull comum encontra a referência resolvendo para outro lugar que não o commit que registrou, e é interrompido em vez de adotá-la:
# 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>`Ele nomeia os dois commits, para que você possa ver exatamente o que se moveu antes de decidir. O lockfile fica como estava — a interrupção acontece antes que qualquer coisa seja escrita — e adotar o novo commit é um ato deliberado:
aggrega pull --upgrade --pin-sources --release release-chart.yamlUma referência movida é o caso para o qual existe --upgrade: um pull comum mantém o commit que o lockfile registra, e só um upgrade adota o ponto para onde a referência aponta agora. Um --upgrade simples descarta toda fixação registrada, então primeiro pede confirmação. --pin-sources também é necessário, porque esta Recipe também registra o commit da sua source no entity.lock ao lado dela: o upgrade reescreve essa fixação para o novo commit, ao passo que, sem a flag, o pull é interrompido no lock e nomeia aggrega pin. Faça commit do entity.lock reescrito junto com a Recipe.
Uma edição feita neste espaço de trabalho, no Aggregate ou na Release por exemplo, é um desvio de outro tipo: o próximo build o relata, e um aggrega pull --release release-chart.yaml comum o elimina.
Fixar um commit em ref: em vez de uma tag é a outra maneira de obter a mesma garantia, ao custo de uma coordenada que nenhum humano consegue ler.
A release de proteção
release-negative.yaml foi feita para falhar, e está aqui porque um caminho de obtenção exercitado apenas no seu caminho feliz não diz nada sobre as suas proteções. Ela implanta o mesmo Aggregate por meio de manifest-negative.yaml, que vincula uma Recipe idêntica à que funciona, exceto pela sua referência — ela nomeia uma tag que o repositório não tem:
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]O repositório está acessível e o clone é bem-sucedido; simplesmente não existe tal referência nele, então não há commit a fixar nem nada a arquivar.
O que este exemplo precisa da rede
Diferentemente da maioria dos espaços de trabalho aqui, este clona um repositório real no seu primeiro build, então esse build precisa de acesso de saída ao host nomeado em url. Depois que o lockfile e o cache de resolução existem, os builds seguintes leem do cache e rodam sem rede nenhuma — aggrega build --release release-chart.yaml --offline reconstrói os mesmos bytes.