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.

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

Terminal window
aggrega scaffold --example workload-identity-binding

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 workload-identity-binding

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

catalog/component/local/compute/identity-app/1.0.0/component.yaml
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:

release.yaml
features:
identity:
type: core/gcp-workload-identity
infra:
service_account_name: app-workload-identity
gcp_service_account: app-dev@example-project.iam.gserviceaccount.com

Mộ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-identity
locals:
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 workload
serviceAccount: "{{ .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:

app--identity--app-serviceaccount-app-workload-identity.yaml
[… omitted: the apiVersion]
kind: ServiceAccount
metadata:
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]
app-deployment.yaml
[… 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-identity

Vì 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.