Các trụ cột dữ liệu
Khung khái niệm của năm từ khóa cấu trúc DSL — parameters, values, uses, infra, inject — nằm tại architecture/06-data-taxonomy-and-composition.md. Trang này trình bày danh sách chuẩn các trụ cột dữ liệu, ngữ nghĩa soạn thảo theo từng trụ cột, cơ chế liên trụ cột và bộ từ vựng về giá trị mặc định mà người soạn thảo gặp ở các trụ cột. Bộ ba topology bổ sung (provides, inject, uses — các từ khóa nối các cạnh của đồ thị) được mô tả tại topology-triad.md; bộ từ vựng metadata tách biệt với các trụ cột dữ liệu (labels, annotations, các trường của bề mặt xuất bản) nằm tại labels-and-annotations.md và publishing-surface.md.
Danh sách trụ cột chuẩn
Các thực thể Aggrega mang bảy trụ cột dữ liệu có tên. Năm trụ cột tham gia vào luồng dữ liệu IR dưới dạng trạng thái sống qua suốt quá trình kết xuất; hai trụ cột còn lại là tạm thời hoặc riêng tư và chỉ tồn tại ở những giai đoạn biên dịch cụ thể.
| Trụ cột | Nằm trên | Vòng đời | Vai trò |
|---|---|---|---|
values | Các instance component / attachment của Aggregate | Sống qua suốt quá trình kết xuất | Payload nhận thức do Developer soạn |
infra | Các mục component, attachment và kết nối của Release | Sống qua suốt quá trình kết xuất | Định cỡ vật lý do Operator soạn |
provides | Khối provides: của Recipe | Sống qua suốt quá trình kết xuất (trụ cột dẫn xuất — xem bên dưới) | Các chuỗi đầu ra công khai do Recipe tính toán mà đường ống topology tiêu thụ |
uses | Các instance component / feature của Aggregate | Sống qua suốt quá trình kết xuất | Các cạnh topology tới các component / feature khác |
features | Các instance component của Aggregate + Release; các slot được khai báo trong featuresSchema của một thực thể catalog — xem “Trụ cột Features” bên dưới | Sống qua suốt quá trình kết xuất | Trụ cột attachment — một hình dạng cho mọi họ attachment |
parameters | Các gốc Aggregate + Release | Có thể đọc cho đến cuối pipeline, tới khi mọi pha kết xuất hoàn tất; path template truy cập được trong quá trình kết xuất thông qua quyền cấp bất đối xứng; các ngữ cảnh của value template tiêu thụ các literal sau nội suy thay vì đọc trực tiếp .parameters | Các slot theo từng môi trường do Release đáp ứng |
locals | Khối locals: của Recipe | Riêng tư của Recipe — chỉ hiển thị bên trong các template của chính Recipe đó | Trạng thái chuỗi được tính toán mà các Recipes dẫn xuất trong phần mở đầu locals |
values / infra / provides / uses / features là năm trụ cột sống mà template context lúc chạy cung cấp lần lượt qua .values, .infra, .provides, .context.uses và .features. parameters và locals không nằm trong danh sách trụ cột sống — parameters vì nó không tồn tại sau bước phân giải; locals vì nó là riêng tư của Recipe và không bao giờ vượt qua ranh giới thực thể.
Trụ cột là biển chỉ dẫn, không phải tường ngăn: template engine cho phép đọc chéo trụ cột tại mọi vị trí trừ khi bị cấm rõ ràng bởi các quy tắc tự chứa (khối provides: của Recipe và khối source: của Recipe đọc .context.inject / .context.uses; được mô tả tại templates/expansion-matrix.md). Ranh giới trụ cột là kỷ luật soạn thảo, không phải sự cưỡng chế của ngôn ngữ.
Ranh giới giữa các trụ dữ liệu và kỷ luật soạn thảo
Việc đọc chéo giữa các trụ từ một template của Recipe không bị hạn chế tại mọi vị trí cho phép ngữ cảnh template đầy đủ. Kỷ luật soạn thảo kỳ vọng tác giả:
- Đọc
.valuesđể lấy tải trọng nhận thức (ý định do Developer soạn). - Đọc
.infrađể lấy kích thước vật lý (kích thước do Operator soạn). - Đọc
.context.uses[].provides.<key>để lấy các chuỗi con trỏ giữa các component (luồng dữ liệu của bộ ba topology). - Đọc
.context.injectđể lấy đường ống phân phối sau hydration (được ghép từ các nguồn inject trêncomponent.inject,uses[].injectvà các lần chặninjectMappingcủa FeatureRecipe).
Kỷ luật này là biển chỉ dẫn, không phải bức tường. Một template của Recipe đọc .infra.replicas để điều khiển một trường values: vẫn hoạt động; template engine không chặn việc đọc đó. Kiến trúc coi ranh giới giữa các trụ mô tả ý định soạn thảo — ai sở hữu dữ liệu — chứ không phải hạn chế lúc chạy. Các quy ước khớp với cách chia bốn miền: giá trị do Developer soạn đến từ .values; kích thước do Operator soạn đến từ .infra; tọa độ giữa các component đến từ đường ống topology.
Khi cần một cầu nối chéo giữa các trụ có chủ đích — ví dụ, schema: của một Component cung cấp một núm điều chỉnh hướng tới developer mà template valuesMapping: của Recipe dẫn vào đầu ra có dạng infra: phía Ops theo vocabulary/inheritance-and-interface.md — kiến trúc coi cầu nối đó là một ngoại lệ có biển chỉ dẫn. Xem “Cơ chế chéo giữa các trụ” bên dưới.
Values
Trụ cột values: mang tải trọng nhận thức do Developer soạn — các tham số về hình dạng ứng dụng mà Developer quy định cho từng thể hiện component. schema: của Component khai báo hình dạng của values; Aggregate của Developer điền các giá trị cụ thể cho từng thể hiện. Đây là lĩnh vực của Developer.
Được soạn tại:
- Aggregate
components.<id>.values:— tải trọng nhận thức cho từng thể hiện component. - Aggregate
subsystems.<name>.components.<id>.values:— tương tự, bên trong các component được nhóm theo subsystem. - Aggregate
components.<id>.features.<name>.values:vàfeatures.<name>.values:của một subsystem — tải trọng values của attachment, bất kể Feature được gắn thuộc họ nào (các tham số truy vấn vault của một attachment thông tin xác thực được soạn tại đây như mọi attachment khác).
Bị cấm trong:
- Thực thể Release (schema của Release cấm khối
values:ở mọi cấp lồng nhau — Parameter Hoisting là con đường được hỗ trợ để thay đổi theo từng môi trường; xem Parameters bên dưới).
Được xác thực bởi: khối values: của schema của Component (và khối values: của schema của Feature đối với các attachment Feature), được phân giải thành JSON Schema 2020-12 tại thời điểm nạp Component / Feature theo Layer 2 của vocabulary/validation-surface.md.
Được tiêu thụ bởi: các template valuesMapping: của Recipe thông qua .values. Ngữ cảnh template đầy đủ cung cấp từ điển values đã phân giải tại mọi vị trí template kết xuất cơ sở.
Infra
Trụ cột infra: mang thông số định cỡ vật lý do Operator soạn — số bản sao, yêu cầu tài nguyên, giới hạn IOPS, ghim vùng, lớp máy. Nó diễn đạt ở đâu và lớn đến mức nào, bổ sung cho cái gì và hoạt động ra sao của values. Đây là lĩnh vực của Operator.
Bốn bề mặt soạn thảo
Người soạn gặp infra: tại bốn bề mặt riêng biệt, mỗi bề mặt có phạm vi và hành vi lan truyền khác nhau:
| # | Bề mặt | Phạm vi | Thứ tự ưu tiên khi hợp nhất |
|---|---|---|---|
| 1 | Ranh giới Release components.<id>.infra: (spec.components.<id>.infra: trong một Release không có ranh giới) | Một instance component | Định cỡ riêng của component; không bề mặt nào khác ghi vào nó |
| 2 | Ranh giới Release features.<name>.infra: | Một attachment trên toàn ranh giới, trên mọi component trong ranh giới | Thấp nhất cho attachment đó — bề mặt 3 ghi đè nó theo từng trường |
| 3 | Ranh giới Release components.<id>.features.<name>.infra: | Một attachment trên một component | Ghi đè bề mặt 2 cho attachment đó, theo từng trường |
| 4 | Release components.<id>.uses.<socket>.<alias>.infra: | Một kết nối | Được kiểm tra theo infraSchema của socket; chỉ đến được bước render của component tiêu thụ |
Bề mặt 1 được soạn nhiều nhất: Operator định cỡ từng component mà Release đặt vào. Một ranh giới không mang infra: riêng — schema của Release từ chối nó — nên định cỡ dùng chung cho nhiều component được viết trên từng component, hoặc kế thừa từ một Release cha qua extends: (bên dưới). Bề mặt 2 và 3 bao quát việc định cỡ gắn kết Feature — các Features mang payload infra riêng mà FeatureRecipe sử dụng khi tổng hợp sidecar hoặc tài nguyên theo từng Feature: một attachment trên toàn ranh giới được định cỡ một lần, và một component điều chỉnh một trường duy nhất của nó.
“Infra chủ yếu cục bộ” — quy tắc có ngoại lệ
Mục tiêu kiến trúc cho infra: là cục bộ theo component: việc định cỡ của một component áp dụng cho thể hiện component đó và không tràn sang các component khác. Đây là cơ chế cho phép Ops tăng IOPS của cơ sở dữ liệu mà không ảnh hưởng đến yêu cầu CPU của máy chủ API.
Quy tắc: infra: chủ yếu cục bộ tại bề mặt đã soạn nó. Các ngoại lệ lan truyền tồn tại theo thiết kế:
- Lan truyền annotation của ranh giới.
annotations:của ranh giới lan truyền qua các ranh giới lồng nhau tới các component bên trong (Bề mặt 5 của ma trận annotation trong labels-and-annotations.md). Các annotation được Recipes dùng làm đầu vào định tuyến trở thành tầm vớiinfragián tiếp — annotation cấp ranh giới chảy qua.context.annotations.releasevào đầu ra được render của Recipe theo từng nút. - Kế thừa Release qua
extends:. Một Releaseextends:một Release cha sẽ kế thừa các khai báoinfracủa cha tại mọi bề mặt mang chúng, trừ khi con ghi đè theo từng khóa. Giá trị của con thắng theo từng khóa, xuống tới giá trị không thể chia nhỏ đầu tiên — một scalar, một danh sách, một template — vốn được thay thế toàn bộ, và một khóa mà con viết lànullsẽ bị loại bỏ thay vì được đặt thành rỗng. Việc kế thừa vượt qua ranh giới của từng Release một cách có chủ ý; để biết toàn bộ quy tắc gộp và những gì khác đi kèm, xementities/release.md. - Dẫn liên trụ cột qua schema-bridge.
schema:của một Component có thể phơi ra một nút điều chỉnhvalues:hướng tới developer mà templatevaluesMapping:của Recipe dẫn vào đầu ra có dạnginfra:của provider (xem “Cơ chế liên trụ cột — Dẫn liên trụ cột qua schema-bridge” bên dưới). Nói chính xác thì giá trị bắt nguồn từvalues:và chảy vào đầu ra được render; sự lan truyền là bên trong thể hiện nhưng liên trụ cột.
Tính cục bộ là ý đồ thiết kế, không phải một bức tường mà engine áp đặt: các lan truyền ở trên là những ngoại lệ có chủ ý, mỗi ngoại lệ được ghi lại tại bề mặt mang nó.
Phân chia phía-theo-trụ cột cho việc mở rộng Feature do annotation điều khiển. Bất biến Aggregate-như-Bề-mặt-Soạn-thảo được duy trì trên đường mở rộng Feature do annotation điều khiển: annotation phía Aggregate (phạm vi subsystem và thể hiện component) chỉ có thể kích hoạt các khóa con maps.values; annotation phía Release (phạm vi ranh giới và thể hiện component) chỉ có thể kích hoạt các khóa con maps.infra. Một binding Manifest có thể khai báo đường dẫn ở cả hai trụ cột; mỗi phía chỉ kích hoạt tập con tương thích của mình, và việc kết hợp liên phía hợp nhất các đóng góp theo từng trường tại thời điểm xây dựng IR. Sự phân chia này giữ sự tách biệt soạn thảo values-developer / infra-operator tại bề mặt annotation — cũng chính sự tách biệt mà values: và infra: áp đặt trên các bề mặt gắn kết tường minh. Xem providers/well-known-annotations.md §“Side-vs-pillar partition per subkey” để biết hướng dẫn theo từng khóa con và mẫu kết hợp liên phía.
Provides
Trụ cột provides: là trụ cột dẫn xuất — một Recipe khai báo nó, nhưng khác với values / infra, nhà phát triển không trực tiếp viết nó. Các Recipes tính toán các chuỗi đầu ra công khai mà đường ống topology sẽ sử dụng.
Khối provides: của một Recipe là một map gồm các cặp <key>: <template>. Mỗi template được đánh giá dựa trên bề mặt tự chứa của chính Recipe đó (.values, .infra, .context.instance_id, .context.rendered_name khi provider của nút báo cáo giá trị này, và .locals đã được phân giải của nút) trong quá trình đánh giá provides. Các chuỗi kết quả được công khai qua .provides và được các khối uses[].inject của bên gọi sử dụng thông qua các tham chiếu from: "<key>". .locals khả dụng vì các locals của nút được phân giải trong phần mở đầu của giai đoạn đó, trước provides của nó (xem Locals bên dưới); việc đặt tên một khóa mà khối locals không khai báo sẽ gây dừng.
Bất biến tự chứa. Các template provides: của Recipe không được tham chiếu .context.inject hoặc .context.uses. Quá trình đánh giá provides chạy các template đó theo thứ tự bất kỳ — chúng chỉ bao đóng trên dữ liệu riêng của nút, nên thứ tự không quan trọng. Các tham chiếu giữa các nút sẽ gắn quá trình đánh giá đó với thứ tự duyệt topo, điều mà thiết kế cố ý tránh. Xem templates/expansion-matrix.md hàng 6 để biết quy tắc và lý do của nó.
Tại sao provides: là một trụ cột. Các chuỗi đầu ra là bề mặt công khai chuẩn của mọi Recipe; các bên tiêu thụ phía sau (uses[].inject của bên gọi, các khối injectMapping của FeatureRecipe đọc provides đã phân giải của đích qua .context.uses) coi từ điển này như một hợp đồng có kiểu. Việc gọi provides: là một trụ cột thừa nhận vị thế hạng nhất của nó bên cạnh values / infra / uses / features. Coi nó là “chỉ là phần nội bộ của Recipe” sẽ đánh giá thấp vai trò của nó như nguồn dữ liệu chính của đường ống topology.
Uses
Trụ cột uses: là phần khai báo cạnh tô-pô. Khối uses: của một instance component nêu tên các cạnh mà component đó tham gia — các socket mà qua đó nó tiêu thụ các đích. Ngữ pháp đầy đủ được mô tả tại topology-triad.md; phần này nêu uses: như một trụ cột cho đầy đủ.
uses: nằm trên các instance component của Aggregate + các attachment feature; ngữ cảnh template lúc chạy cung cấp một mục cho mỗi kết nối đi ra, có khóa là bí danh của nó, dưới dạng .context.uses. Phép chiếu này mang siêu dữ liệu đích đã được phân giải của từng cạnh (provides của đích, labels, annotations) để các Recipes của bên gọi có thể đọc các chuỗi con trỏ liên component khi đánh giá template ở bước render cơ sở, cùng các attachment được viết trên kết nối đó, tại .context.uses.<alias>.features.<slot>.
Trụ cột Features
features: là trụ cột gắn kèm: một từ khóa, một hình dạng, cho mọi phần gắn kèm. Một Feature vận hành, một Feature thông tin xác thực và một Feature danh tính đều được khai báo tại đây dưới tên thể hiện mà tác giả chọn. Ngữ cảnh template lúc chạy hiển thị các phần gắn kèm của nút dưới dạng .features.<name>, mỗi phần mang type, values, infra và provides đã được phân giải của phần gắn kèm. Một phần gắn kèm được viết trên một trong các kết nối của component thì thay vào đó được hiển thị với cùng hình dạng đó dưới kết nối, tại .context.uses.<alias>.features.<slot>, và không bao giờ dưới .features — vì vậy một Recipe duyệt qua .features chỉ gặp các phần gắn kèm của chính component (xem hợp đồng ngữ cảnh template).
Một phần gắn kèm có tên thể hiện khớp với một slot mà thực thể khai báo trong featuresSchema sẽ lấp đầy slot đó; mọi tên thể hiện khác là một phần gắn kèm tự do. Việc lấp đầy một slot là điều kết nối bốn bề mặt mà một thông tin xác thực dựa trên slot đi qua:
| Bề mặt | Nơi viết | Vai trò |
|---|---|---|
Component / Feature featuresSchema: | thực thể trong catalog | Khai báo các slot mà thực thể mong đợi; với mỗi slot, kiểm soát danh sách cho phép về cách phân phối (env / file / blackbox) và tùy chọn một bộ chọn nhãn mà phần lấp đầy phải thỏa mãn |
Aggregate components.<id>.features.<slot>: | thể hiện component trong Aggregate | Lấp đầy slot bằng một phần gắn kèm; cung cấp values: riêng của phần gắn kèm và, với một slot trong suốt, ánh xạ inject: của nó |
Workload containers.<name>.attachments.<KEY>.from/as: | phần thân Workload của Recipe | Tham chiếu một slot đã khai báo — hoặc, bên cạnh connection: <alias>, một slot mà socket của kết nối đó khai báo — và quy định cách phân phối theo từng container cho thứ đã lấp đầy nó |
FeatureRecipe (source / workload / artifacts / valuesMapping, injectMapping, pipeline:) | FeatureRecipe được liên kết | Tạo ra đầu ra của phần gắn kèm — một tài nguyên được phát ra, một sự viết lại cách phân phối, hoặc cả hai |
Tên slot là định danh chịu lực xuyên suốt cả bốn: bề mặt 1 khai báo nó, các bề mặt 2–4 tham chiếu nó, và luồng dữ liệu đi theo một chiều (khai báo → lấp đầy → tham chiếu → tạo ra).
Về danh sách kiểm tra khi viết, xem examples/04-secrets.md “The secret-delivery checklist” (Danh sách kiểm tra phân phối secret).
Locals
Trụ locals: là trạng thái riêng tư của Recipe. Toàn bộ khối được phân giải trong phần mở đầu locals, trước provides: của nút đó; các chuỗi kết quả hiển thị với mọi template sau đó của chính Recipe — provides:, source:, valuesMapping:, workload:, artifacts:, assertions:, pipeline[].with. Một template provides: nêu tên một khóa mà khối không khai báo sẽ dừng biên dịch.
Nơi viết: khối spec.locals: của Recipe — một map gồm các cặp <key>: <template> được đánh giá trên một bề mặt cục bộ của nút, tự chứa: .context.instance_id, .values, .infra, và các mục của cùng khối đã được phân giải. Ngoài ra không có gì khác: .provides, .metadata và phần còn lại của .context.* không có trên đó, và một tham chiếu tới bất kỳ cái nào trong số đó sẽ dừng biên dịch.
Thứ tự mang tính quyết định. Các mục được phân giải theo thứ tự viết và một mục có thể đọc một mục anh em được định nghĩa phía trên nó, nhận giá trị đã phân giải của mục đó. Chuỗi tham chiếu chỉ chạy xuống dưới — khi một mục đọc mục khác, việc chuyển định nghĩa xuống dưới mục đọc nó sẽ bị từ chối, và trình biên dịch không bao giờ sắp xếp lại khối để tham chiếu phân giải được. Một tham chiếu tới mục phía sau sẽ dừng và nêu lỗi thứ tự; một tham chiếu tới khóa chưa khai báo sẽ dừng và nêu tên khóa. Trên một Recipe có source: là một khối có cấu trúc, cả hai lỗi cũng bị từ chối trong khi artifact mà nó nêu tên đang được ghim, nên aggrega pull báo cáo chúng trước khi bất kỳ bản build nào kết xuất đầu ra. Việc kiểm tra đọc đường dẫn mà một tham chiếu phân giải tới chứ không phải các ký tự gõ vào, nên nó bao quát như nhau dạng trực tiếp, một khối with .locals, một biến gắn với .locals, và khối trong ngoặc đơn, (.locals).<key> hoặc ($.locals).<key>. Có một cách viết nó không bao quát: một khóa được truy cập qua một hàm, như index .locals hoặc (default dict .locals).<key>. Một khóa không tồn tại được truy cập theo cách đó không dừng biên dịch, và nó kết xuất văn bản nguyên văn <no value> thay vì không gì cả — ngoại trừ qua chính index, vốn dừng và nêu tên khóa trên mọi bề mặt template khi map mà nó đọc không chứa khóa đó.
Phạm vi hiển thị: riêng tư của Recipe. Không có trường .context.uses[].locals — một bên gọi không thể đọc locals của đích qua cạnh nối. Thứ mà bên gọi có thể đọc là provides: của đích.
Trường hợp sử dụng:
- Tính toán các chuỗi con trỏ nội bộ của Recipe (ví dụ:
secret_target_admin_password: "redis-auth", hậu tố của tên một Secret) mà cảvaluesMapping:vàprovides:của Recipe đều sử dụng, và mà một FeatureRecipe thông tin xác thực gắn vào cùng component đọc dưới dạng.locals.secret_target_admin_password— các template của một attachment thấy locals đã phân giải của Recipe chủ được hợp nhất với locals của chính attachment. Trên đíchhelm, mỗi bên viết tên đầy đủ là{{ .context.rendered_name }}-{{ .locals.secret_target_admin_password }}: tên kết xuất là tên của component được viết bằng các ký tự mà một tên Kubernetes cho phép, và một local không thể đọc nó, nên local mang hậu tố và mọi bên đọc ghép hai phần lại. - Loại bỏ lặp lại (DRY) các giá trị tính toán trùng lặp trong một Recipe (một hostname được tính một lần, được tham chiếu từ nhiều trường
valuesMapping:). - Các giá trị trung gian cho logic template phức tạp vốn sẽ khó đọc nếu viết nội tuyến.
provides: và locals: — mặt công khai và mặt riêng tư
Hai trụ phía Recipe mang một sự phân tách phạm vi hiển thị có chủ đích mà người viết nên ghi nhớ:
provides:là mặt công khai. Mỗi khóa là bề mặt ống dẫn topology chuẩn — các khốiuses[].injectcủa bên gọi phía hạ nguồn sử dụng chúng thông qua các tham chiếufrom: "<key>". Từ điểnprovides:là một hợp đồng có kiểu mà các bên gọi phụ thuộc vào; đổi tên hoặc xóa một khóa là một thay đổi phá vỡ tương thích đối với mọi Recipe có khai báouses[].injecttham chiếu tới nó.locals:là mặt riêng tư. Mỗi khóa là trạng thái nội bộ của Recipe, chỉ hiển thị bên trong các template tiếp theo của chính Recipe. Không bên gọi nào có thể đọc locals của một Recipe; các tên tronglocals:không thuộc bất kỳ giao diện công bố nào và việc đổi tên chúng là một lần tái cấu trúc nội bộ của Recipe, không ảnh hưởng gì phía hạ nguồn.
Hai trụ này cũng có thứ tự: locals: được phân giải trước, nên provides: có thể đọc .locals nhưng locals: không thể đọc .provides. Do đó, công bố giá trị của một local qua provides: nghĩa là thêm một mục provides đọc local đó — biểu thức vẫn nằm ở một chỗ.
Sự phân tách này có chủ đích, theo sự tách biệt kiến trúc giữa phần nội bộ của Recipe (riêng tư) và giao diện của Recipe (công khai). Người viết coi provides: và locals: là một không gian tên sẽ đánh mất sự phân biệt phạm vi hiển thị và có nguy cơ để lộ trạng thái nội bộ qua ống dẫn topology — mọi khóa khai báo trong provides: đều trở thành một phần của bề mặt hợp đồng của Recipe, dù người viết có chủ ý hay không. Mục tiêu kỷ luật: khai báo khóa trong locals: trước; chỉ nâng lên provides: khi một bên gọi phía hạ nguồn thực sự cần nó.
Khả năng hiển thị được xác định bởi trụ cột nơi khóa được khai báo: không có dấu hiển thị theo từng khóa, nên một giá trị vừa riêng tư vừa được công bố là một mục locals: và một mục provides: đọc nó.
Parameters
Cả hai schema Aggregate và Release đều mang một từ điển parameters ở gốc. Nhà phát triển khai báo các khóa mà Aggregate cần; Ops điền giá trị từ các tệp Release riêng cho từng môi trường. Sự tách rời này là cơ chế cho việc thăng cấp GitOps: một Aggregate.yaml bất biến duy nhất đi qua các môi trường Dev, Staging và Production, trong đó Release của mỗi môi trường cung cấp các giá trị tham số riêng.
spec: parameters: corp_db_name: type: string required: true env_workers: type: integer required: true region: type: string required: true enable_debug: type: boolean required: true components: my-backend: type: core/python-worker:1.0.0 values: workers: {{ .parameters.env_workers }} region: "{{ .parameters.region }}"# release-prod.yaml — inline parameter valuesspec: aggregate: my-app manifest: prod-manifest parameters: corp_db_name: "enterprise_data" env_workers: 10 region: "eu-west-1" enable_debug: falseVới các luồng CI/CD giữ giá trị tham số trong một tệp riêng (ví dụ: một tệp .yaml cho từng môi trường được commit cạnh Release), Release dùng dạng $import:: parameters: { $import: ./prod-values.yaml }. Nội dung của tệp thay thế map nội tuyến tại bề mặt Release. Đường dẫn được phân giải từ thư mục chứa Release, bất kể lệnh được chạy từ đâu, và phải dẫn tới một tệp nằm trong workspace — hoặc, với một Release nằm ngoài workspace, nằm trong thư mục chứa nó. Việc xếp lớp nhiều tệp (kết hợp một tệp cơ sở với một lớp phủ riêng cho môi trường) được biểu diễn bằng các chuỗi extends: của Release — Release cha cung cấp các tham số cơ sở; Release con kế thừa và ghi đè theo từng khóa.
Vòng đời tham số. Trình biên dịch phân giải tham số qua ba giai đoạn. (1) Điền mặc định — các slot có định nghĩa default: và không có giá trị từ Release sẽ nhận giá trị mặc định. (2) Xác thực hợp đồng tham số — hợp đồng parameters: có kiểu xác thực từng giá trị theo các ràng buộc type / enum / min / max / pattern đã khai báo, kể cả giá trị mặc định đã được điền, nên một giá trị mặc định vi phạm chính hợp đồng của nó sẽ dừng build. (3) Nội suy — trình biên dịch đánh giá toàn bộ văn bản của Aggregate như một template và thay mọi tham chiếu {{ .parameters.<slot> }} bằng giá trị đã phân giải. Map đã hợp nhất sau đó vẫn đọc được trong suốt quá trình render, để các path template (directory: / subDirectory: ở ranh giới Release) có thể đọc .parameters.<slot> trực tiếp, theo danh sách cho phép khép kín được mô tả tại ../path-template-variables.md. Các bề mặt value-template (Recipe valuesMapping, FeatureRecipe injectMapping / provides / pipeline.with, phần thân Workload) KHÔNG nhận .parameters trong ngữ cảnh template của chúng — chúng dùng các giá trị đã phân giải được ghi vào các chuỗi values: xung quanh bởi bước nội suy ở giai đoạn 3.
Danh sách kiểm tra nâng tham số
Mọi giá trị khác nhau giữa các môi trường đều đi qua bốn điểm chạm soạn thảo theo thứ tự. Mô hình tư duy mà tác giả cần nắm: với bất kỳ giá trị nào thay đổi giữa Dev / Staging / Production, hãy chuẩn bị chạm vào Aggregate (khai báo), template values (tham chiếu), Release (đáp ứng) và template Recipe (tiêu thụ).
| Bước | Bề mặt | Hành động |
|---|---|---|
| 1 | Aggregate spec.parameters.<name> | Khai báo tham số như một phần của hợp đồng soạn thảo có kiểu của Aggregate. Mỗi slot tham số mang một type đã khai báo (string, integer, number, boolean, array, object), một description tùy chọn, một default tùy chọn, các ràng buộc không gian giá trị tùy chọn (enum, min, max, pattern, minLength, maxLength), và cấu trúc lồng tùy chọn cho các slot kiểu object. Hợp đồng xác thực từng giá trị do Release cung cấp trước khi nội suy. |
| 2 | Template values: của Component trong cùng Aggregate | Tham chiếu tham số qua {{ .parameters.<name> }} từ bên trong khối values: của bất kỳ component nào (hoặc feature, hoặc sub-aggregate) tiêu thụ nó. Tham chiếu là một biểu thức Go template — trình biên dịch đánh giá nó trong giai đoạn nội suy của quá trình phân giải. |
| 3 | Release spec.parameters.<name> (nội tuyến hoặc parameters: { $import: ./path.yaml }) | Đáp ứng tham số bằng giá trị riêng cho môi trường tại bề mặt Release. Các tệp Release cho từng môi trường cung cấp các giá trị khác nhau cho cùng một khóa tham số mà không cần sửa Aggregate. |
| 4 | Template valuesMapping: của Recipe | Tiêu thụ giá trị đã phân giải qua {{ .values.<key> }} — Recipe là một bề mặt value-template; ngữ cảnh template của nó không mang .parameters trực tiếp. Sự khác biệt giữa các môi trường tới Recipe thông qua từ điển values: sau nội suy mà giai đoạn nội suy ở trên ghi ra. (Path template trên ranh giới Release là ngoại lệ: chúng đọc .parameters.<slot> trực tiếp trong quá trình render theo quyền cấp bất đối xứng.) |
Bốn điểm chạm diễn ra tuần tự và đều thiết yếu: bỏ qua khai báo trong Aggregate khiến Release không có slot để đáp ứng; bỏ qua tham chiếu values khiến Recipe không có giá trị để tiêu thụ; bỏ qua việc đáp ứng trong Release khiến tham số trống. Trình biên dịch xác thực chuỗi này trong quá trình phân giải (xác thực hợp đồng tham số theo khai báo parameters: có kiểu, sau đó nội suy vào các chuỗi values: xung quanh, rồi xác thực JSON Schema cho từ điển values: thu được theo schema: của Component hoặc Feature); các sai lệch xuất hiện dưới dạng vi phạm hợp đồng tham số (bắt được theo khai báo parameters: có kiểu), lỗi template chưa được điền (bắt được khi nội suy), hoặc vi phạm ràng buộc JSON Schema theo schema values: (bắt được khi xác thực schema).
Mẫu này là cơ chế chuẩn cho việc thăng cấp GitOps: một Aggregate bất biến duy nhất đi qua các môi trường, trong đó Release của mỗi môi trường cung cấp các giá trị tham số riêng. Mọi giá trị theo môi trường mà tác giả muốn thay đổi đều thuộc về chuỗi tham số thay vì được nhúng trực tiếp vào Aggregate.
Ngữ nghĩa hợp nhất extends: theo từng trụ cột
Khi một thực thể catalog khai báo extends: và trình biên dịch duyệt chuỗi kế thừa, nội dung của mỗi trụ cột được hợp nhất theo các quy tắc riêng của trụ cột đó. Ngữ nghĩa khác nhau giữa các trụ cột; bảng dưới đây là tài liệu tham chiếu chuẩn theo từng trụ cột.
| Trụ cột | Hành vi hợp nhất trên chuỗi extends: |
|---|---|
values (JSON Schema 2020-12) | Trên một chuỗi Feature, các schema được kết hợp thông qua cơ chế kết hợp của JSON Schema 2020-12. Một Component mở rộng không viết nội dung trụ cột nào và nhận khối của base đúng như base đã viết, ở mọi độ sâu của chuỗi. |
infra (đoạn JSON Schema 2020-12) | Giống như values — được kết hợp trên một chuỗi Feature, được kế thừa nguyên vẹn bởi một Component mở rộng. |
provides (map template của Recipe) | Thay thế nông ở cấp cao nhất: khóa của con thay thế hoàn toàn khóa của cha có cùng tên; các khóa anh em được giữ lại từ cha. Các template không được kết hợp; template của con sở hữu hoàn toàn vị trí của nó. |
uses (usesSchema) | Phủ toàn bộ mục theo từng socket, theo tên socket. Một con thêm các socket mà base của nó không khai báo, và một socket mà nó khai báo lại dưới một tên đã có sẽ thay thế hoàn toàn mục đó — cả schema value và infra lẫn selector của nó. Các mục socket không được kết hợp, và không có gì so sánh selector được khai báo lại với selector của base. |
features (schema theo từng slot của featuresSchema) | Phủ toàn bộ mục theo từng slot, theo tên slot, với cùng điều kiện như usesSchema. Một con tự do thêm slot; một slot mà nó khai báo lại sẽ thay thế hoàn toàn mục của base thay vì kết hợp với nó. |
locals (map template của Recipe) | Thay thế nông ở cấp cao nhất — giống như provides. |
parameters (map gốc của Aggregate) | Aggregate không có trường extends:, nên không có chuỗi Aggregate nào hợp nhất tham số. Trên một chuỗi extends: của Release, một tham số có giá trị map được hợp nhất sâu với khóa của con được ưu tiên, một tham số có giá trị vô hướng bị con thay thế, và một khóa mà con viết là null sẽ bị xóa. |
Khuôn mẫu chung phụ thuộc vào loại và vào bề mặt. Các trụ cột được kiểm tra bằng schema của một Feature được kết hợp theo JSON Schema 2020-12. Các trụ cột của một Component mở rộng được kế thừa nguyên vẹn — nó không viết trụ cột nào, nên hợp đồng của nó chính xác là của base, và do đó một ràng buộc của base không thể được nới lỏng, theo cấu trúc. Các bề mặt có hình dạng cố định — usesSchema và featuresSchema — phủ theo tên trên cả hai loại: một con thêm mục, và một mục nó khai báo lại sẽ thay thế hoàn toàn mục của base. Các trụ cột được viết bằng template dùng thay thế nông theo từng khóa, trao cho con toàn quyền sở hữu mọi slot template mà nó khai báo.
Một Component mở rộng siết chặt một ràng buộc thông qua assertions: thay vì thông qua một trụ cột — một vị từ mà nó thêm vào, được đánh giá cùng với các vị từ nó kế thừa. Xem inheritance-and-interface.md để biết về cơ chế đó.
Về chính cơ chế kế thừa, xem inheritance-and-interface.md “Inheritance via extends”, phần này đề cập các loại catalog. Một Release không phải là thực thể catalog và được gộp theo quy tắc riêng; quy tắc đó nằm trong entities/release.md “Composite Release and extends: inheritance”.
Cơ chế liên trụ cột
Cách tiếp cận bằng biển chỉ dẫn cho phép đọc liên trụ cột ở mọi nơi, trừ các bề mặt tự chứa đã được ghi lại trong tài liệu. Các mẫu hình dưới đây chính thức hóa các cơ chế liên trụ cột phổ biến; một dấu hiệu soạn thảo đáng ngờ cũng được ghi lại để tác giả nhận ra sự đánh đổi.
Dẫn dữ liệu liên trụ cột qua cầu nối schema — có biển chỉ dẫn, không có tường chắn
Ranh giới giữa các trụ cột là kỷ luật soạn thảo: kiến trúc chỉ dẫn thứ gì đặt ở đâu (values: cho ý định nhận thức của nhà phát triển, infra: cho định cỡ vật lý của Ops, provides: cho các chuỗi do Recipe phát ra, v.v.) và người duyệt catalog thực thi quy ước. Bản thân bộ máy template cho phép đọc liên trụ cột trừ khi các quy tắc tự chứa đã được ghi lại cấm điều đó (provides: của Recipe không thấy .context.inject; provides: phạm vi ranh giới của FeatureRecipe không thấy các trường theo từng bên tiêu thụ). Các bức tường trụ cột là biển chỉ dẫn, không phải sự cưỡng chế.
Một ngoại lệ có biển chỉ dẫn điển hình: schema: của một Component có thể khai báo một nút điều chỉnh values: hướng tới nhà phát triển mà template valuesMapping: của Recipe dẫn vào đầu ra được kết xuất có dạng infra:. Nhà phát triển quyết định ý định thông qua một trường values: có kiểu; template của Recipe dẫn giá trị thu được vào tầng hạ tầng của provider mà nhà phát triển không cần viết mã hạ tầng. Một ví dụ minh họa:
# Component schema declares a developer-facing dial in valuesspec: schema: values: required_iops: { type: integer, min: 100 }# Recipe valuesMapping pipes the developer's intent into the provider's infra-side knobvaluesMapping: iops_limit: "{{ .values.required_iops }}"Cầu nối được mô tả tại inheritance-and-interface.md kèm các ví dụ minh họa. Ý định kiến trúc (một nút điều chỉnh liên trụ cột được khai báo mà Recipe dẫn qua) đi theo một chiều — values: phía nhà phát triển chảy vào đầu ra được kết xuất phía Ops — và nằm trong các template ánh xạ của Recipe, không nằm trong chính schema của Component. Ranh giới trụ cột vẫn chỉ là biển chỉ dẫn: nhà phát triển thấy values:, Recipe thấy cả values: lẫn infra:, đầu ra được kết xuất kết hợp chúng.
Bộ tích lũy inject liên trụ cột
Đường dẫn .context.inject là điểm hợp nhất của ba nguồn trải qua nhiều trụ cột:
- Tự inject cấp Component (
component.inject) — lấy chuỗi từvaluesvàprovidescủa chính component. - Uses-inject (
uses[].inject) — lấy chuỗi từprovidescủa đích. - Các can thiệp
injectMapping:của FeatureRecipe — lấy chuỗi từ bất kỳ nguồn nào ở trên cộng với payloadinfra:của chính FeatureRecipe.
Khi kết xuất cơ sở chạy, .context.inject.<mechanism>.<key> đã tích lũy các mục từ cả ba nguồn. Bộ tích lũy mang tính liên trụ cột theo cấu trúc — các mục bắt nguồn từ values, provides và infra đều chảy vào cùng một map .context.inject. Các Recipes tiêu thụ .context.inject thấy trạng thái sau hợp nhất mà không cần biết trụ cột nào đã đóng góp mục nào.
Về ngữ pháp inject và các quy tắc xung đột, xem topology-triad.md.
Trùng lặp ràng buộc liên trụ cột
Một trường nằm ở hai trụ cột với các tầng kiểm tra khác nhau có thể mang ràng buộc trùng lặp. Ví dụ điển hình: một số cổng được khai báo trong usesSchema của một Component (kiểm tra bằng JSON Schema, phạm vi min: 1, max: 65535) và cùng số cổng đó được tiêu thụ trong trường services.<name>.ports.<port> của một Workload, mà spec.provider.workloadSchema của plugin kết xuất provider có thể thêm quy tắc min: 1024 cho các cổng không đặc quyền. spec.provider.workloadSchema của một Plugin kết xuất provider mô tả cách provider chuyển đổi một Workload và đánh dấu provider là có khả năng tổng hợp Workload; nó không kiểm tra gì cả. Mọi thân Workload đều được kiểm tra theo schema Workload của nền tảng, bất kể provider nào, nên một ràng buộc chỉ được viết trong workloadSchema — chẳng hạn quy tắc cổng min: 1024 — sẽ không được thực thi; để từ chối một giá trị như vậy, hãy đặt ràng buộc trong schema của Component hoặc trong một assertion.
Gắn Feature / cô lập trụ cột của Component
Việc gắn một Feature không ghi vào các trụ cột của Component cha. Mỗi Feature được gắn mang payload trụ cột riêng (khối values: riêng và khối infra: riêng). FeatureRecipe tổng hợp tài nguyên của Feature đọc payload trụ cột riêng của nó, độc lập với payload của Component. Sự cô lập là ở đầu vào: những gì một lần gắn đọc là của riêng nó, bất kể những gì nó ghi ra sẽ ra sao. Khi provider của đích ghi các tài liệu riêng rẽ, đầu ra được kết xuất của lần gắn nằm cạnh đầu ra của Component trong một thư mục riêng; khi provider gộp các bên đóng góp của một ranh giới vào một tài liệu, lần gắn đóng góp vào tài liệu đó như Component, và mỗi tài nguyên vẫn mang danh tính riêng của lần gắn để vẫn đọc được thứ gì đến từ đâu.
Hai hệ quả cho tác giả:
- Một thiết lập
values:trên một lần gắn Feature không xuất hiện trong.valuescủa templatevaluesMapping:của Component. Component chỉ thấy values của chính nó. - Payload
infra:của một Feature không chảy vàoinfra:của Component. Mỗi Feature được gắn có định cỡ vật lý riêng, giới hạn trong tài nguyên của Feature.
Sự cô lập là tường minh theo nguyên tắc phân tách mối quan tâm của kiến trúc: Features là các bên đóng góp độc lập được xếp lớp lên Components thông qua Mô hình Củ hành 5 tầng. Về các bề mặt gắn và thứ tự, xem labels-and-annotations.md “Feature attachment — five surfaces”.
Cùng tên thuộc tính ở cả hai trụ cột
Một Component hoặc Feature mà spec.schema.values: và spec.schema.infra: khai báo cùng một tên thuộc tính — ở gốc, ở bất kỳ độ sâu lồng nào, hoặc cả hai — là một dấu hiệu soạn thảo không tốt thường gặp. Hai trụ cột là các không gian tên riêng biệt theo thiết kế (trình biên dịch chấp nhận sự chồng lấn), nên schema vẫn hợp lệ và đầu ra được kết xuất vẫn đúng dạng. Vấn đề nằm ở nhận thức: người đọc và tác giả template vấp phải câu hỏi “trụ cột nào chứa foo mà tôi đang đọc?” mỗi lần họ xem schema hoặc viết template dựa trên nó.
# Smell — both pillars declare `mode`. A reader of the schema or a# template against the Feature has to disambiguate every reference.spec: schema: values: mode: { type: string } infra: mode: { type: string }Tác giả có sự chồng lấn cố ý có lý do thực sự để giữ cả hai — ví dụ, một mode mang nghĩa “chế độ vận hành ứng dụng” trong values ("debug" / "production") và “chế độ topo triển khai” trong infra ("standalone" / "clustered") mang ngữ nghĩa khác nhau và tên chỉ tình cờ trùng nhau. Tác giả có sự chồng lấn vô tình (trường hợp phổ biến hơn) đổi tên một mục.
Dạng cố ý thứ hai là một dữ liệu mà một trong hai bên tác giả có thể cung cấp. Các Features thông tin xác thực của thư viện chuẩn mang locator của bên gọi — core/referenced-secret, core/referenced-secret-set, core/secret-value và core/secret-provided — khai báo nó ở cả hai trụ cột dưới cùng một tên và cùng một dạng, để nhà phát triển ghi nó trong values hoặc người vận hành ghi trong infra, và assertion riêng của mỗi Feature từ chối lần gắn ghi nó ở cả hai hoặc không ở đâu cả. Cảnh báo bên dưới nêu tên bốn Features đó ở mọi lần tải chạm đến chúng; với chúng, nó báo cáo hợp đồng, không phải một sơ suất.
Quá trình tải catalog phát ra cảnh báo notice: LINT: <kind> "<name>" at <path> declares property "<property>" in both values: and infra: pillars (path: <dotted-path>) cho mọi thuộc tính cùng tên mà sự chồng lấn dẫn tới một nút lá cuối ở ít nhất một phía. Các thuộc tính cùng tên tồn tại như không gian tên tổ chức dùng chung (cả hai trụ cột đều có một đối tượng tên ingress với các thuộc tính con không giao nhau) không gây cảnh báo; chỉ sự chồng lấn ở nút lá được báo cáo. Cảnh báo chỉ mang tính khuyến nghị — quá trình build vẫn tiếp tục.
Các tầng xác thực pillar
Các pillar mang việc xác thực qua ba tầng. Mỗi tầng đảm nhận một mối quan tâm khác nhau; cùng một trường có thể được xác thực bởi nhiều hơn một tầng (xem “Trùng lặp ràng buộc giữa các pillar” ở trên).
| Tầng | Nội dung xác thực | Nơi chạy |
|---|---|---|
| 1 — Lớp bao JSON Schema | Hình dạng cấu trúc (những khóa nào có mặt, kiểu có khớp với khai báo trường hay không) | Giai đoạn phân giải, mỗi lần tải tệp |
2 — Schema theo từng pillar (schema / featuresSchema / usesSchema) | Nội dung có kiểu của từng pillar, được xác thực theo JSON Schema 2020-12 | Giai đoạn phân giải, sau khi lớp bao đạt |
| 3 — Cổng kiểm tra khả năng của provider | Nội dung Workload được kiểm soát bởi khả năng chế độ tổng hợp của provider được gắn, được mô tả bởi spec.provider.workloadSchema của plugin kết xuất provider | Kết xuất cơ sở, sau khi valuesMapping được phân giải |
Về bảng hình dạng lỗi bốn lớp và các tiền tố lỗi theo từng lớp, xem validation-surface.md.
Các cơ chế giá trị mặc định
Giá trị mặc định xuất hiện trong toàn bộ tài liệu qua nhiều cơ chế riêng biệt. Tác giả gặp từ “default” trong hơn năm ngữ cảnh; bảng dưới đây là tài liệu tham chiếu chuẩn cho biết cơ chế nào tạo ra giá trị khi tác giả để trống một trường.
| # | Cơ chế | Nơi viết | Điều kiện kích hoạt |
|---|---|---|---|
| 1 | JSON Schema default: (dạng rút gọn { default: <value> }) | Component / Feature schema:, Aggregate parameters: | Trường được kiểm tra hợp lệ với giá trị mặc định khi nhà phát triển bỏ qua khóa. Với các tham số của Aggregate, bước hợp nhất tham số điền giá trị mặc định đã khai báo trước khi kiểm tra hợp lệ theo hợp đồng chạy (xem templates/parameters-context.md). |
| 2 | Go template optional .X `Y` <fallback> | Recipe valuesMapping:, phần thân Workload, các template của FeatureRecipe, bộ đánh giá assertion | Giá trị dự phòng có nhận biết sự hiện diện — chỉ trả về <fallback> khi khóa không có trong map; một giá trị zero / rỗng / false được tác giả viết tại khóa sẽ trả về chính giá trị đó. Đây là dạng dự phòng cho trường vắng mặt chuẩn phía Aggrega. Xem templates/sprig-functions.md. |
| 3 | Go template | default <expr> | Recipe valuesMapping:, phần thân Workload, các template của FeatureRecipe | Pipeline nội tuyến kích hoạt khi giá trị “rỗng” (phép kiểm tra rỗng của Sprig — zero, chuỗi rỗng, false, nil). Nó gộp chung trường hợp vắng mặt trong map với trường hợp có mặt nhưng là zero/rỗng/false. Phù hợp với ngữ nghĩa ghi đè theo từng vị trí gọi (giá trị dự phòng của binding khác với giá trị mặc định ở cấp schema của trường) khi việc gộp chung này chấp nhận được. Không phù hợp cho dự phòng trường vắng mặt khi zero / rỗng / false do tác giả viết là một ý định hợp lệ — hãy dùng optional (cơ chế 2) cho trường hợp đó. |
| 4 | Hàm default của Sprig ({{ default <expr> .field }}) | Giống như 3 | Dạng hàm của cơ chế 3, với cùng cách gộp chung giá trị rỗng. |
| 5 | Giá trị dự phòng trong Recipe locals: | Template Recipe locals: | Một mục locals tính ra một chuỗi mang giá trị mặc định mà phần còn lại của Recipe sử dụng |
Hướng dẫn vị trí đặt được khuyến nghị. Khi một giá trị mặc định thực sự là một phần của hợp đồng kiểu (ví dụ: “cổng này mặc định là 5432 trừ khi nhà phát triển ghi đè”), JSON Schema default: (cơ chế 1) là cách chuẩn — tính năng tự hoàn thành của IDE hiển thị giá trị mặc định; công cụ kiểm tra hợp lệ tuân theo nó; hợp đồng đi kèm với thực thể catalog Component / Feature HOẶC với khai báo tham số của Aggregate. Khi một template của Recipe cần giá trị dự phòng cho một khóa map tùy chọn, helper optional (cơ chế 2) là dạng dự phòng cho trường vắng mặt chuẩn — nó phân biệt zero / rỗng / false do tác giả viết với sự vắng mặt. | default của Go template (cơ chế 3) dành riêng cho trường hợp ghi đè theo từng vị trí gọi, khi việc gộp chung giá trị vắng mặt và giá trị falsy chấp nhận được; chỉ dùng nó khi ngữ nghĩa ghi đè là ý định rõ ràng.
Tham chiếu chéo
inheritance-and-interface.md— cơ chếextends:, Interface Bindingimplements:, truyền dữ liệu liên trụ cột qua cầu nối schema.topology-triad.md— cơ chế tô-pô củaprovides,inject,uses.labels-and-annotations.md— từ vựng siêu dữ liệu phía nội dung, tách biệt với các trụ cột dữ liệu (danh sách trụ cột chuẩn ở trên không bao gồm labels / annotations / các trường xuất bản — đó là từ vựng siêu dữ liệu).publishing-surface.md— từ vựng siêu dữ liệu phía xuất bản, tách biệt với các trụ cột dữ liệu.validation-surface.md— bốn lớp xác thực schema, bao gồm ba tầng xác thực trụ cột ở trên.templates/expansion-matrix.md— khả năng sử dụng theo từng vị trí template cho việc đọc liên trụ cột + các quy tắc tự chứa tạiprovides:vàsource:của Recipe.examples/04-secrets.md— danh sách kiểm tra phân phối bí mật gồm sáu điểm chạm.architecture/06-data-taxonomy-and-composition.md— khung khái niệm chuẩn cho năm từ khóa cấu trúc của DSL.