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ực thể theo vai trò

Mỗi loại thực thể có một vai trò thường viết nó. Trang này là bản đồ đầy đủ — hãy dùng nó khi bạn biết mối quan tâm của mình nhưng chưa biết nó thuộc về tệp nào. Việc phân vai trò là hướng dẫn, không phải sự cưỡng chế của trình biên dịch (xem Các persona); nó nêu ai thường sở hữu một loại trong một thiết lập được phân tách tốt.

Tổng quan bản đồ

Vai tròLoại thực thểMối quan tâm
DeveloperAggregateÝ định ứng dụng: ứng dụng là gì và cần gì
Kiến trúc sư nền tảngComponent, FeatureHợp đồng catalog có thể tái sử dụng và có phiên bản
Vận hành nền tảngRecipe, FeatureRecipe, Plugin render providerChuyển đổi đặc thù theo Provider sang hạ tầng đã kết xuất
Operator nền tảngManifest, ReleaseĐịnh tuyến và kết nối triển khai
Hỗ trợ xuyên suốtSchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Plugin, WorkloadHình dạng dùng chung, mã mở rộng và loại trình biên dịch thuộc sở hữu của nền tảng

Developer

Aggregate — bề mặt viết duy nhất của developer và nguồn sự thật duy nhất cho cấu trúc liên kết của ứng dụng. Nó khai báo các component tạo nên ứng dụng, các values mà mỗi component nhận, các Features có hành vi là ý định ứng dụng (cùng với values của chúng), các parameters được công khai cho biến thể theo môi trường, và các cạnh uses nối các component với nhau. Nó cố ý không phụ thuộc vào hạ tầng vật lý: không có gì trong Aggregate nêu tên một cloud, một cluster hay một provider. Chính sự không phụ thuộc vào năng lực đó cho phép một Aggregate triển khai ở bất cứ đâu.

Kiến trúc sư nền tảng

Component — một hợp đồng có thể tái sử dụng và có phiên bản cho một loại khối xây dựng. Nó khai báo, thông qua một JSON Schema, các values mà developer có thể cung cấp; các đầu ra provides mà nó chuyển tới bên tiêu thụ; và các socket usesSchema mà nó công khai để kết nối. Các Components mang các nhãn ngữ nghĩa điều khiển chính sách và việc render. Kiến trúc sư giữ cho hợp đồng của Component ổn định để developer có thể dựa vào nó.

Feature — một năng lực có thể gắn mà developer hoặc operator có thể thêm vào một component: một exporter số liệu, việc che văn bản nhạy cảm trên một gateway AI, một liên kết thông tin xác thực. Một Feature khai báo những gì nó cần và những gì nó không tương thích; cách nó được hiện thực hóa — các tài nguyên nó tạo ra, hoặc các thiết lập nó ghi vào những gì component của nó vốn đã render — nằm trong FeatureRecipe của nó.

Vận hành nền tảng

Recipe — sự hiện thực hóa đặc thù theo provider của một Component. Nó ánh xạ các giá trị đã khai báo của Component sang đầu ra của một provider cụ thể — một release Helm, một service Compose, một module Terraform — thông qua template, và chuyển các giá trị provides tới bên tiêu thụ. Một Recipe không bao giờ thay đổi các giá trị hướng tới developer mà một Component khai báo; nó chỉ quyết định cách chúng được render.

FeatureRecipe — sự hiện thực hóa đặc thù theo provider của một Feature, được áp dụng tại thời điểm liên kết. Nó tạo ra các tài nguyên mà việc gắn một Feature hàm ý đối với một provider nhất định, hoặc ghi các thiết lập được hàm ý vào những gì component được gắn vốn đã render.

Plugin render Provider — một provider là guest Wasm biến đầu vào của một Recipe thành các manifest gốc của provider. Nó được cung cấp dưới dạng một Plugin với pluginType: provider khai báo (các) tên provider mà nó render và hợp đồng socket provider của nó. Bộ phận vận hành (hoặc một tác giả plugin) cung cấp các provider để các Recipes có một provider để render. Xem Tổng quan về Providers để biết các provider đi kèm và hợp đồng của chúng.

Đọc thông tin xác thực một cách an toàn trong Recipe

Một thông tin xác thực đến Recipe qua đường ống inject, .context.inject.env, dưới dạng bất kỳ văn bản nào mà tác giả của nó đã chọn, nên nó có thể chứa những ký tự mà template không thể ghi nguyên trạng vào YAML. Bên trong một scalar đặt trong dấu ngoặc kép, một dấu ngoặc kép sẽ kết thúc giá trị sớm và một dấu gạch chéo ngược sẽ bắt đầu một chuỗi thoát: bản build dừng lại, hoặc dấu gạch chéo ngược bị mất mà không có thông báo. Hãy thoát cả hai ký tự tại nơi giá trị được ghi:

variables:
{{- $env := optional (default dict .context.inject) "env" dict }}
DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"

optional đọc khóa từ map của đường ống với giá trị dự phòng rỗng, nên một mật khẩu không được thứ gì phân phối sẽ được render thành văn bản rỗng. Hai lệnh gọi replace thoát dấu gạch chéo ngược trước rồi mới đến dấu ngoặc kép, theo đúng thứ tự đó để ký tự thoát của chính dấu ngoặc kép không bị thoát thêm lần nữa, và giữ nguyên mọi ký tự khác. Một giá trị được đọc qua index, vốn dừng lại khi khóa không có mặt, áp dụng nguyên hai lệnh gọi replace đó.

Một ký tự mà dạng này không mang được là dấu ngắt dòng. YAML gộp một dấu ngắt dòng bên trong scalar đặt trong dấu ngoặc kép thành một dấu cách, nên một thông tin xác thực chứa dấu ngắt dòng sẽ được phân phối với một dấu cách ở chỗ ngắt dòng. Một FeatureRecipe ghi thông tin xác thực vào injectMapping của nó thì thay vào đó ghi qua toJson, vốn mang được dấu ngoặc kép, dấu gạch chéo ngược và dấu ngắt dòng như nhau, như tài liệu tham khảo FeatureRecipe minh họa.

FeatureRecipe đó ghi thông tin xác thực dưới cơ chế mà Recipe đọc nó từ đó — env: cho .context.inject.env, file:, arg:, hoặc một cơ chế riêng của component dưới chính tên của nó. .context.inject.all được xây dựng từ các cơ chế đó và không bao giờ từ đầu ra của một mapping, nên một mapping ghi dưới all: sẽ không phân phối gì cả; thay vào đó bản build dừng lại ở đó, nêu tên phần gắn, khóa và FeatureRecipe.

Operator nền tảng

Manifest — lớp định tuyến. Nó chỉ cho trình biên dịch biết Recipe nào hiện thực hóa mỗi Component cho một đích nhất định, nên cùng một Aggregate có thể được trỏ tới các bản hiện thực khác nhau trên các môi trường — một Recipe cloud cho production, một Recipe Compose cho kiểm thử cục bộ — mà không cần thay đổi gì trong tệp của developer.

Release — đầu vào biên dịch duy nhất, ghi lại những gì một môi trường build. Nó trỏ tới Aggregate và Manifest, đáp ứng các parameters mà developer đã công khai, gắn các Features có đầu vào mang tính vận hành, định cỡ bằng infra cho những Features mà developer đã gắn, và nối các cạnh của riêng nó bên trong các socket mà kiến trúc sư đã khai báo. Một Release đáp ứng các điểm biến thể đã công khai; nó không thể đưa vào values ứng dụng mới hay tài nguyên tính toán mới — những thứ đó chỉ đến từ Aggregate.

Các loại hỗ trợ xuyên suốt

Các loại này phục vụ tác giả ở nhiều vai trò thay vì thuộc về một vai trò.

SchemaLibrary — một thư viện dùng chung gồm các hình dạng schema lặp lại trong nhiều Components và Features. Khi cùng một cấu trúc (chẳng hạn một khối tài nguyên pod) xuất hiện trong nhiều thực thể, kiến trúc sư tách nó thành một mục SchemaLibrary để nó được định nghĩa và cập nhật một lần.

MappingLibrary — một thư viện dùng chung gồm logic ánh xạ có thể tái sử dụng mà các Recipes và FeatureRecipes dựa vào, để các mẫu dịch phổ biến có một nguồn duy nhất thay vì bị sao chép.

WorkloadLibrary — một thư viện dùng chung gồm nội dung Workload có thể tái sử dụng, để một hình dạng triển khai lặp lại trong nhiều Recipes được khai báo một lần và được nhập vào mỗi khối workload:.

ArtifactLibrary — một thư viện dùng chung gồm các bundle artifact có thể tái sử dụng: các tập hợp có tên gồm những tệp đầu ra phụ trợ đi cùng nhau, chẳng hạn một CRD cùng RBAC của nó. Một Recipe hoặc FeatureRecipe nhập một bundle tại một mục artifacts: và phát ra mọi tệp trong đó.

Plugin — loại mở rộng. Ngoài việc render provider, các Plugins đóng gói mã WebAssembly cung cấp trí tuệ đặc thù theo miền — xác thực chính sách, biến đổi, linting và các socket khác. Việc viết Plugin là mối quan tâm của nhóm nền tảng, hỗ trợ mọi vai trò khác.

Workload — một loại trình biên dịch thuộc sở hữu của nền tảng, không phải một tệp mà developer hay operator viết tay như một thực thể cấp cao nhất. Nó được tiêu thụ bên trong khối workload: của một Recipe, nơi provider mà Recipe dùng để render dịch hình dạng workload đã chuẩn hóa sang dạng gốc của nó. Tác giả Recipe tương tác với nó thông qua khối đó; tài liệu tham khảo Workload mô tả hình dạng của nó.

Tiếp theo