Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

catalog/recipe/helm/hello-world-git/1.0.0/recipe.yaml
source:
kind: git-repository
url: https://github.com/helm/examples.git
ref: hello-world-0.1.0
module_subdir: charts/hello-world

Tiga koordinat, dan masing-masing menjawab pertanyaan yang berbeda:

  • url — repositori yang akan di-clone. https://, ssh://, dan git:// 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.lock
source_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.0

Kedua 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:

Terminal window
aggrega scaffold --example chart-from-git-repository

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd chart-from-git-repository

Build

Terminal window
aggrega build --release release-chart.yaml --auto-pull

Contoh 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:

dist/app/helm/web-deployment-web-hello-world.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
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 key

Peringatan 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:

Terminal window
aggrega pull --upgrade --pin-sources --release release-chart.yaml

Referensi 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:

Terminal window
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.