Skrip bootstrap PostgreSQL dan konfigurasi kustom — helm tersintesis
core/datastore/postgres menyediakan dua nilai pengembang opsional yang membentuk start pertama basis data: init_scripts (SQL atau shell yang dijalankan sekali saat inisialisasi) dan custom_config (fragmen postgresql.conf). Pada target helm tersintesis, Recipe membawanya ke dalam kontainer sebagai ConfigMap yang di-mount. Contoh ini menunjukkan bahwa fitur ini bersifat aditif: Aggregate yang tidak menetapkan kedua nilai tersebut dirender persis seperti basis data minimal, dan Aggregate yang menetapkannya mendapatkan ConfigMap, volume, dan mount tanpa mengubah apa pun selain itu.
Dua Releases dari Component yang sama, Manifest yang sama, yang hanya berbeda pada nilai pengembang:
release-bare.yaml(aggregate-bare.yaml) —init_scriptsdancustom_configtidak ditetapkan.release-config.yaml(aggregate-config.yaml) — keduanya ditetapkan.
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 postgres-init-configKemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:
cd postgres-init-configBuild
aggrega build --release release-bare.yaml --auto-pullaggrega build --release release-config.yaml --auto-pullKatalog di-resolve dari registry hub yang disebutkan di .aggrega-config.yaml, sehingga flag --catalog tidak diperlukan, dan --auto-pull menulis lockfile yang tidak dimiliki klon baru selama build. Rilis polos menulis tiga file di bawah dist/helm/helm/; rilis terkonfigurasi menulis ketiga file tersebut ditambah dua lagi di bawah dist/helm/helm/db/.
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 Workspace belum berisi folder `postgres-init-config`, panggil alat `scaffold` sekali dengan `example` diatur ke `postgres-init-config` dan tanpa `dir`: alat ini menulis contoh ke folder `postgres-init-config` yang baru. Kemudian panggil alat `build` sekali untuk setiap Release, dengan urutan ini — `release-bare.yaml` dan `release-config.yaml` — setiap kali dengan `workspace_root` diatur ke `postgres-init-config`, `release` diatur ke file tersebut, `auto_pull` diatur ke true, dan `write` diatur ke true. Beri tahu saya file apa saja yang ditulis setiap build; file-file itu ada di bawah `postgres-init-config/dist/`.Polos — garis dasar aditif
aggregate-bare.yaml membiarkan kedua nilai tidak ditetapkan. Keluaran yang dirender berupa
StatefulSet, Service ClusterIP, dan Headless Service — tanpa ConfigMap, tanpa
volume configmap, tanpa volume mount ke direktori init, dan tanpa argumen
file konfigurasi pada kontainer. Inilah bentuk biasa basis data PostgreSQL
minimal:
dist/helm/helm/db-statefulset.yamldist/helm/helm/db-default-service.yamldist/helm/helm/db-headless-service.yamlKarena kedua nilai dijaga berdasarkan keberadaannya di dalam Recipe, nilai yang tidak ditetapkan tidak menghasilkan apa pun — isi ConfigMap dirender kosong dan dilewati, serta baris volume, mount, dan argumen server dikecualikan oleh penjaga. Aggregate yang tidak pernah menyentuh nilai-nilai ini tidak berubah oleh keberadaannya.
Terkonfigurasi — skrip dan konfigurasi di-mount
aggregate-config.yaml menetapkan kedua nilai:
values: init_scripts: 01-schema.sql: | CREATE TABLE app_users ( ... ); 02-seed.sql: | INSERT INTO app_users (email) VALUES ('founder@example.com'); custom_config: | max_connections = 200 shared_buffers = 256MBBuild kini menulis dua ConfigMap tambahan dan menghubungkannya ke StatefulSet:
dist/helm/helm/db/initdb-configmap.yamldist/helm/helm/db/config-configmap.yamlKeduanya berada di bawah db/, nama komponen itu sendiri. Recipe menamainya dalam
blok artifacts: miliknya, dan file yang dinamai di sana membawa kunci yang ditulis penulisnya,
bukan sesuatu yang mengidentifikasi komponen — sehingga build menulisnya di bawah
komponen yang mendeklarasikannya, dan dua komponen yang berbagi satu Recipe tidak dapat berakhir di
satu path. StatefulSet dan kedua Service dinamai oleh target berdasarkan
komponen tempatnya berada, sehingga tetap berada di direktori milik batas itu sendiri.
Kedua nilai ditempatkan dalam ConfigMap terpisah karena masing-masing di-mount secara utuh ke path kontainer yang berbeda:
init_scripts→ ConfigMapdb-initdb, satu kunci data per skrip (01-schema.sql,02-seed.sql). Volumeconfigmapme-mount-nya di/docker-entrypoint-initdb.d, tempat PostgreSQL menjalankan file-file tersebut sekali pada inisialisasi pertama, dalam urutan kunci alfabetis.custom_config→ ConfigMapdb-config, satu kunci datapostgresql.conf. Volumeconfigmapkedua me-mount-nya di/etc/postgresql, danargs:pada kontainer mengarahkan server ke sana:postgres -c config_file=/etc/postgresql/postgresql.conf. Pengaturan yang tidak dicantumkan fragmen tetap memakai nilai bawaannya.
# db-statefulset.yaml (container)containers: - name: main image: postgres:16 args: - postgres - -c - config_file=/etc/postgresql/postgresql.conf [… omitted: the container's port, environment and resources] volumeMounts: - name: data mountPath: /var/lib/postgresql/data - name: initdb mountPath: /docker-entrypoint-initdb.d - name: pgconf mountPath: /etc/postgresql [… omitted: the liveness and readiness probes]volumes: - name: initdb configMap: name: db-initdb - name: pgconf configMap: name: db-configArgumen server tersebut datang sebagai args:, bukan sebagai command:, dan perbedaan ini menentukan apakah basis data menyala dalam keadaan terisi: args: memberikan argumen kepada entrypoint image, sedangkan command: menggantikannya. Entrypoint tersebut adalah skrip startup yang membuat basis data pada direktori data kosong, membaca lingkungan POSTGRES_*, dan menjalankan file di bawah /docker-entrypoint-initdb.d. Menggantikannya akan menjalankan server dengan postgresql.conf yang di-mount dan melewati inisialisasi maupun skrip bootstrap — nilai yang ditetapkan Aggregate akan dirender ke dalam manifest dan tidak pernah dijalankan.
Menetapkan hanya salah satu dari kedua nilai sama validnya — ConfigMap,
volume, dan mount milik nilai lainnya tidak ada, dan argumen file konfigurasi hanya muncul
ketika custom_config ditetapkan.
Compose
Recipe Compose untuk core/datastore/postgres membaca Component yang sama dan
mewujudkan kedua nilai melalui primitif milik compose sendiri: ia merender entri
configs: tingkat atas, dan service me-mount masing-masing sebagai file.
init_scripts→ satu config per kunci, masing-masing di-mount dengan nama filenya sendiri di bawah/docker-entrypoint-initdb.d. Image menjalankan file yang ditemukannya di sana sekali, dalam urutan nama file, dan hanya ketika direktori data kosong — basis data yang sudah berisi data dibiarkan tanpa perubahan.custom_config→ satu config, di-mount sebagai file tunggal/etc/postgresql/postgresql.conf, dengan argumenpostgres -c config_file=…yang sama yang mengarahkan server ke sana. Pengaturan yang tidak dicantumkan fragmen tetap memakai nilai bawaannya.
Masing-masing bagian juga dijaga berdasarkan keberadaannya di sini, sehingga Aggregate yang membiarkan satu nilai tidak ditetapkan dirender seolah-olah kunci itu tidak ada.
Ada satu pengaturan yang patut disebutkan saat menulis blok custom_config untuk deployment
compose: listen_addresses secara bawaan hanya menerima koneksi lokal, sehingga
blok yang tidak mencantumkannya membuat basis data tidak dapat dijangkau dari service lain di
jaringan compose.
Manifest dalam contoh ini merutekan core/datastore/postgres ke Recipe helm.
Membangun Aggregate yang sama pada compose berarti memakai Manifest yang merutekannya ke
compose/postgres sebagai gantinya; nilai pengembang tidak tersentuh.