Chart yang disimpan di repositori git
Chart Helm tidak harus berasal dari registri chart. Contoh ini mengambil chart
yang berada di repositori git — chart contoh hello-world milik proyek Helm
sendiri — dan membangunnya menjadi manifest Kubernetes.
Aggregate milik pengembang tidak menyebutkan apa pun tentang hal ini. Aggregate tersebut mendeklarasikan satu
core/compute/server, dan asal pengemasan server tersebut ditentukan
di Recipe dan diikat oleh Manifest.
Blok sumber
source: kind: git-repository url: https://github.com/helm/examples.git ref: hello-world-0.1.0 module_subdir: charts/hello-worldTiga koordinat, dan masing-masing menjawab pertanyaan yang berbeda:
url— repositori yang akan di-clone.https://,ssh://, dangit://semuanya diterima. Repositori privat dijangkau melalui SSH lewat agen SSH, atau melalui HTTPS dengan entri untuk host-nya di file netrc Anda —machine github.com login <user> password <token>. Kredensial yang ditulis di dalam URL itu sendiri ditolak, seperti yang dijelaskan di Autentikasi.ref— referensi tempat repositori dibaca: tag, branch, atau commit. Nilainya adalah apa pun yang dinamai oleh penulis repositori itu sendiri, yang tidak selalu berupa versi polos — di sini tag juga memuat nama chart.module_subdir— direktori di dalam repositori yang merupakan chart. Repositori ini menyimpan chart di bawah path tersebut alih-alih merupakan chart itu sendiri, dan direktori tersebut merupakan bagian dari apa yang membuat artefak berbeda: dua direktori dari satu repositori pada satu commit adalah dua artefak, bukan satu.
Jenis sumber menyebutkan transport dan lokasi, bukan format. Jenis yang sama mengambil chart, modul Terraform, atau direktori file lainnya; apa yang dimuat direktori tersebut adalah urusan provider yang mengonsumsinya.
Apa yang dicatat lockfile
Hanya commit yang menyebutkan konten yang tidak dapat berubah tanpa sepengetahuan Anda. Tag atau branch adalah
nama yang dapat diarahkan ulang oleh repositori ke commit lain, sehingga aggrega pull me-resolve
referensi tersebut dan mencatat keduanya — referensi yang Anda tulis, dan commit hasil
resolusinya:
# 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.0Kedua bagian itu memiliki perannya masing-masing. Commit adalah yang diambil oleh build, sehingga build
dapat direproduksi. Referensi adalah yang digunakan build untuk mencari entri, yang
memungkinkan Anda tetap menulis ref: hello-world-0.1.0 di Recipe dan tetap
mendapatkan commit persis yang ditunjuk tag tersebut saat lockfile ditulis.
Membuat contoh
Anda dapat mem-build contoh ini dengan perintah di bawah, atau meminta asisten AI Anda mem-build-nya untuk Anda.
Tulis contoh ke folder baru yang dinamai sesuai contoh itu:
aggrega scaffold --example chart-from-git-repositoryKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd chart-from-git-repositoryBuild
aggrega build --release release-chart.yaml --auto-pullContoh ini memuat dua release, sehingga release yang akan dibangun disebutkan namanya. Build pertama
memerlukan lockfile, itulah sebabnya --auto-pull diberikan di sini; menjalankan
aggrega pull --release release-chart.yaml sekali sebelumnya memberikan hasil yang sama dan
memungkinkan setiap build berikutnya berjalan tanpa flag.
Deployment yang di-render memuat nilai yang diberikan Release, dipetakan ke nama nilai milik chart itu sendiri:
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]Setiap build mencetak satu peringatan:
warning: node "web": .infra key "compute" is read by no template in recipe "hello-world-git" — correct the spelling, or remove the keyPeringatan itu akurat dan layak dibaca alih-alih dibungkam. Component core/compute/server
menawarkan pengaturan ukuran CPU dan memori; chart ini tidak mengekspos
nilai apa pun untuk itu, sehingga Recipe tidak memetakan apa pun di sana. Recipe bersumber memetakan apa yang
benar-benar diterima chart sumbernya, dan compiler melaporkan nilai yang tidak sampai ke
mana pun alih-alih berpura-pura nilai itu sampai.
Dengan asisten AI
Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.
Gunakan hanya tool Aggrega, dan jangan membuat folder apa pun sendiri. Jika folder workspace belum berisi folder `chart-from-git-repository`, panggil tool `scaffold` sekali dengan `example` diatur ke `chart-from-git-repository` dan tanpa `dir`: tool itu menulis contoh ke folder baru `chart-from-git-repository`. Lalu panggil tool `build` dengan `workspace_root` diatur ke `chart-from-git-repository`, `release` diatur ke `release-chart.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana saja yang ditulis build; file-file itu berada di bawah `chart-from-git-repository/dist/`.Ketika referensi berpindah
Tag dapat diarahkan ulang di repositori. Ketika hal itu terjadi, aggrega pull
biasa berikutnya mendapati referensi ter-resolve ke tempat selain commit yang
dicatatnya, dan berhenti alih-alih mengadopsinya:
# 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>`Pesan ini menyebutkan kedua commit, sehingga Anda dapat melihat persis apa yang berpindah sebelum memutuskan. Lockfile dibiarkan seperti semula — penghentian terjadi sebelum apa pun ditulis — dan mengadopsi commit baru adalah tindakan yang disengaja:
aggrega pull --upgrade --pin-sources --release release-chart.yamlReferensi yang berpindah adalah kasus yang menjadi tujuan --upgrade: pull biasa mempertahankan
commit yang dicatat lockfile, dan hanya upgrade yang mengadopsi tempat yang kini ditunjuk
referensi. --upgrade tanpa argumen menghapus setiap pin yang tercatat, sehingga meminta konfirmasi
terlebih dahulu. --pin-sources juga diperlukan, karena Recipe ini juga mencatat commit
sumbernya di entity.lock di sebelahnya: upgrade menulis ulang pin tersebut ke
commit baru, sedangkan tanpa flag itu pull berhenti pada lock dan menyebutkan
aggrega pin. Commit entity.lock yang telah ditulis ulang bersama Recipe.
Suntingan yang dibuat di workspace ini, misalnya pada Aggregate atau Release, adalah drift
jenis lain: build berikutnya melaporkannya, dan
aggrega pull --release release-chart.yaml biasa menghapusnya.
Mem-pin commit di ref: alih-alih tag adalah cara lain untuk mendapatkan jaminan
yang sama, dengan konsekuensi koordinat yang tidak dapat dibaca manusia.
Release pengaman
release-negative.yaml diharapkan gagal, dan ada di sini karena jalur
pengambilan yang hanya diuji pada jalur normalnya tidak memberi tahu Anda apa pun tentang pengamannya.
Release ini men-deploy Aggregate yang sama melalui manifest-negative.yaml, yang mengikat Recipe
yang identik dengan Recipe yang berfungsi kecuali referensinya — referensi itu menyebutkan tag yang
tidak dimiliki repositori:
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]Repositori dapat dijangkau dan clone berhasil; hanya saja tidak ada referensi tersebut di dalamnya, sehingga tidak ada commit untuk di-pin dan tidak ada yang diarsipkan.
Apa yang dibutuhkan contoh ini dari jaringan
Tidak seperti sebagian besar workspace di sini, workspace ini meng-clone repositori nyata pada build
pertamanya, sehingga build tersebut memerlukan akses keluar ke host yang disebutkan di url. Setelah
lockfile dan cache resolusi tersedia, build berikutnya membaca dari cache dan
berjalan tanpa jaringan sama sekali — aggrega build --release release-chart.yaml --offline
membangun ulang byte yang sama.