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.

Bí mật

Trang này giải thích một ý tưởng duy nhất, đó là cách một thông tin xác thực đến được thành phần cần nó, và không phải là một không gian làm việc có thể chạy được. Nền tảng nâng cao — một nền tảng Kubernetes nhiều ranh giới trình bày cả hai mô hình phân phối trong một không gian làm việc do bạn tự xây dựng; hãy ghi nó vào một thư mục của riêng bạn bằng:

Terminal window
aggrega scaffold --example advanced-platform

Sau đó nó in ra các lệnh cần chạy tiếp theo:

Terminal window
cd advanced-platform
aggrega pull --release release.yaml
aggrega build --release release.yaml

Danh sách kiểm tra việc phân phối bí mật

Một thông tin xác thực đi qua sáu bề mặt trước khi đến một container đang chạy. Đây là các điểm chạm cần kiểm tra khi nối một thông tin xác thực mới:

BướcBề mặtHành động
1Component featuresSchema:Khai báo slot thông tin xác thực: tên của nó, nó có required hay không, và danh sách cho phép inject: của nó — các cơ chế phân phối mà một attachment có thể nêu tên, [env] hoặc [env, file] cho một slot trong suốt, [] cho một slot không trong suốt.
2Feature thông tin xác thực schema:Định nghĩa những gì tác giả cung cấp: các Features thông tin xác thực của thư viện chuẩn mang nhãn feature.aggrega.ai/kind: secret và nhận bộ định vị của thông tin xác thực làm origin, và khóa dữ liệu làm key.
3Aggregate features:Yêu cầu thông tin xác thực, dưới cùng từ khóa features: như mọi Feature khác: type của nó, values của nó và, chỉ trên một slot trong suốt, một khối inject: cho biết ứng dụng đọc nó như thế nào.
4FeatureRecipeHiện thực hóa nó cho đích: ghi giá trị vào nơi thành phần đọc nó, render một tài nguyên chứa nó, hoặc render một tài nguyên lấy nó từ một kho bí mật.
5Manifest mappings.features.typeLiên kết Feature thông tin xác thực với FeatureRecipe của nó, trong cùng tầng với mọi Feature khác.
6RecipeĐọc nó, trên một slot không trong suốt: Recipe của thành phần đọc bộ định vị mà thông tin xác thực công bố, .features.<slot>.provides.name, và chuyển nó cho cơ chế riêng của sản phẩm, chẳng hạn như existingSecret của một chart.

Một slot trong suốt dùng năm bước đầu; một slot không trong suốt dùng cả sáu, đây là trường hợp thông thường đối với hạ tầng đóng gói sẵn như chart của một nhà cung cấp.

Slot trong suốt và không trong suốt

Một slot trong suốt cho phép nhà phát triển quyết định ứng dụng đọc thông tin xác thực như thế nào. Một slot không trong suốt để việc phân phối cho Recipe, và một attachment viết khối inject: trên nó sẽ dừng bản build. Trong ví dụ, core/datastore/mariadb khai báo mỗi loại một slot, và Aggregate điền cả hai, từ aggregate.yaml với các chú thích được lược bỏ:

db:
type: core/datastore/mariadb
features:
root_password:
type: core/secret-value
values:
key: MARIADB_ROOT_PASSWORD
origin: dev-root-pw-change-me
user_password:
type: core/secret-provided
values:
origin: dev-app-pw-change-me
inject:
env:
- in: MARIADB_PASSWORD
from: value

root_password là không trong suốt: core/secret-value phân phối giá trị dưới khóa mà attachment nêu tên, nơi Recipe của cơ sở dữ liệu đọc nó. user_password là trong suốt: core/secret-provided công bố giá trị dưới dạng value, và chính khối inject: của attachment phân phối nó vào MARIADB_PASSWORD. Một khối inject: nêu tên một cơ chế mà slot không liệt kê sẽ dừng bản build, một khối nêu tên một khóa mà không gì công bố hay đọc cũng vậy.

Với một slot không trong suốt được điền bởi một thông tin xác thực có thể tham chiếu, Recipe của thành phần đọc bộ định vị đã công bố thay vì suy ra một tên, existingSecret: "{{ .features.root_password.provides.name }}", nên Secret mà một FeatureRecipe phát ra và tham chiếu đến nó là một chuỗi duy nhất. MariaDB (chart Bitnami) — một Secret thông tin xác thực nhiều khóa xây dựng luồng đó trên chart của một nhà cung cấp.

Hiện thực hóa một thông tin xác thực: một tài nguyên, hoặc một pipeline hai bước

Các hiện thực Kubernetes của thư viện chuẩn render tài nguyên của thông tin xác thực từ một chart nhỏ đặt cạnh FeatureRecipe: helm/k8s-secret-from-parameter render một Secret chứa giá trị mà tác giả cung cấp, và helm/k8s-external-secret render một ExternalSecret mà External Secrets Operator đối soát từ một kho bí mật. Features thông tin xác thực lần lượt trình bày từng loại.

Thay vào đó, một FeatureRecipe có thể hiện thực hóa một thông tin xác thực bằng một pipeline: gồm hai bước, mỗi bước là một plugin. Bước đầu tiên, bộ lấy, ghi tài nguyên riêng của kho — chẳng hạn một ExternalSecret — nêu tên mục trong kho mà các giá trị của attachment đưa ra. Bước thứ hai, bộ chèn, vá khối lượng công việc đã render của thành phần để gắn Secret thu được vào container của nó, tại các biến hoặc tệp mà khối inject: của attachment nêu tên, và bước này đọc chúng tại .inject. Chuyển sang một kho bí mật khác sẽ thay bộ lấy; bộ chèn vẫn giữ nguyên. Một bước trả về các tài nguyên nó thêm vào dưới dạng hiệu ứng phụ và các thay đổi của nó đối với các tài liệu đã render dưới dạng bản vá; hợp đồng plugin Wasm là hình dạng của cả hai.

Thông tin xác thực riêng của một Feature

Một Feature có thể cần thông tin xác thực của riêng nó: một proxy bảo vệ xác thực với một dịch vụ upstream, một trình gửi log với một token nạp dữ liệu. Feature khai báo slot trong featuresSchema của chính nó, đúng như một Component làm, và FeatureRecipe gắn với nó đọc những gì lấp đầy slot đó khi render khối lượng công việc của Feature.

Các attachment không lồng nhau. Thông tin xác thực được gắn bên cạnh Feature, trên cùng thành phần, dưới tên mà slot của Feature khai báo; tên slot là thứ gắn kết hai bên với nhau. Feature bảo vệ và thành phần bên dưới là các thực thể riêng của không gian làm việc; core/referenced-secret là của thư viện chuẩn.

# The Feature declares the slot
kind: Feature
metadata:
name: local/guard
spec:
appliesTo: "component.aggrega.ai/type in (server, worker)"
featuresSchema:
guard_api_key:
selector: "feature.aggrega.ai/kind=secret"
sensitive: true
inject: [env]
---
# The Aggregate fills it beside the Feature
spec:
components:
finance-agent:
type: local/compute/guarded-worker
features:
ai-guard:
type: local/guard
guard_api_key:
type: core/referenced-secret
values:
origin: dev-guard-key-change-me
key: api-key

FeatureRecipe của bộ bảo vệ render một khối lượng công việc có container tham chiếu đến slot, attachments: { GUARD_API_KEY: { from: guard_api_key, as: env } }, nên tham chiếu đặt vào container của bộ bảo vệ và không vào container nào khác. Recipe của thành phần chủ không thể tham chiếu đến slot, vì slot thuộc về Feature: một khối lượng công việc tìm cách dùng nó sẽ dừng bản build và nêu tên slot. Một mục khối lượng công việc nêu tên một slot mà không gì điền cũng dừng bản build, vì không có bộ định vị đã công bố nào để phân giải.

Điều tương tự cũng đúng với các kết nối mà một Feature tạo ra: một kết nối trong khối uses: của chính Feature không mang attachment nào, vì vậy thông tin xác thực mà một kết nối như vậy cần là một slot do Feature khai báo, được điền bên cạnh Feature.

Thông tin xác thực riêng của một kết nối

Một gateway kết nối tới hai mô hình có thể xuất trình một khóa khác nhau cho mỗi mô hình, hoặc một khóa cho mô hình này và không có khóa nào cho mô hình kia. Một slot trên gateway chứa một thông tin xác thực cho toàn bộ thành phần, nên thay vào đó thông tin xác thực được đặt trên kết nối: socket của gateway khai báo slot mà mọi kết nối đi qua nó có thể điền, và mỗi kết nối tự điền slot đó, hoặc không.

spec:
components:
router:
type: core/gateway/litellm
uses:
models:
gpt:
target: gpt
features:
credential: # a slot the models socket declares
type: core/referenced-secret
values:
key: api-key

Recipe của gateway đọc attachment từ kết nối của nó, tại .context.uses.gpt.features.credential, nên một gateway kết nối tới nhiều mô hình sẽ đọc khóa riêng của từng mô hình; core/gateway/litellm phân phối mỗi khóa dưới dạng một biến riêng, do mục của kết nối trong bảng định tuyến của nó nêu tên. Một attachment dưới một tên mà socket không khai báo slot nào sẽ dừng bản build, đồng thời nêu tên các slot mà socket có khai báo. Manifest có thể hiện thực hóa thông tin xác thực của một kết nối khác với các kết nối còn lại, theo khóa <connection>.credential trong tầng theo từng thực thể của nó. Thông tin xác thực trên kết nối — một khóa cho mỗi kết nối, và một khóa ở cả hai đầu xây dựng điều này; một Release cũng có thể nối một kết nối như vậy và nêu tên bí mật trong infra của attachment, như Features thông tin xác thực mô tả.