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

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_scripts dan custom_config tidak 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:

Terminal window
aggrega scaffold --example postgres-init-config

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

Terminal window
cd postgres-init-config

Build

Terminal window
aggrega build --release release-bare.yaml --auto-pull
aggrega build --release release-config.yaml --auto-pull

Katalog 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.yaml
dist/helm/helm/db-default-service.yaml
dist/helm/helm/db-headless-service.yaml

Karena 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 = 256MB

Build kini menulis dua ConfigMap tambahan dan menghubungkannya ke StatefulSet:

dist/helm/helm/db/initdb-configmap.yaml
dist/helm/helm/db/config-configmap.yaml

Keduanya 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 → ConfigMap db-initdb, satu kunci data per skrip (01-schema.sql, 02-seed.sql). Volume configmap me-mount-nya di /docker-entrypoint-initdb.d, tempat PostgreSQL menjalankan file-file tersebut sekali pada inisialisasi pertama, dalam urutan kunci alfabetis.
  • custom_config → ConfigMap db-config, satu kunci data postgresql.conf. Volume configmap kedua me-mount-nya di /etc/postgresql, dan args: 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-config

Argumen 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 argumen postgres -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.