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.

Thông tin xác thực nhiều khóa trên một Deployment helm được tổng hợp

Một ứng dụng phi trạng thái 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 có chart bên ngoài. Ứng dụng đọc hai khóa dữ liệu từ một secret: một tên người dùng và một mật khẩu. Một slot thông tin xác thực hỗ trợ cả hai, được điền bởi một thông tin xác thực có thể tham chiếu nhiều khóa.

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 multikey-secret-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 multikey-secret-synth

Build

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

Catalog được phân giải từ hai nguồn được nêu trong .aggrega-config.yaml: ./catalog riêng của ví dụ (Component local/compute/app và Recipe tổng hợp helm/app của nó) và registry hub (Feature thông tin xác thực nhiều khóa, FeatureRecipe của nó và Provider helm). --auto-pull ghi lockfile mà một bản clone mới còn thiếu trong quá trình build. Ba manifest được tạo ra trong 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 `multikey-secret-synth`, hãy gọi công cụ `scaffold` một lần với `example` được đặt thành `multikey-secret-synth` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `multikey-secret-synth` mới. Sau đó gọi công cụ `build` với `workspace_root` được đặt thành `multikey-secret-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 `multikey-secret-synth/dist/`.

Một slot, hai khóa

Component khai báo một slot thông tin xác thực trong suốt, app_credentials (inject: [env]). Aggregate điền slot này bằng core/referenced-secret-set — một thông tin xác thực có thể tham chiếu nhiều khóa, tạo ra một Secret Kubernetes chứa một tập khóa dữ liệu do bên gọi cung cấp và chỉ công bố bộ định vị của Secret (provides.name). Ở đây bên gọi cung cấp hai khóa:

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

Manifest ánh xạ core/referenced-secret-set tới FeatureRecipe k8s-secret-set, FeatureRecipe này kết xuất một Secret chứa cả hai khóa:

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: app-app-credentials
[… omitted: the labels and annotations every rendered document carries]
stringData:
db_username: "appuser"
db_password: "dev-pw-change-me"

Tham chiếu một slot theo từng khóa

Recipe tổng hợp tham chiếu cùng một slot hai lần — mỗi khóa dữ liệu một lần. Mỗi mục nêu khóa dữ liệu mà nó đọc thông qua trường key; khóa map của mục là tên biến môi trường:

# helm/app recipe workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

Bộ tổng hợp kết xuất một env secretKeyRef cho mỗi mục. Cả hai đều tham chiếu cùng một Secret (provides.name), mỗi mục với khóa dữ liệu riêng:

# app-deployment.yaml (container env)
- name: APP_DB_USER
valueFrom:
secretKeyRef:
name: app-app-credentials # == the Secret's metadata.name
key: db_username
- name: APP_DB_PASSWORD
valueFrom:
secretKeyRef:
name: app-app-credentials # same Secret
key: db_password # different data key
[… omitted: the GREETING variable, set from the Aggregate's greeting value]

Trường key là thứ giúp một secret nhiều khóa có thể được sử dụng từ một Workload được tổng hợp. Khi một mục bỏ qua key, nó sẽ đọc khóa dữ liệu duy nhất được công bố của slot thay vào đó — dạng mà một thông tin xác thực một khóa (core/referenced-secret) sử dụng, vốn công bố cả bộ định vị lẫn khóa.

Định cỡ của người vận hành

release.yaml đáp ứng trụ cột định cỡ của operator theo từng môi trường: tag image container lấy từ infra.image_tag (myapp:1.2). Aggregate của nhà phát triển không bao giờ mang trường này.