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

Harbor stack — registri kontainer yang di-deploy sebagai satu rilis

Contoh ini mengompilasi registri kontainer nyata menjadi manifest Kubernetes dari satu Aggregate yang ditulis oleh Developer.

Registri kontainer terdiri atas banyak layanan yang saling bekerja sama — control plane berupa API dan layanan token, penyimpanan blob OCI beserta controller-nya, konsol web, tingkat worker asinkron, pemindai kerentanan, backend relasional, cache key-value, dan reverse proxy di depan semuanya. Katalog menjelaskan semua itu sebagai satu Component, karena pengelola registri itu sendiri menerbitkan chart Helm yang men-deploy keseluruhannya sebagai satu rilis, dalam urutan yang dibutuhkan layanan-layanannya. Component mendeklarasikan registri; Recipe membungkus chart tersebut.

Registri diimpor sebagai modul: sub-aggregate yang dapat digunakan ulang, yang menyusun Component dan mengekspor alamat yang diterbitkannya. Aggregate tingkat atas mengimpor modul berdasarkan nama dan meneruskan tiga kunci registri kepadanya; operator menentukan ukuran komponen modul di dalam Release.

Berkas

BerkasPeran
aggregate.yamlMaksud developer: mengimpor modul container registry (core/harbor) dan meneruskan kepadanya tiga kunci registry dari parameternya sendiri.
manifest-helm-synth.yamlMemetakan tipe komponen registry ke Recipe yang membungkus chart Helm-nya, dan Feature kredensial ke realisasi yang membaca Secret yang sudah ada di namespace — kecuali kata sandi administrator, yang diikatnya berdasarkan nama ke realisasi yang menghasilkan Secret dari parameter modul.
release-helm-synth.yamlCatatan operator untuk target Kubernetes. Menyebutkan Secret yang menyimpan tiga kunci yang diteruskan oleh Aggregate, menentukan ukuran komponen modul berdasarkan ID cakupan modulnya, dan melampirkan padanya kunci penandatanganan token, rahasia bersama layanan, serta kunci yang digunakan untuk mengenkripsi kredensial tersimpan, dengan menyebutkan Secret yang menyimpannya; selebihnya diserahkan pada nilai default skema.

Apa yang didemonstrasikan

  • Produk multi-layanan sebagai satu Component. Yang menjadikan registry ini satu Component, bukan beberapa, bukanlah ukurannya, melainkan tempat pengkabelannya dipelihara: perutean reverse proxy, kunci layanan token yang digunakan control plane untuk memeriksa setiap pull dan push, pengaturan koneksi yang dibaca setiap layanan untuk backend dan cache, pembagian basis data logis yang memisahkan keyspace cache antarlayanan, serta urutan start-up — semuanya dijaga tetap selaras dengan produk oleh orang-orang yang merilisnya, di dalam chart. Konsumen mendeklarasikan sebuah registry dan memperoleh semua itu dalam keadaan selaras.
  • Chart yang dibungkus. Recipe menyebut chart di source: dan menumpangkan valuesMapping: di atasnya — templat values adalah seluruh implementasinya, dan provider Helm merender templat milik chart itu sendiri terhadapnya. Tidak ada workload yang disintesis di sini.
  • Input eksternal yang dipin. Chart adalah input yang diambil oleh build, sehingga dipin seperti dependensi lainnya: lockfile mencatat versi chart, URL hasil resolusinya, dan digest tarball-nya, di bawah source_artifacts. Build dengan lockfile yang sudah terisi menyajikan chart dari content store dan memverifikasinya terhadap digest tersebut.
  • Satu alamat terpublikasi untuk seluruh platform. Reverse proxy milik chart merutekan path browser / ke konsol dan path registry serta API (/v2/, /api/, /service/, /c/) ke control plane, sehingga klien kontainer login, melakukan push dan pull ke host yang sama dengan yang dijangkau browser untuk membuka konsol. Service itulah yang dipublikasikan oleh provides.host, dan konsumen tidak memerlukan alamat kedua untuk menjangkau kedua kumpulan path tersebut.
  • Dua nama publik untuknya. Modul mengekspor satu alamat itu sebagai registry, endpoint yang diajak bicara oleh klien image dan API, serta sebagai ui, endpoint web. Keduanya mengarah ke alamat yang melayani kedua kumpulan path, sehingga konsumen menghubungkan diri ke nama mana pun yang menggambarkan maksudnya.
  • Penentuan ukuran component modul oleh operator. Release menyasar component modul melalui ID berlingkup modulnya (harbor.registry) untuk mengatur compute, tanpa Aggregate milik developer perlu menyatakan ulang ukuran fisik.
  • Aturan kelengkapan pada nilai berkelompok. infra.compute memuat kunci CPU dan kunci memori, dan Recipe berhenti pada kelompok yang membiarkan salah satunya kosong. Control plane yang dirender dengan batas CPU tanpa batas memori secara material berbeda dari yang dijelaskan oleh default yang dideklarasikan Component, dan tidak ada apa pun dalam output hasil render yang menyatakannya — sehingga build berhenti dan menyebut kunci yang hilang. Kunci yang dihilangkan dari kelompok mengambil nilai default Component.
  • Enam kunci tanpa default. Kunci yang digunakan layanan token untuk menandatangani token registry, beserta sertifikatnya; tiga secret yang digunakan layanan-layanan milik registry untuk saling mengautentikasi dan menandatangani status unggahan; kunci pemalsuan permintaan; dan kunci yang digunakan control plane untuk mengenkripsi kredensial tersimpan tidak memiliki nilai default: kunci yang dipegang setiap pembaca katalog akan memungkinkan siapa pun mencetak token yang dipercaya registry atau membaca apa yang disimpannya. Component mendeklarasikan slot-slot tersebut sebagai wajib, sehingga build yang membiarkan salah satunya kosong berhenti dan menyebut slot itu. Build tidak membaca satu pun dari keenam nilai tersebut dan tidak merender satu pun: setiap workload membaca masing-masing dari Secret yang disebutnya.
  • Tiga kunci yang dilampirkan Release. Modul tidak melampirkan kunci penandatanganan token, secret bersama control plane, maupun kunci yang digunakan untuk mengenkripsi kredensial tersimpan, sehingga Release melampirkan ketiganya ke component modul, token_key, core_secret dan secret_key, masing-masing melalui core/referenced-secret dengan infra.origin yang menyebut sebuah Secret, dan Manifest mengikat Feature tersebut ke k8s-existing-secret. Control plane memasang kunci penandatanganan token dan kunci enkripsi dari Secret yang disebutnya, dan layanan-layanan membaca secret bersama dari Secret miliknya.
  • Kredensial yang diisi modul. Kata sandi akun administrator, kunci pemalsuan permintaan lintas situs, secret bersama tingkat worker, dan secret status unggahan blob store juga merupakan slot kredensial pada Component, dan modul mengisi masing-masing dari parameternya sendiri (admin_password, csrf_key, jobservice_secret, registry_http_secret) melalui Feature kredensial core/referenced-secret, sehingga setiap workload membacanya dari sebuah Secret berdasarkan nama. Karena modul melampirkan Feature tersebut, Manifest memetakannya. Ketiga kunci juga tidak memiliki default di dalam modul, sehingga Aggregate mendeklarasikan parameternya sendiri dan meneruskannya melalui aggregates.harbor.parameters, Release memenuhinya, dan k8s-existing-secret membaca masing-masing sebagai nama Secret yang sudah ada di namespace; Release yang tidak memberikan nilai menghentikan build, dengan menyebut parameternya. Contoh ini membiarkan kata sandi administrator pada default pengembangan modul, dan Manifest mengikat satu lampiran itu berdasarkan nama ke k8s-secret-from-parameter, yang menghasilkan Secret yang memuatnya. Kata sandi lainnya ditulis ke dalam konfigurasi yang dirender Release, sehingga kata sandi tersebut diganti dengan mengatur infra; jika tidak diatur, masing-masing mengambil nilai pengembangan yang dinyatakan Recipe.
  • Output deterministik atas chart yang jika tidak demikian akan menghasilkan materialnya sendiri. Jika dibiarkan, chart ini mencetak secret-nya sendiri ketika tidak ada yang diberikan — secret bersama dan secret penandatanganan token control plane, secret tingkat worker dan blob store, kunci pemalsuan permintaan, dan kata sandi ter-hash blob store, yang di-hash ulang dengan salt baru pada setiap render. Masing-masing diberikan sebagai gantinya: keenam kunci selalu dari Secret yang disebut Release, dan kata sandi dari kredensial terlampir berdasarkan nama jika slotnya terisi, dan dari nilai pengembangan tetap jika tidak, sehingga dua render dari input identik menghasilkan byte yang identik.
  • Image yang dapat direproduksi. Setiap image yang dijalankan registry dipin ke tag eksplisit. Produk merilis semuanya pada satu tag, sehingga infra.engine_version memilih semuanya sekaligus; infra.overrides.image mengganti pin satu layanan, dan infra.overrides.image_prefix memindahkan semuanya bersama-sama untuk Release yang menarik dari mirror.

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 harbor-stack

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

Terminal window
cd harbor-stack

Build

Workspace ini tidak memuat .aggrega-config.yaml, sehingga entitas pustaka standar di-resolve dari registri hub, hub.aggrega.ai, dan flag katalog tidak diperlukan. Recipe mengambil sebuah chart, jadi selesaikan dependensi ke dalam lockfile terlebih dahulu:

Terminal window
aggrega pull --release release-helm-synth.yaml
aggrega build --release release-helm-synth.yaml

Artefak yang dirender ditempatkan di bawah dist/.

Sebelum menerapkannya, buat enam Secret yang dinamai oleh Release di namespace tempat registri di-deploy: harbor-token-key, yang berisi kunci privat RSA di bawah kunci data tls.key dan sertifikat atas kunci tersebut di bawah tls.crt; harbor-core-secret, yang berisi secret 16 karakter di bawah kunci data secret; harbor-secret-key, yang berisi kunci 16 karakter di bawah secretKey; harbor-csrf-key, yang berisi kunci 32 karakter di bawah CSRF_KEY; serta harbor-jobservice-secret dan harbor-registry-http-secret, yang berisi secret 16 karakter di bawah JOBSERVICE_SECRET dan REGISTRY_HTTP_SECRET. Sebagai contoh:

Terminal window
openssl req -x509 -newkey rsa:4096 -nodes -days 3650 -subj "/CN=harbor-token-ca" \
-keyout tls.key -out tls.crt
kubectl create secret tls harbor-token-key --key tls.key --cert tls.crt
kubectl create secret generic harbor-core-secret --from-literal=secret="$(openssl rand -hex 8)"
kubectl create secret generic harbor-secret-key --from-literal=secretKey="$(openssl rand -hex 8)"
kubectl create secret generic harbor-csrf-key --from-literal=CSRF_KEY="$(openssl rand -hex 16)"
kubectl create secret generic harbor-jobservice-secret --from-literal=JOBSERVICE_SECRET="$(openssl rand -hex 8)"
kubectl create secret generic harbor-registry-http-secret --from-literal=REGISTRY_HTTP_SECRET="$(openssl rand -hex 8)"

Registri yang layanannya tidak dapat menemukan Secret ini tidak akan berjalan.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `harbor-stack`, panggil alat `scaffold` sekali dengan `example` diatur ke `harbor-stack` dan tanpa `dir`: alat ini menulis contoh ke dalam folder `harbor-stack` yang baru. Lalu panggil alat `build` dengan `workspace_root` diatur ke `harbor-stack`, `release` diatur ke `release-helm-synth.yaml`, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file mana yang ditulis oleh build; file tersebut berada di bawah `harbor-stack/dist/`.

Seperti apa registry yang tersusun

Build menghasilkan sumber daya yang didefinisikan chart untuk konfigurasi ini: Deployments untuk reverse proxy, konsol, control plane, tingkat worker dan blob store; StatefulSets untuk backend, cache dan scanner; persistent volume claim untuk blob store dan untuk log tingkat worker; ConfigMaps dan Secrets yang dibaca setiap layanan; serta Services yang berada di depan layanan-layanan tersebut. Di samping itu, Feature kredensial menghasilkan satu Secret, harbor-zdregistry-admin-password, yang membawa nilai default pengembangan modul untuk kata sandi administrator, yang dibaca control plane dari Secret tersebut alih-alih dari Secret milik chart sendiri. Tidak ada Secret yang dihasilkan untuk keenam kunci tersebut: control plane memasang kunci penandatanganan token dari harbor-token-key dan kunci enkripsi dari harbor-secret-key, dan layanan-layanan membaca yang lainnya dari harbor-core-secret, harbor-csrf-key, harbor-jobservice-secret dan harbor-registry-http-secret, yaitu Secrets yang disebutkan oleh Release.

Tepat satu dari Services tersebut merupakan alamat yang dihubungkan oleh konsumen — dist/app/helm/harbor.registry-service-default-harbor-zdregistry.yaml:

apiVersion: v1
kind: Service
metadata:
name: harbor-zdregistry
[… omitted: the namespace, the chart's labels, and the labels and annotations every rendered document carries]
spec:
type: ClusterIP
ports:
- name: http
port: 80
targetPort: 8080
selector:
release: harbor-zdregistry
app: "harbor"
component: nginx

Selector-nya menunjuk reverse proxy, yang memberikan satu alamat kepada registry. port mengikuti infra.port; proxy di belakangnya mendengarkan pada port yang ditetapkan chart dan Service meneruskan ke sana, sehingga mengubah infra.port akan memindahkan alamat yang dipublikasikan, bukan listener-nya.

Penamaan: knob yang memublikasikan alamat bukanlah knob yang menamai sumber daya

Chart ini menurunkan sebagian besar nama sumber dayanya dari sebuah knob nama tingkat atas, lalu memberinya sufiks — Service milik control plane adalah <instance>-core, milik konsol <instance>-portal, milik blob store <instance>-registry, dan seterusnya untuk worker tier, pemindai, backend, dan cache. Tidak ada yang dinamai dengan nama polos tersebut.

Service yang dipublikasikan dinamai oleh knob terpisah yang cakupannya adalah eksposur, yang nilai bawaannya sendiri berupa literal tetap yang tidak bergantung pada nama tingkat atas. Sebuah Recipe yang hanya menetapkan knob tingkat atas akan memublikasikan alamat yang tidak dijawab oleh Service mana pun, dan dua instans dalam satu namespace akan sama-sama menghasilkan Service dengan literal tetap tersebut dan bertabrakan. Karena itu, Recipe menetapkan kedua knob dari ID instans, itulah sebabnya Service yang dihasilkan di atas dinamai sesuai instans dan mengapa provides.host menamai alamat yang benar-benar ada.

Hal ini patut dibaca dengan cermat saat membungkus chart platform apa pun: provides.host harus menamai Service yang benar-benar dibuat oleh chart, dan knob mana yang menentukannya merupakan sifat chart tersebut, bukan konvensi yang berlaku di semua chart.

Yang tidak disertakan dalam konfigurasi ini

Ingress milik chart dibiarkan nonaktif dan reverse proxy diekspos sebagai Service internal kluster, karena Component menerbitkan alamat di dalam kluster, bukan hostname eksternal. Satu endpoint eksternal dirakit di tingkat ingress, yang merutekan ke alamat yang diekspor modul ini. Keamanan transport dinonaktifkan, karena sumber sertifikat milik chart sendiri menghasilkan otoritas sertifikat dan sertifikat bertanda tangan pada saat render, yang tidak akan direproduksi oleh dua render dari input yang identik. Monitor Prometheus-operator dinonaktifkan.

Metrik registry juga dinonaktifkan. values.metrics_enabled milik Component mengaktifkannya untuk control plane, tingkat worker, blob store, dan sebuah exporter tambahan, serta menerbitkan keempat Service tersebut agar dapat ditemukan oleh scraper; pengaturan chart yang sama juga membuka listener debug blob store — profiling, jejak eksekusi, dan variabel runtime, tanpa pemeriksaan pemanggil — bagi setiap pemanggil di dalam kluster. Modul ini membiarkan nilai tersebut pada default-nya, yaitu false, sehingga contoh ini tidak merender metrik; Aggregate yang mendeklarasikan Component itu sendiri dapat mengaturnya. Meskipun demikian, image exporter tetap di-pin bersama yang lainnya.