Script khởi tạo và cấu hình tùy chỉnh PostgreSQL — helm tổng hợp
core/datastore/postgres cung cấp hai giá trị tùy chọn dành cho nhà phát triển, định hình lần khởi động đầu tiên của cơ sở dữ liệu: init_scripts (SQL hoặc shell chạy một lần khi khởi tạo) và custom_config (một đoạn postgresql.conf). Trên target helm tổng hợp, Recipe đưa chúng vào container dưới dạng các ConfigMap được mount. Ví dụ này cho thấy tính năng này mang tính bổ sung: một Aggregate không đặt giá trị nào sẽ được render giống hệt một cơ sở dữ liệu tối thiểu, còn một Aggregate đặt chúng sẽ có thêm các ConfigMap, volume và mount mà không ảnh hưởng đến bất kỳ thứ gì khác.
Hai Releases của cùng một Component, cùng một Manifest, chỉ khác nhau ở các giá trị dành cho nhà phát triển:
release-bare.yaml(aggregate-bare.yaml) —init_scriptsvàcustom_configkhông được đặt.release-config.yaml(aggregate-config.yaml) — cả hai đều được đặt.
Tạo ví dụ
Bạn có thể build ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn build giúp bạn.
Ghi ví dụ vào một thư mục mới đặt theo tên của nó:
aggrega scaffold --example postgres-init-configSau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:
cd postgres-init-configBuild
aggrega build --release release-bare.yaml --auto-pullaggrega build --release release-config.yaml --auto-pullCatalog được phân giải từ registry hub được nêu trong .aggrega-config.yaml, nên không cần cờ --catalog, và --auto-pull ghi trong lúc build tệp khóa mà một bản clone mới còn thiếu. Release trống ghi ba tệp vào dist/helm/helm/; release có cấu hình ghi ba tệp đó cùng hai tệp nữa vào dist/helm/helm/db/.
Với trợ lý AI
Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.
Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục Workspace chưa có thư mục `postgres-init-config`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `postgres-init-config` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `postgres-init-config` mới. Sau đó gọi công cụ `build` một lần cho mỗi Release, theo thứ tự này — `release-bare.yaml` và `release-config.yaml` — mỗi lần với `workspace_root` đặt thành `postgres-init-config`, `release` đặt thành tệp đó, `auto_pull` đặt thành true và `write` đặt thành true. Cho tôi biết mỗi bản dựng đã ghi những tệp nào; chúng nằm trong `postgres-init-config/dist/`.Trống — đường cơ sở bổ sung
aggregate-bare.yaml không đặt cả hai giá trị. Đầu ra được render gồm một StatefulSet, một ClusterIP Service và một Headless Service — không có ConfigMap, không có volume configmap, không có volume mount vào thư mục init và không có đối số tệp cấu hình trên container. Đây là hình dạng thông thường của một cơ sở dữ liệu PostgreSQL tối thiểu:
dist/helm/helm/db-statefulset.yamldist/helm/helm/db-default-service.yamldist/helm/helm/db-headless-service.yamlVì cả hai giá trị đều được bảo vệ theo sự hiện diện trong Recipe, một giá trị không được đặt sẽ không phát ra gì — nội dung ConfigMap được render rỗng và bị bỏ qua, còn các dòng volume, mount và đối số máy chủ bị loại ra. Một Aggregate không bao giờ chạm đến các giá trị này sẽ không bị thay đổi bởi sự tồn tại của chúng.
Có cấu hình — script và cấu hình được mount
aggregate-config.yaml đặt cả hai giá trị:
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 = 256MBLúc này bản build ghi thêm hai ConfigMap và nối chúng vào StatefulSet:
dist/helm/helm/db/initdb-configmap.yamldist/helm/helm/db/config-configmap.yamlCả hai nằm dưới db/, tên riêng của component. Recipe nêu tên chúng trong khối artifacts:, và một tệp được nêu tên ở đó mang khóa do tác giả của nó viết chứ không phải thứ gì xác định component — vì vậy bản build ghi nó dưới component đã khai báo nó, và hai component dùng chung một Recipe không thể rơi vào cùng một đường dẫn. StatefulSet và hai Service được target đặt tên theo component mà chúng thuộc về, nên chúng nằm ở thư mục riêng của ranh giới.
Hai giá trị nằm trong các ConfigMap riêng biệt vì mỗi ConfigMap được mount nguyên vẹn vào một đường dẫn container khác nhau:
init_scripts→ ConfigMapdb-initdb, mỗi script một khóa dữ liệu (01-schema.sql,02-seed.sql). Một volumeconfigmapmount nó tại/docker-entrypoint-initdb.d, nơi PostgreSQL chạy các tệp một lần khi khởi tạo lần đầu, theo thứ tự bảng chữ cái của khóa.custom_config→ ConfigMapdb-config, một khóa dữ liệupostgresql.conf. Một volumeconfigmapthứ hai mount nó tại/etc/postgresql, vàargs:của container trỏ máy chủ đến nó:postgres -c config_file=/etc/postgresql/postgresql.conf. Các thiết lập mà đoạn cấu hình bỏ qua giữ giá trị mặc định sẵn có.
# 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-configCác đối số máy chủ đó được truyền dưới dạng args: chứ không phải command:, và sự khác biệt này quyết định cơ sở dữ liệu có được khởi tạo dữ liệu khi khởi động hay không: args: cung cấp đối số cho entrypoint của image, còn command: thay thế nó. Entrypoint đó là script khởi động tạo cơ sở dữ liệu trên một thư mục dữ liệu rỗng, đọc môi trường POSTGRES_* và chạy các tệp dưới /docker-entrypoint-initdb.d. Thay thế nó sẽ khởi động máy chủ với postgresql.conf đã mount và bỏ qua cả bước khởi tạo lẫn các script khởi tạo — các giá trị mà Aggregate đặt sẽ được render vào manifest nhưng không bao giờ chạy.
Chỉ đặt một trong hai giá trị cũng hợp lệ như nhau — ConfigMap, volume và mount của giá trị còn lại đơn giản là không có, và đối số tệp cấu hình chỉ xuất hiện khi custom_config được đặt.
Compose
Recipe Compose cho core/datastore/postgres đọc cùng Component đó và hiện thực cả hai giá trị thông qua primitive riêng của compose: nó render các mục configs: cấp cao nhất, và service mount từng mục thành một tệp.
init_scripts→ mỗi khóa một config, mỗi config được mount theo tên tệp riêng dưới/docker-entrypoint-initdb.d. Image chạy các tệp tìm thấy ở đó một lần, theo thứ tự tên tệp, và chỉ khi thư mục dữ liệu rỗng — một cơ sở dữ liệu đã có dữ liệu sẽ không bị đụng đến.custom_config→ một config, được mount thành tệp duy nhất/etc/postgresql/postgresql.conf, với cùng các đối sốpostgres -c config_file=…trỏ máy chủ đến nó. Các thiết lập mà đoạn cấu hình bỏ qua giữ giá trị mặc định sẵn có.
Ở đây mỗi nửa cũng được bảo vệ theo sự hiện diện, nên một Aggregate không đặt một giá trị sẽ được render như thể khóa đó không tồn tại.
Có một thiết lập đáng nêu ra khi viết khối custom_config cho một deployment compose: theo mặc định listen_addresses chỉ chấp nhận kết nối cục bộ, nên một khối bỏ qua nó sẽ khiến cơ sở dữ liệu không thể truy cập được từ các service khác trên mạng compose.
Manifest trong ví dụ này định tuyến core/datastore/postgres đến Recipe helm. Build cùng Aggregate đó trên compose nghĩa là dùng một Manifest định tuyến nó đến compose/postgres thay thế; các giá trị dành cho nhà phát triển không bị thay đổi.