Siklus hidup Day-2
Siklus hidup Day-2 dan eksekusi temporal
Compiler Ahead-of-Time (AOT) yang agnostik terhadap kapabilitas secara inheren menciptakan kesenjangan antara niat deklaratif (Day-1) dan realitas operasional (Day-2). Cloud tidak sepenuhnya deterministik, deployment memerlukan pengurutan temporal, dan developer memerlukan pemicu imperatif untuk tugas pemeliharaan.
Aggrega secara struktural menjembatani kesenjangan ini melalui polyfill arsitektural tertentu dan perutean bawaan GitOps, sehingga konfigurasi yang dihasilkan memenuhi kebutuhan operasional ini tanpa mengorbankan kemurnian compiler inti.
1. Model eksekusi DAG (pengurutan temporal)
Masalahnya: Deployment infrastruktur adalah graf asiklik berarah (DAG) dari waktu. Sebuah task migrasi basis data harus berjalan hingga selesai sebelum server web menyala. Namun, compiler AOT menghasilkan folder datar berisi YAML statis atau Terraform. Jika Anda menyerahkan folder datar ini ke controller GitOps (seperti ArgoCD), controller akan menerapkan semuanya secara bersamaan, sehingga server web mengalami crash-loop saat menunggu basis data.
Solusinya: syncWave per batas dalam Release Aggregate milik developer dibiarkan tidak tersentuh. Karena pengurutan adalah realitas operasional fisik, pengurutan dikelola secara ketat di Domain 4 (Release). Setiap batas dalam Release membawa field opsional syncWave: <integer>, yang memungkinkan operator platform mengatur urutan rollout secara eksplisit pada tingkat batas.
apiVersion: aggrega.ai/v1beta1kind: Releasemetadata: name: sequenced-release version: 1.0.0 environment: productionspec: aggregate: my-app manifest: prod-manifest boundaries: infra: syncWave: 0 components: core-vpc: {} postgres-db: {} migrations: syncWave: 1 components: db-migration-task: {} apps: syncWave: 2 components: web-server: {} support-agent: {}Semantik nilai gelombang:
- Gelombang adalah bilangan bulat bertanda; nilai default-nya
0. Nilai negatif berjalan sebelum semua hal lain (CRD, namespace, RBAC); nilai yang lebih besar berjalan setelah nilai yang lebih kecil. Operator menetapkan nilai sesuai topologi deployment mereka. - Setiap instans komponen yang berada langsung dalam sebuah batas mewarisi nilai gelombang batas tersebut ke dalam node IR-nya. Tidak ada override per komponen di lapisan penulisan — pengurutan per sumber daya internal provider di dalam satu batas adalah urusan provider.
- Batas bersarang tidak mewarisi secara implisit. Batas bersarang yang tidak mendeklarasikan
syncWavemenggunakan default0, terlepas dari deklarasi batas luarnya. Operator yang menginginkan “seluruhouteradalah gelombang 1, termasuk sub-batasinner-nya” mendeklarasikansyncWave: 1pada keduanya.
Efek kompiler: Kompiler menyebarkan nilai wave setiap boundary ke manifes yang dirender di boundary tersebut. Providers memancarkan primitif pengurutan native:
- Untuk Kubernetes (ArgoCD/Flux): provider helm mengeluarkan
argocd.argoproj.io/sync-wave: "<N>"sebagai entrimetadata.annotationspada setiap manifest yang dirender, dan sumber daya yang ditandai chart sebagai hook Helm juga menerimahelm.sh/hook-weight: "<N>"untuk pengurutan hook Helm bawaan. Provider helm-chart mengeluarkan anotasi tersebut hanya pada file template yang ditambahkan sebuah Recipe ke chart melaluiartifacts:; provider itu menyalin template milik chart sendiri tanpa perubahan, sehingga template tersebut tidak membawa wave. - Untuk Compose: provider compose menyatakan pengurutan sebagai
depends_onantara layanan-layanan dari file tempat sebuah batas dirender, dengan syarat kesehatan target jika target mendeklarasikanhealthcheckdan syarat dimulainya target jika tidak.depends_onmenyebut sebuah layanan di dalam satu file, sehingga pengurutan lintas dua file compose tidak dapat dinyatakan; operator mengurutkan proyek compose yang terpisah pada lapisan pemanggilandocker compose up. - Untuk CloudFormation: provider cloudformation menyatakan pengurutan sebagai
DependsOnantara sumber daya dari templat stack tempat sebuah grup dispatch dirakit, dengan setiap sumber daya menyebut sumber daya dari gelombang terisi yang tepat sebelumnya dan target merangkai sisanya. Atribut ini mengatur urutan penghapusan secara terbalik sekaligus urutan pembuatan; atribut ini tidak menyatakan kondisi kesiapan apa pun, karena templat tidak mengenal konsep sumber daya yang siap melayani.DependsOnmenyebut sebuah sumber daya di dalam satu templat, sehingga pengurutan lintas dua stack tidak dapat dinyatakan; operator mengurutkan stack yang terpisah pada lapisan deployment. - Untuk Terraform: provider terraform menyatakan pengurutan sebagai
depends_ondi antara blokmoduledari konfigurasi root tempat sebuah batas dirakit, setiap modul menyebut modul-modul dari wave terisi yang tepat sebelumnya dan Terraform merangkai sisanya. Pengurutan ini mengatur tindakan yang dilakukan Terraform dan tidak menyatakan kondisi kesiapan apa pun, karena sebuah konfigurasi tidak mengenal konsep sumber daya yang siap melayani.depends_onmenyebut modul di dalam satu konfigurasi, sehingga pengurutan di antara dua konfigurasi root tidak dapat dinyatakan; mengurutkannya adalah urusan operator.
Kunci internal Aggrega aggrega.ai/sync-wave: "<N>" dikirimkan bersama anotasi ArgoCD untuk keperluan observabilitas dan provenans — sebagai anotasi pada output helm dan pada file template yang ditambahkan sebuah Recipe ke chart helm-chart, sebagai label service pada compose, sebagai satu baris komentar provenans di setiap modul terraform, dan di bawah Metadata."aggrega.ai/provenance" setiap sumber daya cloudformation — sedangkan anotasi ArgoCD itulah yang dikonsumsi controller GitOps.
Unit penulisan gelombang vs unit yang dapat di-deploy
Batas adalah unit penulisan gelombang. Unit yang dapat di-deploy adalah jalur perakitan — keluaran di disk yang dihasilkan compiler dan menjadi sasaran orkestrasi pipeline CI/CD. Secara default, satu batas dipetakan ke satu jalur perakitan: komponen setiap batas dikeluarkan di bawah boundaries/<boundary-name>/<provider>/, dan helm install / docker compose up dijalankan terhadap jalur tersebut.
Operator dapat meruntuhkan pemetaan 1:1 ini. Batas dapat mendeklarasikan field templat jalur directory: (dan subDirectory:) yang, jika dibagikan di antara beberapa batas, mengarahkan komponen batas-batas tersebut ke dalam satu keluaran rakitan di jalur bersama. Dua batas yang mendeklarasikan directory: "deploy/cluster" menghasilkan satu keluaran rakitan yang berisi komponen dari keduanya — unit yang dapat di-deploy menjadi jalur perakitan, bukan identitas batas.
Manifest dengan gelombang campuran dalam satu keluaran rakitan adalah hal normal dan didukung. Ketika batas A mendeklarasikan syncWave: 1 dan batas B mendeklarasikan syncWave: 2, dan keduanya berbagi directory: "deploy/cluster", unit yang dapat di-deploy yang dihasilkan berisi komponen kedua batas; setiap manifest membawa anotasi gelombang dari batas asalnya. Perangkat runtime membaca anotasi per sumber daya dan mengurutkan di dalam unit deployment rakitan — konteks sinkronisasi per Application milik ArgoCD memproses manifest gelombang 1, menunggu hingga semuanya Healthy, lalu memproses gelombang 2; pengurutan hook Helm membaca helm.sh/hook-weight per sumber daya hook. Inilah pola standar ArgoCD: keluaran per sumber daya persis merupakan masukan yang diharapkan konsumen lintas alat.
Pengurutan lintas Application (ketika operator menjalankan beberapa Application ArgoCD terhadap keluaran rakitan yang terpisah) adalah konfigurasi CI di tingkat operator — Aggrega menghasilkan artefak; operator merangkai Application ArgoCD mereka di sekitarnya melalui app-of-apps atau Progressive Sync. Pola anotasi per sumber daya milik Aggrega adalah bentuk masukan standar yang diharapkan setiap konsumen lintas alat.
2. Polyfill pengalamatan dinamis
Masalahnya: Cloud tidak deterministik pada saat pembuatan. Sumber daya seperti instans AWS RDS atau bucket S3 menghasilkan hash URL acak hanya setelah sumber daya tersebut diprovisikan secara fisik. Karena compiler AOT menghasilkan konfigurasi sebelum cloud memprovisikan apa pun, secara fisik mustahil bagi compiler untuk menyuntikkan URL literal basis data ke dalam variabel lingkungan sebuah container.
Solusinya: Pointer deterministik melalui Features kredensial Aggrega menyelesaikan hal ini dengan memanfaatkan Features kredensial yang sudah ada, menggeser definisi “deterministik” dari alamat IP literal menjadi pointer deterministik. Konfigurasi yang dihasilkan tidak meneruskan URL; konfigurasi itu meneruskan jalur ke Cloud Vault tempat URL tersebut akan ada.
- Contoh 1: Pembuatan keluaran (Terraform RDS) Recipe Ops untuk basis data membuat instans AWS RDS. Yang terpenting, Recipe ditulis untuk secara bawaan mengeluarkan URL dinamis yang baru dihasilkan itu ke AWS Systems Manager (SSM) Parameter Store pada jalur yang dinamai secara deterministik (mis.,
/aggrega/prod/db-url). - Contoh 2: Injeksi input (aplikasi Kubernetes) Developer melampirkan Feature kredensial
core/referenced-secretke worker, dalam slot yang dideklarasikan Component-nya, denganorigindiatur ke string pointer deterministik ("/aggrega/prod/db-url"). Pada target Kubernetes, Manifest mengikat lampiran itu kehelm/k8s-external-secret, yang merenderExternalSecretKubernetes yang meminta operator secret-store kluster mengambil entri itu ke dalam sebuah Secret, dan memublikasikan nama serta kunci data Secret tersebut; Recipe worker membacanya melaluiattachments:container-nya dan merender variabel lingkungan Pod yang dipetakan kevalueFrom: secretKeyRef(lihat Bagaimana kredensial mencapai container). Compiler meneruskan string pointer dan tidak pernah membaca URL.
Pada saat runtime, Terraform memprovisikan DB dan menyimpan URL ke vault. Container menyala, membaca Secret yang direkonsiliasi dari vault, dan terhubung. Compiler AOT menghasilkan relasi melalui string pointer yang stabil tanpa pernah memerlukan alamat IP literal.
3. Tindakan imperatif (serah terima yang dapat dieksekusi)
Masalahnya: Status deklaratif sempurna untuk provisioning Day-1, tetapi developer perlu menjalankan tindakan imperatif: “Jalankan backup DB sekarang juga.” Pipeline GitOps yang sepenuhnya deklaratif tidak memiliki mekanisme bawaan untuk memicu ulang skrip statis.
Solusi: Task dorman & perintah milik target sendiri Aggrega menyelesaikan hal ini sambil mempertahankan kemurnian AOT yang ketat. Aggrega menghasilkan konfigurasi untuk task yang di-deploy tanpa dimulai, dan setiap eksekusi dimulai di target dengan perintah milik target itu sendiri.
- Niat developer: Developer mendeklarasikan skrip sebagai
taskdalamAggregatedan melampirkan Feature yang meminta agar skrip itu dijalankan sesuai permintaan (mis.,core/manual-trigger). Dijalankan sesuai permintaan adalah bagian dari hakikat task tersebut, sehingga developer yang melampirkannya; Feature yang semua masukannya bersifat operasional justru dilampirkan oleh tim operasi, di dalam Release. - Bentuk dorman: Recipe milik task itu sendiri di setiap target membaca lampiran tersebut dan merender task dalam bentuk yang di-deploy tanpa memulai eksekusi. Di Kubernetes, task berupa
CronJobyang ditahan dengansuspend: true, dengan jadwal yang menyebut tanggal yang tidak pernah tiba, sebagai penggantiJobyang akan berjalan segera setelah di-deploy. Di Docker Compose, layanan task, yang tidak dimulai ulang oleh Compose setelah keluar, membawa profilmanual, sehinggadocker compose upmembiarkannya tetap berhenti. Di Amazon ECS, melalui Terraform atau CloudFormation, definisi task di-deploy sendiri, tanpa jadwal yang memulainya. FeatureRecipe yang diikat Manifest untuk lampiran tersebut tidak menambahkan file sendiri di target mana pun: perubahannya ada pada output task itu sendiri. - Serah terima: Compiler tidak menjangkau klaster mana pun dan tidak memanggil API cloud apa pun, dan build tidak memulai eksekusi apa pun serta tidak menulis skrip apa pun. Setiap eksekusi dimulai oleh operator dengan perintah milik target sendiri:
kubectl create job <run-name> --from=cronjob/<cronjob>di Kubernetes,docker compose run --rm <service>di Docker Compose, danaws ecs run-taskdi Amazon ECS, dengan diberikan klaster, definisi task, dan konfigurasi jaringan yang ditetapkan Release di bawahinfra.overridesmilik task. Pembuatan konfigurasi dan eksekusi runtime tetap terpisah.
(Catatan: Di Kubernetes dan Amazon ECS, task yang membawa jadwal berjalan sesuai jadwal itu, ada atau tidak ada lampirannya, dan perintah yang sama memulai eksekusi tambahan di antara eksekusi terjadwal; di Docker Compose, yang tidak memiliki penjadwal, Recipe task menolak jadwal. Contoh lengkap task-run-on-demand membangun satu Aggregate untuk Kubernetes, Docker Compose, Terraform, dan CloudFormation, dan menunjukkan pada masing-masing output yang dirender serta perintah yang memulai eksekusi.)
4. Pra-analisis: Hook workspace (RBAC dan kuota platform)
Masalahnya: Sebagian perubahan memprovisikan infrastruktur yang mahal atau kritis bagi produksi — misalnya cluster GPU yang besar — dan tidak boleh masuk ke pipeline GitOps tanpa ditinjau. Kontributor mana yang boleh mempromosikan perubahan mana ke lingkungan mana adalah keputusan kebijakan organisasi; compiler tidak boleh meng-hardcode-nya.
Solusinya: Compiler AOT murni tidak dapat menghubungi Active Directory atau mengambil kredensial cloud untuk mengetahui siapa yang menjalankan build. Untuk mencegah pembuatan yang tidak sah bahkan sebelum CI/CD berjalan, arsitektur mengandalkan injeksi konteks yang eksplisit.
Ketika aggrega build dipanggil oleh runner CI/CD, pipeline menulis konteks eksekusi ke dalam file konfigurasi yang diteruskannya dengan --config, sebagai with.settings dari lampiran tata kelola yang menilainya (mis., approval: standard). File tersebut mencantumkan lampirannya di bawah governance_append, sehingga lampiran itu ditambahkan ke plugin tata kelola yang dilampirkan oleh konfigurasi workspace sendiri alih-alih digantikan olehnya. Kebijakan pada peran ir-verdict membaca pengaturan tersebut sebagai input.settings. Kebijakan itu menerima graf yang telah dirakit dan bukan Release, sehingga lingkungan Release mencapainya sebagai label: kebijakan pada peran label-transform membaca input.compilation_context.environment dan memberi label itu pada setiap node. Putusan membandingkan keduanya dan menghentikan build ketika keduanya tidak cocok — di sini, build produksi yang pengaturannya tidak membawa approval: platform-approved:
# ci-governance.yaml — written by the CI/CD runner, passed as `aggrega build --config ci-governance.yaml`plugins: governance_append: - uri: governance/rego:<version> role: label-transform with: sources: - policies/environment.rego - uri: governance/rego:<version> role: ir-verdict with: sources: - policies/approval.rego settings: approval: standard# policies/environment.rego — evaluated by the governance label-transform role, during topology constructionpackage acme.context
import rego.v1
labels contains {"node": id, "key": "acme.com/environment", "value": input.compilation_context.environment} if { some id, _ in input.graph.nodes}# policies/approval.rego — evaluated by the governance ir-verdict role over the assembled graphpackage acme.approval
import rego.v1
approved if input.settings.approval == "platform-approved"
deny contains msg if { not approved some node in input.graph.spec.nodes node.labels["acme.com/environment"] == "production" msg := "a production build needs the approval platform-approved in the pipeline's governance settings."}Run yang pengaturannya sama sekali tidak membawa persetujuan juga ditolak, karena aturan menanyakan apakah persetujuan tersebut ada, bukan apakah persetujuan lain ada. Hal ini mengisolasi RBAC dari logika bawaan compiler, sehingga compiler bertindak murni sebagai evaluator deterministik atas data yang diberikan.
5. FinOps shift-left (estimasi biaya melalui kebijakan)
Masalahnya: Kesalahan konfigurasi yang tidak disengaja (mis., meminta workers: 500) dapat melewati pengaman finansial dan memicu pembengkakan biaya cloud yang besar.
Solusinya (kebijakan Wasm perusahaan): Karena Graf IR berisi topologi lengkap dan Release berisi pemetaan fisik (.infra), perusahaan dapat mengevaluasi biaya yang tepat dari apa yang di-deploy sebuah Release sebelum pembuatan tanpa memerlukan fitur compiler yang di-hardcode. Perusahaan cukup menulis plugin WebAssembly FinOps kustom dan melampirkannya ke soket tata kelola dalam peran putusan. Plugin kustom ini dapat membaca payload .infra, menghitung estimasi biaya bulanan, dan menghentikan build jika biaya yang dihitung melampaui batas anggaran yang ditetapkan secara internal oleh perusahaan.
6. Siklus hidup impor “brownfield”
Masalahnya: Perusahaan sudah menjalankan sebagian besar infrastruktur mereka. Meskipun Aggrega dirancang untuk menghubungkan build ke infrastruktur yang tidak dikelola melalui beban kerja referensi (jaringan pass-through; lihat beban kerja referensi), memindahkan basis data Oracle yang sudah ada ke dalam status Terraform yang dihasilkan Aggrega biasanya membuat orkestrator mencoba membuat ulang basis data tersebut, sehingga menghancurkan data yang ada.
Solusinya (direncanakan): Sebuah Feature core/resource-adoption direncanakan untuk mengelola siklus hidup impor.
Ketika developer memodelkan basis data yang sudah ada dalam Aggregate miliknya dan melampirkan fitur resource-adoption dalam pipeline yang dieksekusi secara berurutan, plugin rendering Wasm dirancang untuk mengevaluasi payload Ops dasar dari Recipe. Alih-alih mengeluarkan konfigurasi pembuatan standar, plugin dirancang untuk mengeluarkan sintaks adopsi eksplisit dari platform target (mis., mengembalikan JSONPatch dengan blok Terraform import {} atau kebijakan manajemen Crossplane ObserveOnly). Hal ini memungkinkan perusahaan menghasilkan konfigurasi dengan aman yang menyerap arsitektur lama ke dalam control plane GitOps tanpa downtime.
7. Praktik terbaik Ops dan penamaan deterministik
Sementara compiler inti mengandalkan ID node internal yang stabil (mis., support-db) dalam Graf IR datar, penyedia cloud fisik (seperti AWS, Azure, dan GCP) sering mensyaratkan string yang unik secara global untuk infrastruktur fisik (mis., nama bucket S3, nama IAM Role, atau domain API Gateway).
Jika seorang engineer Platform Ops meng-hardcode nama fisik dalam templat dasarnya (mis., bucket_name: "enterprise-data-bucket"), artefak yang dihasilkan akan diterapkan dengan lancar pada kali pertama. Namun, jika developer men-deploy lingkungan kedua (mis., staging vs prod), penyedia cloud akan menolak sumber daya lingkungan kedua saat runtime karena tabrakan nama.
Aturan keluaran deterministik (keamanan GitOps): Karena controller GitOps (ArgoCD, Flux) melakukan deteksi diff tingkat byte pada artefak yang dirender, compiler menjamin bahwa masukan yang identik menghasilkan keluaran yang identik per byte. Map yang mengalir melalui konteks templat (.context.inject.env, .values, .infra, dan bagian lain dari tampilan runtime) didukung oleh struktur map terurut yang mempertahankan urutan penyisipan penulis di seluruh lapisan data, dan batas templat adalah satu-satunya pengecualian: {{ range }} atas map tersebut beriterasi dalam urutan kunci alfabetis, seperti yang dilakukan templat Go, bukan dalam urutan penulis. Engineer Ops dapat mengandalkan urutan iterasi tersebut yang deterministik di antara eksekusi dengan masukan yang sama; jika urutan memiliki makna, urutan itu ditulis sebagai daftar alih-alih dipulihkan dari map. Namun, fungsi Sprig keys mengembalikan urutan iterasi map Go (yang tidak deterministik menurut desain bahasa); templat yang menyusun urutan kunci deterministik dari keluaran keys harus menyalurkannya melalui sortAlpha (mis., {{ keys .values | sortAlpha }}) untuk memulihkan determinisme.
Aturan emas untuk Recipes Ops (pola Helm): Engineer Platform Ops tidak boleh pernah meng-hardcode nama sumber daya cloud fisik. Sebaliknya, mereka harus menyusun nama yang unik secara deterministik dengan menggabungkan konteks deployment Aggrega selama fase evaluasi templat. Ini adalah aturan keterpakaian ulang dan keamanan dari tabrakan, bukan aturan determinisme — nama yang di-hardcode menghasilkan keluaran yang stabil tetapi bertabrakan secara fatal ketika Recipe yang sama merender beberapa instans komponen atau ketika Aggregate yang sama di-deploy ke beberapa Releases.
Compiler menyediakan tepat dua variabel untuk menjamin keunikan global:
{{ .metadata.release_name }}: NamaReleaseyang menggerakkan deployment (mis.,prod-billing).{{ .context.instance_id }}: ID Component spesifik dariAggregatemilik developer (mis.,receipt-storage).
Dengan menggabungkan keduanya (mis., {{ .metadata.release_name }}-{{ .context.instance_id }}), tim Ops menjamin bahwa konfigurasi yang dihasilkan plugin Wasm menggunakan nama sumber daya yang unik per lingkungan dan per komponen, tanpa mengharuskan developer mengelola konvensi penamaan fisik.