Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

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ó:

Terminal window
aggrega scaffold --example mariadb-helm-synth

Sau đó 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:

Terminal window
cd mariadb-helm-synth

Build

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

Catalog đượ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-me

Mộ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.

db--user-zupassword--db-secret-db-user-password.yaml
[… 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.