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
| Berkas | Peran |
|---|---|
aggregate.yaml | Maksud developer: mengimpor modul container registry (core/harbor) dan meneruskan kepadanya tiga kunci registry dari parameternya sendiri. |
manifest-helm-synth.yaml | Memetakan 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.yaml | Catatan 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 menumpangkanvaluesMapping: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 olehprovides.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 sebagaiui, 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.computememuat 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_secretdansecret_key, masing-masing melaluicore/referenced-secretdenganinfra.originyang menyebut sebuah Secret, dan Manifest mengikat Feature tersebut kek8s-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 kredensialcore/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 melaluiaggregates.harbor.parameters, Release memenuhinya, dank8s-existing-secretmembaca 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 kek8s-secret-from-parameter, yang menghasilkan Secret yang memuatnya. Kata sandi lainnya ditulis ke dalam konfigurasi yang dirender Release, sehingga kata sandi tersebut diganti dengan mengaturinfra; 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_versionmemilih semuanya sekaligus;infra.overrides.imagemengganti pin satu layanan, daninfra.overrides.image_prefixmemindahkan 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:
aggrega scaffold --example harbor-stackKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd harbor-stackBuild
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:
aggrega pull --release release-helm-synth.yamlaggrega build --release release-helm-synth.yamlArtefak 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:
openssl req -x509 -newkey rsa:4096 -nodes -days 3650 -subj "/CN=harbor-token-ca" \ -keyout tls.key -out tls.crtkubectl create secret tls harbor-token-key --key tls.key --cert tls.crtkubectl 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: v1kind: Servicemetadata: 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: nginxSelector-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.