MariaDB trên Kubernetes — helm tổng hợp (StatefulSet), thông tin xác thực hai khe
Một cơ sở dữ liệu MariaDB duy nhất được kết xuất trên Kubernetes bằng cơ chế tổng hợp Workload
của provider helm — không dùng chart bên ngoài. Component core/datastore/mariadb liên kết với
Recipe helm/mariadb, vốn khai báo một Workload form: stateful; provider helm
chuyển nó thành một StatefulSet, một ClusterIP Service, một Headless
Service (danh tính mạng ổn định của StatefulSet), và một
volumeClaimTemplate cho thư mục dữ liệu.
Mục đích của ví dụ là mô hình thông tin xác thực hai khe của MariaDB trên đích helm tổng hợp. Hai khe mật khẩu được cung cấp bằng các cơ chế khác nhau vì Component khai báo chúng khác nhau, và Recipe nối mỗi khe theo cách mà khe đó đòi hỏi.
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 mariadb-helm-synthSau đó 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 mariadb-helm-synthBuild
aggrega build --release release.yaml --auto-pullCatalog được phân giải từ hub registry được nêu trong .aggrega-config.yaml, nên không cần cờ --catalog, và --auto-pull ghi lockfile mà một bản clone mới còn thiếu trong quá trình build. Bốn manifest được tạo ra dưới dist/helm/helm/.
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ỉ sử 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 không gian làm việc chưa chứa thư mục `mariadb-helm-synth`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `mariadb-helm-synth` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `mariadb-helm-synth` mới. Sau đó gọi công cụ `build` với `workspace_root` được đặt thành `mariadb-helm-synth`, `release` được đặt thành `release.yaml`, `auto_pull` được đặt thành true và `write` được đặt thành true. Hãy cho tôi biết bản build đã ghi những tệp nào; chúng nằm trong `mariadb-helm-synth/dist/`.root_password — Black-Box, được cung cấp qua đường inject
root_password là một khe Black-Box: featuresSchema của Component khai báo
inject: [], nên Recipe kiểm soát việc cung cấp và nhà phát triển không thể quyết định điều đó.
Aggregate gắn core/secret-value, mà Manifest ánh xạ sang
env-secret. FeatureRecipe đó đặt giá trị lên đường inject của component
dưới khóa đã chọn, và Recipe đọc nó dưới dạng
.context.inject.env.MARIADB_ROOT_PASSWORD, tạo ra một biến môi trường container thông thường:
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meMột khe Black-Box không bao giờ được tham chiếu từ khối attachments: của container workload, và không có
tài nguyên Kubernetes Secret nào được tạo cho nó — giá trị đến container
trực tiếp qua đường inject.
user_password — trong suốt, được cung cấp dưới dạng Secret + secretKeyRef
user_password là một khe trong suốt (inject: [env, file]). Aggregate
gắn core/referenced-secret, mà Manifest ánh xạ sang
k8s-secret-from-parameter. FeatureRecipe đó tạo ra một Kubernetes Secret
và công bố danh tính của Secret dưới dạng provides {name, key}. Recipe
tham chiếu khe qua containers.attachments, mà bộ tổng hợp kết xuất thành
một env secretKeyRef. Secret được tạo và tham chiếu của container chỉ đến
cùng một tài nguyên vì cả hai đều đọc .features.user_password.provides.name — không
có việc suy diễn lại và không có quy ước nào để hai bên phải thống nhất. Tên được công bố
chuẩn hóa dấu gạch dưới trong tên khe thành dấu gạch nối, nên user_password
trở thành tên tài nguyên Kubernetes hợp lệ db-user-password. Tên tệp
chứa nó là một phép suy diễn riêng và đọc khác: nó thêm tiền tố là
component và tên khe làm tọa độ riêng của attachment, được mã hóa cho một
bảng chữ cái tên tệp chỉ chấp nhận chữ thường và chữ số, nên
dấu gạch dưới xuất hiện ở đó dưới dạng ký tự thoát chứ không phải dấu gạch nối.
[… omitted: the apiVersion and the Secret kind]metadata: name: db-user-password [… omitted: the labels and annotations every rendered document carries]stringData: MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)- name: MARIADB_PASSWORD valueFrom: secretKeyRef: name: db-user-password # == the Secret's metadata.name key: MARIADB_PASSWORD # == the Secret's data keyĐể user_password không được gắn cũng hợp lệ: Recipe chuyển về một
giá trị mặc định phát triển nội tuyến (MARIADB_PASSWORD: apppass) và không có Secret nào
được tạo, nên một triển khai tối thiểu vẫn kết xuất và chạy được.
Định cỡ của người vận hành
release.yaml đáp ứng trụ cột định cỡ của người vận hành theo từng môi trường: tag image
của container lấy từ infra.engine_version (mariadb:11.4), còn
yêu cầu và storage class của volumeClaimTemplate lấy từ infra.storage
(5Gi, standard). Aggregate của nhà phát triển không bao giờ chứa các trường này.