Gắn một workload với những gì một attachment công bố
Một ứng dụng không 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 helm provider — không có chart bên ngoài. Ứng dụng chạy dưới một danh tính đám mây mà Component của nó khai báo một slot và Release điền vào: attachment điền vào slot phát ra một Kubernetes ServiceAccount và công bố tên của nó, và Recipe của ứng dụng gắn pod với tên đã công bố đó.
Điểm cần học là hướng của luồng dữ liệu. Bên tạo ra nêu tên một lần; bên sử dụng đọc nó. Không có gì ở phía sử dụng khai báo lại một giá trị mà bên tạo ra đã sở hữu, nên hai bên không thể lệch nhau.
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 workload-identity-bindingSau đó 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 workload-identity-bindingBuild
aggrega build --release release.yaml --auto-pullCatalog đượ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/identity-app và synth Recipe helm/identity-app của nó) và registry hub (Feature core/gcp-workload-identity và FeatureRecipe của nó). --auto-pull ghi trong lúc build tệp khóa mà một bản clone mới còn thiếu. 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ỉ 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 có thư mục `workload-identity-binding`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `workload-identity-binding` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `workload-identity-binding` mới. Sau đó gọi công cụ `build` với `workspace_root` đặt thành `workload-identity-binding`, `release` đặt thành `release.yaml`, `auto_pull` đặt thành true và `write` đặt thành true. Hãy cho tôi biết lần build đã ghi những tệp nào; chúng nằm dưới `workload-identity-binding/dist/`.Component khai báo nhu cầu; Release đáp ứng nó
Ứng dụng cần một danh tính để chạy, nên Component của nó khai báo một danh tính, dưới dạng một slot identity bắt buộc:
featuresSchema: identity: required: true selector: "feature.aggrega.ai/kind!=secret" inject: []Aggregate không viết gì cho nó. Ứng dụng chạy dưới danh tính nào, trên đám mây nào, là lựa chọn của Operator cho từng mục tiêu, nên Release điền vào slot bằng Feature danh tính và mọi trường mà Feature đó cần:
features: identity: type: core/gcp-workload-identity infra: service_account_name: app-workload-identity gcp_service_account: app-dev@example-project.iam.gserviceaccount.comMột Release để trống slot sẽ dừng lại, nêu tên slot. Một Release cho một cluster EKS thay vào đó điền cùng slot đó bằng core/aws-irsa và role_arn của nó, và Manifest của nó ánh xạ Feature đó tới FeatureRecipe của nó. Bộ chọn giữ thông tin xác thực ngoài slot: một Feature loại secret điền vào slot sẽ dừng lại.
Attachment công bố
Feature khai báo trong schema.provides của nó rằng nó công bố một name, và FeatureRecipe của nó công bố giá trị đó — từ cùng biến local mà chart được phát ra dùng để đặt tên ServiceAccount, tức là service_account_name do operator đặt khi Release có viết giá trị này:
# FeatureRecipe gcp-workload-identitylocals: sa_name: '{{ default (printf "%s-%s" .context.rendered_name (.attachment_name | replace "_" "-")) .infra.service_account_name }}'provides: name: "{{ .locals.sa_name }}"Recipe sử dụng
Recipe sử dụng đọc tên đã công bố tại .features.<instance-name>.provides.<key>:
# helm/identity-app recipe workloadserviceAccount: "{{ .features.identity.provides.name }}"containers: main: variables: IDENTITY_SERVICE_ACCOUNT: {{ .features.identity.provides.name }}Cả hai lần đọc đều phân giải về ServiceAccount mà attachment thực sự đã phát ra:
[… omitted: the apiVersion]kind: ServiceAccountmetadata: name: app-workload-identity annotations: iam.gke.io/gcp-service-account: "app-dev@example-project.iam.gserviceaccount.com" [… omitted: the boundary and recipe annotations, and the labels, that every rendered document carries][… omitted: the Deployment's metadata, selector and pod template up to the containers] containers: - name: main [… omitted: the image and the port] env: [… omitted: the GREETING variable] - name: IDENTITY_SERVICE_ACCOUNT value: app-workload-identity serviceAccountName: app-workload-identityVì sao đọc thay vì lặp lại
Cách thay thế là viết app-workload-identity lần thứ hai ở phía sử dụng. Cách đó hoạt động cho đến khi ai đó thay đổi service_account_name của Operator và chỉ cập nhật một trong hai chỗ — lúc đó pod yêu cầu một ServiceAccount không tồn tại, và không có gì trong quá trình biên dịch phát hiện ra, vì cả hai cách viết đều là chuỗi hợp lệ.
Đọc .features.identity.provides.name loại bỏ cách viết thứ hai. Cùng cấu trúc đó áp dụng cho mọi attachment: một thông tin xác thực công bố locator của Secret của nó tại .features.<slot>.provides.name, một sidecar công bố cổng của nó, một danh tính công bố tên của nó. Cấu trúc attachment đầy đủ theo từng trường có tại templates/template-context-contract.md.
Định cỡ của người vận hành
release.yaml thực hiện trụ cột operator-sizing theo từng môi trường: tag image của container lấy từ infra.image_tag (myapp:1.2), và danh tính — Feature của nó và các trường của Feature đó — lấy từ phần điền của slot. Aggregate của Developer không mang cả hai.