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.

Kết hợp đầu ra

Một lần build Aggrega duy nhất tạo ra các tệp đầu ra vào các thư mục theo từng ranh giới dưới dist/ thông qua sáu cơ chế riêng biệt — kết xuất từ nguồn, tổng hợp workload, FeatureRecipe Resource Generation, các bản vá pipeline plugin của FeatureRecipe, kết hợp ở cấp Release, và phát xuất artifact trực tiếp. Các cơ chế chạy theo một thứ tự xác định; các đầu ra xung đột một cách tất định khi hai cơ chế tạo ra một tệp cùng tên trong cùng một thư mục ranh giới; khi phát hiện xung đột, quá trình build dừng lại trước khi phát xuất, nêu tên mọi bên đóng góp, với loại lỗi mà quy tắc xung đột tương ứng chỉ định.

Trang này mô tả sáu cơ chế tại một chỗ và nêu thứ tự kết xuất giữa chúng. Các tài liệu tham khảo theo từng chương và từng thực thể trình bày phạm vi riêng của chúng; các quy tắc phát hiện xung đột trên cả sáu cơ chế nằm ở đây.

Sáu cơ chế tạo đầu ra

Mỗi cơ chế nằm ở một bề mặt soạn thảo Recipe / FeatureRecipe cụ thể và tạo ra các tệp theo các quy ước đặt tên cụ thể. Các cơ chế cộng dồn theo từng nút — một instance component duy nhất có thể điều khiển nhiều cơ chế cùng lúc (một Recipe cơ sở dạng sourced + một tệp đi kèm được tổng hợp từ Workload + một CRD ExternalSecret do FeatureRecipe phát ra + một bản vá plugin-pipeline được áp dụng cho Deployment đã tổng hợp).

1 — Kết xuất sourced của Recipe (source: + valuesMapping:)

Bề mặt soạn thảo. Recipe khai báo source: <path> cùng với valuesMapping: (trường này chấp nhận Go template nội tuyến, $import: từ tệp, hoặc $import: từ thư viện tới một mục MappingLibrary — xem entities/recipe.md “Trường valuesMapping — ba chế độ soạn thảo”). Source trỏ tới một Helm chart trên đĩa, một tệp YAML docker-compose, hoặc một artefact gốc khác của provider.

Vị trí trong pipeline. Kết xuất cơ sở, sau khi locals và provides của Recipe được phân giải.

Hình dạng đầu ra. Tùy theo từng Provider:

  • helm provider — các tệp YAML Kubernetes phẳng, được đặt tên theo định danh của component rồi theo chính tài nguyên: <component-id>-<kind>[-<namespace>]-<name>.yaml, còn một tài liệu không có kind hoặc không có name thì được đặt tên theo đường dẫn template của nó. Tên lấy từ tài nguyên chứ không từ template, nên hai template ở hai thư mục con khác nhau có cùng tên tệp vẫn là hai tệp. Helm SDK kết xuất chart với các giá trị đã hợp nhất; Aggrega chèn các label và annotation nguồn gốc sau khi kết xuất.
  • helm-chart provider — các tệp sub-chart được sao chép vào charts/<instance_id>/, giữ nguyên văn trừ name của chính chart, được umbrella đặt thành định danh đã mã hóa của instance để hai component vendor các chart khai báo cùng một tên vẫn phân biệt được (xem providers/helm-chart.md); Chart.yaml + values.yaml umbrella theo từng boundary được phát ra bên cạnh.
  • compose provider — các tệp trung gian <nodeID>.compose-fragment.yaml chảy vào bước kết hợp cấp Release (cơ chế 5).

2 — Tổng hợp Workload của Recipe (workload:)

Bề mặt soạn thảo. Recipe khai báo workload: mang một tài liệu Workload. Trường này chấp nhận nội dung nội tuyến (block scalar) hoặc $import: (đường dẫn tệp).

Vị trí trong pipeline. Kết xuất cơ sở, sau khi valuesMapping của Recipe được phân giải (bản thân phần thân Workload là một chuỗi Go template được đánh giá với ngữ cảnh template đầy đủ).

Hình dạng đầu ra. Tùy theo từng Provider:

  • helm provider — một đối tượng controller được chọn theo form của Workload (Deployment cho stateless, StatefulSet cho stateful, DaemonSet cho daemon, Job cho task, CronJob cho scheduled) + một Service cho mỗi service + một PVC cho mỗi volume persistent. Hai dạng đặt tên, và chúng không giống nhau: đối tượng controller được đặt tên theo release name của nút và kind của nó — <release name>-deployment.yaml, <release name>-statefulset.yaml, <release name>-daemonset.yaml, <release name>-job.yaml, <release name>-cronjob.yaml — còn một tệp theo từng tài nguyên được đặt tên theo tài nguyên mà nó mang, với kind ở cuối: <release name>-<svcName>-service.yaml và <release name>-<volName>-pvc.yaml, vì mỗi tệp được đặt tên từ metadata.name của chính tài nguyên đó. Release name là định danh của nút được viết bằng bảng chữ cái mà một tên Kubernetes chấp nhận, nên nó bằng ID của nút ở mọi chỗ ID đó không chứa dấu gạch dưới và chữ hoa: nút my_api ghi ra my-zuapi-deployment.yaml (xem entities/workload.md “Synthesized-name convention”). Một Workload mà phơi bày duy nhất là một external name thì phát ra <release name>-service.yaml thay vào đó, vì không có khóa service nào để mang.
  • compose provider — các tệp trung gian <nodeID>.compose-fragment.yaml chảy vào bước kết hợp cấp Release.
  • helm-chart provider — không được hỗ trợ; vai trò của helm-chart chỉ là kết hợp chart ở chế độ sourced. Một Recipe nhắm tới helm-chart với workload: bị từ chối khi kết xuất (helm-chart provider báo không có khả năng tổng hợp).

3 — Resource Generation của FeatureRecipe (chế độ sourced cho FeatureRecipes)

Bề mặt soạn thảo. FeatureRecipe khai báo source: cùng với valuesMapping: (hoặc tương đương), cùng mẫu với kết xuất sourced của Recipe nhưng dành cho các attachment Feature thay vì các Components chính.

Vị trí trong pipeline. Kết xuất cơ sở, song song với kết xuất Recipe cơ sở cho Component cha. Mỗi attachment Feature chạy lượt kết xuất FeatureRecipe riêng của nó.

Dạng đầu ra. Do provider của Component cha quyết định, vì đầu ra của attachment gia nhập nhóm lắp ráp của Component đó chứ không phải một nhóm riêng — và nó suy ra từ cách provider đó kết hợp nhóm, vì chính điều đó cho biết có chỗ nào để đặt một attachment hay không. Ba dạng, mỗi dạng ứng với một cách kết hợp:

  • Một provider cấp cho mỗi bên đóng góp một vị trí riêng — một chart chứa một chart cho mỗi bên đóng góp, một cấu hình gốc chứa một module cho mỗi bên đóng góp — cũng cấp cho attachment một vị trí riêng, bên cạnh component mà nó gắn vào chứ không nằm bên trong. Hai tọa độ tạo nên phân đoạn thư mục duy nhất của vị trí đó, <component-id>--<feature-instance-id>, nên một component api mang attachment aux nằm tại api--aux bên cạnh api, dưới thư mục nào mà provider đó đặt cho các bên đóng góp. Bên cạnh chứ không bên trong, vì target của provider như vậy phát hiện các bên đóng góp tại các vị trí nó đã cấp: một thư mục thấp hơn một cấp dưới một trong các vị trí đó là nội dung thuộc về bên đóng góp đó chứ không phải một bên đóng góp riêng, nên không gì định địa chỉ tới và không gì đọc nó. Một attachment khai báo trên boundary không có component chủ để đặt tên, nên phân đoạn của nó chỉ là tên instance. Mỗi tọa độ được mã hóa trước khi ghép, nên một tọa độ tự chứa chuỗi ghép không thể bị nhầm với chỗ ghép.
  • Một provider ghi mỗi tài liệu trực tiếp tại thư mục boundary thì không có chỗ như vậy, vì đó chính là điều nó khai báo về target của mình: chỉ các tệp nằm trực tiếp trong một thư mục mới được đọc. Vì vậy hai tọa độ đó chuyển từ phân đoạn thư mục sang tên tệp, và các tệp của attachment nằm bên cạnh tệp của chính component dưới dạng <component-id>--<feature-instance-id>--<file>. Hai tọa độ được mã hóa, vì tên tệp không có dấu phân cách nào để dựa vào, và chúng được ghép với tên riêng của tệp tại một ranh giới hai ký tự mà không tọa độ đã mã hóa nào có thể chứa — đó là điều giữ cho hai attachment phát ra cùng một tên tệp thành hai tệp riêng biệt.
  • Một provider gộp các bên đóng góp của nhóm vào một tài liệu cũng gộp đầu ra của attachment vào tài liệu đó, trong đó mỗi tài nguyên mang định danh riêng của attachment để vẫn đọc được cái gì đến từ đâu. Khi provider như vậy mang một attachment đã kết xuất cho một target khác, nội dung đó không thể gộp vào một tài liệu mà nó không thuộc về, nên nó được ghi bên cạnh tài liệu đã lắp ráp — theo dạng tiền tố tên tệp ở trên, vì cùng lý do.

Các dạng thường gặp:

  • Một CRD ExternalSecret / VaultSecret được tạo bởi Fetcher của một FeatureRecipe thông tin xác thực.
  • Một CRD ServiceMonitor / PrometheusRule được tạo bởi một Feature quan sát.
  • Một CRD HTTPRoute / Gateway được tạo bởi một Feature định tuyến.

4 — Pipeline plugin của FeatureRecipe (bản vá RFC 6902 + phát sinh tài nguyên)

Bề mặt soạn thảo. FeatureRecipe khai báo pipeline: — một mảng các bước plugin Wasm (Nguyên tắc Plugin hai phần: Fetcher + Injector cho các Features thông tin xác thực; pipeline plugin tùy ý cho các Features không liên quan đến thông tin xác thực).

Vị trí trong pipeline. Pipeline plugin, sau khi kết xuất cơ sở và kết xuất có nguồn của FeatureRecipe hoàn tất.

Hình dạng đầu ra. Phụ thuộc vào Plugin cụ thể. Một bước trả về hai lớp đầu ra:

  • Bản vá RFC 6902 mà công cụ áp dụng áp lên các tài liệu được nhắm tới trong tập đã kết xuất (ví dụ: thêm một container sidecar, gắn một volume secret, viết lại một biến môi trường trên Deployment được tổng hợp).
  • Tác dụng phụ — các tài nguyên mới hoàn chỉnh được phát sinh cùng với bản vá thông qua side_effects của một bước (thường là CRD vault-fetch của Fetcher mà Injector sau đó tham chiếu).

Trạng thái hiện tại: khả dụng theo Trạng thái của ngôn ngữ → Các giai đoạn của pipeline biên dịch. Mỗi bước được khai báo chạy trong aggrega build: host điều phối plugin Wasm của bước đó trên tập đã kết xuất, áp dụng các bản vá được trả về và phát sinh các tác dụng phụ của bước. Xem plugins/plugin-contract.md để biết bề mặt hợp đồng plugin.

5 — Kết hợp ở cấp Release (lắp ráp ranh giới theo từng provider)

Bề mặt soạn thảo. Được điều khiển bởi hình dạng của Release — không có soạn thảo theo từng Recipe. Một capability lắp ráp một ranh giới sẽ làm việc đó một lần, sau khi mọi nút trong ranh giới đó đã kết xuất: capability compose gom tất cả các mảnh theo từng nút vào một docker-compose.yaml cho mỗi ranh giới, và capability helm-chart gom các bản sao sub-chart theo từng nút vào một umbrella chart cho mỗi ranh giới.

Vị trí trong pipeline. Sau khi kết xuất cơ sở, khi đầu ra theo từng Recipe của mọi nút đã được tích lũy cho ranh giới.

Dạng đầu ra. Theo từng provider:

  • compose provider — một docker-compose.yaml tại gốc ranh giới, tổng hợp services, volumes và networks của mọi nút đóng góp. Các tệp trung gian <nodeID>.compose-fragment.yaml (cơ chế 1 + 2) được hợp nhất vào đầu ra duy nhất; các mảnh này không xuất hiện trong thư mục ranh giới cuối cùng.
  • helm-chart provider — một umbrella Chart.yaml + values.yaml tại gốc ranh giới, cùng với các thư mục sub-chart theo từng nút dưới charts/<instance_id>/.

6 — Phát sinh artifact trực tiếp từ Recipe (artifacts:)

Bề mặt soạn thảo. Recipe khai báo artifacts: dưới dạng một map các mục có tên; mỗi mục là nội dung nội tuyến (một chuỗi template mang nội dung tệp) hoặc một tham chiếu $import: tới đường dẫn tệp template — phát sinh tệp trực tiếp mà không đi qua provider.

Vị trí trong pipeline. Đánh giá artifact, trong kết xuất cơ sở.

Dạng đầu ra. Một tệp cho mỗi mục artifact, được đặt tên theo khóa của mục trong map artifacts:. Tác giả Recipe trực tiếp quyết định tên tệp và nội dung.

Trạng thái hiện tại: khả dụng theo Trạng thái của ngôn ngữ → Các loại đầu vào của Recipe. Mỗi mục được đánh giá với toàn bộ ngữ cảnh template sau khi tổng hợp workload và phân giải nguồn, và tệp kết quả được phát sinh dưới khóa của mục. Việc một target làm gì với artifact được phát sinh phụ thuộc vào capability: một provider chấp nhận artifact độc lập sẽ phát sinh nó thành tệp riêng, trong khi provider chỉ chấp nhận artifact đi kèm một loại đầu vào khác sẽ gộp mục đó vào những gì nó lắp ráp — vì vậy một nội dung không đúng hình dạng mà bộ lắp ráp đó mong đợi sẽ dừng lại với loại lỗi TRANSLATION_ERROR thay vì được phát sinh nguyên văn. Hãy kiểm tra bảng theo từng capability tại architecture/16-recipe-input-composition.md trước khi soạn một artifact cho một capability.

Thứ tự kết xuất

Sáu cơ chế chạy theo một thứ tự xác định để các cơ chế phía sau có thể đọc đầu ra của các cơ chế phía trước. Thứ tự như sau:

  1. Đánh giá provides — với mỗi nút, khối locals: của Recipe được phân giải trước tiên, theo thứ tự tác giả viết, mỗi mục đọc các mục phía trên nó; sau đó các template provides: của nút được đánh giá, theo thứ tự bất kỳ giữa chúng với nhau (tự chứa: .context.instance_id, .context.rendered_name khi provider của nút báo cáo giá trị này, .values, .infra, .locals đã phân giải, văn bản tĩnh). Chính thứ tự locals trước provides cho phép một mục provides: đọc một local và nhận được một giá trị đã phân giải.
  2. Công bố locals và phân giải source — các locals đó được công bố lên .locals, và template URI source: của Recipe được đánh giá dựa trên chúng (phân giải con trỏ source nếu được tạo bằng template). Bề mặt source dùng chung ngữ cảnh locals, nên nó đọc .locals chứ không đọc .provides.
  3. Inject mapping — các khối injectMapping: của FeatureRecipe được đánh giá (pipe inject được chặn lại trước khi kết xuất Recipe).
  4. Values mapping — valuesMapping: của Recipe được đánh giá (chế độ sourced và chế độ sourceless tạo ra các từ điển values).
  5. Tổng hợp Workload — tổng hợp Workload của Recipe (cơ chế 2 phát sinh manifest cho chế độ synthesized).
  6. Đánh giá artifact — đánh giá artifacts: của Recipe (cơ chế 6).
  7. Provider render — provider thực hiện kết xuất (cơ chế 1 — chế độ có nguồn tạo ra các manifest phẳng; chế độ không nguồn tạo ra các manifest sinh).
  8. Kết xuất Feature — kết xuất FeatureRecipe cho mọi gắn kết Feature trên nút (cơ chế 3 + 4 — Resource Generation chạy ở đây; plugin pipeline chạy sau, ở bước 9).
  9. Plugin pipeline — biến đổi sau kết xuất: các bước plugin pipeline: của FeatureRecipe áp dụng các bản vá RFC 6902 và phát sinh thêm tài nguyên (cơ chế 4).
  10. Kết hợp cấp Release — phần lắp ráp ranh giới của capability gom các phân đoạn theo từng nút thành đầu ra theo từng ranh giới (cơ chế 5).

Thứ tự này quan trọng vì các cơ chế phía sau có thể đọc đầu ra của các cơ chế phía trước — ví dụ, một bước plugin pipeline có thể vá một Deployment do provider kết xuất, và một bộ kết hợp cấp Release có thể hợp nhất các phân đoạn được phát sinh bởi bước kết xuất provider, bởi bước kết xuất feature và bởi plugin pipeline.

Bộ quy tắc phát hiện xung đột

Khi hai cơ chế tạo ra một tệp có cùng tên trong cùng một thư mục boundary, bản dựng dừng lại, nêu tên mọi bên đóng góp, thuộc danh mục mà từng quy tắc dưới đây chỉ định. Bộ quy tắc:

Quy tắc hình dạng Recipe: xung đột khóa mục artifacts:

Một Recipe khai báo hai mục dưới artifacts: có cùng khóa (khóa quyết định tên tệp được phát ra, dù phần thân của mục được viết trực tiếp hay được nạp qua $import:). Được phát hiện lúc nạp Recipe theo errors/fatal-halts.md “artifacts: entry keys must be unique (các khóa mục phải là duy nhất)”.

Quy tắc hình dạng Recipe: xung đột lúc phát ra giữa các loại đầu vào

Ba loại đầu vào của một Recipe — sourced, synthesized và artifacts — đều phát tệp vào cùng một thư mục boundary. Nếu đầu ra được render từ source, được tổng hợp từ workload hoặc được phát ra từ artifact tạo ra một tệp có tên mà một loại đầu vào khác cũng đã tạo, bản dựng dừng lại lúc phát ra. Được phát hiện lúc phát ra theo errors/fatal-halts.md “Emission-time filename collision across input kinds (Xung đột tên tệp lúc phát ra giữa các loại đầu vào)”.

Xung đột tên service của compose (cấp Release)

Khi hai node khác nhau (trong bất kỳ tổ hợp boundary nào) đóng góp các service có cùng tên vào đầu ra compose đã hợp nhất, compose provider dừng lại khi nó hợp thành boundary, thuộc danh mục TRANSLATION_ERROR, nêu tên mọi bộ (boundary, node, serviceName) đóng góp. Được phát hiện ở bước hợp thành cấp Release theo mục đầu ra cấp Release của providers/compose.md.

Một service bị từ chối chỉ dựa trên tên, không so sánh những gì hai node đã khai báo. Một service compose là một container đang chạy duy nhất, nên hai node mà mỗi node đều muốn một service sẽ chỉ nhận được một service chung, và ý định của một bên đóng góp bị mất dù hai định nghĩa có giống hệt nhau đến đâu.

Xung đột tên volume và tên config của compose (cấp Release)

Khi hai node khác nhau đóng góp một mục volumes: hoặc configs: cấp cao nhất có cùng tên vào đầu ra compose đã hợp nhất, và hai khai báo khác nhau, compose provider dừng lại thuộc danh mục TRANSLATION_ERROR, nêu tên mục đó và mọi bộ (boundary, node) đóng góp. Được phát hiện ở bước hợp thành cấp Release theo mục đầu ra cấp Release của providers/compose.md.

Khác với quy tắc service ở trên, quy tắc này so sánh các khai báo, và một tên dùng chung là hợp lệ khi các bên đóng góp thống nhất. Một volume hoặc config có tên là một đối tượng duy nhất, nên hai node khai báo nó giống hệt nhau đều đã yêu cầu đúng mục mà tài liệu hợp nhất cuối cùng có, và không có gì bị mất. Hai node khai báo nó khác nhau là bất đồng về chính đối tượng đó, và giữ lại một trong hai khai báo sẽ loại bỏ khai báo kia khỏi một bản dựng lẽ ra đã thành công. Hai khai báo được coi là thống nhất khi chúng mô tả cùng một mục trong tệp đã lắp ráp, nên một phần thân viết là mapping rỗng và một phần thân bị bỏ hẳn là thống nhất.

Alias và thư mục của sub-chart helm-chart

Một sub-chart helm-chart nằm tại charts/<instance_id>/ và các giá trị của nó được đặt trong phạm vi alias của nó, tức là instance ID được mã hóa cho vị trí alias. Hai instance không thể có cùng một alias trừ khi instance ID của chúng là cùng một chuỗi, vì phép mã hóa viết ra các ký tự mà alias không chấp nhận thay vì thay thế chúng — nên một alias xác định đúng một sub-chart, và các giá trị được ghi dưới nó chỉ đến sub-chart đó. Đến lượt mình, các instance ID là duy nhất trong mỗi boundary theo các quy tắc làm phẳng Aggregate, nên thư mục cũng không thể xung đột. Cả hai nửa đều mang tính cấu trúc: không nửa nào dựa vào một phép kiểm tra.

Xung đột tên tài nguyên được render của Helm

Trong một boundary, hai node render ra cùng một tên tài nguyên Kubernetes sẽ tạo ra hai tệp YAML có các trường metadata.name trùng nhau. Tên tệp khác nhau, vì mỗi tệp được thêm tiền tố là cơ sở đặt tên riêng của nó, trong khi metadata.name bên trong chúng vẫn có thể trùng — nên bản dựng kiểm tra các tên mà tài nguyên được render mang theo, và hai bên đóng góp suy ra cùng một tên cho cùng một kind trong cùng một namespace sẽ làm bản dựng dừng lại thuộc danh mục TRANSLATION_ERROR trước khi bất cứ thứ gì được ghi ra, nêu tên đó cùng từng component và từng attachment đã suy ra nó (xem errors/fatal-halts.md).

Trường hợp lớn nhất được loại trừ bằng cấu trúc thay vì được kiểm tra. Một chart sourced đặt tên tài nguyên theo tên release không còn có thể gây ra điều này giữa hai component, vì hai cơ sở đặt tên chỉ cần khác nhau là sẽ cho ra hai tên release — xem providers/helm.md “How the release name is derived”. Còn lại hai trường hợp, và phép kiểm tra ở trên chính là thứ báo cáo chúng. Một là chart viết trực tiếp tên tài nguyên vào template của nó, và không phép suy dẫn nào phân biệt được một tên như vậy với bất kỳ literal nào khác. Trường hợp kia là hai attachment Feature trên một component mà mỗi attachment cung cấp một chart do tác giả của nó viết: cả hai đều render theo tên release của component đó, theo thiết kế, nên hai chart đặt tên tài nguyên theo .Release.Name sẽ trùng nhau ở đó — hãy đặt tên riêng biệt cho tài nguyên của hai chart, hoặc gắn chúng vào các component khác nhau.

Mọi tên được tổng hợp đều bắt đầu bằng định danh riêng của node — tên của đối tượng controller, và từng tên theo tài nguyên thông qua quy ước tên Service được tổng hợp <release name>-<svcName> (theo entities/workload.md “Synthesized-name convention”) — điều này khiến xung đột giữa các node là bất khả thi về mặt cấu trúc. Tác giả có bản dựng dừng lại vì một tên Deployment / Service nên kiểm tra trước tiên liệu có hai Recipes khác nhau đang phát ra các tài nguyên cùng tên qua các đường render khác nhau hay không (ví dụ: templates/deployment.yaml của một chart sourced xung đột với metadata.name của một Deployment được tổng hợp từ workload).

Các mẫu tương tác giữa các cơ chế

Tổng hợp từ Workload + bản vá của plugin-pipeline

Mẫu chuẩn: cơ chế 2 (tổng hợp workload) phát ra một Deployment cơ sở; cơ chế 4 (plugin Injector) áp dụng một bản vá RFC 6902 gắn một volume secret vào Deployment. Hai cơ chế kết hợp với nhau — Deployment là cùng một tài nguyên K8s, với bản vá chồng các tham chiếu ConfigMap / Secret lên phần cơ sở đã tổng hợp.

Đây là mẫu phổ biến nhất để chèn thông tin xác thực vào các workload được tổng hợp. Fetcher (cơ chế 3, Resource Generation) phát ra một CRD ExternalSecret mà cluster sẽ lấy về khi chạy; Injector (cơ chế 4, một bản vá của plugin-pipeline) sửa Deployment để gắn Secret K8s thu được.

Sourced + tổng hợp Workload trên các boundary khác nhau

Một Aggregate duy nhất có thể có một component gắn với một Recipe helm dạng sourced (cơ chế 1) trên boundary A và một component anh em gắn với một Recipe helm tổng hợp Workload (cơ chế 2) trên boundary B. Thư mục của mỗi boundary mang dạng đầu ra phù hợp; việc đặt tên tệp giữa các boundary không xung đột vì các thư mục dist/ theo từng boundary được cô lập ngang hàng với nhau.

Hợp nhất compose ở cấp Release theo từng thư mục đầu ra

Quá trình lắp ráp của năng lực compose gom các phân đoạn theo từng node của mọi boundary có thư mục được đánh giá thành cùng một đường dẫn vào một docker-compose.yaml duy nhất tại đường dẫn đó; hai boundary nhắm tới compose trong cùng một Release sẽ ghi ra hai tệp khi thư mục của chúng khác nhau, và một tệp hợp nhất khi chúng dùng chung một thư mục.

Do đó, xung đột tên service được phát hiện theo từng tệp, khi hợp nhất tệp đó ở cấp Release, theo quy tắc ở trên. Hai boundary nhắm tới compose ở các thư mục khác nhau mà mỗi boundary khai báo một service tên api sẽ không xung đột: tệp của mỗi boundary mang service riêng của nó. Hai boundary dùng chung một thư mục sẽ ghi ra một tệp, và bản dựng dừng lại, nêu tên cả hai bên đóng góp.

Tham chiếu chéo

  • entities/recipe.md — bề mặt soạn thảo Recipe (các cơ chế 1 + 2 + 6 phát sinh từ nội dung Recipe).
  • entities/featurerecipe.md — bề mặt soạn thảo FeatureRecipe (các cơ chế 3 + 4 phát sinh từ nội dung FeatureRecipe).
  • providers/helm.md — các dạng đầu ra theo từng cơ chế và các quy ước đặt tên của provider helm.
  • providers/helm-chart.md — cách kết hợp umbrella chart + sub-chart của provider helm-chart (cơ chế 5).
  • providers/compose.md — việc phân mảnh theo từng node + kết hợp ở cấp Release của provider compose (cơ chế 5).
  • errors/fatal-halts.md — các quy tắc về hình dạng Recipe đối với khóa mục artifacts: duy nhất và đối với xung đột tên tệp giữa các loại đầu vào khác nhau.
  • templates/expansion-matrix.md — thời điểm đánh giá của từng vị trí template theo thứ tự kết xuất.
  • plugins/plugin-contract.md — bề mặt hợp đồng của pipeline plugin (cơ chế 4).
  • 10-status.md — trạng thái sẵn sàng hiện tại của cơ chế 6 (artifacts:) và runtime pipeline plugin của cơ chế 4.
  • architecture/10-compilation-pipeline.md — toàn bộ pipeline biên dịch, bao gồm thứ tự của các giai đoạn kết xuất.
  • architecture/16-recipe-input-composition.md — ba loại đầu vào của Recipe (khung nền tảng phía trên cho các cơ chế 1 + 2 + 6).