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.

Các lỗi dừng nghiêm trọng

Lỗi dừng nghiêm trọng là một lỗi tại thời điểm biên dịch, khiến bản build dừng lại trước khi tạo ra bất kỳ đầu ra nào. Mỗi lỗi dừng nêu tên tệp, thực thể và trường gây lỗi, giải thích điều mà trình biên dịch không thể phân giải, và chỉ ra thay đổi cụ thể trong phần soạn thảo để khắc phục. Trình biên dịch không bao giờ âm thầm sửa chữa hay viết lại đầu vào của bạn — nếu có gì sai, bản build sẽ dừng và cho bạn biết sai ở đâu.

Danh mục này được sắp xếp theo giai đoạn biên dịch mà tại đó mỗi lần dừng xảy ra.

Mỗi mục dưới đây trích dẫn thông báo mà bản build in ra cho điều kiện mà mục đó mô tả: câu cố định nêu điều kiện, sau đó là những gì lần xảy ra cụ thể đó cung cấp. Trong terminal, thông báo này xuất hiện bên trong một khung — một phần đầu trong ngoặc vuông chứa danh mục và mã ngắn của điều kiện, một con trỏ tới tệp và khóa gây lỗi, theo sau là instance mà lỗi liên quan dưới dạng (instance <name>) — hoặc chỉ riêng instance đó, dưới dạng instance <name>, khi không có tệp nào áp dụng — và thông báo ở dòng bên dưới — vì vậy cả một dòng được dán từ bản build sẽ không khớp với mục nào ở đây, nhưng thông báo bên trong nó thì sẽ khớp; error-translation.md trình bày đầy đủ về khung này.

Nếu bạn đến đây từ một bản build với mã ngắn trong tay — chữ E và bốn chữ số, trong phần đầu trong ngoặc vuông của chẩn đoán — hãy bắt đầu tại Tìm lỗi dừng từ mã ngắn mà bản build đã in ra ở cuối trang này, nơi liệt kê mọi điều kiện được ghi trong danh mục này cùng với mã ngắn mà bản build in ra cho điều kiện đó.

Khi tải các tệp của bạn

Trình biên dịch đọc mọi Aggregate, Manifest, Component, Feature, Recipe, FeatureRecipe, Plugin và Release mà bản dựng của bạn tham chiếu, xác thực từng thực thể theo schema của nó, và nội suy các tham số có kiểu từ Release vào Aggregate.

YAML anchor aliased inside its own content (Anchor YAML được alias bên trong chính nội dung của nó)

Một tài liệu đặt anchor cho một nút bằng &name rồi alias nó bằng *name ở đâu đó bên trong nội dung mà anchor đó bao phủ. Việc mở rộng alias tái tạo anchor, mà nội dung của nó lại chứa alias, nên tài liệu mô tả một cấu trúc không có điểm kết thúc. Không có gì hữu hạn để đọc, chưa nói đến xác thực, và bản dựng dừng lại thay vì bắt đầu một lượt duyệt không thể kết thúc.

Việc đọc YAML thành cây không mở rộng alias, nên một tài liệu có dạng này được đọc mà không có lỗi và chỉ thất bại khi có thứ gì đó duyệt nó. Do đó, việc từ chối nằm giữa bước đọc và bước duyệt — và một bản dựng đọc YAML do người dùng viết ở nhiều thời điểm, nên cùng một điều kiện có thể gặp ở nhiều thời điểm. Bốn thời điểm báo cáo nó, mỗi thời điểm đóng khung cùng một lời giải thích bằng thông tin định vị tài liệu trên bề mặt đó:

  • Một tệp thực thể, khi được đọc. Bản dựng dừng trước khi thực thể đó được kiểm tra theo schema của nó, nên lỗi dừng này nêu tên một anchor thay vì một trường, và không mang dòng và cột: tại thời điểm đó tài liệu chưa có vị trí nào mà một chẩn đoán có thể chỉ tới một cách hữu ích.
  • Một thân schema, khi được biên dịch. Một trụ cột spec.schema: được biên dịch từ dạng rút gọn thành một tài liệu JSON Schema sau khi tệp của nó đã được đọc, nên lỗi dừng này xảy ra trong quá trình biên dịch đó chứ không phải trước đó, và nó có mang số dòng. Dạng mà một lần đọc trước không thể phát hiện là thân của lối thoát $jsonschema:: thân lối thoát là một block scalar — văn bản thuần, không mang anchor — trong khi tệp xung quanh được đọc, và các anchor của nó chỉ trở thành anchor khi chính văn bản đó được phân tích cú pháp, ở một cấp thấp hơn. Khi vòng lặp nằm trong một khối như vậy, lỗi dừng còn nêu $jsonschema là từ khóa có thân chứa vòng lặp.
  • Workload schema của một Plugin provider, khi Plugin được tải. spec.provider.workloadSchema được viết dưới dạng block scalar: văn bản thuần trong khi chính tệp Plugin được đọc, không mang anchor tại thời điểm đó, và các anchor của nó chỉ trở thành anchor khi văn bản đó được phân tích cú pháp như một tài liệu riêng, ở một cấp thấp hơn. Việc phân tích cú pháp đó và quá trình biên dịch theo sau đều diễn ra khi Plugin được tải, nên lỗi dừng này xảy ra ở đó chứ không phải khi tệp được đọc, và nó có mang số dòng. Khi vòng lặp nằm trong một lối thoát $jsonschema: bên trong thân schema, lỗi dừng còn nêu $jsonschema là từ khóa có thân chứa vòng lặp. Xem ../entities/plugin.md để biết bề mặt viết của trường này.
  • Một fragment CloudFormation đã render, khi provider đọc nó. Một Recipe cloudformation viết một fragment, và thân artifacts: là một template — nên thứ mà provider đọc là văn bản mà template đó render ra, nội dung chưa tồn tại khi các tệp của bạn đang được đọc. Do đó, lỗi dừng này xảy ra trong khi đầu ra đang được render, sau khi mọi kiểm tra schema đã vượt qua. Xem ../providers/cloudformation.md để biết bề mặt viết fragment.

Điều bị từ chối là đệ quy, không bao giờ là việc tái sử dụng hay độ sâu. Đặt anchor cho nội dung dùng chung và tham chiếu nó từ nhiều nơi là một mẫu viết được hỗ trợ — xem ../entities/aggregate.md “YAML anchor patterns (defs: block)” và ../entities/manifest.md “YAML anchors for DRY manifests” — và một tham chiếu mở rộng rồi kết thúc sẽ được tải bình thường, dù nó xuất hiện bao nhiêu lần và tài liệu lồng sâu đến đâu; riêng độ sâu không bao giờ là lý do cho lỗi dừng này. Điều gây dừng là một anchor được chạm tới trong khi bản dựng vẫn đang ở bên trong nó, kể cả khi nó được chạm tới gián tiếp, thông qua một anchor thứ hai được khai báo bên dưới nó. Thông báo nêu tên anchor mà vòng lặp khép lại, vốn không nhất thiết là anchor ngoài cùng trong tài liệu.

Các thông báo được phát ra. Cả bốn đều mang cùng một lời giải thích, và điều này là có chủ ý: đó là một điều kiện gặp ở bốn thời điểm, và người viết đã học cách đọc nó một lần thì không phải học lại. Chỉ có khung định vị tài liệu là khác nhau.

anchor &<anchor> is aliased by *<anchor> inside its own content, so the document expands without end; point that alias at content declared outside &<anchor>, or write the content out in full (anchor được alias bên trong chính nội dung của nó, nên tài liệu mở rộng không có điểm dừng; hãy trỏ alias đó đến nội dung được khai báo bên ngoài anchor, hoặc viết đầy đủ nội dung ra)

Một tệp thực thể được đóng khung bởi bước kiểm tra envelope đang đọc nó và đường dẫn mà nó được đọc từ đó:

document envelope validation failed: envelope: parse <path>: <the explanation above>

Một thân schema được đóng khung bởi vị trí của nó trong schema, và bởi từ khóa lối thoát khi vòng lặp nằm trong một khối $jsonschema:. Bản dựng báo cáo nó dưới thẻ CATALOG_ERROR, thẻ này cũng nêu tên tệp, thực thể và trụ cột có thân không biên dịch được:

compactform at <schema-path>:<line> (keyword "$jsonschema"): <the explanation above>

Workload schema của một Plugin provider mang cùng khung dạng rút gọn đó; điều khác biệt là thẻ CATALOG_ERROR bao quanh nó, thẻ này nêu tên Plugin và spec.provider.workloadSchema thay cho thực thể và trụ cột của nó.

Một fragment đã render được đóng khung bởi provider đã đọc nó:

cloudformation-provider: parse fragment: <the explanation above>

Cách khắc phục: trỏ alias tới nội dung được khai báo bên ngoài anchor mà nó hiện đang nằm bên trong, hoặc viết đầy đủ nội dung lặp lại tại chỗ sử dụng. Trên một Aggregate hoặc một Manifest, khối defs: ở cấp gốc là nơi tự nhiên cho các anchor dùng chung — nó nằm ngoài mọi khối tham chiếu đến nó, nên một anchor được khai báo ở đó không thể được chạm tới từ bên trong chính nó. Trên các loại thực thể khác, vốn không có khối defs:, hãy đặt anchor cho nội dung dùng chung ở nơi mà khối tham chiếu không phải là hậu duệ. Một anchor có thể được tham chiếu từ bất kỳ số nơi nào và từ bất kỳ độ sâu nào; dạng duy nhất nó không thể có là một tham chiếu quay ngược vào bên trong nội dung mà anchor bao phủ.

Cùng một cách khắc phục áp dụng ở bất cứ nơi nào gặp lỗi dừng, và khung cho bạn biết cần mở tài liệu nào: chính tệp thực thể, khối $jsonschema: bên trong một trụ cột schema, thân workloadSchema bên trong một Plugin provider, hoặc thân artifacts: có đầu ra đã render mà provider đọc. Trong trường hợp cuối, anchor nằm trong template bạn viết, không phải trong văn bản đã render — quá trình render đã tái tạo nó một cách trung thực.

Parameter type mismatch / contract violation (Kiểu tham số không khớp / vi phạm hợp đồng)

Release đã cung cấp một giá trị có kiểu hoặc hình dạng không khớp với những gì Aggregate đã khai báo cho tham số đó. Trình kiểm tra hợp đồng tham số phát hiện các trường hợp không khớp kiểu, vi phạm enum, vi phạm phạm vi, vi phạm mẫu, các chuỗi không phải là thể hiện hợp lệ của format đã khai báo cho chúng, các lỗi vị từ validate: và các tham số bắt buộc bị thiếu, trước khi bất kỳ phép nội suy template nào chạy. Các tên mà một format có thể nhận, cùng với những gì mỗi tên kiểm tra, được liệt kê trong Các định dạng có tên.

Thông báo được phát ra — câu nêu điều kiện, sau đó là thực thể gây lỗi, đường dẫn trường và chi tiết ràng buộc:

parameter contract violated (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" expected type <declared type>; got <received type>) (hợp đồng tham số bị vi phạm (Aggregate, tại .spec.parameters.<parameter>, tham số “<parameter>” cần kiểu <declared type>; nhận được <received type>))

Với một tham số được khai báo required: true mà không có default: và không có giá trị do Release cung cấp, báo cáo mang một điều kiện khác và một mã ngắn khác:

required parameter not supplied (Aggregate, at .spec.parameters.<parameter>, parameter "<parameter>" is required but not supplied by Release) (tham số bắt buộc không được cung cấp (Aggregate, tại .spec.parameters.<parameter>, tham số “<parameter>” là bắt buộc nhưng không được Release cung cấp))

Chỉ phần chi tiết sau đường dẫn trường thay đổi theo ràng buộc không được đáp ứng. Câu và khung trong ngoặc đơn bao quanh nó luôn giống nhau, nên câu là phần để đối chiếu và chi tiết là phần để đọc. Các chi tiết mà một bản dựng in ra, mỗi loại ràng buộc một chi tiết:

parameter "<parameter>" value <value> not in enum [<members>] (giá trị của tham số không nằm trong enum) parameter "<parameter>" value "<value>" does not match pattern "<pattern>" (giá trị của tham số không khớp pattern) parameter "<parameter>" value "<value>" is not a valid <format>: <reason> (giá trị của tham số không phải là format hợp lệ) parameter "<parameter>" value <value> above max <max> (giá trị của tham số vượt quá max) parameter "<parameter>" failed validate predicate (tham số không vượt qua predicate validate) parameter "<parameter>" validate predicate error: <detail> (lỗi predicate validate của tham số)

<reason> của một lỗi format cho biết giá trị sai ở đâu theo chính thuật ngữ của format đó. Một giá trị bên trong một hợp đồng lồng nhau được gọi tên theo đường dẫn của nó, nên một format mà hợp đồng items: khai báo được kiểm tra trên mọi phần tử và báo cáo nêu tên phần tử đã thất bại: phần tử thứ hai của tham số hosts được báo cáo tại .spec.parameters.hosts.1, với chi tiết nêu tên "hosts.1".

Một tham số khai báo validateMessage: sẽ thay toàn bộ chi tiết đó bằng văn bản của riêng nó, nên báo cáo có dạng parameter contract violated (Aggregate, at .spec.parameters.<parameter>, <the validateMessage you wrote>) — khung không thay đổi và câu bạn viết nằm ở vị trí của chi tiết ràng buộc.

Cùng điều kiện này bao gồm một hợp đồng không thể ràng buộc bất cứ điều gì như cách nó được viết. Một pattern: không phải là biểu thức chính quy hợp lệ sẽ bị từ chối khi hợp đồng tham số của Aggregate được đọc, trước khi bất kỳ giá trị Release nào được kiểm tra, nên nó dừng bản dựng dù Release có cung cấp tham số hay không. Báo cáo chỉ tới khóa — .spec.parameters.<parameter>.pattern, hoặc đường dẫn qua một hợp đồng lồng nhau như .spec.parameters.<parameter>.items.pattern — và chi tiết của nó nêu tên khai báo, pattern và lý do:

parameter "<parameter>" pattern "<pattern>" does not compile: <reason> (pattern của tham số không biên dịch được)

Một format: nêu tên một format nằm ngoài tập được hỗ trợ cũng không thể ràng buộc gì, và nó bị từ chối tại cùng thời điểm, trước khi bất kỳ giá trị Release nào được kiểm tra, nên nó cũng dừng bản dựng dù Release có cung cấp tham số hay không. Bên trong một hợp đồng lồng nhau — dưới items:, properties: hoặc valuesType: — chính điều kiện này từ chối nó: báo cáo chỉ tới khóa, chẳng hạn .spec.parameters.<parameter>.items.format, và chi tiết của nó nêu tên khai báo, format như đã viết và mọi tên được hỗ trợ:

parameter "<parameter>.items": format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date (format không được hỗ trợ; các format được hỗ trợ là email, uri, hostname, ipv4, ipv6, uuid, date-time, date)

Trên chính khai báo của một tham số, cùng tên đó bị từ chối sớm hơn một bước, bởi schema của Aggregate, nơi format chỉ chấp nhận các tên được hỗ trợ. Sự từ chối đó là việc tài liệu không thỏa mãn schema của kind của nó — một điều kiện khác, với mã ngắn riêng, E0215 — và aggrega pull cùng aggrega validate --release liệt kê nó sau khi báo cáo rằng tham chiếu aggregate: của Release không thể phân giải (E0170), vì Aggregate mang tên đó đã không được tải:

document envelope validation failed (Aggregate, at <path>); <line>:<column>: spec.parameters.<parameter>.format: enum: <format> does not equal any of: [email uri hostname ipv4 ipv6 uuid date-time date]. correct the document to match its kind’s schema (xác thực envelope của tài liệu thất bại; format không bằng bất kỳ giá trị nào trong danh sách; hãy sửa tài liệu cho khớp với schema của loại của nó)

Chi tiết lỗi predicate bao gồm cả hai cách mà một predicate validate: có thể không đưa ra được kết luận: một hàm mà bề mặt không đăng ký, và một tham chiếu tới thứ khác ngoài .value. Mỗi trường hợp được báo cáo theo predicate thay vì theo giá trị, và mỗi trường hợp nêu tên thứ nó không thể phân giải.

Một predicate validate: đọc giá trị đang được xác thực dưới tên .value, và đó là tên duy nhất nó định nghĩa. Một predicate nêu tên bất cứ thứ gì khác sẽ bị từ chối trước khi chạy, nên một tham chiếu gõ sai được báo cáo đúng là lỗi đặt tên, thay vì phân giải thành rỗng và xuất hiện như một giá trị không vượt qua xác thực.

Cách khắc phục: thay đổi giá trị Release cho khớp với các ràng buộc type / enum / min / max / pattern / format đã khai báo của tham số, cung cấp tham số bắt buộc bị thiếu, sửa một pattern: không biên dịch được, thay một format: nêu tên format không được hỗ trợ bằng một trong các format có tên hoặc xóa nó, sửa một predicate validate: nêu tên thứ khác ngoài .value hoặc render ra thứ khác ngoài true hoặc false, hoặc mở rộng khai báo của Aggregate để chấp nhận dạng bạn thực sự cần.

Quy tắc hình dạng của Recipe

Một Recipe tạo đầu ra từ ba loại đầu vào — sourced, synthesized và artifacts — được mô tả trong ../../architecture/16-recipe-input-composition.md. Hình dạng của một Recipe hợp lệ bị ràng buộc bởi các quy tắc kết hợp dưới đây. Chúng khác nhau ở thời điểm được kiểm tra — khi Recipe được tải, khi một node render, hoặc khi đầu ra được phát ra — vì vậy hãy đọc từng mục để biết thời điểm điều kiện của chính nó được kiểm tra.

Mỗi quy tắc được đặt tên theo thứ nó ràng buộc. Không có đánh số, và không số nào được dành riêng: một tên cho biết phần nào của Recipe cần mở, và nó vẫn nói như vậy dù danh sách dưới đây mở rộng hay được sắp xếp lại thế nào. Khi bạn cần ghi lại một điều kiện một cách bền vững — trong một cổng CI, một issue, một runbook — hãy dùng mã của nó, định danh mà sentinels.md liệt kê cho điều kiện đó và là định danh giữ cố định khi các gói xung quanh thay đổi.

Một lần dừng do hình dạng Recipe được cấu thành theo cùng cách. Nó mở đầu bằng câu nêu quy tắc, sau đó nêu những gì Recipe cụ thể này đã cung cấp, rồi đến chi tiết riêng cho nó:

<the rule's sentence> (Recipe <name>:<version>, rule <rule-name>, at <position>). <rule-specific detail>

Câu mở đầu là cố định theo từng quy tắc — cùng một văn bản mỗi lần quy tắc đó dừng build, bất kể giai đoạn nào phát hiện — vì vậy đó là phần của đầu ra để so khớp, và đó là văn bản mà sentinels.md liệt kê cho điều kiện của quy tắc. Mọi thứ sau nó thay đổi theo Recipe có lỗi: các giá trị trong ngoặc đơn cho biết tài liệu nào, quy tắc nào theo tên, và ở đâu, còn câu kết là lời khuyên cho lần xảy ra đó. Vị trí là tệp mà Recipe được tải từ đó khi quy tắc nói về toàn bộ tài liệu, và là một đường dẫn dạng chấm tới khóa bạn đã viết — .spec.outputComponentLabels.hosting — khi quy tắc nói về một thứ bên trong nó; một khóa có chứa dấu chấm riêng không thể được viết thành thêm một đoạn mà không bị đọc như hai đoạn, nên đường dẫn dừng ở khối chứa nó và lời khuyên trích dẫn khóa thay vào đó.

Build in toàn bộ dòng dưới thẻ CATALOG_ERROR, cho biết lỗi thuộc về thực thể catalog (Recipe, hoặc provider mà nó liên kết tới), không phải Aggregate hay Release. Tệp mà Recipe được tải từ đó được in bên cạnh thẻ, nên một quy tắc được định vị tại một khóa vẫn cho bạn biết cần mở tệp nào.

valuesMapping requires source (valuesMapping yêu cầu source)

Một Recipe khai báo valuesMapping nhưng không khai báo source. Không có source để phủ lên thì không có gì nhận các giá trị được ánh xạ. Quy tắc này được kiểm tra khi Recipe được tải.

Thông báo được phát ra:

Recipe: valuesMapping requires source (Recipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended)

Cách khắc phục: thêm một con trỏ source: (tham chiếu tới chart, module hoặc tệp compose) bên cạnh valuesMapping, hoặc xóa valuesMapping và dùng một loại đầu vào khác (workload: cho đầu ra synthesized, artifacts: để phát manifest trực tiếp).

workload: requires a provider that can synthesize (workload: yêu cầu một provider có khả năng tổng hợp)

Một Recipe khai báo workload: (chế độ synthesized) cho một provider không triển khai việc tổng hợp Workload. Hỗ trợ chế độ synthesized là một thuộc tính của provider — theo quy ước, catalog thư viện chuẩn khai báo workloadSchema trên các provider có khả năng tổng hợp, nhưng việc kiểm tra dựa trên khả năng của provider, không dựa trên sự hiện diện của trường đó.

Hai bề mặt báo cáo nó, và chỉ một trong số đó quyết định build. Lần dừng được đưa ra lúc render, sau khi provider của node được liên kết và khi các loại đầu vào mà Recipe của nó khai báo đã được đọc, nên báo cáo đó nêu tên node. aggrega validate báo cáo cùng phát hiện đó sớm hơn, trước khi bất kỳ node nào được liên kết, bằng cách đọc riêng Recipe — nên báo cáo đó nêu tên Recipe và phiên bản của nó thay vào đó. Hai bên không đọc cùng một tập Recipes: báo cáo sớm được đưa ra cho bất kỳ Recipe nào có khai báo workload:, còn lần dừng được đưa ra cho mọi loại đầu vào mà node khai báo nhưng provider của nó không đáp ứng được. Vì vậy một Recipe kết hợp workload: với source: vẫn dừng, và dừng vì workload — việc khai báo một loại đầu vào mà provider có thể render không giúp một loại không được hỗ trợ vượt qua cổng kiểm tra.

Giới hạn duy nhất của điều đó: artifacts: chỉ được kiểm tra đối với hỗ trợ standalone-artifacts khi nó là loại được khai báo duy nhất của node. Đi cùng source: hoặc workload:, các tệp của nó được chuyển qua như đầu ra được kết hợp, điều mà khả năng đó không chi phối.

Thông báo được phát ra lúc render. Danh mục mà lỗi được quy cho đến với bạn trong phần đầu trong ngoặc vuông của chẩn đoán thay vì bên trong thông báo. Thông báo mở đầu bằng câu cố định nêu điều kiện, sau đó nêu node, provider, loại được khai báo đã bị từ chối, và các loại mà provider đó hỗ trợ. Khi một node khai báo hai loại mà provider của nó không đáp ứng được, loại đầu tiên theo thứ tự source → workload → artifacts là loại được báo cáo, để phát hiện chỉ liên quan tới một dòng duy nhất trong Recipe của bạn:

provider does not support the node’s input kind (node "<node-id>"). provider "<provider-name>" does not support <mode> recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports <mode>

Phần đầu mang danh mục và mã ngắn của điều kiện này, E0265, là định danh cần ghi lại khi bạn cần gọi tên lần dừng này một cách bền vững — trong một cổng tích hợp liên tục, một issue hoặc một runbook. Một số được cấp một lần rồi cố định, nên nó giữ nguyên dù cách diễn đạt xung quanh được cải thiện thế nào; bảng mọi điều kiện tra cứu nó, và câu mở đầu ở trên là thứ để so khớp khi bạn làm việc từ văn bản thay vì từ định danh.

aggrega validate báo cáo cùng mệnh đề dưới Recipe chứa khối đó, có tiền tố là bề mặt đã đọc nó và được mở đầu bằng mã ngắn của điều kiện này, vì báo cáo sớm đó là cùng một điều kiện:

input-kind: [E0265] Recipe "<name>:<version>": provider "<provider-name>" does not support synthesized recipes (this provider supports: <kinds>); declare one of the supported input kinds, or target a provider that supports synthesized (input-kind: Recipe: provider không hỗ trợ các recipe tổng hợp (provider này chỉ hỗ trợ các loại được liệt kê); hãy khai báo một trong các loại đầu vào được hỗ trợ, hoặc nhắm tới một provider hỗ trợ tổng hợp)

Trên toàn bộ catalog, đó là một dòng; với --release, phần đầu nằm trên một dòng riêng phía trên mệnh đề. Chẩn đoán của trình soạn thảo cho cùng phát hiện đó mang E0265 làm mã của nó.

Cách khắc phục: hoặc liên kết Recipe với một provider có khả năng tổng hợp (thường gặp nhất là helm hoặc compose), hoặc chuyển Recipe sang một loại đầu vào khác (artifacts: để phát manifest trực tiếp, hoặc source: + valuesMapping: nếu có sẵn chart/module).

Xác thực nội dung Workload theo từng provider. Hiện nay workloadSchema của provider chỉ mang tính tài liệu và không xác thực phần thân Workload; các phần thân được xác thực theo schema Workload nhúng do nền tảng sở hữu. Khi bộ tổng hợp Workload dựa trên Wasm được phát hành, workloadSchema sẽ trở thành hợp đồng theo từng provider mà bộ tổng hợp dùng để xác thực phần thân Workload (một lần dừng riêng, ở cấp nội dung).

The provider does not support omits (Provider không hỗ trợ omits)

Một Recipe hoặc một FeatureRecipe khai báo omits: nhưng provider render nó không khai báo rằng nó loại bỏ các tài liệu đã render. Loại bỏ một tài liệu khỏi những gì một source render là việc chỉ provider làm được — chỉ provider biết source render những tài liệu nào và mỗi tài liệu tên là gì — nên một provider không làm việc đó sẽ render mọi tài liệu mà các mục nêu tên và báo thành công. Thay vào đó, bản build từ chối trước khi bất cứ thứ gì được render, để khóa này không bao giờ lặng lẽ không có tác dụng.

Việc một provider có loại bỏ tài liệu hay không được đọc từ chính khai báo của provider về những gì nó hỗ trợ, chứ không từ một danh sách provider mà trình biên dịch lưu giữ. Mọi mục đều được tính, bất kể when: của nó render ra gì, vì việc provider có thể tôn trọng khóa này hay không không phụ thuộc vào việc bản build giữ lại những mục nào. Các provider helm, compose và cloudformation tôn trọng khóa này. helm-chart và terraform chuyển source của chúng đi để được render khi triển khai, nên tại thời điểm build không có tài liệu đã render nào để loại bỏ, và cả hai đều bị từ chối.

Việc từ chối được quyết định khi Recipe của mọi component và FeatureRecipe của mọi attachment đã được gắn và mỗi provider đã tự mô tả — trước khi component đầu tiên render và trước khi bất kỳ mục nào được đánh giá, nên một bản build bị từ chối ở đây không render gì cả. Điều kiện này được kiểm tra với mọi tài liệu render một source: Recipe của một component; FeatureRecipe mà một attachment gắn trên một component, một lần cho mỗi component mang attachment đó; và một FeatureRecipe sinh một lần cho một boundary, một lần, tại boundary khai báo nó. Mọi tài liệu có lỗi được báo cáo trong một bản build; khi có nhiều hơn một, các phát hiện được nhóm dưới documents declaring omits whose provider does not honour them. Một tài liệu được gắn với một provider mà bản build không thể phân giải sẽ không được báo cáo ở đây: bản build đó dừng tại nơi provider được chọn, nêu tên binding.

Thông báo được phát ra, được định vị tại chính khóa của component dưới components: đối với các mục của một Recipe (một component được viết bên trong một subsystem được định vị dưới khóa của subsystem đó trước), tại khóa của attachment trong khối features: đã viết nó đối với các mục của một FeatureRecipe trên một component, và tại .spec.boundaries.<boundary>.features.<attachment> trong Release đối với một FeatureRecipe sinh một lần cho boundary của nó. Danh mục đến với bạn trong phần đầu đặt trong ngoặc vuông; thông báo nêu tên provider trước, sau đó là component mà tài liệu render cho:

provider does not support omits ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it leaves rendered documents out; remove the omits key, or render the source through a provider whose contract declares it

Phát hiện của một FeatureRecipe nêu tên attachment sau component — node "<node-id>", attachment "<attachment>" — và phát hiện của một FeatureRecipe sinh một lần cho boundary của nó nêu tên boundary và attachment thay cho một component: boundary "<boundary>", attachment "<attachment>".

Phần đầu mang mã ngắn của điều kiện này, E0335.

Cách khắc phục: xóa khóa omits:, hoặc render source thông qua một provider tôn trọng nó. Khi một Recipe helm-chart hoặc terraform lấy source từ một chart hoặc module cục bộ, một dòng trong .aggregaignore bên cạnh Recipe sẽ loại bỏ một tệp của source đó thay thế, kể từ lần tiếp theo Recipe được pin — xem aggrega pin.

The provider does not support boundary artifacts (Provider không hỗ trợ boundary artifacts)

Một Recipe khai báo spec.boundary.artifacts — các tệp cho đầu ra dùng chung của boundary mà nó render trong đó — nhưng provider render nó không khai báo rằng nó chấp nhận những tệp như vậy. Trình biên dịch tự ghi những tệp đó, bên cạnh những gì provider tập hợp cho boundary, và không chuyển tệp nào cho provider, nên việc một tệp đặt ở đó có ý nghĩa hay không là thuộc tính của đích của provider. Một đích không đọc nó sẽ phát hành nó rồi bỏ qua, và cấu hình nó mang sẽ không bao giờ có hiệu lực; thay vào đó, bản build từ chối trước khi bất cứ thứ gì được render.

Việc một provider có chấp nhận các tệp hay không được đọc từ chính khai báo của provider về những gì nó hỗ trợ, chứ không từ một danh sách provider mà trình biên dịch lưu giữ. Mọi mục đều được tính, bất kể nó sẽ render ra gì. Provider terraform chấp nhận chúng, ghi mỗi tệp bên cạnh cấu hình gốc của boundary; helm, compose, helm-chart và cloudformation thì không, và bị từ chối.

Việc từ chối được quyết định khi Recipe của mọi component đã được gắn và mỗi provider đã tự mô tả — trước khi component đầu tiên render và trước khi bất kỳ mục nào được đánh giá, nên một bản build bị từ chối ở đây không render gì cả. Mọi Recipe có lỗi được báo cáo trong một bản build, một lần cho mỗi component mà nó render; khi có nhiều hơn một phát hiện, chúng được nhóm dưới Recipes declaring boundary artifacts whose provider does not accept them. Một Recipe được gắn với một provider mà bản build không thể phân giải sẽ không được báo cáo ở đây: bản build đó dừng tại nơi provider được chọn, nêu tên binding.

Thông báo được phát ra, được định vị tại .spec.boundary trong Recipe, nơi cần chỉnh sửa. Danh mục đến với bạn trong phần đầu đặt trong ngoặc vuông; thông báo nêu tên provider trước, sau đó là component mà Recipe render cho:

provider does not support boundary artifacts ("<provider-name>", node "<node-id>"). this provider’s contract does not declare that it accepts files written to a boundary’s shared output; remove the boundary block, or render the Recipe through a provider whose contract declares it

Phần đầu mang mã ngắn của điều kiện này, E0351.

Cách khắc phục: xóa khối boundary:, hoặc render Recipe thông qua một provider chấp nhận nó. Một tệp thuộc về component thay vì boundary thì thay vào đó là một mục artifacts:.

Phải có ít nhất một loại đầu vào

Một Recipe không khai báo loại đầu vào nào: không có source đi kèm valuesMapping, không có workload:, không có artifacts:. Một Recipe như vậy không tạo ra đầu ra và không có bề mặt render. Quy tắc này được kiểm tra khi Recipe được tải.

Một tệp Recipe có hình dạng đó sẽ gặp schema của Recipe trước: schema yêu cầu, trên mọi provider, một trong source, valuesMapping, workload hoặc artifacts, nên bước kiểm tra phong bì tài liệu từ chối tệp dưới E0215 trước khi quy tắc này chạy, với một nhánh cho mỗi khóa:

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec: no anyOf branch matched: branch[0]: validation: required: missing properties: [“source”]; branch[1]: validation: required: missing properties: [“valuesMapping”]; branch[2]: validation: required: missing properties: [“workload”]; branch[3]: validation: required: missing properties: [“artifacts”]. correct the document to match its kind’s schema (xác thực phong bì tài liệu thất bại (Recipe): spec: không nhánh anyOf nào khớp: nhánh 0 thiếu thuộc tính bắt buộc “source”; nhánh 1 thiếu thuộc tính bắt buộc “valuesMapping”; nhánh 2 thiếu thuộc tính bắt buộc “workload”; nhánh 3 thiếu thuộc tính bắt buộc “artifacts”. Hãy sửa tài liệu cho khớp với schema của loại của nó)

Thông báo được phát ra:

Recipe: at least one input kind required (Recipe <name>:<version>, rule input-kinds, at <path>). declare one of: source (with valuesMapping), workload, artifacts

Cách khắc phục: thêm loại đầu vào phù hợp với ý định soạn thảo của Recipe. Một Recipe cho một service mà build không cấp phát — một cơ sở dữ liệu hoặc một API đã chạy ở nơi khác — khai báo một workload: có form: reference cùng endpoint của nó (và tùy chọn port), và publish các giá trị kết nối của nó dưới provides: như mọi Recipe: helm kết xuất nó thành một ExternalName Service, compose không kết xuất gì cho nó, và trên cả hai, các bên sử dụng nó đọc các giá trị đã được publish.

Các khóa mục artifacts: phải là duy nhất

Một Recipe khai báo hai hoặc nhiều mục dưới artifacts: có cùng khóa. Khóa quyết định tên tệp được phát ra (dù nội dung của mục được viết inline hay được tải qua $import: theo từng mục); các khóa trùng lặp sẽ phát ra một tệp cùng tên vào cùng một thư mục boundary.

Bản build từ chối Recipe trong khi giải mã tài liệu thành dạng có kiểu, nêu tên khóa bị lặp và dòng nơi nó xuất hiện lại. Bước đó chạy sau kiểm tra schema của envelope và trước các quy tắc hình dạng, nên một Recipe có khóa artifacts: trùng lặp sẽ báo schema hợp lệ rồi đến lần dừng này, và các quy tắc hình dạng còn lại không báo cáo về nó.

Cách khắc phục: đổi tên một trong các khóa mục bị trùng để mỗi mục artifacts: có một tên tệp duy nhất.

Emission-time filename collision across input kinds (Xung đột tên tệp khi xuất giữa các loại đầu vào)

Một Recipe và một FeatureRecipe đều khai báo các loại đầu vào tạo ra tệp: một source: mà provider kết xuất, một workload: mà provider tổng hợp, các mục artifacts:, và một pipeline: mà các bước của nó có thể xuất tệp. Mỗi loại tự chọn tên đầu ra độc lập với các loại khác, và không có gì khai báo rằng các tên đó khác nhau — nên hai trong số chúng có thể tạo ra tệp dưới cùng một tên, và chỉ một trong hai tệp còn lại. Bản build dừng lại và nêu tên đầu ra cùng với mọi khối đã tạo ra nó.

Việc kiểm tra chạy một lần cho mỗi tài liệu xuất tệp, ngay khi việc xuất của chính tài liệu đó hoàn tất và trước khi đầu ra của nó tham gia bất kỳ phần lắp ráp nào. Có ba tài liệu xuất tệp, và mỗi tài liệu được kiểm tra riêng: Recipe của chính một component, FeatureRecipe mà một attachment gắn trên một component, và FeatureRecipe mà một attachment ở phạm vi boundary gắn. Việc tách riêng chúng là điều giúp chẩn đoán nêu đúng tài liệu — các tệp của một attachment được kết xuất dưới danh tính của component chủ, nên một xung đột trong FeatureRecipe của attachment được báo cáo đối với FeatureRecipe đó chứ không phải đối với component chủ.

Mỗi tên xung đột được báo cáo riêng, nên một tài liệu có các khối trùng nhau ở hai tên sẽ báo cáo cả hai. Một phát hiện được định vị tại tài liệu mà bạn sửa để khắc phục: thực thể component đối với một Recipe, và chính FeatureRecipe đối với một attachment, phát hiện này cũng nêu tên attachment — một component hoặc một boundary có thể gắn nhiều attachment.

Một khối xuất nhiều tệp dưới cùng một tên không phải là lần dừng này. Đó là một nguồn đóng góp duy nhất chứ không phải hai khối gặp nhau, và các khóa artifacts: trùng lặp bên trong một khối bị từ chối khi tài liệu được giải mã.

Thông báo được phát ra:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>) (xung đột tên tệp giữa các loại đầu vào: hai khối loại đầu vào đã tạo ra một tệp dưới cùng một tên đầu ra)

Một xung đột trong FeatureRecipe còn mang theo attachment:

filename collision across input kinds: two input-kind blocks produced a file under one output name (output name <filename>, produced by <origin1>, <origin2>, attachment <instance>) (xung đột tên tệp giữa các loại đầu vào: hai khối loại đầu vào đã tạo ra một tệp dưới cùng một tên đầu ra, kèm theo attachment)

Cách khắc phục: đổi tên tệp xung đột trong loại đầu vào mà bạn kiểm soát. Nếu xung đột liên quan đến một tên tệp do Workload chuyển dịch và một mục artifacts:, các tên do Workload chuyển dịch tuân theo quy ước chuyển dịch của provider (ví dụ: <release-name>-deployment.yaml đối với helm, trong đó tên release là {{ .context.rendered_name }}) — hãy chỉnh tên tệp artifacts: thành một tên mà provider không tổng hợp.

An output-label key uses a reserved namespace (Một khóa nhãn đầu ra dùng một namespace dành riêng)

Một Recipe nêu một khóa nhãn dưới aggrega.ai/ hoặc app.kubernetes.io/ — trong outputLabels:, khối gắn các nhãn literal lên đầu ra đã kết xuất, hoặc trong outputComponentLabels:, khối nêu các khóa nhãn component mà giá trị của chúng được đưa lên đầu ra. Cả hai tiền tố đều thuộc không gian khóa nguồn gốc của chính nền tảng: đó là các khóa mà bản build tự gắn, nên một Recipe gắn một khóa như vậy sẽ ghi vào không gian cho biết một tài nguyên đến từ đâu. Việc dành riêng chúng cũng là điều giữ cho tập nhãn của một Recipe tách rời khỏi tập nguồn gốc, để hai tập này không bao giờ phải được đối chiếu khi hợp nhất. Quy tắc này được kiểm tra khi Recipe được tải.

Việc dành riêng chỉ áp dụng cho gốc trần. Một khóa chỉ mang một gốc dành riêng nằm sâu hơn bên trong một namespace của riêng nó — chẳng hạn component.aggrega.ai/hosting — là một không gian khóa khác mà nền tảng không sở hữu, và vẫn có thể được viết.

Thông báo được phát ra. Một điều kiện bao trùm cả hai khối, nên câu của nó không thể nói khối nào đã được viết; lời khuyên sau đó nêu khối bằng cách trích dẫn khóa bạn đã gõ và khối bạn đã gõ nó vào:

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-labels, at .spec.outputLabels). key "<key>" in outputLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (ràng buộc output-labels của recipe: khóa dùng một không gian tên được dành riêng; khóa trong outputLabels dùng một không gian tên được dành riêng, vì aggrega.ai/ và app.kubernetes.io/ được dành riêng cho nguồn gốc của nền tảng)

Một khóa viết trong khối được đưa lên báo cáo dưới tên quy tắc của khối đó và nêu tên khối trong lời khuyên:

recipe output-labels constraint: key uses a reserved namespace (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels). key "<key>" in outputComponentLabels uses a reserved namespace ("aggrega.ai/" and "app.kubernetes.io/" are reserved for platform provenance) (ràng buộc output-labels của recipe: khóa dùng một không gian tên được dành riêng; khóa trong outputComponentLabels dùng một không gian tên được dành riêng, vì aggrega.ai/ và app.kubernetes.io/ được dành riêng cho nguồn gốc của nền tảng)

Các khóa của khối literal được kiểm tra theo thứ tự đã sắp xếp và các khóa của khối được đưa lên theo thứ tự bạn đã viết, nên một Recipe vi phạm quy tắc ở nhiều chỗ luôn báo cáo cùng một chỗ trước.

Cách khắc phục: chuyển khóa vào một namespace bạn sở hữu — tên miền của riêng bạn, hoặc một namespace có tiền tố con như component.aggrega.ai/… — hoặc bỏ nó nếu giá trị bạn muốn là giá trị mà bản build đã tự gắn. Các khóa nguồn gốc mà một tài nguyên đã kết xuất mang theo được liệt kê trong ../providers/well-known-annotations.md; việc đọc lại một khóa không cần khai báo nào trong Recipe.

A promoted component label is also declared literally (Một nhãn component được đưa lên cũng được khai báo literal)

Một Recipe nêu một khóa trong cả outputComponentLabels: và outputLabels:. Hai khối gắn lên cùng một bề mặt nhãn từ các nguồn khác nhau — khối đầu đưa lên giá trị mà component mang, khối sau ghi giá trị mà tác giả Recipe đã gõ — nên một khóa được nêu trong cả hai sẽ có hai giá trị ứng viên và không có gì cho biết giá trị nào thắng. Quy tắc này được kiểm tra khi Recipe được tải, sau quy tắc namespace dành riêng ở trên, nên một Recipe vi phạm cả hai sẽ báo cáo namespace dành riêng trước: cách khắc phục lỗi đó không phụ thuộc vào nội dung của khối kia.

Thông báo được phát ra:

recipe output-component-labels constraint: key is also declared in outputLabels (Recipe <name>:<version>, rule output-component-labels, at .spec.outputComponentLabels.<key>). key "<key>" is promoted through outputComponentLabels and also declared literally in outputLabels; keep whichever source the label should come from and drop the other (ràng buộc output-component-labels của recipe: khóa cũng được khai báo trong outputLabels; khóa được nâng lên qua outputComponentLabels và đồng thời được khai báo trực tiếp trong outputLabels; hãy giữ nguồn mà nhãn cần lấy giá trị và bỏ nguồn còn lại)

Cách khắc phục: quyết định giá trị của nhãn đến từ đâu và xóa khai báo còn lại. Giữ mục outputComponentLabels: khi giá trị nên theo bất cứ thứ gì component mang, để hai component gắn với một Recipe gắn giá trị riêng của chúng; giữ mục outputLabels: khi giá trị là của chính Recipe và giống nhau ở bất cứ nơi nào Recipe được gắn.

Quy tắc hình dạng FeatureRecipe

Một FeatureRecipe tạo đầu ra từ cùng các loại đầu vào như một Recipe, và quy tắc kết hợp bên dưới ràng buộc nó giống như ràng buộc một Recipe. Quy tắc được kiểm tra khi FeatureRecipe được tải, và báo cáo theo hình dạng của một lần dừng về hình dạng Recipe — câu của quy tắc, rồi tài liệu bị lỗi, tên quy tắc, và lời khuyên cho lần xảy ra đó — dưới thẻ CATALOG_ERROR.

Ở đây có chủ ý không có quy tắc phải có ít nhất một loại đầu vào, và đó là điểm khác biệt so với một Recipe. Một FeatureRecipe chỉ khai báo một provider và thứ nó hiện thực là một attachment thuần đấu nối hợp lệ: nó không kết xuất gì, và tác dụng của nó là kết nối mà Feature nó hiện thực mang theo. Một FeatureRecipe chỉ khai báo injectMapping: cũng hợp lệ theo cách tương tự.

A FeatureRecipe’s valuesMapping requires source (valuesMapping của FeatureRecipe yêu cầu source)

Một FeatureRecipe khai báo valuesMapping nhưng không khai báo source. Một values mapping là một lớp phủ, nên khi không có chart, module hay tệp nào để phủ lên thì các giá trị đã ánh xạ không có nơi nào để đến.

Thông báo được phát ra:

FeatureRecipe: valuesMapping requires source (FeatureRecipe <name>:<version>, rule values-mapping, at <path>). declare a source: pointer alongside valuesMapping (or remove the valuesMapping if no overlay is intended) (FeatureRecipe: valuesMapping yêu cầu source, theo quy tắc values-mapping, tại đường dẫn đã nêu. Hãy khai báo con trỏ source: cùng với valuesMapping (hoặc xóa valuesMapping nếu không định dùng lớp phủ nào))

Cách khắc phục: thêm con trỏ source: mà lớp phủ được viết cho nó, hoặc xóa valuesMapping và để attachment thực hiện công việc theo cách khác — artifacts: để xuất các tệp của riêng nó, injectMapping: để định hình lại những gì nó cung cấp, hoặc không dùng cái nào, cho một attachment chỉ thuần nối dây.

A pipeline declares one step id twice (Một pipeline khai báo một id bước hai lần)

Một Recipe hoặc FeatureRecipe khai báo cùng một id trên hai bước của spec.pipeline của nó. Một bước công bố các đầu ra mà nó trả về dưới id của nó, và một bước sau trong cùng pipeline đọc chúng dưới dạng .steps.<id>.outputs, nên hai bước dùng chung một id sẽ khiến bước sau đó đọc đầu ra của bước nào công bố sau cùng trong hai bước, thay vì bước mà bạn muốn.

Quy tắc này áp dụng cho pipeline riêng của một tài liệu. Recipe của một thành phần và các FeatureRecipes được gắn vào thành phần đó chạy pipeline của mình một cách riêng biệt, và mỗi pipeline bắt đầu mà không có đầu ra bước nào, nên một bước của Recipe và một bước của FeatureRecipe được gắn có thể mang cùng một id.

Không schema nào có thể diễn đạt quy tắc này — JSON Schema không có từ khóa nào cho một danh sách mà các mục là duy nhất theo một trong các trường của chúng — nên một trình soạn thảo hiểu schema sẽ chấp nhận một tài liệu như vậy, và việc kiểm tra chạy khi tài liệu được đọc, ngay sau bước kiểm tra schema. Mọi bề mặt đọc một Recipe hoặc FeatureRecipe đều báo cáo nó: aggrega validate trên tệp hoặc trên toàn bộ catalog, một lần build tải catalog, một lần pull tiếp nhận một thực thể được tìm nạp, chẩn đoán của trình soạn thảo, và một lần chỉnh sửa tài liệu, vốn bị từ chối thay vì được ghi. Một tài liệu đồng thời không đạt schema của nó sẽ báo cáo các phát hiện của schema trước, và báo cáo lần từ chối này sau khi chúng được sửa.

Mỗi lần lặp lại là một phát hiện riêng, được định vị tại id bị lặp và nêu tên bước đã khai báo id đó đầu tiên, cùng dòng và cột của nó. Khi một id xuất hiện ba lần, cả hai bước sau đều nêu tên bước đầu tiên.

Thông báo được phát ra, cho một FeatureRecipe có bước thứ hai lặp lại id của bước đầu tiên. Danh mục và mã ngắn của điều kiện này, E0370, đến với bạn trong phần đầu nằm trong ngoặc vuông:

a pipeline declares one step id twice (FeatureRecipe, at <path>); <line>:<column>: spec.pipeline[1].id: step id "<id>" is already declared at spec.pipeline[0].id (line <line>, column <column>). give each step of the pipeline its own id, and point every .steps.<id> reference a later step makes at the step it means (một pipeline khai báo một id bước hai lần; id bước tại spec.pipeline[1].id đã được khai báo tại spec.pipeline[0].id. hãy đặt cho mỗi bước của pipeline một id riêng, và trỏ mọi tham chiếu bước mà một bước sau tạo ra tới đúng bước mà nó muốn chỉ)

Cách khắc phục: đổi tên một trong hai bước, để mỗi id chỉ được khai báo một lần. Sau đó đọc các template with: và when: của mọi bước sau để tìm các tham chiếu .steps.<id> tới id bạn giữ lại, và trỏ mỗi tham chiếu tới bước có đầu ra mà nó muốn chỉ — chính việc đổi tên làm cho đầu ra của hai bước có thể truy cập riêng biệt.

A document declares an API version this compiler no longer reads (Một tài liệu khai báo phiên bản API mà trình biên dịch này không còn đọc nữa)

Dòng apiVersion của một tài liệu khai báo aggrega.ai/v1alpha1. Mọi loại tài liệu có dòng apiVersion đều khai báo aggrega.ai/v1beta1, phiên bản duy nhất mà trình biên dịch này đọc, và không có chuyển đổi nào từ phiên bản trước đó được thực hiện: tài liệu bị từ chối ngay khi được đọc, trước khi bất kỳ điều gì khác được kiểm tra, vì mọi phát hiện khác đều sẽ liên quan đến một phiên bản của tài liệu mà trình biên dịch không đọc.

Mọi bề mặt đọc tài liệu đều báo cáo điều này: aggrega validate, một lần build, một lần pull tiếp nhận thực thể được tải về, chẩn đoán của trình soạn thảo, và một lần chỉnh sửa tài liệu. Một tài liệu khai báo phiên bản mà trình biên dịch chưa từng đọc thì thay vào đó bị lược đồ của loại tài liệu đó từ chối, với mã E0215.

Thông báo được phát ra, cho một Component. Hạng mục và mã ngắn của điều kiện này, E0373, đến với bạn trong phần đầu nằm trong dấu ngoặc vuông:

a document declares an API version this compiler no longer reads (Component, at <path>); 1:1: apiVersion: the document declares aggrega.ai/v1alpha1, and this compiler reads aggrega.ai/v1beta1. change the apiVersion line to apiVersion: aggrega.ai/v1beta1 (một tài liệu khai báo phiên bản API mà trình biên dịch này không còn đọc nữa (Component); 1:1: apiVersion: tài liệu khai báo aggrega.ai/v1alpha1, và trình biên dịch này đọc aggrega.ai/v1beta1. hãy đổi dòng apiVersion thành aggrega.ai/v1beta1)

Cách khắc phục: đổi dòng apiVersion của tài liệu thành apiVersion: aggrega.ai/v1beta1. Các trường của mỗi loại không thay đổi giữa hai phiên bản, nên dòng này là toàn bộ thay đổi.

A plugin declares a plugin ABI version this compiler no longer speaks (Một plugin khai báo phiên bản ABI plugin mà trình biên dịch này không còn hỗ trợ nữa)

Một plugin khai báo ABI plugin v1alpha1. Trình biên dịch này hỗ trợ ABI plugin v1beta1 và không hỗ trợ ABI nào khác, nên một plugin được build theo ABI trước đó sẽ bị từ chối thay vì được chạy. Một plugin nêu ABI của nó ở hai nơi, và mỗi nơi đều bị từ chối theo cùng một điều kiện này: báo cáo describe() mà mô-đun guest của nó trả về khi được tải, và trường spec.abiVersion của thực thể Plugin của nó, bị từ chối khi thực thể được đọc, trước khi bất kỳ điều gì khác được kiểm tra. Một plugin khai báo phiên bản ABI mà trình biên dịch này chưa từng hỗ trợ cũng bị từ chối, bởi bước kiểm tra bộ mô tả (E0085) hoặc bởi lược đồ Plugin (E0215).

Thông báo được phát ra, cho một mô-đun guest khi tải. Hạng mục và mã ngắn của điều kiện này, E0374, đến với bạn trong phần đầu nằm trong dấu ngoặc vuông:

plugin "<plugin>" declares abi_version “v1alpha1”, and this compiler speaks “v1beta1”; rebuild the plugin against the current plugin kit and publish it again: a plugin declares a plugin ABI version this compiler no longer speaks (plugin khai báo abi_version “v1alpha1”, và trình biên dịch này hỗ trợ “v1beta1”; hãy build lại plugin theo bộ công cụ plugin hiện tại và phát hành lại: một plugin khai báo phiên bản ABI plugin mà trình biên dịch này không còn hỗ trợ nữa)

Thông báo được phát ra, cho một thực thể Plugin:

a plugin declares a plugin ABI version this compiler no longer speaks (Plugin, at <path>); <line>:<column>: spec.abiVersion: the Plugin declares abiVersion v1alpha1, and this compiler speaks v1beta1. rebuild the plugin against the current plugin kit and publish it again; its Plugin entity then declares abiVersion: v1beta1 (một plugin khai báo phiên bản ABI plugin mà trình biên dịch này không còn hỗ trợ nữa (Plugin); spec.abiVersion: Plugin khai báo abiVersion v1alpha1, và trình biên dịch này hỗ trợ v1beta1. hãy build lại plugin theo bộ công cụ plugin hiện tại và phát hành lại; khi đó thực thể Plugin của nó khai báo abiVersion v1beta1)

Cách khắc phục: build lại plugin theo phiên bản hiện tại của bộ công cụ plugin của nó, phiên bản này ghi v1beta1 vào báo cáo describe() của mô-đun guest, rồi phát hành lại plugin, để thực thể được tạo bên cạnh nó cũng khai báo abiVersion: v1beta1. Chỉ chỉnh sửa dòng của thực thể là không đủ: bản thân mô-đun guest vẫn báo cáo ABI trước đó và bị từ chối khi được tải.

An artifact carries a media type this compiler no longer reads (Một artifact mang kiểu media mà trình biên dịch này không còn đọc nữa)

Một artifact được tải về từ registry mang một kiểu media mà một phiên bản trước đó đã dùng để phát hành — application/vnd.aggrega.<kind>.v1alpha1 kèm hậu tố của nó, trên kiểu artifact của manifest, trên cấu hình của nó hoặc trên một trong các lớp của nó. Trình biên dịch này phát hành và đọc các kiểu media v1beta1, nên artifact bị từ chối kèm theo tên ngay khi manifest của nó được đọc, trước khi bất kỳ phần nội dung nào của nó được lấy: dù đó là một thực thể danh mục, một plugin cùng tệp thực thi của nó, hay một gói tài liệu. Việc lập chỉ mục một registry sẽ bỏ qua artifact như vậy, kèm theo lý do. Một kiểu media nằm ngoài không gian tên application/vnd.aggrega. riêng của Aggrega không bao giờ thuộc điều kiện này.

Thông báo được phát ra, cho một Component được phát hành bởi một phiên bản trước đó. Hạng mục và mã ngắn của điều kiện này, E0375, đến với bạn trong phần đầu nằm trong dấu ngoặc vuông:

"<reference>" carries media type “application/vnd.aggrega.component.v1alpha1+yaml”, and this compiler reads “application/vnd.aggrega.component.v1beta1+yaml”; publish the artifact again with the current release: oci: artifact carries a media type this compiler no longer reads (mang kiểu media “application/vnd.aggrega.component.v1alpha1+yaml”, và trình biên dịch này đọc “application/vnd.aggrega.component.v1beta1+yaml”; hãy phát hành lại artifact bằng phiên bản hiện tại: oci: artifact mang kiểu media mà trình biên dịch này không còn đọc nữa)

Cách khắc phục: phát hành lại artifact bằng phiên bản hiện tại của aggrega, phiên bản này ghi các kiểu media v1beta1. Một artifact do người khác phát hành thì người đó phải phát hành lại; cho đến khi họ làm vậy, artifact đó không thể được đọc.

A file cannot be read, or its bytes do not parse (Không thể đọc một tệp, hoặc không phân tích được các byte của nó)

Một tệp mà bản build phải đọc, hoặc một tài liệu Aggrega mà một lần kiểm tra toàn catalog đã đọc dưới các thư mục catalog, không mang lại gì mà bề mặt đã nêu tên hoặc đọc nó có thể dùng được. Hoặc tệp không thể đọc từ đĩa, hoặc các byte của nó đã được phân tích nhưng không phân tích trọn vẹn. Không có gì ở phía sau chạy trên tệp đó, vì không có nội dung để kiểm tra theo schema, không có component để đặt, và không có template để render.

Điều kiện này không nêu định dạng nào, và đó là có chủ ý. Phần lớn các tệp mà nó bao quát được đọc dưới dạng YAML; các phần thân workload, values-mapping và artifact của một Recipe được đọc dưới dạng mã nguồn Go template và hoàn toàn không bao giờ được phân tích. Một câu hứa hẹn YAML sẽ mở đầu một chẩn đoán về tệp template bằng một khẳng định về định dạng của tệp đó. Lỗi nào trong hai lỗi đã xảy ra, và với loại tệp nào, là điều mà mệnh đề sau câu đó cho biết.

Các tài liệu mà một bản build bắt đầu từ đó — Aggregate, Release và Manifest — là đối tượng phổ biến nhất, và điểm dừng này được phát ra tại mọi điểm mà một trong ba tài liệu đó được đọc. Chẩn đoán nêu tài liệu nào đang được đọc và đường dẫn mà nó được đọc từ đó. Đường dẫn là thứ giúp phân biệt tệp bị thiếu với tệp bị hỏng: lỗi đọc trích dẫn lý do của chính hệ điều hành, còn lỗi phân tích trích dẫn lý do của trình phân tích YAML, trong đó có dòng mà trình phân tích dừng lại.

Thông báo được phát ra, khi không thể đọc tệp:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to read file: <underlying reason>) (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó (Aggregate, tại <path>, không đọc được tệp: <underlying reason>))

và khi văn bản của tệp không phân tích được:

file load failed: the file could not be read, or its bytes did not parse (Aggregate, at <path>, failed to unmarshal YAML: <underlying reason>) (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó (Aggregate, tại <path>, không unmarshal được YAML: <underlying reason>))

Release và Manifest xuất hiện thay cho Aggregate khi một trong hai là tài liệu đang được đọc. Cùng điều kiện này cũng bao quát hợp đồng tham số được đọc từ khối parameters: mà một Aggregate khai báo, khối này được đọc từ chính văn bản của Aggregate trước khi bất cứ thứ gì được nội suy vào đó.

Một parameters: { $import: … } của Release nêu tên một tệp mà bản build không lấy được cũng báo cáo tại đây, và ở cả hai trường hợp: đường dẫn không chỉ tới tệp nào bản build đọc được, hoặc tệp được đọc nhưng các byte của nó không phân tích được. Release là đối tượng, và mệnh đề nêu khóa đã trỏ tới tệp:

file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to read file: <underlying reason>) (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó (Release, tại .spec.parameters.$import: <path>, không đọc được tệp: <underlying reason>)) file load failed: the file could not be read, or its bytes did not parse (Release, at .spec.parameters.$import: <path>, failed to unmarshal YAML: <underlying reason>) (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó (Release, tại .spec.parameters.$import: <path>, không unmarshal được YAML: <underlying reason>))

Đường dẫn tương đối được phân giải từ thư mục chứa Release viết ra nó — Release mà một lệnh nêu tên, hoặc một mắt xích trong chuỗi extends: của nó — bất kể lệnh được chạy từ đâu, nên dòng lệnh và trình soạn thảo đọc cùng một tệp; đường dẫn tuyệt đối tự chỉ ra vị trí của nó. Hãy xác nhận bản checkout mà bản build chạy trên đó có chứa tệp ở vị trí đó: một tệp parameters có trên máy của bạn nhưng bị loại khỏi quản lý phiên bản sẽ vắng mặt trong lần chạy tích hợp liên tục, và đây là cách thường gặp lỗi này. Đường dẫn dẫn ra ngoài workspace — hoặc, với Release được nêu tên bên ngoài workspace, ra ngoài thư mục của chính Release đó — hoàn toàn không được đọc, và được báo cáo dưới mục “A reference to another file leads out of the directory it must stay inside (Một tham chiếu tới tệp khác dẫn ra ngoài thư mục mà nó phải nằm bên trong)” bên dưới.

Một $import: của schema nêu tên một tệp mà bản build không lấy được cũng báo cáo tại đây, vì lỗi là một: chỉ thị đúng cú pháp và tệp mà nó nêu không mang lại tài liệu nào. Khi đó đối tượng là một thực thể catalog chứ không phải một trong ba tài liệu kia, nên mệnh đề nêu bề mặt schema mà nó đang phân giải — spec.schema, một trụ cột của nó như spec.schema.values, hoặc valueSchema của một socket usesSchema — và con trỏ nguồn là dòng nơi chỉ thị được viết:

file load failed: the file could not be read, or its bytes did not parse. <surface>: read imported schema <value>: <the operating system's reason> (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó. <surface>: đọc schema được import <value>: <the operating system's reason>)

với resolve imported schema path thay cho read trong trường hợp hiếm hơn là hoàn toàn không xác lập được thư mục của chính thực thể, và parse imported schema khi tệp đã được đọc nhưng văn bản của nó không phải YAML đúng cú pháp. Lỗi trong chỉ thị bạn viết — một khóa anh em bên cạnh nó, một giá trị không phải đường dẫn, hoặc nội dung import phân tích được nhưng không phải map — là một điều kiện khác và được báo cáo dưới mục “A schema $import: cannot be applied (Không thể áp dụng một $import: của schema)” bên dưới.

Một import valuesMapping:, workload: hoặc artifacts.<name>: của Recipe hoặc FeatureRecipe cũng báo cáo tại đây, vì cùng lý do và với cùng cách khắc phục: chỉ thị đúng cú pháp và tệp mà nó nêu không mang lại nội dung. Ba phần thân đó là mã nguồn Go template chứ không phải tài liệu, nên chỉ việc đọc có thể thất bại — không có gì phân tích chúng ở thời điểm này. Thực thể và khóa đã nêu đường dẫn nằm trong mệnh đề, và con trỏ nguồn là đường dẫn của chính tệp được import:

file load failed: the file could not be read, or its bytes did not parse (Recipe <name> valuesMapping file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó (Recipe <name> import tệp valuesMapping, <the operating system's reason>). nếu bạn muốn một mục thư viện chứ không phải một tệp, tham chiếu cần có fragment — một $import: không có fragment được đọc như đường dẫn tệp, và một giá trị không có dấu ngoặc kép kết thúc tại nơi một khoảng trắng trước # bắt đầu chú thích, vì vậy hãy đặt toàn bộ tham chiếu trong dấu ngoặc kép) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> workload file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó (Recipe <name> import tệp workload, <the operating system's reason>). nếu bạn muốn một mục thư viện chứ không phải một tệp, tham chiếu cần có fragment — một $import: không có fragment được đọc như đường dẫn tệp, và một giá trị không có dấu ngoặc kép kết thúc tại nơi một khoảng trắng trước # bắt đầu chú thích, vì vậy hãy đặt toàn bộ tham chiếu trong dấu ngoặc kép) file load failed: the file could not be read, or its bytes did not parse (Recipe <name> artifact <key> file import, <the operating system's reason>). if you meant a library entry rather than a file, the reference needs its fragment — an $import: carrying none is read as a file path, and an unquoted value ends where a space before # starts a comment, so quote the whole reference (tải tệp thất bại: không thể đọc tệp, hoặc không phân tích được các byte của nó (Recipe <name> import tệp artifact <key>, <the operating system's reason>). nếu bạn muốn một mục thư viện chứ không phải một tệp, tham chiếu cần có fragment — một $import: không có fragment được đọc như đường dẫn tệp, và một giá trị không có dấu ngoặc kép kết thúc tại nơi một khoảng trắng trước # bắt đầu chú thích, vì vậy hãy đặt toàn bộ tham chiếu trong dấu ngoặc kép)

Fragment là thứ phân biệt một tham chiếu thư viện với một đường dẫn: <Library>#/mappings/<entry> được phân giải theo các thư viện, còn cùng văn bản đó khi mất fragment là một đường dẫn tương đối thông thường. Fragment dễ bị mất mà không nhận ra, vì một giá trị YAML thuần kết thúc tại nơi một khoảng trắng trước # mở đầu chú thích — nên $import: LibBeta:1.0.0 #/workloads/Web đến bản build dưới dạng LibBeta:1.0.0, và bản build khi đó tìm một tệp có tên đó bên cạnh Recipe. Hãy đặt toàn bộ tham chiếu trong dấu ngoặc kép để giữ fragment.

Cùng ba khóa đó trên một FeatureRecipe báo cáo cùng điều kiện và được hiểu theo cùng cách. Một import artifacts được đọc hai lần trong vòng đời của một Release — một lần khi aggrega pull cố định content pin của nó, và lần nữa khi mục đó được render — nên cùng một tệp bị thiếu báo cáo điều kiện này ở lần nào bạn gặp trước. Lỗi hình dạng trong chính chỉ thị, như một khóa anh em bên cạnh $import: hoặc một tham chiếu oci:// có chứa host, là một điều kiện khác và được báo cáo dưới mục riêng của nó.

aggrega lint và aggrega validate trên toàn catalog cũng báo cáo ở đây, đối với một tài liệu dưới các thư mục catalog có khai báo apiVersion của Aggrega — một dòng bắt đầu, không thụt lề, bằng apiVersion: và một giá trị bắt đầu bằng aggrega.ai/ — mà không thể đọc, không phân tích được, hoặc không giải mã được thành envelope mà lần kiểm tra đọc, chẳng hạn một metadata viết dưới dạng danh sách. Không tác giả nào viết đường dẫn tới nó: lần kiểm tra đọc nó vì nó nằm trong một thư mục catalog. Mỗi lần kiểm tra đọc mọi tệp trước khi dừng, nên một lần chạy nêu tên mọi tài liệu như vậy, và không kiểm tra gì khác cũng không in bản tóm tắt. YAML không khai báo apiVersion của Aggrega — trong đó có các template của một Helm chart — được bỏ qua. Phần đầu đếm số tài liệu và nêu tên các tệp của chúng, và mỗi tài liệu được liệt kê bên dưới cùng lý do của chính thao tác đọc hoặc bộ phân tích:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (các tài liệu dưới các thư mục catalog khai báo apiVersion của Aggrega nhưng không thể tải, nên không có gì được kiểm tra) file load failed: the file could not be read, or its bytes did not parse (catalog document, failed to unmarshal YAML: <the parser's reason>) (tải tệp thất bại: không thể đọc tệp, hoặc các byte của nó không phân tích được (tài liệu catalog, giải mã YAML thất bại))

với failed to decode the envelope: cùng dòng và thứ bộ giải mã tìm thấy ở đó — line 4 (metadata): a list is written where a map is expected đối với một metadata viết dưới dạng danh sách — cho một tài liệu phân tích được nhưng không giải mã được, và failed to read file: cùng lý do của hệ điều hành cho một tệp không thể đọc. Một tài liệu tải được nhưng khai báo một loại mà không catalog nào chứa được nêu tên bởi cùng lần dừng đó, được đếm trong cùng phần đầu, và được liệt kê dưới điều kiện riêng của nó — xem “A catalog document declares a kind a catalog does not hold (Một tài liệu catalog khai báo một loại mà catalog không chứa)” bên dưới.

Cách khắc phục: hãy đọc đường dẫn trong thông báo thay vì tên tài liệu — hai thứ này khác nhau mỗi khi một tham chiếu được phân giải tới nơi không ngờ. Với lỗi đọc, hãy xác nhận tệp tồn tại ở đường dẫn đó, đường dẫn được viết đúng như tài liệu tham chiếu viết, và bản build có quyền đọc nó; một tệp có ở máy cục bộ nhưng không có trong bản checkout của build agent là trường hợp thường gặp. Với lỗi phân tích, hãy mở tệp tại dòng mà trình phân tích nêu — một giá trị không có dấu ngoặc kép chứa dấu hai chấm, một tab dùng để thụt lề, và một mục danh sách thụt lề dưới sai khóa là ba nguyên nhân chiếm phần lớn các trường hợp.

A catalog document declares a kind a catalog does not hold (Một tài liệu catalog khai báo một loại mà catalog không chứa)

Một tài liệu dưới các thư mục catalog khai báo một apiVersion Aggrega — một dòng bắt đầu, không thụt lề, bằng apiVersion: và một giá trị bắt đầu bằng aggrega.ai/ — và một kind mà không catalog nào chứa: một lỗi chính tả như Componnent, một loại viết sai hoa thường như component, hoặc hoàn toàn không có kind. Một catalog xếp mỗi tài liệu dưới loại mà nó khai báo, nên một tài liệu như vậy không vào catalog nào: một lần build, inspect và mọi lệnh khác tải catalog đều bỏ qua nó, và một tham chiếu tới thực thể mà nó định khai báo sẽ không phân giải được tới thứ gì.

Một catalog chứa các tài liệu Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate và Plugin. Ba loại khác nằm hợp lệ trong các thư mục của nó và không bao giờ bị báo cáo ở đây: một Manifest và một Release được đặt cạnh các thực thể, và một Workload trong thư mục của Recipe hoặc FeatureRecipe nhập nó.

aggrega validate và aggrega lint trên toàn catalog, cùng lint theo phạm vi Release, vốn duyệt cùng các thư mục, đều báo cáo nó. Mỗi lệnh đọc mọi tệp trước khi dừng, nên một lần chạy nêu tên mọi tài liệu như vậy cùng với bất kỳ tài liệu nào hoàn toàn không tải được, dưới một phần đầu duy nhất đếm chúng và nêu tên các tệp của chúng; không có gì được kiểm tra và không có bản tóm tắt nào được in. Mỗi tài liệu được liệt kê cùng loại mà nó khai báo, và dòng đó kết thúc bằng các loại mà một catalog chứa:

<n> documents under the catalog directories declare an Aggrega apiVersion and could not be loaded, so nothing was checked: <path>, <path> (các tài liệu dưới các thư mục catalog khai báo một apiVersion Aggrega và không tải được, nên không có gì được kiểm tra) catalog document declares a kind a catalog does not hold (kind “Componnent”). a catalog holds Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate and Plugin documents, and passes over a Workload, a Manifest or a Release; correct the kind, or move the file out of the catalog directories (tài liệu catalog khai báo một loại mà catalog không chứa. một catalog chứa các tài liệu Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary, Aggregate và Plugin, và bỏ qua một Workload, một Manifest hoặc một Release; hãy sửa loại, hoặc di chuyển tệp ra khỏi các thư mục catalog)

với no kind thay cho kind "<kind>" đối với một tài liệu không khai báo loại nào.

Một lần build không dừng lại trước một tài liệu như vậy: nó bỏ qua tài liệu đó như mọi lần tải, và một tài liệu mà không Release nào chạm tới thì không bao giờ làm build thất bại. Khi một Release thực sự chạm tới thực thể đó, build dừng tại tham chiếu, theo mục “A reference names no entity the catalog holds (Một tham chiếu không chỉ tới thực thể nào mà catalog chứa)” bên dưới, và ghi chú bên dưới lỗi đó nêu tên tệp khi tệp khai báo tên mà tham chiếu yêu cầu — xem mục đó.

Cách khắc phục: mở tệp mà thông báo nêu tên và sửa kind của nó thành đúng loại của tài liệu — cả chính tả lẫn chữ hoa chữ thường đều có ý nghĩa. Một tệp hoàn toàn không phải là thực thể catalog thì không nên nằm dưới các thư mục catalog; hãy di chuyển nó ra ngoài, hoặc nếu đó là tài liệu của một công cụ khác, hãy cho nó một apiVersion không phải của Aggrega.

Một đường dẫn trỏ tới nội dung nằm ngoài thư mục riêng của thực thể

Nội dung của một thực thể nằm trong thư mục riêng của thực thể đó, vì mọi tệp mà một bản phát hành của thực thể mang theo đều được lấy từ đó. Một đường dẫn rời khỏi thư mục này sẽ trỏ tới một tệp không đi cùng thực thể, nên tệp đó không có mặt với bất kỳ ai nhận thực thể, và một pin được ghi lại trên nó sẽ bảo chứng cho những byte mà họ không thể lấy được.

Vì vậy, mọi đường dẫn mà một thực thể viết cho nội dung nó mang theo đều được đọc tương đối với thư mục chứa tệp của thực thể và phải nằm trong thư mục đó. Điều này bao gồm source: của một Recipe và của một FeatureRecipe — một đường dẫn trần, hoặc url: của dạng có cấu trúc — tệp mà mỗi mục valuesMapping:, workload: và artifacts: nhập bằng $import:, và mọi schema mà một Component hoặc một Feature nhập, toàn bộ, theo từng trụ cột, hoặc cho valueSchema và infraSchema của một socket usesSchema. Có ba dạng rời khỏi thư mục: một đường dẫn leo lên trên thư mục, một đường dẫn tuyệt đối, vốn chỉ một vị trí trên máy nơi nó được viết, và một đường dẫn viết bên trong thư mục nhưng bị một liên kết tượng trưng trên đường đi đưa ra ngoài — một thư mục dọc theo đường dẫn, cũng như tệp ở cuối đường dẫn, là một liên kết dẫn ra ngoài thư mục của thực thể. Một đường dẫn leo lên rồi quay lại bên trong — ./charts/../values.tmpl — là một đường dẫn bình thường bên trong thư mục, và một đường dẫn đi qua một liên kết dẫn tới chỗ khác bên trong thư mục cũng vậy. Một lần leo lên rồi vào lại thư mục bằng chính tên của nó — ../1.0.0/values.tmpl được viết trong một thư mục tên 1.0.0 — bị từ chối, vì tên của thư mục không thuộc phần được mang đi: một thực thể đã phát hành được đọc từ một thư mục do bộ nhớ đệm của bên sử dụng đặt tên, nơi tên đó không tìm thấy gì. Một đường dẫn đi qua một liên kết dẫn ra ngoài bị từ chối vì nếu không, một bản phát hành sẽ mang theo những byte mà liên kết trỏ tới, từ bất cứ đâu nó trỏ tới, dưới một cái tên bên trong thực thể.

Nó bị từ chối ở bất cứ đâu thực thể được đọc. Một lệnh aggrega validate trên toàn bộ catalog, aggrega validate trên chính tệp của thực thể, aggrega pull và aggrega build từ chối nó khi tệp của thực thể được đọc, và aggrega pin một Recipe hoặc một FeatureRecipe cùng aggrega push bất kỳ kiểu nào trong bốn kiểu cũng vậy, trước khi bất cứ thứ gì được tải về, ghi ra hoặc phát hành. Một source: được viết dưới dạng template chưa chỉ tới gì cho đến khi bản build đánh giá nó, nên một template tạo ra đường dẫn ngoài thư mục bị bản build từ chối, vào thời điểm giá trị đó tồn tại.

Một Release thì khác, và một tham chiếu thực thể cũng vậy. Một Release trỏ tới các thực thể khác — Aggregate của nó, Manifest của nó, Release mà nó mở rộng — và không bao giờ được phát hành, nên không gì nó đọc được mang đi đâu cả: những đường dẫn đó, và tệp mà parameters: của một Release nhập, được đọc đúng như đã viết. type của một Aggregate chỉ tới một thực thể khác theo định danh của nó chứ không phải nội dung mà Aggregate mang theo, và cũng được phân giải theo cách riêng của nó: qua các thư mục catalog, bộ nhớ đệm và registry, không bao giờ như một đường dẫn tệp.

Thông báo được phát ra, nêu đường dẫn đúng như đã viết:

a path names content outside the entity’s own directory ("<path>"). remediation: move the file into the directory holding the entity, or a directory beneath it, and name it with a path relative to that directory. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a path that leaves it points at a file that would not travel with the entity (một đường dẫn trỏ tới nội dung nằm ngoài thư mục riêng của thực thể. khắc phục: di chuyển tệp vào thư mục chứa thực thể, hoặc một thư mục bên dưới nó, và gọi tệp bằng một đường dẫn tương đối với thư mục đó. Nội dung của một thực thể nằm trong thư mục riêng của nó vì mọi tệp mà một bản phát hành của nó mang theo đều được lấy từ đó; một đường dẫn rời khỏi thư mục trỏ tới một tệp sẽ không đi cùng thực thể)

và, với một đường dẫn bị một liên kết đưa ra khỏi thư mục, nêu liên kết đó và nơi nó dẫn tới:

a path names content outside the entity’s own directory ("./frag/fragment.yaml", the link <entity-directory>/frag leads to <elsewhere>/frag). remediation: replace the link with a copy of what it leads to, placed inside the directory holding the entity. An entity’s content lives in the entity’s own directory because every file a publication of it carries is taken from there; a link leading out of it would carry the bytes it points at under a name inside the entity (một đường dẫn trỏ tới nội dung nằm ngoài thư mục riêng của thực thể, liên kết dẫn ra chỗ khác. khắc phục: thay liên kết bằng một bản sao của thứ nó dẫn tới, đặt bên trong thư mục chứa thực thể. Nội dung của một thực thể nằm trong thư mục riêng của nó vì mọi tệp mà một bản phát hành của nó mang theo đều được lấy từ đó; một liên kết dẫn ra ngoài sẽ mang theo những byte nó trỏ tới dưới một cái tên bên trong thực thể)

Trường mà đường dẫn được đọc từ đó được nêu trên dòng phía trên thông báo: resolve Recipe source …, resolve Recipe artifact "<key>" $import target …, spec.schema.values: imported schema …, hoặc, với một source dạng template, node "<name>" source.

Cách khắc phục: di chuyển tệp vào thư mục của thực thể, hoặc một thư mục bên dưới nó, và viết đường dẫn của tệp tương đối với thư mục đó. Khi một liên kết đưa đường dẫn ra ngoài, hãy thay liên kết bằng một bản sao của thứ nó dẫn tới, đặt bên trong thư mục của thực thể. Một chart được nhiều Recipes dùng chung được sao chép vào thư mục của từng Recipe, vì mỗi Recipe được phát hành riêng; một schema được nhiều Components dùng chung thuộc về một SchemaLibrary, mà mỗi Component sau đó tham chiếu theo định danh, và một nội dung mapping, workload hoặc artifact được nhiều Recipes dùng chung thuộc về kiểu library tương ứng.

source: của một Recipe nêu một loại mà không thành phần nào biết cách thu nhận

source: của một Recipe cho biết loại thứ mà nó trỏ tới — một chart, một module, một dự án compose — và mỗi loại được thu nhận bởi source adapter phục vụ loại đó. Điều kiện này báo cáo một loại mà không source adapter nào phục vụ, nên không thứ gì chương trình này mang theo có thể tải nguồn về. source: của một FeatureRecipe tuân theo cùng quy tắc.

Nó bị từ chối khi tài liệu được đọc, trước khi bất cứ thứ gì được tải về: kiểm tra riêng Recipe sẽ từ chối nó, và mọi Release đi tới nó cũng vậy. Không có gì được thử, vì không có gì có thể thử — đó là điều phân biệt nó với một lần thu nhận đã chạy và thất bại.

Thông báo được phát ra, nêu tài liệu, loại như đã viết và các loại được phục vụ:

no source adapter serves the source kind (Recipe <name>:<version>, rule source-kind, at <file>). the source names kind "<kind>"; name a kind a source adapter serves (<the served kinds>), or write the source as a single URI whose shape names its kind (không source adapter nào phục vụ loại nguồn này (Recipe, quy tắc source-kind). nguồn nêu loại này; hãy nêu một loại mà một source adapter phục vụ, hoặc viết nguồn thành một URI duy nhất có hình dạng cho biết loại của nó)

Cách khắc phục: sửa loại trong source: thành một loại mà bộ công cụ phục vụ — một lỗi chính tả và một loại thực sự không có adapter tạo ra cùng một thông báo, và thông báo trích dẫn loại như bạn đã viết bên cạnh các loại được phục vụ, nên điều đầu tiên cần kiểm tra là đối chiếu cách viết với danh sách đó, vốn cũng được mô tả trong trang Recipe. Nếu loại được viết đúng như bạn định, thì đó không phải loại mà bản build này có thể thu nhận, và không thay đổi nào khi soạn Recipe làm được điều đó; thay vào đó hãy trỏ source: tới một dạng được phục vụ, hoặc viết nó thành một URI duy nhất có hình dạng cho biết loại của nó.

No source adapter is registered in this program for a source kind (Không có source adapter nào được đăng ký trong chương trình này cho một loại nguồn)

Một nguồn được tải về bởi adapter đã đăng ký cho loại của nó. Điều kiện này báo cáo một lần tải được điều phối tới một loại không có adapter nào được đăng ký. Một loại được viết mà không adapter nào phục vụ sẽ bị từ chối khi Recipe của nó được đọc (xem “A Recipe’s source: names a kind nothing knows how to acquire (Nguồn của một Recipe nêu một loại mà không gì biết cách thu nhận)” ở trên), nên không gì tác giả viết đi tới được đây: điều kiện này báo cáo một chương trình được lắp ráp thiếu adapter cho một loại mà nó phục vụ, hoặc một chương trình xây trên các gói Go của Aggrega điều phối một loại do chính nó lắp ráp.

Thông báo được phát ra, nêu loại:

kind "<kind>": no source adapter is registered in this program for the source kind (không có source adapter nào được đăng ký trong chương trình này cho loại nguồn này)

Cách khắc phục: không gì trong các tệp thực thể của bạn gây ra điều này. Hãy báo cáo cho người đã build tệp nhị phân bạn đang chạy.

A source URL carries a credential (URL nguồn mang theo thông tin xác thực)

Một url nguồn được ghi lại đúng như bạn đã viết — trong lockfile của Release, trong entity.lock bên cạnh Recipe và trong bộ nhớ đệm nguồn — và bản thân Recipe là một tệp bạn commit và có thể phát hành. Vì vậy một thông tin xác thực viết vào URL sẽ đi tới mọi nơi URL đi tới. Điều kiện này báo cáo source: của một Recipe có url viết một người dùng trước host: https://user:token@host/…, hoặc một token viết riêng như https://token@host/…, vì một dịch vụ truy cập qua HTTP thường nhận token ở vị trí của người dùng. Với http và https, bất kỳ người dùng nào viết ở đó đều được tính; với scheme khác chỉ mật khẩu được tính, vì một người dùng viết riêng ở đó nêu một tài khoản — ssh://git@github.com/… được chấp nhận, và SSH agent cung cấp khóa của nó. source: của một FeatureRecipe tuân theo cùng quy tắc.

Nó bị từ chối khi tài liệu được đọc, trước khi bất cứ thứ gì được tải về: kiểm tra riêng Recipe sẽ từ chối nó, và mọi Release đi tới nó cũng vậy, trong một lần xác thực, pull, pin hay build. Thông báo nêu host và không bao giờ nêu thông tin xác thực. Lần kiểm tra chỉ đọc phần URL viết trước host và không gì khác, nên một token nằm trong chuỗi truy vấn hoặc đường dẫn sẽ không bị phát hiện — và được ghi lại như đã viết, giống phần còn lại của URL.

Thông báo được phát ra qua http hoặc https, nêu tài liệu, khóa và host, rồi nơi thông tin xác thực nên được đặt:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a user or password for host <host>; remove it from the URL and write the credential in the netrc file instead, as an entry “machine <host> login <user> password <secret>” (the file NETRC names, else .netrc in your home directory, or _netrc in %USERPROFILE% on Windows) (URL nguồn mang theo thông tin xác thực (Recipe, quy tắc source-url). spec.source.url nêu một người dùng hoặc mật khẩu cho host; hãy xóa nó khỏi URL và thay vào đó viết thông tin xác thực vào tệp netrc dưới dạng một mục machine, login, password (tệp mà NETRC chỉ định, nếu không thì .netrc trong thư mục home, hoặc _netrc trong %USERPROFILE% trên Windows))

và qua scheme khác, khi cách khắc phục là xóa mật khẩu:

the source URL carries a credential (Recipe <name>:<version>, rule source-url, at <file>). spec.source.url names a password for host <host>; remove it from the URL, which is written into the lockfile and the cache as authored (URL nguồn mang theo thông tin xác thực (Recipe, quy tắc source-url). spec.source.url nêu một mật khẩu cho host; hãy xóa nó khỏi URL, vốn được ghi vào lockfile và bộ nhớ đệm đúng như đã viết)

Cách khắc phục: xóa người dùng và mật khẩu khỏi url, chỉ để lại URL nêu host. Với một nguồn được tải qua http hoặc https, hãy đặt thông tin xác thực vào một mục machine cho host đó trong tệp netrc của bạn, tệp được đọc mỗi lần tải một kho Helm chart cổ điển, một đoạn compose hoặc một kho Git qua HTTP hoặc HTTPS — Xác thực mô tả tệp nào và mục nào. Với một kho Git qua SSH, SSH agent cung cấp khóa, và người dùng có thể giữ nguyên. Nếu Recipe đã được commit hoặc phát hành kèm thông tin xác thực, thông tin xác thực đã nằm trong lịch sử đó: hãy thay đổi nó cả trên máy chủ.

A {{ .parameters.* }} reference cannot be interpolated (Không thể nội suy một tham chiếu {{ .parameters.* }})

Văn bản của Aggregate được đánh giá như một template trước khi được đọc như một tài liệu, để một tham chiếu {{ .parameters.<key> }} được thay bằng giá trị mà Release cung cấp cho nó. Lỗi dừng này xảy ra khi quá trình đánh giá đó không thể hoàn tất: văn bản không phân tích được như một template, hoặc phân tích được nhưng thất bại khi chạy.

Việc nội suy diễn ra trước khi Aggregate được phân tích dưới dạng YAML, vì vậy một lỗi ở đây được báo cáo cho toàn bộ Aggregate thay vì tại một khóa bên trong nó — tại thời điểm đó tài liệu chưa có khóa nào. Đó cũng là lý do tham chiếu có thể để không có dấu nháy: việc thay thế diễn ra trên các byte thô, và quy tắc đặt dấu nháy của chính YAML sau đó quyết định kiểu của giá trị, nên một tham chiếu trần cho ra kiểu tự nhiên của giá trị còn một tham chiếu có dấu nháy cho ra một chuỗi.

Một tham chiếu nêu tên một khóa mà Release không cung cấp không phải là lỗi dừng này. Một khóa vắng mặt được phân giải thành giá trị rỗng ở đây và bị phát hiện, cùng với kiểu và hợp đồng của nó, bởi các kiểm tra tham số được mô tả trong “Parameter type mismatch / contract violation (Kiểu tham số không khớp / vi phạm hợp đồng)” ở trên. Điều lỗi dừng này báo cáo là văn bản mà công cụ template hoàn toàn không xử lý được — một {{ chưa đóng, một tên hàm viết sai, một pipeline có các giai đoạn không khớp với nhau. Đọc một tham số qua index — {{ index .parameters "db_size" }} — khi Release không cung cấp tham số đó là một lỗi khi chạy, và lỗi dừng này mang nó, nêu tên khóa: index dừng khi gặp một khóa mà map không chứa trên mọi bề mặt template, như “A template indexes a map with a key the map does not hold (Một template truy cập map bằng một khóa mà map không chứa)” mô tả ở dưới.

Văn bản hoàn toàn không phân tích được sẽ bị từ chối kèm theo đường dẫn của chính Aggregate, vì tệp đó đã có sẵn trước khi bất cứ thứ gì đọc nó. Một module mà phần kết hợp import được đánh giá theo cùng cách ở một cấp sâu hơn, nơi văn bản của nó được đọc từ catalog thay vì được giao cho bản build. Lỗi dừng là cùng điều kiện này và mang cùng mã trong cả hai trường hợp; đối với một module, nó còn nêu tên import đang được theo và tệp mà văn bản của module được đọc từ đó, còn thông báo nó mang chỉ nêu loại — vì vậy vị trí mà thông báo đó đưa ra là một vị trí trong văn bản của chính module, không phải trong Aggregate mà bạn bắt đầu.

Các thông báo được phát ra, cho một template không phân tích được, cho cùng lỗi đó trong một module mà phần kết hợp import, và cho một template thất bại khi chạy:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate <path>, “template parse error: <underlying reason>”) (tham chiếu tham số không hợp lệ: kiểm tra rằng biểu thức {{ .parameters.* }} nêu tên một tham số đã khai báo và phân tích được như một Go template) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template parse error: <underlying reason>) (tham chiếu tham số không hợp lệ: kiểm tra rằng biểu thức {{ .parameters.* }} nêu tên một tham số đã khai báo và phân tích được như một Go template) invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, template execution error: <underlying reason>) (tham chiếu tham số không hợp lệ: kiểm tra rằng biểu thức {{ .parameters.* }} nêu tên một tham số đã khai báo và phân tích được như một Go template)

Văn bản của một Aggregate có một gốc duy nhất, .parameters, nên một tham chiếu qua bất kỳ gốc nào khác — {{ .values.app_token }}, hay {{ $.values.app_token }} — không đọc được gì và thất bại khi chạy. Khi đó lý do mở đầu bằng việc nêu tham chiếu mà nó đã đọc:

invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template (Aggregate, the template reads <reference>, and an Aggregate’s text defines no root but .parameters; template execution error: <underlying reason>) (tham chiếu tham số không hợp lệ: hãy kiểm tra biểu thức parameters nêu một tham số đã khai báo và phân tích được như một Go template (Aggregate; template đọc tham chiếu này, nhưng văn bản của một Aggregate không định nghĩa gốc nào ngoài .parameters; lỗi thực thi template))

Cách khắc phục: mở Aggregate và đọc lý do gốc, vốn nêu vị trí trong văn bản và cấu trúc bị lỗi. Xác nhận rằng mọi {{ đều có }} của nó, rằng một hàm bạn gọi là hàm mà bề mặt cung cấp — việc nội suy tham số chỉ cung cấp các hàm của Sprig, nên helper optional không có ở đây — và rằng các giai đoạn của một pipeline chấp nhận những gì giai đoạn trước tạo ra. Khi lý do nêu một khóa mà index không tìm thấy, hãy đọc một tham số có thể chưa được đặt bằng dấu chấm ({{ .parameters.db_size }}) hoặc qua get hay hasKey của Sprig. Khi nó nêu một tham chiếu qua một gốc khác, hãy khai báo giá trị đó là một tham số của Aggregate và đọc nó bằng {{ .parameters.<key> }}. Khi nó nêu thứ mà bạn chưa bao giờ định dùng làm template — undefined variable "$json" từ một biểu thức n8n, hay một hàm mang tên một node Flowise — thì văn bản đó có cặp ngoặc nhọn kép của riêng nó, kể cả trong comment: hãy viết mỗi {{ trong đó thành {{"{{"}}, như Văn bản có cặp ngoặc nhọn kép của riêng nó mô tả.

The Release directory declares one Aggregate or Manifest twice (Thư mục Release khai báo một Aggregate hoặc Manifest hai lần)

Một Release có tham chiếu aggregate: hoặc manifest: là một định danh trần được phân giải bằng cách quét thư mục của chính Release trước, và lần quét đó đã tìm thấy hai Aggregates — hoặc hai Manifests — mang cùng metadata.name. Một tham chiếu định danh trần nêu tên một thực thể bằng tên đó, nên một tên bị khai báo hai lần là tên mà thư mục không thể trả lời.

Lần quét từ chối toàn bộ thư mục, không chỉ tên mà một tham chiếu yêu cầu. Nó đọc mọi Aggregate và mọi Manifest nằm cạnh Release, nên một cặp trùng mà không tham chiếu nào nêu tên cũng làm dừng bản build: thư mục bị mơ hồ bất kể Release này có phải là cái sắp đọc thực thể đó hay không. Một tham chiếu viết dưới dạng đường dẫn (./aggregate.yaml, ../shared/manifest.yaml) trỏ tới một tệp thay vì một thực thể và được phân giải mà không cần quét, nên một Release có aggregate: và manifest: đều là đường dẫn sẽ không bao giờ chạy lần quét đó.

Đây là phiên bản cùng thư mục của việc từ chối định danh trùng lặp trong catalog, và hai trường hợp được báo cáo riêng để thông báo nêu tên thư mục bạn đang đứng thay vì một tầng catalog mà bạn có thể không nghĩ tới.

Thông báo được phát ra:

duplicate Aggregate/Manifest identity (metadata.name) in the Release directory: Aggregate "<name>" declared more than once in <release-directory> (định danh Aggregate/Manifest (metadata.name) bị trùng trong thư mục Release: Aggregate này được khai báo nhiều lần trong thư mục Release)

với Manifest thay cho Aggregate khi hai Manifests bị trùng.

Cách khắc phục: đặt cho một trong hai thực thể một metadata.name khác, hoặc chuyển nó ra khỏi thư mục của Release. Hai Releases thực sự triển khai các Aggregates khác nhau cùng tên nên nằm trong các thư mục riêng; sao chép một Release sang một tệp bên cạnh mà không đổi tên những gì nó mang là cách thường gặp dẫn đến lỗi này.

A Release’s aggregate: or manifest: reference resolves to nothing (Tham chiếu aggregate: hoặc manifest: của một Release không phân giải được thành gì)

Một Release nêu tên một Aggregate hoặc một Manifest bằng định danh trần và không tìm thấy thực thể nào mang tên đó trên bất kỳ bề mặt nào mà một định danh trần được tra cứu: thư mục của chính Release, catalog và registry.

Thông báo được phát ra, khi không có gì khớp ở bất cứ đâu:

aggregate/manifest reference unresolvable: no Aggregate named "<reference>" in the Release directory, catalog, or registry (không phân giải được tham chiếu aggregate/manifest: không có Aggregate nào mang tên được tham chiếu trong thư mục Release, catalog hoặc registry)

Một tệp trong thư mục của Release không thể lập chỉ mục sẽ thay đổi báo cáo, vì nó thay đổi những gì có thể khẳng định một cách trung thực. Một tệp như vậy có thể chính là thực thể, nên thông báo nói rõ điều đó thay vì khẳng định một sự vắng mặt mà nó không thể xác lập, và mang theo lỗi phân tích đã khiến tệp không đọc được:

aggregate/manifest reference unresolvable: Aggregate "<reference>" not found; unparseable file <path> could not be indexed and may be it: <parse failure> (không phân giải được tham chiếu aggregate/manifest: không tìm thấy Aggregate được tham chiếu; một tệp không phân tích được nên không thể lập chỉ mục và có thể chính là nó, kèm lỗi phân tích)

và khi một tệp không phân tích được chính là tệp mà tham chiếu nêu tên trực tiếp:

aggregate/manifest reference unresolvable: needed Aggregate "<reference>" is the unparseable file <path>: <parse failure> (không phân giải được tham chiếu aggregate/manifest: Aggregate cần dùng chính là tệp không phân tích được, kèm lỗi phân tích)

Cách khắc phục: khi tham chiếu thực sự vắng mặt, hãy sửa cách viết của nó — định danh là metadata.name của thực thể, không phải tên tệp — hoặc thêm thực thể vào thư mục của Release hay catalog mà bản build đọc. Khi thông báo nêu tên một tệp không phân tích được, hãy sửa tệp đó trước: lỗi phân tích của nó được trích trong thông báo, và sửa nó thường giải quyết luôn tham chiếu trong cùng lần chỉnh sửa. Một tham chiếu ./ hoặc ../ là đường dẫn chứ không phải định danh và được phân giải như đường dẫn, nên một dấu chấm ở đầu sẽ thay đổi việc bạn đang tìm loại lỗi nào trong hai loại.

A component is placed in more than one boundary (Một component được đặt vào nhiều hơn một boundary)

Cây boundary của một Release đặt một component vào hai boundary khác nhau. Hai vị trí đặt này không được gộp lại cũng không được xếp hạng, và không thể làm vậy: boundary của một component quyết định đầu ra của nó được ghi ở đâu, nằm trong thư mục con nào, tham gia sync wave nào, và thừa hưởng các annotation boundary cùng hạ tầng boundary nào — trong khi bề mặt uses: theo từng cạnh của nó được đọc bởi một lượt duyệt riêng. Một component được nêu tên hai lần sẽ lấy vị trí đầu ra từ một vị trí đặt và cấu hình theo từng cạnh từ vị trí đặt kia.

Một boundary đặt các component theo ba cách, và cả ba đều được tính. Nêu tên một component trực tiếp dưới components:, bằng id mà nó mang sau khi composition hoàn tất, sẽ đặt nó. Nêu tên một component bên trong components: riêng của một mục định tuyến, bằng tên cục bộ mà nó mang bên trong module con đó, cũng đặt nó. Và định tuyến cả một module con vào dưới aggregates: sẽ đặt mọi component mà module đó chứa. Vì vậy lỗi dừng này cũng bao gồm trường hợp một module con được định tuyến vào hai boundary, một module được định tuyến vào một boundary trong khi một module lồng bên trong nó được định tuyến vào boundary khác, và một component được nêu tên tại một boundary trong khi module chứa nó được định tuyến vào một boundary khác.

Định tuyến một module vào một boundary và đồng thời nêu tên một trong các component của nó dưới cùng boundary đó không phải là xung đột — cả hai vị trí đặt đều thống nhất về nơi component thuộc về — và bản build thành công. Một id được viết hai lần dưới một boundary vẫn là xung đột ngay cả ở đó: một mục trong components: của boundary và một mục cho chính component đó bên trong mục định tuyến của boundary là hai mục mang cấu hình cho một component, không có gì để chọn giữa chúng.

Mọi vị trí đặt vi phạm đều được báo cáo. Một Release đặt nhiều component hai lần sẽ dừng với một thông báo như vậy cho mỗi mục vi phạm trong cùng một bản build, mỗi thông báo tại khóa của mục mà nó phản đối — vì vậy nhiều thông báo cùng lúc là một bản build nêu tên mọi thứ nó tìm thấy, chứ không phải một lỗi được viết ra nhiều lần.

Vị trí đặt mà thông báo báo cáo là đã có hiệu lực không phải lúc nào cũng là vị trí được viết đầu tiên trong tệp. Các mục components: riêng của một boundary được đọc trước các component mà các mục định tuyến của nó nêu tên và trước các module con mà nó định tuyến, và một boundary được đọc trước các boundary lồng bên trong nó; các boundary viết cạnh nhau được đọc theo thứ tự xuất hiện. Khi có nhiều hơn một vị trí đặt trước đó xung đột, vị trí được đọc đầu tiên là vị trí được nêu tên. Cả hai vị trí đều được nêu tên dù chúng rơi vào thứ tự nào, và không vị trí nào được xếp trên vị trí kia.

Thông báo được phát ra. Câu nêu quy tắc; phần tiếp theo nêu tên mục có lỗi, boundary mà mỗi vị trí đặt nằm trong, khối mà mỗi vị trí được viết, và tệp chứa cả hai. Khi một mục dưới components: của một boundary gặp một mục trước đó dưới của một boundary khác:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, "<component>", named in the components block of boundary "<boundary-b>", while it is already named in the components block of boundary "<boundary-a>", that earlier entry naming "<component>", both declared in "<path>") (thành phần được khai báo trong nhiều hơn một ranh giới: hãy khai báo mỗi thành phần trong đúng một ranh giới; mục bị lỗi được nêu trong khối components của một ranh giới trong khi nó đã được nêu trong khối components của một ranh giới khác, cả hai được khai báo trong cùng một tệp)

Hai mệnh đề nêu tên các boundary được diễn đạt theo khối mà mỗi mục được viết. Mục có lỗi nhận một trong các dạng:

  • named in the components block of boundary "<boundary>" — map components: riêng của boundary;
  • named inside a routing entry in boundary "<boundary>" — map components: của một mục định tuyến dưới aggregates: của boundary đó;
  • routed as a sub-module into boundary "<boundary>" — chính mục định tuyến.

Vị trí đặt trước đó, tiếp nối cùng câu, nhận một trong các dạng:

  • while it is already named in the components block of boundary "<boundary>";
  • while it is already named inside a routing entry in boundary "<boundary>";
  • while it is already placed by a sub-module routed into boundary "<boundary>".

Hai mệnh đề được chọn độc lập, nên bất kỳ cặp nào cũng có thể xuất hiện, và that earlier entry naming mang bất cứ thứ gì mà vị trí đặt trước đó nhắm tới: id của component, hoặc tiền tố của module con khi chính một module con được định tuyến đã đặt nó.

Khi mục có lỗi chính là một mục định tuyến, thứ nó nhắm tới là một module con chứ không phải một component đơn lẻ, và thông báo nói rõ như vậy thay vì trình bày tiền tố module như tên component — ở đây là gặp một module con trước đó được định tuyến vào boundary khác:

component declared in more than one boundary: declare each component in exactly one boundary (Release <name>, at <field-path>, sub-module "<module>", routed as a sub-module into boundary "<boundary-b>", while it is already placed by a sub-module routed into boundary "<boundary-a>", that earlier entry naming "<module>", both declared in "<path>") (thành phần được khai báo trong nhiều hơn một ranh giới: hãy khai báo mỗi thành phần trong đúng một ranh giới; mô-đun con được định tuyến vào một ranh giới trong khi nó đã được đặt bởi một mô-đun con được định tuyến vào một ranh giới khác, cả hai được khai báo trong cùng một tệp)

Cách khắc phục: xóa vị trí đặt nào trong hai vị trí mà bạn không có ý định. Thông báo nêu tên cả hai, nên lựa chọn thuộc về bạn chứ không phải trình biên dịch. Khi một khai báo trực tiếp và một module được định tuyến không thống nhất, hãy quyết định component thuộc về module của nó hay đứng riêng: định tuyến module sẽ đặt nó cùng mọi thứ khác mà module chứa, còn nêu tên trực tiếp sẽ tách nó khỏi chúng. Khi hai mục định tuyến cùng nhận một module, hãy bỏ phần định tuyến bạn không có ý định — định tuyến một module vào một boundary sẽ đặt mọi component nó chứa vào đó, nên hai mục như vậy nhận cùng một tập component.

A Manifest annotation binding claims the reserved aggrega.ai/ prefix (Một liên kết annotation của Manifest chiếm tiền tố dành riêng aggrega.ai/)

Một Manifest khai báo một liên kết annotation dưới một khóa bắt đầu bằng tiền tố aggrega.ai/ trần. Tiền tố đó là nơi bản build đóng dấu các khóa do chính nó phát ra, nên một liên kết chiếm một khóa bên trong nó sẽ đặt việc định tuyến của bạn và đầu ra riêng của nền tảng vào cùng một không gian khóa, tranh giành cùng các tên.

Nó dừng build, và không thể chỉ là một cảnh báo. Việc dành riêng là toàn bộ điều khiến không gian khóa đó thuộc về nền tảng; chấp nhận liên kết rồi nhắc đến nó sau đó sẽ để lại xung đột trong bản build.

Quy tắc này liên quan đến không gian khóa mà một liên kết do tác giả viết chiếm, nên một khóa mà Manifest được trình bày không khai báo liên kết sẽ được bỏ qua thay vì bị báo cáo — không có liên kết nào để vi phạm.

Thông báo được phát ra. Khóa vi phạm đứng đầu, vì câu nói về nó, và các giá trị sau nó đều được giới thiệu bằng chính bản chất của chúng:

manifest annotation binding uses reserved prefix (Manifest, at <field-path>, "<key>", reserved prefix "aggrega.ai/", routing to Feature "<feature-uri>", author the binding under a domain of your own such as "feature.<your-domain>/") (ràng buộc annotation của Manifest dùng tiền tố dành riêng; hãy viết ràng buộc dưới một tên miền của riêng bạn)

Cách khắc phục: đổi tên khóa liên kết sang một không gian tên mà bạn kiểm soát. Khóa có tiền tố con là dạng được hỗ trợ và không bị dành riêng: feature.aggrega.ai/… cho một lối tắt của thư viện chuẩn, hoặc tên miền riêng của bạn — acme.aggrega.ai/…, compliance.example.com/… — cho một lối tắt doanh nghiệp. Đổi tên khóa sẽ thay đổi những gì tác giả viết trên một component để kích hoạt liên kết, nên hãy cập nhật các annotation dùng nó trong cùng lần sửa. Các khóa riêng của nền tảng dưới tiền tố trần được liệt kê trong ../providers/well-known-annotations.md.

Two Manifest annotation bindings compete for one routing slot (Hai annotation binding của Manifest tranh nhau một vị trí định tuyến)

Hai annotation binding trong cùng một Manifest cùng định tuyến đến cùng một Feature, qua cùng một pillar, tại cùng một đường dẫn. Nhiệm vụ của một binding là cho biết giá trị của một annotation sẽ đặt vào đâu, và hai binding cùng chỉ một đích khiến giá trị có hai tuyến mà không có gì để chọn giữa chúng lúc mở rộng.

Với mỗi Feature đích, chỉ một binding được khai báo một cặp đường dẫn và pillar nhất định. Hai binding nhắm cùng một Feature tại các đường dẫn khác nhau là cách viết bình thường và build được; hai binding định tuyến cùng một đường dẫn đến hai Features khác nhau cũng vậy.

Các binding được duyệt theo thứ tự Manifest khai báo chúng, nên binding mà thông báo nêu trước luôn là binding xuất hiện sớm hơn trong tài liệu của bạn.

Thông báo được phát ra:

manifest annotation bindings collide on same Feature path+pillar (Manifest, at <path>, annotation bindings "<first-key>" and "<second-key>" both target Feature "<feature-uri>" with path "<path>" routing to pillar "<pillar>"; only one binding may declare a given (path, pillar) pair per Feature) (các ràng buộc chú thích manifest xung đột trên cùng đường dẫn+pillar của Feature (Manifest, tại <path>, các ràng buộc chú thích “<first-key>” và “<second-key>” cùng nhắm tới Feature “<feature-uri>” với đường dẫn “<path>” định tuyến tới pillar “<pillar>”; với mỗi Feature, chỉ một ràng buộc được khai báo một cặp (đường dẫn, pillar) nhất định))

Cách khắc phục: quyết định binding nào sở hữu đích đến và xoá đường dẫn khỏi danh sách maps.infra hoặc maps.values của binding kia, hoặc bỏ hẳn binding thứ hai. Nếu hai binding tồn tại vì bạn muốn hai khoá annotation cùng đến một trường của Feature, hãy giữ một binding và để cả hai khoá annotation định tuyến qua nó; nếu chúng tồn tại vì hai giá trị khác nhau được dự định đặt vào hai nơi, hãy sửa đường dẫn nào đã bị viết nhầm.

A Release reached resolution without passing through the load path (Một Release đến bước phân giải mà không đi qua đường nạp)

Một Release đến bước phân giải mang cả một bề mặt components: cấp cao nhất không rỗng lẫn một boundary default được tổng hợp. Tổ hợp đó không thể sinh ra từ một Release được nạp bình thường: đường nạp gộp khối components: cấp cao nhất vào boundary mặc định rồi xóa nó, còn một tài liệu viết thẳng cả hai sẽ bị schema của nó từ chối trước khi tới được bước này.

Vì vậy lỗi dừng này không báo về bất cứ điều gì bạn đã viết. Nó báo rằng có thứ đã đến bước phân giải mà vòng qua đường nạp — thường nhất là một Release được một chương trình nhúng dựng trong bộ nhớ thay vì đọc từ tệp — và nó dừng lại thay vì để build tiếp tục trên một tài liệu có hai bề mặt component mâu thuẫn nhau. Đọc chúng theo thứ tự nào cũng sẽ tạo ra đầu ra âm thầm bỏ sót hoặc nhân đôi các component, và lượt duyệt boundary với lượt duyệt theo từng cạnh thậm chí còn không thống nhất với nhau là component nào.

Thông báo được phát ra:

release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary): construct releases through the normalization core (types.NormalizeRelease via the load path), not a hand-built literal (release đến bước phân giải mà chưa được chuẩn hoá (components gốc không rỗng cùng với một boundary mặc định được tổng hợp): hãy dựng release qua lõi chuẩn hoá (types.NormalizeRelease qua đường nạp), không phải một literal dựng tay)

Cách khắc phục: không cần làm gì nếu bạn đang viết YAML — gặp lỗi dừng này từ aggrega build, aggrega validate hoặc trình soạn thảo nghĩa là trình biên dịch có một lỗi đáng báo cáo, và Release bạn đang build không có lỗi. Nếu bạn đang nhúng trình biên dịch và dựng một giá trị Release trong mã của mình, hãy dựng nó qua đường nạp thay vì lắp struct trực tiếp, để bước chuẩn hoá gộp các components gốc vào boundary mặc định được chạy.

A library reference expands into itself (Một tham chiếu thư viện mở rộng vào chính nó)

Một chuỗi tham chiếu xuyên tài liệu quay lại một tài liệu mà nó đã đi qua, nên việc mở rộng sẽ không bao giờ kết thúc. Hai bề mặt viết dẫn đến cùng tình trạng này, và cả hai đều là chuỗi giữa các thực thể thư viện chứ không phải thứ gì bên trong một tệp: một $ref: từ một schema pillar vào một mục SchemaLibrary tham chiếu vòng trở lại, và một $import: vào một mục MappingLibrary hoặc WorkloadLibrary làm điều tương tự.

Chuỗi được so sánh trên một khoá chuẩn tắc — danh tính của thư viện và tên của mục, đã loại bỏ mọi host registry và cách viết phiên bản — nên một chu trình không thể né việc kiểm tra bằng cách gọi cùng một mục theo hai cách khác nhau dọc đường đi. Một tham chiếu mở rộng và kết thúc thì không sao dù xuất hiện bao nhiêu lần và chuỗi sâu đến đâu; riêng độ sâu không bao giờ gây ra lỗi dừng này, và dùng lại một mục thư viện từ nhiều nơi chính là mục đích tồn tại của thư viện.

Thông báo được phát ra, cho một chuỗi $import:, nêu toàn bộ vòng lặp theo thứ tự đã duyệt để bạn thấy bước nào khép vòng:

circular reference expansion: <Library>#/mappings/<entry> -> <Library>#/mappings/<entry> -> <Library>#/mappings/<entry>

Một chuỗi $ref: thì được trình biên dịch compact-form báo thay vào đó, kèm tài liệu và từ khoá mà nó đang đọc:

compactform at <consumer-file> (keyword "$ref"): circular cross-document $ref expansion: <Library>#/schemas/<entry> -> <Library>#/schemas/<entry> -> <Library>#/schemas/<entry>

Cách khắc phục: đọc chuỗi trong thông báo và cắt nó ở bước nào không được dự định. Một chu trình thường có nghĩa là hai mục thư viện được viết để mỗi mục mở rộng mục kia; hãy gom phần chung vào một mục thứ ba mà cả hai cùng tham chiếu, hoặc viết nội tuyến nó vào một trong hai. Bước cuối cùng được hiển thị là bước đã khép vòng, nhưng chưa chắc là bước sai — toàn bộ chuỗi được in ra chính vì việc cắt mắt xích nào là quyết định của bạn.

Cùng tình trạng này cũng là cơ sở cho việc từ chối đệ quy anchor được mô tả ở “YAML anchor aliased inside its own content” phía trên. Trường hợp đó là một vòng lặp bên trong văn bản của một tài liệu; trường hợp này là một vòng lặp giữa các tài liệu. Chuỗi trong thông báo giúp phân biệt hai trường hợp ngay lập tức: vòng lặp giữa các tài liệu nêu các mục thư viện, còn vòng lặp bên trong một tài liệu nêu một anchor.

A declared schema cannot be resolved (Một schema đã khai báo không thể được phân giải)

Một schema đã đến lúc được dùng để kiểm tra hợp lệ một thứ gì đó nhưng hoàn toàn không thể lắp thành một schema. Nguyên nhân phổ biến nhất là một $ref: không trỏ đến thứ gì phân giải được; một schema không thoả meta-schema của JSON Schema cũng dẫn đến lỗi dừng này, và một nhánh then: hoặc else: dưới một từ khoá điều kiện không thể tự phân giải cũng vậy.

Việc từ chối xảy ra trước khi bất cứ thứ gì được kiểm tra theo schema, và thứ tự đó chính là điểm mấu chốt. Bỏ qua một schema không đọc được sẽ khiến mọi thứ nó bao phủ không được kiểm tra trong khi build báo thành công — một bước kiểm tra đã ngừng chạy mà không có gì báo rằng nó đã ngừng.

Thông báo được phát ra, nêu vị trí bên trong schema, từ khoá không thể phân giải, và điều mà bước phân giải đã báo:

validator/jsonschema: schema resolution failed (at <path-inside-the-schema>, keyword "<keyword>", <what resolution reported>) (validator/jsonschema: phân giải schema thất bại (tại <path-inside-the-schema>, từ khóa “<keyword>”, <what resolution reported>))

Khi lỗi nằm ở gốc của schema thay vì ở một từ khoá bên trong, vị trí và từ khoá được lược bỏ và câu chỉ mang lý do được báo.

Cách khắc phục: mở schema tại vị trí mà thông báo nêu. Một $ref: thường là thủ phạm: xác nhận đích tồn tại, rằng một tham chiếu trong tài liệu viết chính xác đường dẫn #/$defs/… của nó, và rằng một tham chiếu xuyên tài liệu nêu một mục SchemaLibrary mà bao đóng phụ thuộc của build thực sự chứa. Khi thông báo nêu một nhánh then: hoặc else:, nhánh đó tự nó là một schema và phải phân giải được theo chính các điều kiện của nó.

An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Không thể đánh giá vị từ x-aggrega-when: hoặc x-aggrega-validate:)

Một schema khai báo một trong hai từ khóa mở rộng có giá trị là template và template đó không thể sử dụng được: nó không phải là chuỗi, không phân tích được thành template, bị lỗi khi chạy, hoặc kết xuất ra thứ gì đó khác true hoặc false.

x-aggrega-when: quyết định một nhánh điều kiện của schema có áp dụng hay không; x-aggrega-validate: quyết định một giá trị có thỏa mãn một quy tắc mà các từ khóa riêng của schema không thể diễn đạt hay không. Cả hai đều được đọc như các phán quyết, đó là lý do một kết quả không phải phán quyết sẽ bị từ chối thay vì được diễn giải: một vị từ kết xuất ra chuỗi rỗng sẽ bị đọc là false và sẽ âm thầm vô hiệu hóa quy tắc mà nó được viết ra để thực thi.

Thông báo được phát ra:

validator/jsonschema: x-aggrega extension evaluation failed (at <path-inside-the-schema>, keyword "x-aggrega-validate", <what evaluation reported>) (validator/jsonschema: đánh giá phần mở rộng x-aggrega thất bại (tại <path-inside-the-schema>, từ khóa “x-aggrega-validate”, <what evaluation reported>))

với "x-aggrega-when" thay cho từ khóa khi vị từ của điều kiện là nơi gây lỗi, và lý do được báo cáo nêu lỗi của template — một vị trí phân tích, một hàm bị thiếu, hoặc giá trị không phải boolean mà template tạo ra.

Cách khắc phục: mở schema tại vị trí mà thông báo nêu và đọc lý do được báo cáo. Xác nhận giá trị của từ khóa là một chuỗi, template phân tích được, và mọi đường dẫn mà nó duyệt qua đều thực sự có trong giá trị đang được kiểm tra — một vị từ đọc giá trị dưới dạng .value, và việc truy cập bất kỳ thứ gì khác là lỗi phổ biến nhất. Khi lý do nêu một khóa mà index không tìm thấy, hãy kiểm tra khóa bằng hasKey hoặc đọc nó bằng get: index dừng lại với một khóa mà map không chứa, như mô tả trong “A template indexes a map with a key the map does not hold (Một template truy cập map bằng một khóa mà map không chứa)” bên dưới. Đảm bảo template kết thúc bằng việc tạo ra true hoặc false: một phép so sánh làm được điều đó, còn một template chỉ kết xuất giá trị thì không.

A Workload does not satisfy the Workload schema (Một Workload không thỏa mãn schema của Workload)

Khối workload: của một Recipe hoặc FeatureRecipe đã được đọc và kiểm tra theo schema của Workload, và một hoặc nhiều trường không thỏa mãn nó — một khóa viết sai chính tả, một giá trị sai kiểu, một trường bắt buộc bị bỏ sót, một giá trị nằm ngoài phạm vi hoặc tập liệt kê đã khai báo.

Báo cáo được gom nhóm: một lần dừng mang theo mọi trường bị lỗi, nên một Workload có bốn lỗi sẽ cho bạn biết cả bốn trong một lần build thay vì mỗi lần build một lỗi. Phần tiêu đề nêu tên Workload, Recipe khai báo nó và tệp; mỗi phát hiện bên dưới nêu đường dẫn trường bên trong Workload, điều schema yêu cầu ở đó, và cách sửa khi có thể nêu ra.

Thông báo được phát ra:

workload validation failed (xác thực workload thất bại) (Workload in Recipe <name>:<version>, at <path>, schema stage): .containers.<name>.<field>: <what the schema required> — <the fix, where one can be stated> .initContainers[<i>].<field>: <what the schema required> — <the fix, where one can be stated>

Một lỗi không có chi tiết theo từng trường — khối hoàn toàn không đọc được, chứ không phải đọc được nhưng không đạt — sẽ mang toàn bộ lý do làm phát hiện duy nhất của nó.

Khi template workload: đọc một giá trị được khai báo là nhạy cảm, không phát hiện nào trích dẫn giá trị. Không thể biết trường nào của tài liệu được kết xuất đến từ giá trị đó, nên mọi phát hiện mà nội dung có thể mang giá trị đều nêu ràng buộc của schema với <redacted> thay cho giá trị, kết thúc bằng một thông báo nêu lý do, và không đưa ra cách sửa nào suy ra từ giá trị:

.containers.main.imagePullPolicy: against /$defs/container: enum: <redacted> does not satisfy enum ["Always","Never","IfNotPresent"] (the value is withheld because the template that rendered this document reads a value declared sensitive)

Một phát hiện không trích dẫn giá trị nào — một khóa bị thiếu, một khóa mà Workload không chấp nhận — được đọc giống như với bất kỳ template nào khác. Xem vocabulary/compact-form-authoring.md “Một lời từ chối nói gì về một giá trị đã khai báo”.

Bản build báo cáo lần dừng này dưới thẻ CATALOG_ERROR, vì khối workload: do tác giả của Recipe viết chứ không phải do Aggregate hay Release.

Cách khắc phục: mở Recipe tại các đường dẫn trường được liệt kê và sửa từng trường. Các đường dẫn được tính từ gốc của chính Workload, nên .containers.main.health.ready là khối ready dưới khóa health của container main. Một container có tên được truy cập theo khóa của nó, còn một init container theo vị trí của nó, đó là lý do hai loại này được đọc khác nhau. Những gì mỗi trường chấp nhận có trong tài liệu tham khảo về cách viết Workload.

Một trường mà schema muốn là văn bản, bị từ chối vì giá trị là số hoặc boolean, hầu như luôn có nghĩa là một biểu thức template không có dấu ngoặc kép. Khối workload: được kết xuất trước khi được kiểm tra, nên một biểu thức viết không có dấu ngoặc kép sẽ mở rộng thành văn bản trần và YAML sau đó đọc văn bản đó theo hình thức của nó. Một lượng tài nguyên tính bằng số core nguyên, một phiên bản chỉ gồm chữ số, một cổng, và các từ yes, no, on và off đều được đọc thành thứ khác văn bản. Phát hiện cho biết YAML đã đọc thành kiểu nào, và cách khắc phục là đặt biểu thức trong dấu ngoặc kép ở Recipe — cpu: "{{ .infra.compute.cpu }}" thay vì cpu: {{ .infra.compute.cpu }} — để giá trị vẫn là văn bản dù người vận hành cung cấp gì. Lưu ý rằng giá trị của chính người vận hành không có lỗi ở đây và việc đặt nó trong dấu ngoặc kép ở Release không thay đổi gì: dấu ngoặc kép phải nằm trong Recipe, bao quanh biểu thức.

Một tệp đính kèm Workload nêu tên một slot mà thực thể không khai báo, hoặc một cách phân phối mà slot cấm

Một mục attachments: của container bên trong khối workload: tham chiếu đến một slot đính kèm, và tham chiếu đó không khớp với các slot mà Component hoặc Feature khai báo trong featuresSchema của nó — hoặc, đối với một mục nêu tên một kết nối bằng connection:, không khớp với các slot mà socket của kết nối đó khai báo. Một mục envFrom nêu tên một kết nối cũng phải tuân theo cùng các quy tắc về kết nối. Phát hiện cho biết bạn đang gặp trường hợp nào trong số này.

  • Slot không được khai báo. from: của mục nêu tên một slot mà featuresSchema của thực thể không có — do viết sai chính tả, hoặc một slot chỉ được đổi tên ở một phía.
  • Slot là blackbox. Slot khai báo một danh sách cho phép inject: rỗng, dành việc phân phối cho cơ chế nội bộ của chính Recipe. Một slot như vậy được điền và tiêu thụ nội bộ, nên một Workload không thể truy cập nó.
  • Cách phân phối nằm ngoài danh sách cho phép của slot. as: của mục nêu tên một cơ chế mà danh sách inject: của slot không cho phép.
  • Kết nối không phải là kết nối mà component tạo ra. connection: của mục nêu tên một bí danh mà không kết nối nào của component được viết dưới đó.
  • Socket của kết nối không khai báo slot. from: của mục (hoặc, trên envFrom, là secret:) nêu tên một slot mà socket mà kết nối đó đi qua không khai báo.
  • Slot được viết bằng tên ghép của nó. from: (hoặc secret:) của mục là tên mà tệp đính kèm của một kết nối mang trên component — bí danh, một dấu chấm và slot — được viết mà không có connection:. Slot của một kết nối chỉ có thể được truy cập bằng cách nêu tên kết nối.

Mọi mục vi phạm trên mọi container đều được báo cáo cùng lúc, nên một lần build nêu tên tất cả. Các phát hiện được nhóm dưới một tiêu đề nêu tên Workload, Recipe của nó và tệp.

Thông báo được phát ra:

workload featuresSchema cross-check failed (Workload in Recipe <name>:<version>, at <path>, featuresSchema stage): .containers.<name>.attachments.<KEY>.from: references slot "<slot>" which is not declared in the Component’s featuresSchema — either declare the slot in the Component (or Feature) featuresSchema, or rename the reference to an existing slot .containers.<name>.attachments.<KEY>.from: slot "<slot>" is blackbox (no inject: allowlist) and cannot be referenced from a Workload attachments entry — blackbox slots are delivered by Recipe-internal plumbing; remove the Workload-side reference, or widen the slot’s inject allowlist if Workload-side delivery is intended .containers.<name>.attachments.<KEY>.as: delivery mechanism "<as>" is not permitted by slot "<slot>" (inject allowlist: [<mechanisms>]) — use one of the allowlisted delivery mechanisms ([<mechanisms>]), or widen the slot’s inject allowlist in the Component/Feature featuresSchema .containers.<name>.attachments.<KEY>.connection: names connection "<alias>" for slot "<slot>", but the component draws no connection under that alias — name a connection the component draws (<aliases>), or remove connection to read a slot the Component declares for its own attachments .containers.<name>.attachments.<KEY>.from: names slot "<slot>" of connection "<alias>", which socket "<socket>" does not declare — name a slot socket "<socket>" declares (<slots>), or declare the slot in that socket’s featuresSchema .containers.<name>.attachments.<KEY>.from: names "<alias>.<slot>", the name the compiler composes for slot "<slot>" of connection "<alias>"; a slot a connection’s socket declares is named by naming the connection — write connection: <alias> beside from: <slot>

Trên một mục envFrom, các phát hiện tương tự nằm tại .containers.<name>.envFrom[<i>].connection và .containers.<name>.envFrom[<i>].secret.

Cách khắc phục: mỗi phát hiện nêu tên cả hai phía, nên bạn cần chọn phía nào để thay đổi. Với một slot chưa được khai báo, hãy sửa chính tả của from: hoặc khai báo slot trong featuresSchema của thực thể — hậu tố .from của đường dẫn trường chỉ vào tham chiếu. Với một slot blackbox, hãy xóa tham chiếu phía Workload và để Recipe phân phối dữ liệu, trừ khi thực sự muốn phân phối phía Workload, khi đó hãy cấp cho slot một danh sách cho phép inject:. Với một cơ chế bị từ chối, hãy đổi as: sang một cơ chế mà danh sách cho phép nêu tên, hoặc thêm cơ chế của bạn vào danh sách đó. Với một kết nối mà component không tạo ra, hãy sửa bí danh thành một bí danh mà phát hiện liệt kê, hoặc tạo kết nối trong Aggregate hoặc Release. Với một slot mà socket không khai báo, hãy nêu tên một trong các slot mà phát hiện liệt kê, hoặc khai báo slot trong featuresSchema của socket trên Component. Với một tên ghép, hãy viết kết nối và slot riêng biệt, như phát hiện chỉ ra.

Một Workload tham chiếu đến một slot mà phần điền của nó không công bố locator nào

Một mục attachments: của container nêu tên một slot theo tham chiếu, và tệp đính kèm điền slot đó không công bố các khóa provides mà một tham chiếu như vậy đọc. Tham chiếu đến một slot theo tên nghĩa là yêu cầu tài nguyên mà slot đại diện được định địa chỉ trong đầu ra được render — theo tên của tài nguyên, và theo trường bên trong nó. Một phần điền không công bố cả hai thì không có locator nào để trỏ tới, nên tham chiếu không thể chuyển thành bất cứ thứ gì.

Các khóa bắt buộc tùy thuộc vào mục, và phát hiện cho biết nó cần khóa nào. Một mục nêu tên key: của riêng nó tự cung cấp trường, nên chỉ cần công bố name của tài nguyên — đó là điều cho phép nó tham chiếu đến một tài nguyên nhiều khóa. Một mục không nêu tên key: đọc trường được công bố duy nhất của slot, nên phải có cả name và key.

Việc kiểm tra chỉ đọc xem các khóa có hiện diện hay không; nó không bao giờ xem xét giá trị của chúng. Mọi mục vi phạm đều được báo cáo cùng lúc, dưới một tiêu đề.

Thông báo được phát ra:

workload attachment slot is not referenceable (Workload in Recipe <name>:<version>, at <path>, slotReferenceability stage): .containers.<name>.attachments.<KEY>.from: slot "<slot>" is not referenceable: its resolved provides does not expose "<key>" (a workload attachment reference reads the provides keys name and key) — reference a slot filled by an attachment whose schema.provides declares the keys this reference reads, or deliver it through the slot’s inject pipe rather than a workload reference

Cách khắc phục: có hai hướng, và hướng nào đúng tùy thuộc vào ý định của bạn. Nếu tham chiếu là đúng, tệp đính kèm điền slot là thứ cần thay đổi: hãy đính kèm một Feature có schema.provides khai báo name — và key, khi mục không tự nêu tên khóa nào — để có một locator để trỏ tới. Nếu dữ liệu vốn không nhằm được định địa chỉ theo tên trong đầu ra, hãy bỏ tham chiếu và phân phối nó qua đường ống inject: của slot, vốn mang chính giá trị thay vì một con trỏ đến nơi nó nằm.

A container gives one environment variable two values (Một container gán hai giá trị cho một biến môi trường)

Một container của khối workload: nêu cùng một biến môi trường hai lần: một lần là khóa trong variables của nó, và một lần là khóa của một mục attachments được phân phối as: env. Cả container chính lẫn init container đều được kiểm tra, trong Workload mà Recipe của một component kết xuất cũng như trong Workload mà một FeatureRecipe kết xuất — một cái gắn vào một component và một cái khai báo tại một boundary — và phép kiểm tra đọc Workload theo đúng cách template của nó đã kết xuất.

Vì sao dừng thay vì chọn một. Môi trường của một container được ghi từ hai tập hợp đó theo một thứ tự cố định — các provider helm và compose ghi mọi mục đọc từ attachment trước, rồi đến các variables thông thường. Do đó, một tên được ghi theo cả hai cách sẽ đến tiến trình với giá trị mà thứ tự đó cho thắng, đây là hệ quả của nơi hai loại được đặt chứ không phải của bất cứ điều gì bạn viết, nên bản build từ chối cặp này thay vì kết xuất nó. Phép kiểm tra chạy một lần, bất kể provider nào kết xuất Workload, sau các phép kiểm tra khác của Workload và trước khi các mục artifacts: được đánh giá hay bất kỳ provider nào nhận Workload, nên một cặp bị từ chối không bao giờ được kết xuất. Một mục attachments được phân phối as: file được mount như một tệp chứ không được đặt vào môi trường, nên nó không bao giờ tạo thành một cặp.

Phép kiểm tra chỉ so sánh tên; nó không bao giờ đọc giá trị, nên không phát hiện nào trích dẫn giá trị. Có hai loại mục môi trường nằm ngoài phạm vi so sánh: một mục envFrom đặt các khóa của ConfigMap hoặc Secret mà nó nêu, vốn không được biết khi bản build chạy, và một mục mà một bước pipeline ghi vào tài liệu đã kết xuất không thuộc Workload mà phép kiểm tra đọc.

Mỗi cặp là một phát hiện riêng, được định vị tại khóa workload: của Recipe hoặc FeatureRecipe khai báo Workload, và nêu tên biến cùng container — container chính theo khóa của nó, init container theo vị trí của nó trong danh sách initContainers. Các phát hiện xuất hiện với các container chính trước, theo thứ tự được viết, sau đó là các init container theo vị trí, và trong một container thì theo thứ tự các mục attachments của nó được viết.

Thông báo được phát ra, cho một cặp trên container chính của Workload thuộc một Recipe. Danh mục và mã ngắn của điều kiện này, E0345, đến với bạn trong phần đầu đặt trong ngoặc vuông, và vị trí hiển thị là <path> at .spec.workload:

a container declares one environment variable twice ("<NAME>", container "<container>"). Rename one of the two, or write them under complementary template conditions so that only one of them renders (một container khai báo một biến môi trường hai lần. Hãy đổi tên một trong hai, hoặc viết chúng dưới các điều kiện template bổ sung cho nhau để chỉ một trong hai được render)

Một cặp trên init container thì nêu vị trí của nó trong danh sách — init container "initContainers[<i>]" — và phát hiện của một FeatureRecipe nêu attachment ràng buộc nó sau container, attachment "<attachment>", vì một component có thể mang nhiều attachment mà các FeatureRecipes của chúng là các tài liệu riêng biệt.

Khi một Workload mang nhiều cặp, các phát hiện được nhóm dưới một dòng nêu tên tài liệu: containers of the Workload this Recipe renders name one environment variable twice, hoặc, với một FeatureRecipe, containers of the Workload rendered by the FeatureRecipe that attachment "<attachment>" binds name one environment variable twice.

Bản build báo cáo việc dừng dưới thẻ CATALOG_ERROR, vì khối workload: do tác giả của Recipe hoặc FeatureRecipe viết chứ không phải do Aggregate hay Release.

Cách khắc phục: quyết định container nên nhận cái nào trong hai. Khi cần cả hai, hãy đổi tên một trong số chúng để tiến trình thấy hai biến. Khi chúng là các lựa chọn thay thế — chẳng hạn một giá trị dự phòng thông thường khi không có credential nào được gắn — hãy bảo vệ chúng bằng các điều kiện bổ sung cho nhau để đúng một cái được kết xuất: viết biến dưới {{ if not (hasKey (default dict .features) "<slot>") }} và mục attachments dưới {{ if hasKey (default dict .features) "<slot>" }}, hoặc dưới hai nhánh của một {{ if }}/{{ else }}. Một cặp được bảo vệ theo cách đó không bao giờ đến phép kiểm tra, vì chỉ một trong hai có mặt trong Workload đã kết xuất.

A Release’s parameters: block is written in neither of its two shapes (Khối parameters: của một Release không được viết theo dạng nào trong hai dạng của nó)

Một Release đáp ứng các tham số mà một Aggregate khai báo theo một trong hai cách, và khối được đọc theo dạng của nó. Hoặc đó là một mapping từ tên tham số đến giá trị được viết tại chỗ, hoặc đó là một mapping có đúng một khóa, $import:, với giá trị là đường dẫn của một tệp YAML chứa các giá trị đó. Một khối không thuộc dạng nào sẽ bị từ chối ngay khi được đọc, trước khi bất cứ thứ gì kiểm tra các giá trị theo khai báo của Aggregate.

Có ba dạng bị từ chối. Một giá trị parameters: hoàn toàn không phải là mapping — một scalar, hoặc một list. Một mapping mang $import: cùng với các khóa khác, tức là yêu cầu cả các giá trị được import lẫn các giá trị được viết sẵn cùng lúc mà không đưa ra quy tắc nào để kết hợp chúng. Và một $import: có giá trị không phải là một chuỗi thuần, tức là không chỉ đến tệp nào.

Schema của Release khai báo cùng hai hình dạng đó, nên một tệp Release mang bất kỳ trường hợp nào trong ba trường hợp sẽ gặp lần kiểm tra envelope tài liệu trước, dưới E0215, lần kiểm tra này thử cả hai hình dạng và cho biết vì sao mỗi hình dạng thất bại — ở đây là cho một danh sách:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.parameters: no oneOf branch matched (2 branches tried): branch[0]: type: expected object, got array; branch[1]: type: expected object, got array. correct the document to match its kind’s schema (xác thực envelope tài liệu thất bại (Release); spec.parameters: không nhánh oneOf nào khớp (đã thử 2 nhánh): branch[0]: kiểu: cần object, nhận được mảng; branch[1]: kiểu: cần object, nhận được mảng. hãy sửa tài liệu cho khớp với schema của kind của nó)

Với $import: nằm cạnh một khóa khác, nhánh thứ hai kết thúc bằng additionalProperties: unexpected property: "<key>", và với một $import: viết dưới dạng danh sách thay vì chuỗi, nó kết thúc bằng validation: type: array has type "array", want "string".

Thông báo được phát ra, khi giá trị không phải mapping, nêu thứ đã được viết ở đó — ví dụ a list:

parameters: shape must be an inline object or {$import: }: line <line>: <shape> is written where a map is expected (parameters: hình dạng phải là một object viết tại chỗ hoặc một mapping chỉ có $import: một hình dạng khác được viết ở nơi cần một map)

và khi $import: dùng chung mapping với thứ khác, hoặc nêu thứ không phải đường dẫn:

parameters: shape must be an inline object or {$import: }: $import: must be the only key (got <n> keys) at line <line> (parameters: dạng phải là một object viết tại chỗ hoặc {$import: đường dẫn cục bộ}: $import: phải là khóa duy nhất) parameters: shape must be an inline object or {$import: }: $import value must be a string scalar at line <line> (parameters: dạng phải là một object viết tại chỗ hoặc {$import: đường dẫn cục bộ}: giá trị $import phải là một string scalar)

Cách khắc phục: mở Release tại dòng mà thông báo nêu. Viết các giá trị tại chỗ dưới parameters:, hoặc thay toàn bộ khối bằng một mục $import: duy nhất có giá trị là một đường dẫn đặt trong dấu nháy. Nếu bạn muốn có các giá trị viết tại chỗ và một tệp được import chứa các giá trị mặc định dùng chung, hãy chuyển các giá trị viết tại chỗ sang một Release dùng extends: để kế thừa Release chứa phần import — việc xếp lớp nhiều nguồn parameters chính là mục đích của một chuỗi extends:, còn khóa này được thiết kế để chỉ đọc từ một nguồn duy nhất.

Một trường inline-hoặc-import không được viết theo hình dạng nào trong hai hình dạng

Ba trường mà một Recipe hoặc FeatureRecipe viết — một mục artifacts.<name>:, một valuesMapping: và một workload: — chấp nhận cùng hai dạng. Hoặc phần thân được viết tại chỗ, dưới dạng một string scalar (một khối | là cách viết thông thường cho mọi nội dung nhiều dòng), hoặc giá trị là một mapping có đúng một khóa, $import:, chỉ ra nơi phần thân nằm. Những gì một $import: có thể chỉ tới khác nhau theo từng trường: một mục artifacts nhập một đường dẫn cục bộ hoặc một bundle từ một ArtifactLibrary, còn valuesMapping: và workload: nhập một đường dẫn cục bộ hoặc một mục từ một thư viện theo định danh.

Một bộ đọc kiểm tra cả ba, nên các trường hợp bị từ chối là cùng ba trường hợp, bất kể trường nào có lỗi: một mapping mang nhiều hơn một khóa, một mapping có khóa duy nhất không phải là $import, và một $import: có giá trị không phải là một chuỗi thuần. Một giá trị không phải scalar cũng không phải mapping — thường là một danh sách — bị từ chối chỉ vì hình dạng của nó.

Schema của Recipe và FeatureRecipe khai báo cùng hai hình dạng cho mỗi trường trong ba trường, nên một tệp mang bất kỳ trường hợp nào trong số này sẽ gặp lần kiểm tra envelope tài liệu trước, dưới E0215, lần kiểm tra này nêu trường và cho biết vì sao mỗi hình dạng thất bại — nhánh thứ nhất là hình dạng viết tại chỗ, nhánh thứ hai là hình dạng $import::

document envelope validation failed (Recipe, at <path>); <line>:<column>: spec.artifacts.<name>: no oneOf branch matched (2 branches tried): branch[0]: validation: type: object has type “object”, want “string”; branch[1]: additionalProperties: unexpected property: “<key>”. correct the document to match its kind’s schema (xác thực envelope tài liệu thất bại (Recipe); không nhánh oneOf nào khớp với mục spec.artifacts này (đã thử 2 nhánh): branch[0]: xác thực: kiểu là object, cần chuỗi; branch[1]: additionalProperties: thuộc tính không mong đợi. hãy sửa tài liệu cho khớp với schema của kind của nó)

Đó là một mapping mang một khóa bên cạnh $import:. Một khóa duy nhất không phải $import kết thúc bằng required: missing required property: $import, additionalProperties: unexpected property: "<key>", một danh sách kết thúc bằng type: expected object, got array, và một $import: không phải chuỗi sẽ nêu kiểu được tìm thấy ở nơi cần một chuỗi, như trong type: array has type "array", want "string".

Các thông báo được phát ra. Mỗi thông báo mở đầu bằng câu dành cho trường có lỗi, rồi cho biết bộ đọc đã tìm thấy gì và ở đâu:

artifacts entry: shape must be a string scalar or {$import: }: got <n> keys at line <line> valuesmapping: shape must be a string scalar or {$import: }: got key "<key>" at line <line> workload: shape must be a string scalar or {$import: }: $import value must be a string scalar at line <line>

Bất kỳ trường nào trong ba trường cũng có thể báo bất kỳ phần kết nào trong số đó; một giá trị không thuộc hình dạng nào kết thúc bằng line <line>: <shape> is written where text or a map is expected, nêu thứ đã được viết — thường gặp nhất là a list.

Cách khắc phục: mở thực thể tại dòng mà thông báo nêu. Viết phần thân tại chỗ dưới dạng một block scalar, hoặc thay toàn bộ giá trị bằng một mục $import: duy nhất. Một mapping mang $import: cùng bất kỳ thứ gì khác không thuộc một trong hai dạng — hãy chuyển các khóa thừa vào trong tệp được nhập, hoặc viết phần thân tại chỗ. Một $import viết sai chính tả — thường gặp nhất là thiếu $ — được đọc như một khóa thông thường và được báo cáo là khóa duy nhất không phải $import.

Một tham chiếu đến một mục thư viện chứa khoảng trắng

Một tham chiếu chỉ đến một mục bên trong một thư viện được viết thành một token liền mạch: tên thư viện, một mức sàn :<version> tùy chọn, rồi # và đường dẫn của mục — BaseWorkloads:1.0.0#/workloads/StatelessService. Không phần nào của nó chấp nhận khoảng trắng. Tên thư viện và tên mục đều bị các schema thư viện giới hạn trong cách viết định danh, và một phiên bản là một phiên bản, nên một dấu cách, một tab hoặc một ngắt dòng ở bất kỳ đâu trong tham chiếu đều không thuộc về phần nào trong ba phần.

Việc từ chối áp dụng cho mọi nơi tham chiếu một mục thư viện theo định danh: một valuesMapping:, một workload: và một mục artifacts.<name>: được viết dưới dạng $import:, cùng một $ref: của schema. Một đường dẫn cục bộ viết dưới dạng $import: không chứa # và không phải là tham chiếu tới một mục thư viện, nên một đường dẫn có khoảng trắng không bị ảnh hưởng.

Điều khiến trường hợp này đáng bị từ chối thay vì được dọn dẹp là phần đầu của một giá trị như vậy thường tự nó đã là một tham chiếu. Cắt tại khoảng trắng sẽ phân giải tham chiếu đó và lặng lẽ bỏ đi phần còn lại của những gì tác giả đã viết — và hai nửa của một bản build không nhất thiết bỏ đi cùng một lượng, nên một nửa có thể ghi nhận một phụ thuộc mà nửa kia không bao giờ thấy. Việc từ chối giữ cho giá trị chỉ mang một nghĩa.

Sự từ chối được báo tại dòng của tài liệu mà tham chiếu được đọc từ đó:

library reference: a reference to a library entry carries no whitespace or line break: $import target "<reference>" at line <line> (tham chiếu thư viện: một tham chiếu đến một mục thư viện không chứa khoảng trắng hay ngắt dòng: đích $import “<reference>” tại dòng <line>)

Một tham chiếu còn đến được một bản build từ một nơi nữa: phần thân của một mục thư viện mà bản build đã phân giải, nơi một $import: ở gốc trường trên dòng đầu tiên trỏ đến mục của một thư viện khác. Tham chiếu đó chưa bao giờ được đọc từ một tài liệu mà bản build mở, nên nó được báo mà không có dòng:

library reference: a reference to a library entry carries no whitespace or line break: "<reference>" (tham chiếu thư viện: một tham chiếu đến một mục thư viện không chứa khoảng trắng hay ngắt dòng: “<reference>”)

Cách khắc phục: mở thực thể tại dòng mà thông báo chỉ ra và nối liền tham chiếu để nó là một token. Một ngắt dòng trước # là nguyên nhân thường gặp — một tham chiếu bị ngắt qua hai dòng cho vừa một cột được YAML đọc là một giá trị và ở đây là một tham chiếu hỏng, nên hãy viết nó trên một dòng dù dài đến đâu. Một dấu cách thừa trước dấu ngoặc kép đóng là nguyên nhân còn lại: nó nằm trong mức sàn phiên bản, nơi nó chỉ ra một phiên bản mà không artifact đã phát hành nào mang. Với dạng thứ hai, tham chiếu nằm trong thư viện được nêu ngay trước nó trong thông báo; hãy sửa nó tại nơi thư viện đó khai báo mục.

Phần thân của một mục thư viện không có hình dạng mà thư viện đó chứa

Một thư viện công bố các phần thân có tên để các thực thể khác import, và mỗi loại thư viện chứa một hình dạng. Một mục MappingLibrary và một mục WorkloadLibrary mỗi mục chứa một phần thân template, nên giá trị của mục là một scalar — trên thực tế là một khối |. Một mục ArtifactLibrary chứa một bundle: các tệp thuộc về nhau dưới một tên, nên mục là một mapping từ tên tệp đầu ra đến phần thân của tệp đó, và mỗi phần thân bên dưới là một scalar.

Các phần thân được ghi nhận đúng như đã viết và không được phân tích cú pháp khi thư viện được nạp. Template bên trong được phân tích tại nơi nó được import, đó là lý do ở đây chỉ kiểm tra hình dạng — một phần thân hoàn toàn không phải template vẫn được nạp mà không có cảnh báo và thất bại tại điểm có thứ gì đó render nó.

Các thông báo được phát ra, mỗi thông báo nêu dòng và thứ đã được viết ở đó — ví dụ a list:

mappinglibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (mappinglibrary: phần thân mục phải là một chuỗi scalar: một hình dạng khác được viết ở nơi cần văn bản) workloadlibrary: entry body must be a string scalar: line <line>: <shape> is written where text is expected (workloadlibrary: phần thân mục phải là một chuỗi scalar: một hình dạng khác được viết ở nơi cần văn bản) artifactlibrary: entry must be a mapping of filename to a string body: line <line>: <shape> is written where a map is expected (artifactlibrary: mục phải là một mapping từ tên tệp đến một phần thân chuỗi: một hình dạng khác được viết ở nơi cần một map)

và, với một bundle có mục là một mapping nhưng một trong các tệp của nó không phải scalar, nêu tên tệp:

artifactlibrary: entry must be a mapping of filename to a string body: file "<filename>": line <line>: <shape> is written where text is expected (artifactlibrary: mục phải là một mapping từ tên tệp đến một phần thân chuỗi: trong tệp này, một hình dạng khác được viết ở nơi cần văn bản)

Bản build báo các lỗi này dưới một thẻ CATALOG_ERROR nêu tên tệp đang được đọc, với câu ở trên nằm bên dưới.

Cách khắc phục: viết phần thân dưới dạng một block scalar dưới khóa của nó. Một phần thân có dòng đầu trông giống một khóa YAML — điều mà một template sinh ra YAML thường có — sẽ được đọc như một mapping lồng nhau trừ khi có block scalar, và đó là nguyên nhân thường gặp. Với một ArtifactLibrary, hãy viết một khóa cho mỗi tên tệp đầu ra với mỗi phần thân là một block scalar riêng; một bundle được viết thành một phần thân duy nhất là lỗi hình dạng thường gặp còn lại.

A $instantiate: reference cannot be resolved (Không thể phân giải một tham chiếu $instantiate:)

Một SchemaLibrary có thể khai báo các hình dạng tái sử dụng được dưới spec.templates, mỗi hình dạng có $params riêng, và khi đó một mục schema khởi tạo một hình dạng bằng cách nêu tên nó dưới $instantiate: và cung cấp các tham số của nó dưới $args:. Việc thay thế là theo nghĩa đen: một scalar $<name> trong phần thân của template được thay bằng giá trị của đối số. Không có việc đánh giá biểu thức, không có điều kiện và không có vòng lặp, và một giá trị đã được thay thế được chèn vào nguyên trạng thay vì được quét để tìm thêm các dấu đánh dấu.

Ba lỗi khiến việc khởi tạo bị từ chối. Tên dưới $instantiate: không phải là tên mà thư viện khai báo. Một tham số mà template khai báo không có default: lại không có mục nào dưới $args:. Hoặc giá trị của một đối số không đúng kiểu mà tham số của nó khai báo — và một khóa $args: không nêu tên tham số nào đã khai báo cũng được báo cáo theo cùng cách, thay vì bị bỏ qua, nên một tên đối số viết sai chính tả sẽ là một sự từ chối thay vì một tham số âm thầm nhận giá trị mặc định.

Các thông báo được phát ra:

schemalibrary: template not found: "<template-name>" not declared in spec.templates (schemalibrary: không tìm thấy template: tên template không được khai báo trong spec.templates) schemalibrary: template parameter missing: "<parameter-name>" (template "<template-name>") (schemalibrary: thiếu tham số của template) schemalibrary: template parameter type mismatch: <what the type check found> (schemalibrary: kiểu của tham số template không khớp) schemalibrary: template parameter type mismatch: argument "<argument-name>" is not declared in template "<template-name>"’s $params (schemalibrary: kiểu của tham số template không khớp: đối số không được khai báo trong $params của template)

Cách khắc phục: với một template không tìm thấy, hãy sửa tên thành một tên mà thư viện khai báo dưới spec.templates — và kiểm tra rằng bạn đang import đúng thư viện bạn định dùng. Với một tham số bị thiếu, hãy thêm nó vào $args:, hoặc cho tham số một default: trong template để nơi gọi có thể bỏ qua nó. Với một kiểu không khớp, hãy đổi đối số sang kiểu đã khai báo hoặc mở rộng type: của tham số; khi thông báo nêu tên một đối số không được khai báo, hãy sửa chính tả của nó hoặc xóa nó.

A schema uses a JSON Schema keyword the library does not admit (Một schema dùng một từ khóa JSON Schema mà thư viện không chấp nhận)

$dynamicAnchor và $dynamicRef không được chấp nhận trong nội dung SchemaLibrary. Chúng trì hoãn việc xác định một tham chiếu phân giải tới schema nào cho đến khi giá trị đang được xác thực, điều này khiến ý nghĩa của một mục thư viện phụ thuộc vào nơi nó được import thay vì vào nội dung nó nói — và compiler phân giải các hình dạng của một thư viện trước mọi bước xác thực, nên không có gì để một tham chiếu bị trì hoãn phân giải theo.

Sự từ chối được áp dụng tại ba điểm, cùng nhau đóng lại cả hai cách mà từ khóa có thể xuất hiện. Một mục schema được quét khi thư viện nạp. Phần thân của một template được quét khi thư viện nạp, nên một template chứa từ khóa theo nghĩa đen sẽ thất bại ngay tại điểm đó thay vì tại bản build nào khởi tạo nó đầu tiên. Và phần thân sau khi thay thế được quét lại sau một lần khởi tạo, nên việc cung cấp từ khóa dưới dạng giá trị đối số không vượt qua được hai điểm đầu.

Thông báo được phát ra:

schemalibrary: forbidden JSON Schema keyword: "$dynamicRef" at line <line> (schemalibrary: từ khóa JSON Schema bị cấm: “$dynamicRef” tại dòng <line>)

Cách khắc phục: thay tham chiếu bị trì hoãn bằng một $ref trỏ trực tiếp tới một mục $defs. Khi hình dạng thực sự thay đổi theo từng lần dùng, hãy biểu đạt sự thay đổi đó thành một template với $params và khởi tạo nó cho từng lần dùng — đó là cơ chế thay thế mà bề mặt này cung cấp, và nó được phân giải trước khi bất cứ thứ gì được xác thực theo kết quả.

A document nests deeper than the reader will descend (Một tài liệu lồng sâu hơn mức bộ đọc sẽ đi xuống)

Mọi mapping được viết đều được đọc vào một cấu trúc giữ nguyên thứ tự các khóa đã được viết, vì thứ tự đó đi tới đầu ra được render và là một phần của điều khiến một bản build giống hệt nhau từng byte qua các lần chạy. Bộ đọc đó đi xuống một số cấp có giới hạn — một trăm — và từ chối đi sâu hơn, nên đầu vào lẽ ra sẽ làm cạn stack của chính bộ đọc được báo cáo đúng như một sự từ chối.

Thông báo được phát ra:

a document nests too many levels deep: it is read at most 100 levels deep (một tài liệu lồng quá nhiều cấp: nó chỉ được đọc tối đa 100 cấp)

Cách khắc phục: các tài liệu thực tế do người viết chỉ lồng vài cấp, nên một tài liệu đạt tới một trăm cấp là do được sinh tự động, dịch máy, hoặc vô tình tự tham chiếu. Hãy tìm một giá trị đã tự mở rộng vào chính nó — một YAML anchor tham chiếu tới nội dung chứa nó bị từ chối bởi điểm dừng riêng ở phía trên, nhưng một trình sinh phát ra cùng một hình dạng lặp đi lặp lại thì không. Khi độ sâu là thật sự cần thiết, hãy tách nhánh sâu thành một thực thể riêng và tham chiếu nó theo tên.

A provider declares a well-known annotation at a scope it does not render (Một provider khai báo một annotation phổ biến tại một phạm vi mà nó không render)

Một Plugin phục vụ một provider nói hai điều về chính nó, và hai điều đó phải khớp nhau. Dưới spec.provider.wellKnownAnnotations, nó liệt kê các annotation mà nó xử lý, mỗi annotation kèm các phạm vi nơi nó đọc chúng. Dưới contract.inputKinds, nó nói những loại đầu vào nào nó render. Một khóa được khai báo tại một phạm vi mà loại đầu vào của phạm vi đó không được chính thực thể ấy nhận là hai phát biểu đó mâu thuẫn nhau trong cùng một tệp, nên thực thể bị từ chối ngay khi nạp.

Phép kiểm tra là sự so sánh thực thể với chính nó, đó là lý do nó không cần tệp nhị phân plugin nào và được kích hoạt ở bất cứ đâu thực thể được đọc — kể cả trong một lượt duyệt catalog trên một máy chưa từng tải artifact về.

Có hai loại mục được cố ý không so sánh. Một mục có phạm vi boundary không nêu loại đầu vào nào, vì nó được phân giải một lần cho cả một boundary thay vì trên đường render của bất kỳ node nào. Một mục không khai báo phạm vi nào thì không đưa ra khẳng định theo từng đường: nó chỉ nói rằng plugin đọc khóa ở đâu đó.

Điều mà sự từ chối không xác lập là một khai báo còn lại là đúng. Không gì có thể chứng minh rằng plugin phục vụ một provider thực sự đọc một khóa mà nó nói nó đọc; điều mà việc so sánh hai trường được viết có thể làm là từ chối cặp không thể cùng đúng. Một khóa được khai báo tại một phạm vi mà provider có render, nhưng plugin của nó không đọc gì ở đó, vẫn qua được bước này.

Thông báo được phát ra:

provider "<plugin-name>" declares well-known annotation "<key>" at scope "<scope>", but its contract.inputKinds.<field> is not claimed; declare the key only at a scope the provider renders, or claim the input kind: wellKnownAnnotations: a key is declared at a scope the provider’s contract does not render (provider khai báo một annotation well-known tại một scope, nhưng trường tương ứng trong contract.inputKinds của nó không được khai nhận; chỉ khai báo khóa tại scope mà provider render, hoặc khai nhận input kind đó: wellKnownAnnotations: một khóa được khai báo tại scope mà contract của provider không render)

Cách khắc phục: thông báo nêu cả hai nửa. Hoặc bỏ phạm vi đó khỏi danh sách scope: của annotation, giữ lại các phạm vi mà provider có render, hoặc nhận loại đầu vào dưới contract.inputKinds nếu provider thực sự render nó.

Một schema dạng compact dùng một từ khóa mà dạng compact không biết

Một schema viết ở dạng compact mang một khóa không phải là từ khóa của dạng compact, cũng không phải một trong các từ khóa JSON Schema mà dạng này cho đi qua, cũng không phải một trong ba dấu hiệu mà dạng này dành riêng — $jsonschema:, $mode: và $ref:. Các khóa không xác định bị từ chối ngay khi schema được đọc thay vì bị bỏ qua, vì một ràng buộc gõ sai mà bị bỏ qua sẽ trở thành không có ràng buộc nào cả, và một schema trông như được thực thi nhưng không thực thi gì còn tệ hơn một schema thất bại.

Sự từ chối xảy ra ở bất cứ nơi nào một schema được biên dịch. Các mục của một SchemaLibrary được biên dịch khi catalog được tải; spec.schema của một Component, valueSchema và infraSchema theo từng socket của nó, cùng các schema mà một Feature và một Plugin provider khai báo được biên dịch khi catalog được đọc. spec.schema của một Component hay Feature tự báo cáo điều kiện này, nêu thực thể và trường; valueSchema hoặc infraSchema của một socket báo cáo bên trong “A declared schema contract cannot be read as a schema (Một hợp đồng schema đã khai báo không thể được đọc như một schema)” bên dưới, mang câu được trích ở đây làm chi tiết của nó.

Câu riêng của trình biên dịch dạng compact nêu vị trí bên trong schema, dòng nguồn và khóa mà nó không nhận ra:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): unknown keyword (từ khóa không xác định)

Một khóa viết bên cạnh một $ref: liên tài liệu cũng báo lỗi theo cùng điều kiện này, với một câu riêng, vì chỉ ba khóa anh em được phép đi kèm một tham chiếu như vậy:

compactform at <path-inside-the-schema>:<line> (keyword "<key>"): cross-document $ref sibling not allowed (allowed: properties, required, description) (không cho phép khóa anh em của $ref liên tài liệu (được phép: properties, required, description))

và khi khóa anh em đó yêu cầu mở lại hình dạng đã hợp nhất, câu sẽ nêu cách làm thay thế:

compactform at <path-inside-the-schema>:<line> (keyword "additionalProperties"): cross-document $ref sibling not allowed (allowed: properties, required, description); use $jsonschema: to embed an open-object schema if the merged shape must accept arbitrary properties (không cho phép khóa anh em của $ref liên tài liệu (được phép: properties, required, description); hãy dùng $jsonschema: để nhúng một schema đối tượng mở nếu hình dạng đã hợp nhất phải chấp nhận các thuộc tính tùy ý)

Điều kiện mà nó được ghi nhận là compactform: unknown keyword, cũng là thứ mà mã ngắn của nó trỏ tới.

Cách khắc phục: sửa khóa tại vị trí mà câu nêu, đối chiếu với bộ từ khóa trong compact-form-authoring.md — lỗi chính tả là nguyên nhân phổ biến nhất. Khi hình dạng thực sự cần một từ khóa JSON Schema mà dạng compact không có, hãy viết đoạn đó dưới $jsonschema:, nơi nhúng JSON Schema nguyên văn. Bên cạnh một tham chiếu liên tài liệu, chỉ giữ properties:, required: và description:; mọi thứ khác thuộc về mục thư viện mà tham chiếu trỏ tới.

Một schema dạng compact khai báo một trường có tên đúng là type

Dạng compact xác định ý nghĩa của một mapping từ hình dạng nội dung của nó: một khóa type: đánh dấu một lá ràng buộc, các từ khóa cấu trúc JSON Schema đánh dấu một đoạn cần cho đi qua, và một mapping gồm các tên thông thường đánh dấu một đối tượng có các con là schema. Một schema khai báo một trường có tên type là hình dạng duy nhất mà các cách đọc đó không phân biệt được — nó trông như một lá ràng buộc nhưng lại có ý là một đối tượng có một trường — nên dạng này yêu cầu tác giả nói rõ là cái nào, bằng một khóa $mode: đặt thành compact hoặc jsonschema.

Điều kiện này là thứ được báo khi $mode: được viết với bất kỳ giá trị nào khác. Dấu hiệu này tồn tại để giải quyết sự mơ hồ, nên một giá trị không giải quyết được gì sẽ bị từ chối thay vì bị đoán.

Câu riêng của trình biên dịch dạng compact:

compactform at <path-inside-the-schema>:<line> (keyword "$mode"): value must be compact or jsonschema (compactform tại <path-inside-the-schema>:<line> (từ khóa “$mode”): giá trị phải là compact hoặc jsonschema)

Điều kiện mà nó được ghi nhận là compactform: ambiguous dispatch — $mode required, cũng là thứ mà mã ngắn của nó trỏ tới.

Cách khắc phục: đặt $mode: compact khi mapping là một đối tượng dạng compact mà các trường của nó tình cờ có một trường tên type, hoặc $mode: jsonschema khi mapping là một đoạn JSON Schema cần được lấy nguyên như đã viết. Khi không có ý định nào trong hai cách đọc đó, việc đổi tên trường sẽ xóa sự mơ hồ mà không cần dấu hiệu nào.

Một lối thoát $jsonschema: mang nội dung không phải là schema

Khóa $jsonschema: nhúng nguyên văn một đoạn JSON Schema, cho các hình dạng mà dạng compact không diễn đạt được. Những gì nó nhúng được lấy nguyên như đã viết và không bao giờ được chuyển đổi, nên nó phải là một schema: một block scalar phân tích được thành YAML, hoặc một mapping lồng nhau. Nội dung không thuộc loại nào sẽ bị từ chối tại đây thay vì được chuyển tiếp để dùng làm chuẩn kiểm tra, nơi lỗi sẽ được báo đối với bên sử dụng schema thay vì đối với chính schema.

Bốn hình dạng báo lỗi theo điều kiện này, và câu cho bạn biết bạn gặp hình dạng nào. Phần thân lối thoát không phân tích được thành YAML. Giá trị của lối thoát không phải block scalar cũng không phải mapping. Một khóa properties: chứa thứ không phải mapping từ tên tới schema. Và, ở cấp ngoài cùng, tài liệu đưa cho trình biên dịch bị rỗng hoặc mang một node mà trình đọc không có quy tắc xử lý.

Các câu riêng của trình biên dịch dạng compact:

compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): escape content does not parse as YAML: <what the parse reported> (nội dung lối thoát không phân tích được thành YAML) compactform at <path-inside-the-schema>:<line> (keyword "$jsonschema"): expected block-scalar string or nested mapping (cần một chuỗi block-scalar hoặc mapping lồng nhau) compactform at <path-inside-the-schema>:<line> (keyword "properties"): expected a mapping of property names to schemas (cần một mapping từ tên thuộc tính tới schema) compactform: unsupported YAML node kind (loại node YAML không được hỗ trợ)

Điều kiện mà nó được ghi nhận là compactform: $jsonschema content invalid, cũng là thứ mà mã ngắn của nó trỏ tới.

Cách khắc phục: viết phần thân lối thoát thành một block scalar dưới $jsonschema: — nếu không, một phần thân có dòng đầu tiên đọc như một khóa YAML sẽ bị hấp thụ vào mapping bao quanh, đây là nguyên nhân phổ biến — và kiểm tra rằng những gì nó chứa tự thân là JSON Schema hợp lệ. Khi đoạn đó đủ nhỏ để diễn đạt ở dạng compact, bỏ lối thoát là cách đơn giản hơn.

Một ràng buộc dạng compact không áp dụng cho kiểu mà nó được viết trên đó

Các ràng buộc dạng compact được phân phối theo kiểu đã khai báo của trường: min: và max: trở thành giới hạn số trên một số, giới hạn độ dài trên một chuỗi, và giới hạn số phần tử trên một mảng. Vì vậy một ràng buộc phải nằm trên một trường có kiểu chấp nhận nó, và kiểu phải là một giá trị duy nhất thì việc phân phối mới có câu trả lời.

Bốn hình dạng báo lỗi theo điều kiện này. Một ràng buộc được viết khi type: vắng mặt hoặc nêu một union, nên không có gì quyết định giới hạn nào được dự định. Một ràng buộc được viết trên một kiểu không nhận giới hạn loại đó — một đối tượng, hoặc một boolean. Một type: có giá trị không phải tên scalar cũng không phải một dãy tên. Và một valuesType: được gán thứ khác ngoài một tên scalar.

Các câu riêng của trình biên dịch dạng compact:

compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to a single declared type (integer/number/string/array); type: is unresolved (union or absent) — narrow type: to a single value or remove this constraint compactform at <path-inside-the-schema>:<line> (keyword "<constraint>"): constraint applies to integer/number/string/array; declared type is <the type as written> compactform at <path-inside-the-schema>:<line> (keyword "type"): expected a scalar type name or a sequence of type names (JSON Schema 2020-12 array-of-types); got unsupported node kind compactform at <path-inside-the-schema>:<line> (keyword "valuesType"): expected a scalar type name

Điều kiện mà nó được ghi nhận là compactform: constraint not valid for declared type, cũng là thứ mà mã ngắn của nó trỏ tới.

Cách khắc phục: câu nêu cả hai nửa — ràng buộc và kiểu mà nó gặp. Thu hẹp type: về một tên duy nhất khi nó chứa một union, thêm nó khi bị thiếu, hoặc bỏ ràng buộc khi trường thực sự nhận bất kỳ kiểu nào trong số nhiều kiểu. Một giới hạn phải thay đổi theo kiểu được diễn đạt thành một tập các phương án dưới $jsonschema:, nơi mỗi nhánh mang kiểu riêng và giới hạn riêng của nó.

Một $ref: không được viết theo dạng mà trình biên dịch có thể phân giải

Một schema tham chiếu đến một hình dạng khác bằng $ref:, hoặc trong cùng tài liệu, hoặc xuyên tài liệu vào một mục của SchemaLibrary. Hai điều kiện bao quát hai cách một tham chiếu thất bại, và câu thông báo cho bạn biết bạn gặp trường hợp nào: tham chiếu không được viết theo dạng trình biên dịch đọc được, hoặc nó đúng cú pháp nhưng chỉ đến một đích không tồn tại.

Tham chiếu không đọc được. Giá trị rỗng, hoặc dạng xuyên tài liệu của nó không phải là <Library>#/schemas/<Entry>, hoặc nó tách phiên bản bằng @ — trường hợp này được báo cáo kèm cách viết đã sửa thay vì một lời phàn nàn chung chung, vì đây là lỗi mà dạng này hay gặp nhất:

compactform at <path-inside-the-schema>:<line> (keyword "$ref"): expected a non-empty reference URL compactform at <consumer-document> (keyword "$ref"): cross-document $ref shape must be <LibraryName>#/schemas/<EntryName>: <the value as written> compactform at <consumer-document> (keyword "$ref"): cross-document $ref version separator is ’:’, not ’@’ — use <the corrected value>: <the value as written>

Điều kiện mà các thông báo trên được ghi nhận là compactform: $ref unresolvable.

Đích không tồn tại. Tham chiếu đọc đúng nhưng thư viện hoặc mục bên trong nó không có — hoặc hoàn toàn không có catalog thư viện nào được cung cấp để phân giải:

compactform at <consumer-document> (keyword "$ref"): SchemaLibrary <library> not found in catalog (referenced from <consumer-document>): <the value as written> compactform at <consumer-document> (keyword "$ref"): entry <entry> not found in SchemaLibrary <library>: <the value as written> compactform at <path-inside-the-schema>:<line> (keyword "$ref"): cross-document $ref but no SchemaLibrary catalog supplied: <the value as written>

Điều kiện mà các thông báo trên được ghi nhận là compactform: cross-document $ref target not found.

Việc tách riêng hai trường hợp giúp báo cáo có thể hành động được: trường hợp đầu là một giá trị cần viết lại trong tài liệu bạn đang xem, còn trường hợp thứ hai là câu hỏi về những gì bản build có thể thấy. Một tham chiếu tự mở rộng vào chính nó lại là một trường hợp thứ ba, và được báo cáo là “A library reference expands into itself (Một tham chiếu thư viện tự mở rộng vào chính nó)” ở trên.

Cách khắc phục: với tham chiếu không đọc được, hãy viết lại giá trị — <Library>#/schemas/<Entry> cho tham chiếu xuyên tài liệu, #/$defs/<name> cho tham chiếu trong cùng tài liệu — và dùng : trước mức phiên bản tối thiểu thay vì @. Với đích không tồn tại, hãy đối chiếu tên của mục với thư viện công bố nó, và xác nhận rằng thư viện có thể truy cập được từ bao đóng phụ thuộc của Release: một thư viện mà không ai khai báo phụ thuộc thì không được nạp, nên một tham chiếu đúng vào nó vẫn phân giải thành rỗng.

Khi thư viện chỉ nằm trong bộ nhớ đệm artifact. Bộ nhớ đệm giữ những gì một lần tải về đã đặt vào đó, và một thư viện trong bộ nhớ đệm chỉ được tính là nội dung catalog khi một mục trong lockfile của Release bảo chứng cho digest của nó. Khi bộ nhớ đệm chứa một SchemaLibrary mà không mục lockfile nào ghim và không thư mục catalog nào cung cấp, báo cáo sẽ được theo sau bởi một dòng remediation: nêu tên từng thư viện như vậy và hành động có hiệu quả đối với lệnh đã báo cáo nó:

  • aggrega build và aggrega validate --release đọc lockfile của Release, nên dòng của chúng nêu aggrega pull --release <release>, lệnh phân giải thư viện và ghi lại mục của nó, hoặc việc tạo thư viện trong một thư mục catalog.
  • aggrega validate không có đối số, và aggrega validate với một đường dẫn thực thể dù có cung cấp --release hay không, chỉ đọc thư viện từ các thư mục catalog và không đọc lockfile nào, nên một mục đã ghi lại sẽ không thay đổi kết luận của chúng. Dòng của chúng nói rõ điều đó, và chỉ tới việc tạo thư viện trong một thư mục catalog, hoặc tới aggrega pull --release <release> rồi đến aggrega validate --release <release>, lệnh kiểm tra Release dựa trên các thư viện mà lockfile của nó ghim.

Một lần pull không tìm thấy thư viện như vậy sẽ báo cáo nó dưới mục A reference names no entity the catalog holds (Một tham chiếu nêu tên một thực thể mà catalog không chứa), với một dòng riêng.

Một $ref: định địa chỉ thư viện theo vị trí registry

Một $ref: xuyên tài liệu gọi tên thư viện của nó theo danh tính — tên trần của thư viện, rồi # và đường dẫn của mục — và không bao giờ theo registry mà nó tình cờ được công bố lên. Một tên được phân giải qua registry nào là cấu hình workspace, còn phiên bản nào được dùng là câu trả lời của lockfile, nên một tham chiếu mang theo host sẽ cố định trong schema hai điều mà bản build có nhiệm vụ quyết định, và khi chuyển schema giữa các workspace sẽ thành một tham chiếu hỏng.

Khi giá trị có host vẫn phân tích được thành một thư viện và một mục, câu thông báo mang theo cách viết dạng danh tính để dùng thay thế:

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity (use <Library>#/schemas/<Entry>): <the value as written>

và khi không phân tích được, câu kết thúc sau giá trị:

compactform at <consumer-document> (keyword "$ref"): cross-document $ref carries a registry host; reference the library by identity: <the value as written>

Điều kiện mà nó được ghi nhận là compactform: cross-document $ref carries a registry host; reference the library by identity, cũng là thứ mà mã ngắn của nó phân giải tới.

Cách khắc phục: bỏ host và mọi thứ đứng trước tên thư viện, chỉ để lại <Library>#/schemas/<Entry>. Khi cần một mức phiên bản tối thiểu, hãy viết nó sau tên thư viện dưới dạng :<version>. Cùng quy tắc này áp dụng cho các trường $import: trên một Recipe và một FeatureRecipe, vốn được báo cáo riêng dưới “A library $import: addresses its library by registry location (Một thư viện tham chiếu thư viện của nó theo vị trí registry)” ở bên dưới.

A schema $import: cannot be applied (Không thể áp dụng một $import: của schema)

spec.schema của một Component hoặc Feature — toàn bộ khối hoặc một trụ cột của nó — và valueSchema: hoặc infraSchema: của một socket usesSchema đều có thể được viết dưới dạng $import: chỉ tới một tệp nằm cạnh thực thể. Lệnh import được áp dụng khi thực thể được nạp, nên mọi bên đọc về sau đều thấy hợp đồng đã được import thay vì con trỏ. Điều kiện này xảy ra khi lỗi nằm ở chính những gì bạn viết: bản thân chỉ thị, hoặc hình dạng của nội dung mà tệp nó chỉ tới hóa ra chứa.

Các lỗi đó là một điều kiện duy nhất vì mỗi lỗi đều khiến cùng một bề mặt không dùng được và cho bạn cùng một việc cần làm — sửa chỉ thị, hoặc sửa tệp mà nó chỉ tới. Chẩn đoán mở đầu bằng câu cố định rồi cho biết lỗi nào, nên câu đó là phần để đối chiếu và mệnh đề theo sau là điều cần xử lý:

a schema $import: could not be applied. <surface>: <the clause for this occurrence>

Mệnh đề nêu tên bề mặt đã đọc — spec.schema, một trụ cột của nó như spec.schema.values, hoặc valueSchema của một socket — kèm theo lỗi cụ thể. Các lỗi và ý nghĩa của từng lỗi:

  • $import: must be the only key when a schema is imported from a file (khi import schema từ tệp, $import: phải là khóa duy nhất). Chỉ thị nằm chung mapping với nội dung schema được viết tay. $import: thay thế toàn bộ một giá trị, nên khóa anh em không có gì để kết hợp.
  • $import: value must be a path to a file (giá trị của $import: phải là đường dẫn tới một tệp). Giá trị rỗng, hoặc không phải một chuỗi đơn.
  • $import: takes a file path beside this entity, not a registry location <value> ($import: nhận đường dẫn tệp nằm cạnh thực thể này, không phải vị trí registry <value>). Giá trị trỏ tới một registry. Việc một tên được phân giải qua registry nào là cấu hình workspace, nên một bề mặt schema không bao giờ mang registry; thông báo nêu dạng tham chiếu cần dùng thay thế.
  • $import: takes a file path beside this entity; reference the SchemaLibrary entry <value> with $ref: instead ($import: nhận đường dẫn tệp nằm cạnh thực thể này; hãy tham chiếu mục SchemaLibrary <value> bằng $ref: thay vào đó). Giá trị trỏ tới một mục thư viện. Một mục thư viện được tham chiếu, không được import — $ref: là từ khóa phân giải nó.
  • imported schema <value> must be a YAML map of schema content; it is not (schema được import <value> phải là một map YAML chứa nội dung schema; nhưng không phải). Tệp đã được tìm thấy, đọc và phân tích, và kết quả phân tích là một giá trị vô hướng hoặc một chuỗi, nên không có nội dung schema nào để thay thế.

Phần đầu mang danh mục và mã ngắn của điều kiện này, E0266, là định danh cần ghi lại khi bạn cần gọi tên lần dừng này một cách bền vững — trong một cổng tích hợp liên tục, một issue, hoặc một runbook. Mỗi số được cấp một lần rồi cố định, nên nó giữ nguyên dù câu chữ xung quanh được cải thiện thế nào; bảng mọi điều kiện phân giải nó.

Một chỉ thị đúng dạng nhưng chỉ tới một tệp mà bản build không lấy được sẽ được báo ở nơi khác, dưới một mã khác. Một đường dẫn không phân giải được, một tệp không tồn tại hoặc không đọc được, và các byte không phân tích được thành YAML không phải lỗi trong những gì bạn viết — không có tài liệu được import nào để đánh giá — nên chúng được báo như lỗi nạp, dưới “A file cannot be read, or its bytes do not parse (Không thể đọc một tệp, hoặc không phân tích được các byte của nó)” ở trên, nơi mô tả mệnh đề mà mỗi trường hợp mang theo. Hãy đối chiếu với điều kiện đó, và ghi lại mã của nó, khi điều bạn đang bắt là một tệp import bị thiếu hoặc không đọc được.

Đường dẫn được phân giải tương đối với thư mục chứa tệp thực thể, cùng gốc mà mọi trường mang import khác sử dụng. Một import mà bản thân nội dung khai báo $import: sẽ được đi theo, và một chuỗi quay lại một tệp đang được xử lý sẽ được báo là “A library reference expands into itself (Một tham chiếu thư viện tự mở rộng vào chính nó)” ở trên thay vì ở đây. Một chỉ thị được viết bên trong một tệp mà import mang vào được báo cáo tại tệp đó và dòng trong tệp, vì đó là nơi cần sửa; một chỉ thị được viết trong thực thể được báo cáo tại thực thể.

Cách khắc phục: đặt $import: làm khóa duy nhất trong mapping của nó, và cho nó một đường dẫn tương đối tới một tệp YAML nằm cạnh thực thể có cấp cao nhất là một map nội dung schema. Để dùng một hình dạng mà một SchemaLibrary công bố, hãy dùng $ref: <Library>#/schemas/<Entry> thay vào đó — một mục thư viện được tham chiếu chứ không được import.

A schema block names a key that is not a data pillar (Một khối schema nêu tên một khóa không phải trụ cột dữ liệu)

Khối spec.schema của một Component hoặc Feature mang các trụ cột dữ liệu của thực thể, và ba khóa là toàn bộ những gì nó chấp nhận: values, hình dạng mà nhà phát triển điền cho từng instance; infra, kích thước vật lý mà người vận hành cung cấp; và provides, các khóa mà thực thể phơi bày cho bất kỳ bên nào sử dụng nó. Điều kiện này xảy ra khi khối mang một khóa khác ở cấp cao nhất.

Tập này đóng chứ không mở, cùng lý do nội dung của mỗi trụ cột được kiểm tra theo kiểu đóng: một khối liệt kê một bề mặt hợp lệ khiến mọi thứ ngoài bề mặt đó là lỗi. Một khóa không gì nhận ra sẽ mang một hợp đồng không bao giờ được biên dịch, dùng để kiểm tra, hay trao cho bên sử dụng — nên những gì bạn viết bên dưới nó trông như đã khai báo nhưng không có tác dụng. Điều đó khó nhận ra hơn một hợp đồng bạn chưa từng viết, đó là lý do khối bị từ chối thay vì khóa lạc bị bỏ qua.

Chẩn đoán mở đầu bằng câu cố định, rồi nêu tên thực thể, quy tắc, vị trí khóa được viết, và điều nên viết thay thế:

a schema block declares a key that names no data pillar (<Kind> <name>, rule schema-pillars, at .spec.schema.<key>). rename "<key>" to one of the pillar keys, or remove it and the contract beneath it; allowed: values, infra, provides. See vocabulary/data-pillars.md for the canonical pillar set.

Phần đầu mang danh mục và mã ngắn của điều kiện này, E0267, là định danh cần ghi lại khi bạn cần gọi tên lần dừng này một cách bền vững — trong một cổng tích hợp liên tục, một issue, hoặc một runbook. Mỗi số được cấp một lần rồi cố định, nên nó giữ nguyên dù câu chữ xung quanh được cải thiện thế nào; bảng mọi điều kiện phân giải nó.

Hai thứ được viết ở vị trí đó không phải khóa của tập này, và không thứ nào được báo ở đây. Một $import: chỉ tới một tệp nằm cạnh thực thể được thay bằng nội dung tệp đó trước khi khối được đọc, nên điều kiện này kiểm tra cấp cao nhất của chính tài liệu được import — một khóa lạc bên trong tệp được import sẽ được báo ở đây, còn bản thân chỉ thị thì không bao giờ. Và một Component khai báo extends viết chuỗi trần inherited thay cho khối, là một giá trị vô hướng không mang khóa nào.

Cách khắc phục: câu thông báo nêu tên khóa nó gặp và ba khóa nó chấp nhận, nên nguyên nhân phổ biến nhất — viết sai chính tả, hoặc dùng số ít trong khi tên trụ cột là số nhiều — có thể thấy ngay từ chẩn đoán. Khi nội dung bên dưới khóa lạc thuộc về một trụ cột, hãy chuyển nó vào values:, infra: hoặc provides: tùy theo quyền sở hữu; data-pillars.md cho biết trụ cột nào sở hữu gì. Khi nó vốn là nội dung schema độc lập, nó thuộc về sâu hơn một cấp, bên trong một trụ cột, thay vì nằm cạnh chúng. Một hình dạng do một SchemaLibrary công bố được truy cập bằng $ref: <Library>#/schemas/<Entry> viết bên trong một trụ cột, không phải ở cấp khối.

A plugin asks the host to parse a source while a parse is already running for it (Một plugin yêu cầu host phân tích một nguồn trong khi một lần phân tích đang chạy cho chính nó)

Một plugin có thể yêu cầu host phân tích một nguồn và trả lại kết quả, để một plugin cần một tài liệu ở định dạng nào đó không phải tự mang theo bộ đọc cho định dạng ấy. Host chạy plugin tạo ra kết quả phân tích và trả về những gì plugin đó tạo ra. Điều kiện này là những gì xảy ra khi plugin được gọi theo cách đó lại yêu cầu một lần phân tích của riêng nó: yêu cầu ấy sẽ đi lại vào chính cơ chế mà nó đang chạy bên trong, và host từ chối thay vì đi sâu thêm. Cơ chế này cung cấp đúng một cấp như vậy, và sự từ chối là thứ giữ nó ở một cấp.

Sự từ chối đến với plugin, không phải với bản build. Host không dừng lại ở đó và tháo lui; nó trả lời lời gọi bằng một phong bì lỗi mang câu dưới đây và một mã chỉ rõ sự từ chối, và plugin đã yêu cầu nhận nó như câu trả lời cho yêu cầu của mình. Bản build sau đó làm gì phụ thuộc vào việc plugin đó xử lý câu trả lời ra sao — một plugin coi nó là lỗi nghiêm trọng sẽ kết thúc bản build, còn một plugin báo cáo rồi tiếp tục thì không. Bản thân sự từ chối là như nhau trong cả hai trường hợp.

Đây không phải lỗi riêng của plugin nào: cơ chế bảo vệ áp dụng cho bất kỳ cặp plugin nào mà yêu cầu đi qua chứ không phải một cặp được chỉ định, nên cùng một sự từ chối sẽ gặp ở bất cứ đâu cơ chế bị đi lại vào.

Thông báo được phát ra, như plugin nhận được:

aggrega_parse_source: producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call (aggrega_parse_source: từ chối đi lại vào producer-consumption: một producer được gọi thông qua host không được phát thêm một lời gọi producer-consumption nào nữa)

Cách khắc phục: không có gì trong các tệp của bạn gây ra điều này và không thay đổi nào trong nội dung bạn viết có thể xóa nó — đây là một thuộc tính của các plugin mà bản build được cấu hình cùng. Plugin yêu cầu phân tích từ bên trong một lần phân tích là plugin cần sửa, vì vậy hãy báo điều kiện này cho bên phát hành nó, kèm theo thông báo. Nếu plugin đó là của bạn, hãy để nó đọc trực tiếp nguồn mà nó được giao thay vì yêu cầu host phân tích một nguồn khác trong khi chính nó đang phục vụ một lần phân tích.

The workspace configuration is invalid (Cấu hình workspace không hợp lệ)

Một workspace được mô tả bởi một tệp .aggrega-config.yaml ở thư mục gốc của nó: registry mà nó phát hành lên và kéo về, nơi đặt bộ nhớ đệm artifact, các plugin nào được gắn vào socket nào, và lập trường ký của từng registry. Tệp đó được đọc và kiểm tra theo schema của nó trước khi bất kỳ tệp thực thể nào được mở, vì mọi thứ diễn ra sau đó đều được đọc từ nó.

Thiếu tệp không phải là lỗi. Một workspace không có tệp cấu hình sẽ nhận các giá trị mặc định đã được ghi trong tài liệu, nên điểm dừng này không bao giờ nêu tên một tệp không tồn tại. Nó nêu tên tệp mang giá trị đó — hoặc, với một thiết lập mà biến môi trường ghi đè và schema không bao giờ thấy, thì nêu tên biến đó.

Việc kiểm tra chạy trước khi tài liệu được chuyển thành các thiết lập có kiểu. Thứ tự đó là điều cho phép thông báo nêu đường dẫn trường mà schema phản đối, thay vì báo một lỗi không khớp kiểu từ một chỗ nào đó xa hơn mà không có trường nào để chỉ ra.

Những dạng sau được báo ở đây ngoài một phản đối schema thông thường, mỗi dạng vì riêng schema chỉ có thể nói điều gì đó quá chung chung để hành động: một khóa workspace: được viết mà không có gì bên dưới, một khóa vốn thuộc cấp cao nhất lại được viết bên dưới workspace:, một khối cache: được viết dưới một tên mà tệp không dùng, một host registry không được viết theo cách một host registry được viết, và ba thiết lập có giá trị mà schema chấp nhận nhưng workspace không dùng được — một artifact_cache_dir là đường dẫn tuyệt đối hoặc chỉ chính thư mục gốc của workspace, một mục signing.kinds nêu một thứ không phải loại artifact có thể phát hành, và một mục plugins.providers hoặc providers_append có uri là một vị trí registry được viết với oci://. Một liên kết provider nêu plugin của nó theo định danh, provider/<name> với :<version> tùy chọn, vì định danh đó chính là thứ mà liên kết được đối chiếu khi một capability được phân giải; một vị trí registry cho biết plugin được phát hành ở đâu, không cho biết đó là plugin nào, nên một mục được viết như vậy không bao giờ có thể chọn được gì. Một mục nêu một hàm điểm vào bằng function: mà không có uri: cũng được báo ở đây, khi đó là một mục plugins.linter hoặc linter_append, hoặc một mục plugins.governance hoặc governance_append ở vai trò phán quyết, ir-verdict hoặc render-verdict: các mục gắn đó chọn plugin của chúng theo uri, nên một mục như vậy không gắn plugin nào và hàm mà nó nêu sẽ không bao giờ được gọi — một lần lint sẽ tiếp tục chạy như thể mục đó không tồn tại, và một bản build chỉ dừng lại muộn hơn, khi đến lúc phân giải một plugin mà mục đó chưa bao giờ nêu.

Một thư mục catalog mà cấu hình liệt kê — dưới workspace.catalog_dirs hoặc catalog_dirs_append, hoặc trong mục riêng của một Release dưới workspace.releases, trong bất kỳ tệp nào mà cấu hình được đọc từ đó — cũng được báo cáo ở đây khi nó không phải là thư mục: không có gì tồn tại ở đường dẫn đó, hoặc ở đó là một tệp hay một liên kết không trỏ tới đâu. Điều này được xét khi một catalog sắp được đọc qua nó, nên mọi lệnh đọc catalog đều từ chối nó trước khi đọc hay ghi bất cứ thứ gì, trong khi một lệnh không đọc catalog vẫn chạy. Tiếp tục đọc mà không có nó sẽ build với ít catalog hơn số bạn đã liệt kê, mà không có gì cho biết là thiếu những catalog nào. Một thư mục do AGGREGA_CATALOG_DIRS liệt kê cũng tuân theo cùng quy tắc, và lời từ chối nêu biến đó thay cho một tệp.

Một host registry — host của một mục registries, hoặc host mà default_registry bắt đầu bằng khi nó không nêu một trong các mục đó theo name: của mục, trong trường hợp đó nó đại diện cho host của mục ấy — được viết dưới dạng chính host đó: chữ thường, chứa dấu chấm, hoặc localhost, hoặc một tên đơn theo sau là một cổng, hoặc một địa chỉ IP (địa chỉ IPv6 thì đặt trong ngoặc vuông), mỗi dạng có thể kèm :port tùy chọn, và không có scheme hay thông tin xác thực. Host của một mục registries không mang đường dẫn; default_registry có thể theo sau host của nó bằng / và một đường dẫn repository — các đoạn chữ thường nối bằng /, không có tag, digest hay / ở cuối. Một giá trị nêu một host theo cách viết khác sẽ bị từ chối kèm cách viết cần dùng — với default_registry là toàn bộ vị trí, gồm cả đường dẫn — để chính sách tin cậy lưu dưới host đó áp dụng cho nó; điều này bao gồm cả cổng 443 trên một host truy cập qua HTTPS, vì đó là cổng mặc định của host ấy. Một đường dẫn không phải đường dẫn repository sẽ bị từ chối kèm tên host đứng trước nó, và name: của một mục theo sau là một đường dẫn sẽ bị từ chối kèm hai cách viết thay thế, chỉ tên đó, hoặc host của mục theo sau là đường dẫn, vì một tên đại diện cho host của mục chứ không cho một vị trí bên dưới nó. Một giá trị hoàn toàn không nêu host nào — một tên đơn không có cổng mà không mục nào mang, văn bản có khoảng trắng hoặc dấu ngoặc nhọn — bị từ chối vì không phải host, và với default_registry lời từ chối nói rằng tên của một mục cũng dùng được. AGGREGA_DEFAULT_REGISTRY được đọc theo cùng cách và bị từ chối theo cùng cách, kèm tên biến.

Các thông báo được phát ra. Một phản đối schema nêu tệp, đường dẫn trường, và điều schema đã nói:

workspaceconfig: <path>: <field-path>: <the schema's own objection>: workspace configuration is invalid (workspaceconfig: cấu hình workspace không hợp lệ)

Các dạng có gợi ý sửa mở đầu bằng tệp và nói một câu về dạng cụ thể thay cho đường dẫn trường và phản đối của schema. Một artifact_cache_dir chỉ thư mục gốc của workspace:

<path>: artifact_cache_dir "<value>" names the workspace root itself; a catalog directory at the workspace root would then be stepped over as cache, leaving nothing to load — give the cache its own subdirectory (for example .aggrega/cache): workspace configuration is invalid (artifact_cache_dir chỉ chính thư mục gốc của workspace; khi đó một thư mục catalog ở gốc workspace sẽ bị bỏ qua như bộ nhớ đệm, không còn gì để tải — hãy cho bộ nhớ đệm một thư mục con riêng (ví dụ .aggrega/cache): cấu hình workspace không hợp lệ)

một mục signing.kinds không dùng được, thông báo này cũng nêu ký tự đại diện bao phủ mọi loại:

<path>: signing.kinds entry "<kind>" is not a signable artifact kind; use a catalog entity or plugin kind, or "all" for every kind: workspace configuration is invalid (mục signing.kinds không phải loại artifact có thể ký; hãy dùng một loại thực thể catalog hoặc loại plugin, hoặc “all” cho mọi loại: cấu hình workspace không hợp lệ)

một liên kết provider được viết dưới dạng một vị trí registry, nêu mục, capability và dạng cần viết:

<path>: plugins.providers[<n>] binds capability "<capability>" to "oci://<registry>/<repository>", which is where a plugin is published rather than which plugin it is; a provider binding names its plugin by its identity — write uri: provider/<name>, with an optional :<version>: workspace configuration is invalid (một mục plugins.providers liên kết capability với một vị trí registry, là nơi plugin được phát hành chứ không phải đó là plugin nào; một liên kết provider nêu plugin của nó theo định danh — hãy viết định danh của plugin vào uri, kèm phiên bản tùy chọn: cấu hình workspace không hợp lệ)

một mục gắn linter hoặc mục gắn quản trị ở vai trò phán quyết nêu một hàm điểm vào nhưng không nêu plugin nào, thông báo nêu tên danh sách, mục và hàm, ở đây trên plugins.linter:

<path>: plugins.linter[<n>] names the entry function "<function>" but no plugin uri; an attachment on this list selects its plugin by uri, so this one attaches no plugin and "<function>" is never called — add the uri of the plugin that exports it: workspace configuration is invalid (mục plugins.linter nêu hàm điểm vào nhưng không có URI của plugin; một mục gắn trong danh sách này chọn plugin của nó theo URI, nên mục này không gắn plugin nào và hàm đó không bao giờ được gọi — hãy thêm URI của plugin xuất ra hàm đó: cấu hình workspace không hợp lệ)

một host registry được viết theo cách khác, ở đây là HUB.AGGREGA.AI:

<path>: default_registry "HUB.AGGREGA.AI" is not written as the registry host it names; write "hub.aggrega.ai" — lowercase, with no scheme, path, credentials or default port — which is the spelling that host’s trust policy is kept under: workspace configuration is invalid (default_registry “HUB.AGGREGA.AI” không được viết đúng như host registry mà nó nêu; hãy viết “hub.aggrega.ai” — chữ thường, không có scheme, đường dẫn, thông tin xác thực hay cổng mặc định — đó là cách viết mà chính sách tin cậy của host ấy được lưu dưới: cấu hình workspace không hợp lệ)

một default registry có host được viết theo cách khác trước đường dẫn repository, ở đây là GHCR.io/acme, thông báo nêu toàn bộ vị trí cần viết:

<path>: default_registry "GHCR.io/acme" is not written as the registry location it names; write "ghcr.io/acme" — the registry host lowercase, with no scheme, credentials or default port, followed by the repository path — which keeps that host’s trust policy applying to it: workspace configuration is invalid (default_registry “GHCR.io/acme” không được viết đúng như vị trí registry mà nó nêu; hãy viết “ghcr.io/acme” — host registry viết thường, không có scheme, thông tin xác thực hay cổng mặc định, theo sau là đường dẫn repository — để chính sách tin cậy của host ấy tiếp tục áp dụng cho nó: cấu hình workspace không hợp lệ)

tên của một mục theo sau là một đường dẫn, ở đây là local/acme trong khi mục tên local dành cho 127.0.0.1:5000:

<path>: default_registry "local/acme" is the name of the registries entry "local" followed by a path, and an entry’s name stands for that entry’s host alone; write "local" to use the entry, or its host followed by the path, "127.0.0.1:5000/acme": workspace configuration is invalid (default_registry “local/acme” là tên của mục registries “local” theo sau là một đường dẫn, mà tên của một mục chỉ đại diện cho host của mục đó; hãy viết “local” để dùng mục đó, hoặc host của nó theo sau là đường dẫn, “127.0.0.1:5000/acme”: cấu hình workspace không hợp lệ)

một giá trị không nêu host nào, câu thông báo liệt kê các dạng mà một host có thể có:

<path>: registries[<n>].host "<value>" is not a registry host; write a lowercase host name containing a dot (registry.example.com), localhost, a single name followed by a port (registry:5000), or an IP address, an IPv6 one in brackets — each with an optional :port and nothing else: workspace configuration is invalid (giá trị registries[].host không phải host registry; hãy viết một tên host chữ thường có chứa dấu chấm (registry.example.com), localhost, một tên đơn theo sau là một cổng (registry:5000), hoặc một địa chỉ IP, địa chỉ IPv6 đặt trong ngoặc vuông — mỗi dạng có thể kèm :port tùy chọn và không gì khác: cấu hình workspace không hợp lệ)

một thư mục catalog được liệt kê nhưng không có gì tồn tại ở đó; thông báo nêu tệp và dòng, danh sách, mục như đã viết và đường dẫn mà nó phân giải tới — danh sách là workspace.catalog_dirs, workspace.catalog_dirs_append, hoặc danh sách của một mục Release, chẳng hạn `catalog_dirs` of the `workspace.releases` entry "release.yaml":

<path>:<line>: the `workspace.catalog_dirs` entry "<entry>" names <directory>, which does not exist; create that directory, or remove the entry: workspace configuration is invalid (thư mục mà mục đó nêu không tồn tại; hãy tạo thư mục đó, hoặc xóa mục: cấu hình workspace không hợp lệ)

và một dấu đánh dấu workspace: rỗng:

workspaceconfig: <path>: workspace must be a mapping; write workspace: {} to mark a workspace root with no catalog directories: workspace configuration is invalid (workspaceconfig: workspace phải là một mapping; hãy viết workspace: {} để đánh dấu một thư mục gốc workspace không có thư mục catalog nào: cấu hình workspace không hợp lệ)

Hai thông báo khác nêu một khóa được viết sai chỗ — default_registry, offline, auto_pull và artifact_cache_dir đều nằm ở cấp cao nhất chứ không nằm dưới workspace:, và khối của bộ nhớ đệm phân tích là parse_cache:. Mỗi thông báo nói nó muốn nói khóa nào và khóa đó thuộc về đâu.

Cách khắc phục: mở tệp mà thông báo nêu và đi đến đường dẫn trường mà nó trích dẫn. Khi thông báo mang một câu gợi ý sửa, câu đó nêu trực tiếp cách viết hoặc vị trí đúng và không cần đọc thêm gì. Khi thay vào đó nó mang một phản đối schema, đường dẫn trường là khóa bị lỗi và phản đối nói schema muốn gì ở đó — các trang thực thể không chi phối tệp này, nên hãy đọc phản đối thay vì tìm một hợp đồng thực thể. Một artifact_cache_dir được viết tương đối so với thư mục gốc workspace và cần một thư mục con riêng, để một thư mục catalog ở gốc workspace không bị nhầm là bộ nhớ đệm và bị bỏ qua. Một liên kết provider được viết dưới dạng vị trí registry phải được viết lại thủ công thành định danh của plugin — oci://hub.aggrega.ai/plugin/provider/compose trở thành provider/compose — vì mọi lệnh đọc tệp đều từ chối nó cho đến khi được sửa, kể cả aggrega plugin remove; aggrega plugin add provider tự viết dạng định danh. Một mục linter hoặc mục quản trị ở vai trò phán quyết nêu một hàm nhưng không nêu plugin nào thì được thêm uri của plugin xuất ra hàm đó; khi không có plugin nào xuất ra nó, hãy xóa mục đó — trên danh sách linter, linter chuẩn khi đó chạy như khi không có linter nào được cấu hình. Một thư mục catalog được liệt kê mà không phải là thư mục thì được tạo tại đường dẫn mà lời từ chối nêu, hoặc mục của nó được xóa khỏi dòng mà lời từ chối nêu; một bản sao dự án được lấy mà không kèm bản checkout anh em mà nó liệt kê thì xóa mục đó.

A plugin binding sets a key the socket it attaches to does not read (Một liên kết plugin đặt một khóa mà socket nó gắn vào không đọc)

Các socket trong cấu hình workspace gắn plugin theo hai cách khác nhau, và một khóa thuộc về cách này không có ý nghĩa gì ở cách kia. Thay vì chấp nhận khóa đó rồi lặng lẽ bỏ qua, cấu hình bị từ chối, để người vận hành biết rằng thiết lập không có tác dụng thay vì sau này phải thắc mắc vì sao nó không có hiệu lực.

Hai trường hợp không khớp này là ảnh phản chiếu của nhau.

  • Một socket xuyên suốt được liên kết theo capability. Các socket governance, linter và importer gắn plugin trực tiếp bằng uri:. Một plugin governance hoặc linter không phục vụ capability nào, nên một liên kết capability: ở đó sẽ được tra cứu với không gì cả và không khớp gì — một phần gắn không bao giờ phân giải được. Một importer có quảng bá các định dạng nó xử lý, nhưng định dạng nào được cần là do lần import quyết định chứ không phải phần gắn: một phần gắn importer chỉ định importer của nó bằng uri:, và chính điều đó chọn nó trong số các importer quảng bá định dạng mà một lần import yêu cầu.
  • Một socket provider đặt một khóa không có đối tượng tham chiếu. Một liên kết provider chỉ định một capability và plugin phục vụ nó, và plugin điều khiển một tập export cố định thay vì một điểm vào có thể chọn, nên function: không chỉ định gì trên nó. with: bị từ chối vì một lý do khác: cấu hình render cho một provider được viết trong Recipe, nên đặt nó trên liên kết của workspace là đặt nó sai phía trong sự phân chia giữa nhà phát triển và người vận hành.

Thông báo được phát ra. Một capability trên một socket xuyên suốt:

workspaceconfig: the <socket> socket is bound by capability "<capability>", but the cross-cutting sockets attach by uri: their plugin serves no capability, so a capability lookup matches nothing; attach it with uri: instead: a cross-cutting socket is bound by capability but attaches by uri (workspaceconfig: socket <socket> được liên kết theo capability “<capability>”, nhưng các socket xuyên suốt gắn theo uri: plugin của chúng không phục vụ capability nào, nên việc tra cứu capability không khớp với gì; hãy gắn nó bằng uri: thay vào đó: một socket xuyên suốt được liên kết theo capability nhưng gắn theo uri)

một function: không có tác dụng trên một liên kết provider:

workspaceconfig: the provider socket binding for capability "<capability>" sets function:, but a provider drives a fixed set of phase-keyed exports rather than one selectable entry, so function: names nothing there; remove it: a provider socket binding sets a field with no referent on that socket (workspaceconfig: liên kết socket provider cho capability “<capability>” đặt function:, nhưng một provider điều khiển một tập export cố định theo pha chứ không phải một điểm vào có thể chọn, nên function: không chỉ tới gì ở đó; hãy xóa nó: một liên kết socket provider đặt một trường không có đối tượng tham chiếu trên socket đó)

và một with: không có tác dụng, được báo theo cùng dạng và chỉ ra nơi cấu hình nên thuộc về:

workspaceconfig: the provider socket binding for capability "<capability>" sets with:, but provider render configuration belongs in the Recipe, not the workspace provider binding; remove it: a provider socket binding sets a field with no referent on that socket (workspaceconfig: liên kết socket provider cho capability “<capability>” đặt with:, nhưng cấu hình render của provider thuộc về Recipe, không phải liên kết provider của workspace; hãy xóa nó: một liên kết socket provider đặt một trường không có đối tượng tham chiếu trên socket đó)

Một function: viết trong .aggrega-config.yaml không đi tới được câu của nó ở trên: schema cấu hình workspace không khai báo khóa như vậy trên một binding provider, nên tệp bị từ chối trước, dưới E0224, và cách khắc phục là như nhau — xóa khóa:

workspaceconfig: <file>: plugins.providers[<index>].function: against /$defs/FixedEntryPluginRef: unexpected property: “function”: workspace configuration is invalid (workspaceconfig: function của mục plugins.providers: theo /$defs/FixedEntryPluginRef: thuộc tính không mong đợi “function”: cấu hình workspace không hợp lệ)

Cách khắc phục: chỗ cần sửa nằm trong .aggrega-config.yaml và mỗi thông báo chỉ ra chính xác thay đổi cần làm. Trên một phần gắn governance, linter hoặc importer, thay capability: bằng uri: của plugin bạn định gắn. Trên một liên kết provider, xóa khóa được nêu — và nếu đó là with:, hãy chuyển cấu hình đó vào Recipe render thông qua provider, vì đó là nơi đọc nó.

A capability is bound to more than one provider plugin (Một capability được liên kết với nhiều hơn một plugin provider)

Một capability chỉ định một cách biến một workload thành các artifact, và đúng một plugin phục vụ nó trong một workspace đã phân giải. Hai liên kết cho một capability khiến không có câu trả lời về việc liên kết nào sẽ render, và cấu hình workspace được ghép từ nhiều lớp — một tệp dùng chung, một tệp workspace, và các tệp bổ sung (append) mà mỗi tệp có thể đóng góp — nên liên kết thứ hai thường do một lớp đóng góp mà tác giả của nó không thể thấy liên kết thứ nhất.

Việc từ chối là điều làm cho điều đó hiển thị. Để một liên kết thắng một cách lặng lẽ sẽ khiến đầu ra được render phụ thuộc vào lớp nào tình cờ được đọc sau cùng.

Thông báo được phát ra, nêu capability và quy tắc:

workspaceconfig: capability "<capability>" is bound to more than one provider plugin; keep exactly one plugins.providers entry per capability: capability is bound to more than one provider plugin (workspaceconfig: capability “<capability>” được liên kết với nhiều hơn một plugin provider; hãy giữ đúng một mục plugins.providers cho mỗi capability: capability được liên kết với nhiều hơn một plugin provider)

Cách khắc phục: giữ một mục plugins.providers cho capability mà thông báo nêu và xóa mục còn lại. Khi hai mục đến từ các lớp cấu hình khác nhau, lớp bạn kiểm soát là lớp cần sửa — xóa mục của bạn nghĩa là dùng mục mà lớp dùng chung đóng góp, còn giữ mục của bạn nghĩa là mục của lớp dùng chung phải bị bỏ. Hai plugin thực sự cùng phục vụ workspace thì phục vụ hai capability khác nhau, nên nếu cần cả hai, hãy cho mỗi plugin một capability riêng thay vì liên kết một capability hai lần.

An importer is attached by more than one plugins.importer entry (Một importer được gắn bởi nhiều hơn một mục plugins.importer)

Một mục plugins.importer gắn importer mà uri của nó chỉ định: khi importer đó quảng bá định dạng mà một lần import yêu cầu, mục này quyết định phiên bản nào của nó chạy và chuyển cho nó with.sources và with.settings của mục. Một mục làm điều đó cho một importer, nên một mục thứ hai chỉ định cùng importer — cùng định danh, ở cùng phiên bản hoặc phiên bản khác — sẽ không được gì đọc, và with của nó sẽ không đến importer nào mà không có lời báo nào. Thay vào đó, cấu hình bị từ chối khi được nạp, bất kể lệnh nào đọc nó.

Cấu hình workspace được ghép từ nhiều tệp — tệp toàn cục, mỗi .aggrega-config.yaml từ thư mục gốc dự án xuống đến thư mục mà lệnh chạy trong đó, tệp bổ sung importer_append mà mỗi tệp có thể có, và .aggrega-config-append-ci.yaml của một pipeline — nên mục thứ hai thường được viết trong một tệp khác với mục thứ nhất. Thông báo nêu importer và cả hai mục, mục sớm hơn trước, mỗi mục theo khóa và vị trí nó được viết dưới đó, tệp nó được viết trong đó, và uri của nó như được viết ở đó.

Chỉ danh sách importer được xét: các danh sách governance và linter chấp nhận một plugin được gắn nhiều lần, mỗi phần gắn mang with riêng. Một mục có uri là đường dẫn hệ thống tệp không chỉ định importer nào, nên nó không được so sánh.

Thông báo được phát ra:

importer "<identity>" is attached by <key>[<position>] in <file> (uri "<uri>") and again by <key>[<position>] in <file> (uri "<uri>"); keep exactly one plugins.importer entry per importer, its uri naming the version you want: importer is attached by more than one plugins.importer entry (importer “<identity>” được gắn bởi <key>[<position>] trong <file> (uri “<uri>”) và lại được gắn bởi <key>[<position>] trong <file> (uri “<uri>”); hãy giữ đúng một mục plugins.importer cho mỗi importer, với uri chỉ định phiên bản bạn muốn: importer được gắn bởi nhiều hơn một mục plugins.importer)

Cách khắc phục: giữ một mục cho importer mà thông báo nêu — mục có uri chỉ định phiên bản bạn muốn, mang with bạn muốn chuyển cho importer đó — và xóa mục còn lại. Khi hai mục nằm trong các tệp khác nhau, tệp bạn kiểm soát là tệp cần sửa: xóa mục của bạn nghĩa là dùng mục của tệp kia, còn giữ mục của bạn nghĩa là mục của tệp kia phải bị bỏ.

A provider binding names a capability containing a colon (Một liên kết provider chỉ định một capability chứa dấu hai chấm)

capability: của một Recipe được đọc là tên capability cho đến dấu hai chấm cuối cùng và một ghim phiên bản sau đó — helm:1.0.0 yêu cầu capability helm ở phiên bản 1.0.0. Một mục plugins.providers được tra cứu theo tên đó, nên capability mà một liên kết chỉ định không bao giờ chứa dấu hai chấm, và một mục có capability chứa dấu hai chấm là mục mà không Recipe nào có thể đến được. Thay vì để nó nằm trong cấu hình mà không được đọc, cấu hình bị từ chối khi được nạp, bất kể lệnh nào đọc nó.

Chỉ danh sách provider được xét. Danh sách importer có cùng dạng mục, nhưng các plugin của nó được gắn bằng uri: và đặt tên định dạng là import:<format>, trong đó dấu hai chấm là một phần của tên. uri: của một liên kết vẫn có thể kết thúc bằng :<version>; đó không phải phần mà quy tắc này đọc.

Thông báo được phát ra, nêu capability:

the provider socket binding for capability "<capability>": a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so the capability a binding names carries no colon; bind the capability name alone and let each Recipe pin the version it needs: a provider socket binding names a capability containing a colon, which no Recipe can select (liên kết socket provider cho capability “<capability>”: tham chiếu capability của một Recipe được đọc là capability tính đến dấu hai chấm cuối cùng và một phiên bản ghim sau đó, nên capability mà một liên kết chỉ định không chứa dấu hai chấm; hãy chỉ liên kết tên capability và để mỗi Recipe ghim phiên bản nó cần: một liên kết socket provider chỉ định một capability chứa dấu hai chấm, điều mà không Recipe nào có thể chọn)

Cách khắc phục: chỉ viết tên capability trong mục — capability: helm — và ghim phiên bản ở nơi chúng thuộc về: một Recipe ghim phiên bản provider nó cần trong capability: của chính nó, và một liên kết cần chọn một phiên bản cụ thể của plugin thì viết phiên bản đó trên định danh plugin, uri: provider/helm:1.0.0.

A governance attachment declares no role, or one that is not a known role (Một attachment governance không khai báo role nào, hoặc khai báo một role không được biết đến)

Một attachment governance mang theo một role, và chính role đó — chứ không phải kind mà plugin tự khai báo — quyết định attachment chạy ở đâu và được phép làm gì: nó chấp nhận hay từ chối một bản build, và nó đọc đồ thị hay đọc các artifact đã render. Các attachment được điều phối bằng cách đọc role đó, nên một attachment không mang role nào, hoặc mang một role không ai nhận ra, sẽ không gắn vào đâu cả và bị bỏ qua trong im lặng.

Sự im lặng đó chính là điều mà việc từ chối ngăn chặn. Một plugin governance được cấu hình nhưng không bao giờ được tham vấn sẽ tạo ra đúng đầu ra của một bản build chưa từng được quản trị, và không có gì trong kết quả cho bạn biết mình đang cầm loại nào.

Các thông báo được phát ra, cả hai đều nêu tên attachment và liệt kê các role hiện có. Thiếu role:

workspaceconfig: governance attachment "<uri>" declares no role; set role: to one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: mục gắn governance không khai báo vai trò; hãy đặt role: thành một trong các vai trò đã biết: một mục gắn governance không khai báo vai trò hoặc khai báo một vai trò không xác định)

và một role không được nhận ra:

workspaceconfig: governance attachment "<uri>" declares unknown role "<role>"; use one of <the known roles>: a governance attachment declares no role or an unknown role (workspaceconfig: mục gắn governance khai báo một vai trò không xác định; hãy dùng một trong các vai trò đã biết: một mục gắn governance không khai báo vai trò hoặc khai báo một vai trò không xác định)

Cách khắc phục: đặt role: trên attachment nằm dưới plugins.governance thành một trong các role mà thông báo liệt kê. Chọn role nào là quyết định về việc bạn muốn plugin làm gì chứ không phải về bản thân plugin: một role chấp nhận hoặc từ chối sẽ đọc bản build và trả về một phán quyết, còn một role biến đổi là chỉ dẫn tường minh cho phép plugin thay đổi những gì nó nhận được. Thông báo liệt kê toàn bộ tập hợp, nên cách viết cần dùng nằm ngay trong thông báo.

A registry alias matches more than one host (Một alias registry khớp với nhiều hơn một host)

Một registry có thể được đặt một alias ngắn trong cấu hình workspace để các lệnh và tham chiếu có thể gọi tên nó mà không cần viết đầy đủ host. Một alias chọn đúng một host. Điều kiện này là điều được báo cáo khi một token khớp với alias của hai mục registry: không có câu trả lời cho việc host nào được nhắm tới, và chọn một host sẽ âm thầm gửi artifact đến, hoặc lấy artifact từ, một registry mà tác giả không chỉ định.

Thông báo được phát ra, nêu tên alias, số mục đã nhận alias đó, và đó là những host nào:

registry alias "<alias>" matches <count> hosts (<hosts>); address the registry by host or remove the duplicate alias: registry alias matches more than one host (bí danh registry khớp với nhiều host; hãy chỉ định registry theo host hoặc xóa bí danh trùng lặp: bí danh registry khớp với nhiều hơn một host)

Cách khắc phục: mở .aggrega-config.yaml và gán alias cho một trong các host mà thông báo liệt kê, hoặc gọi registry bằng host của nó và bỏ alias khỏi tham chiếu. Thông báo nêu tên mọi host đang giữ alias, nên các mục cần xem xét đã có trong thông báo. Khi các mục đến từ những lớp cấu hình khác nhau, hãy sửa lớp mà bạn sở hữu.

The lockfile does not satisfy its schema (Lockfile không thỏa mãn schema của nó)

Lockfile của một release ghi lại những gì bản build đã phân giải được: với mọi entity, library và plugin mà nó chạm tới, phiên bản được chọn và digest của các byte ở phiên bản đó. Nó được đọc và kiểm tra theo schema trước khi được chuyển thành các pin có kiểu, nên một tài liệu không khớp sẽ bị từ chối kèm đường dẫn trường nơi nó thất bại, thay vì âm thầm tạo ra các pin bị khuyết.

Lockfile do máy viết. Nó được tạo ra bởi lệnh pull phân giải một release, và được commit để cùng một bản build sau này phân giải theo cùng một cách. Vì vậy, một lỗi schema gần như luôn là do chỉnh sửa bằng tay, một lần merge để tài liệu ở trạng thái phân giải dở dang, hoặc một lockfile được viết cho một dạng cũ hơn của tệp — chẳng hạn một lockfile có các entities không mang kind — chứ không phải thứ được viết có chủ ý.

Thiếu lockfile là một điều kiện khác và được báo cáo khác — lockfile là bắt buộc, nên việc thiếu nó được báo cáo tại nơi bản build tìm nó, kèm chỉ dẫn chạy lệnh pull để tạo ra nó.

Thông báo được phát ra, nêu tên tệp, đường dẫn trường và phản đối riêng của schema:

lockfile: <path>: <field-path>: <the schema's own objection>: lockfile: file failed schema validation (lockfile: tệp không vượt qua kiểm tra schema)

Một bản build, cũng như aggrega pull --verify, sẽ thêm lệnh viết lại lockfile:

…: lockfile: file failed schema validation; run aggrega pull --release <release> to write it again from the Release (lockfile: tệp không vượt qua kiểm tra schema; hãy chạy lệnh này để viết lại tệp từ Release)

Một tài liệu hoàn toàn trống được báo cáo riêng, vì không có trường nào để nêu tên:

lockfile: <path>: document is empty (lockfile: tài liệu trống)

Cách khắc phục: đừng sửa lockfile bằng tay. Chạy lại lệnh pull cho release, lệnh này viết lại tài liệu từ kết quả phân giải mà nó thực hiện, rồi commit kết quả — phân giải lại chính là điều tạo ra một tài liệu có các pin khớp với những gì release thực sự chạm tới. Khi lỗi xảy ra sau một lần merge, giải quyết xung đột bằng cách pull lại thay vì chỉnh sửa là điều giúp tránh một tài liệu phân tích được nhưng lại pin sai phiên bản. Đường dẫn trường trong thông báo đáng được đọc trước: nó cho bạn biết hư hỏng nằm ở một mục hay ở cấu trúc tổng thể của tài liệu.

Khi phân giải catalog

Sau khi tải, trình biên dịch duyệt hai tầng của Manifest (bản đồ kiểu, rồi bản đồ tên) để chọn Recipe cho mọi Component, và duyệt mọi chuỗi extends trên Manifests, Components hoặc Features. Chuỗi extends riêng của một Release được theo dõi bằng cùng phép duyệt đó, sớm hơn một bước: nó được theo dõi khi Release được phân giải, trước khi tìm Manifest hay Aggregate mà Release đó chỉ định, nên các điều kiện dưới đây được báo cáo đối với Release thay vì đối với một con trỏ anh em mà chuỗi lẽ ra sẽ cung cấp.

Chuỗi extends có vòng lặp

Một chuỗi con trỏ extends vòng ngược lại chính nó. Mọi kind khai báo extends — Component, Feature, Manifest và Release — đều được duyệt bởi cùng một lượt duyệt chuỗi, nên một vòng lặp được báo cáo bằng cùng một lời ở bất cứ đâu nó được tìm thấy.

Thông báo được phát ra. Câu nêu tên điều kiện mở đầu thông báo, tiếp theo là thực thể mà quá trình phân giải bắt đầu và quy tắc đã từ chối nó, rồi đến cạnh khép vòng lặp — thực thể mang extends: gây lỗi và tham chiếu mà nó khai báo:

cyclic extends chain (<kind> <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (chuỗi extends có vòng lặp (<kind> <name>, quy tắc extends). <entity> extends <reference>, vốn đã có trong chuỗi; hãy gỡ extends trên <entity>, hoặc trỏ nó tới một thực thể nằm ngoài chuỗi)

Thực thể được nêu đầu tiên và thực thể được nêu trong cạnh thường khác nhau, và đó chính là điểm mấu chốt: một vòng lặp được báo cáo đối với mọi thực thể trên nó, còn dòng extends: cần sửa là dòng mà cạnh chỉ ra. Hãy theo cạnh, không theo phần đầu.

Với một Manifest, <kind> là Manifest, mỗi thực thể được gọi bằng metadata.name của nó, và <reference> là giá trị extends: đúng như đã viết — một đường dẫn tương đối như ./base.yaml, hoặc metadata.name trần của một Manifest nằm cạnh Release. Bạn viết dạng nào trong hai dạng cũng không thay đổi điều được báo cáo: một liên kết Manifest là tệp mà nó phân giải tới, nên hai tệp Manifest tình cờ khai báo cùng một metadata.name là hai liên kết, và một chuỗi đi qua cả hai không phải là vòng lặp.

Một Release cũng được đọc theo cách tương tự, và điểm về danh tính tệp còn quan trọng hơn ở đó vì cấu trúc mà nó bảo vệ là phổ biến: <kind> là Release, <reference> là đường dẫn tương đối mà extends: chỉ định, và một liên kết Release là tệp mà nó phân giải tới. Hai tệp Release đặt tên theo hệ thống được triển khai thay vì theo môi trường — cả hai đều metadata.name: shared-release, tệp này extends tệp kia — là hai liên kết, và một chuỗi đi qua cả hai không phải là vòng lặp.

Một vòng lặp được báo cáo là vòng lặp dù nó dài đến đâu. Phép duyệt chuỗi chỉ áp dụng giới hạn độ sâu cho một chuỗi có điểm kết thúc, nên một chu trình trải qua nhiều thực thể hơn mức giới hạn cho phép vẫn được báo cáo ở đây chứ không phải như một chuỗi quá sâu — cách khắc phục một vòng lặp không bao giờ là rút ngắn nó.

Cách khắc phục: mở thực thể mà cạnh chỉ ra, và hoặc gỡ extends: của nó, hoặc trỏ nó tới một thực thể chưa có trên chuỗi. Khi nhiều tầng được dự định chia sẻ nội dung, việc gom nội dung trùng lặp vào một thực thể cơ sở duy nhất sẽ loại bỏ cả vòng lặp lẫn sự trùng lặp.

implements của Recipe không khớp với kiểu component được ánh xạ

Mục ánh xạ của Manifest trỏ tới một Recipe có khai báo spec.implements: không khớp với khóa kiểu component của mục ánh xạ đó. spec.implements là một mốc nhất quán chứ không phải cơ chế điều phối: giá trị ánh xạ chỉ định trực tiếp Recipe, và bước kiểm tra này xác nhận rằng Recipe mà tác giả chỉ định là Recipe khai báo đúng kiểu mà họ đã ánh xạ.

Bước kiểm tra đọc Manifest đã được hợp thành trước khi bất kỳ Recipe nào được phân giải, nên nó báo cáo mục ánh xạ mà tác giả đã viết thay vì một triệu chứng phát sinh về sau từ mục đó.

Thông báo được phát ra:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (manifest mapping "<component-type>" -> "<recipe-uri>", recipe spec.implements is "<recipe-implements>", expected "<component-type>", or a type "<component-type>" extends) (spec.implements của recipe trong mục ánh xạ manifest không khớp với khóa component-type / feature-type được ánh xạ (ánh xạ manifest <component-type> -> <recipe-uri>, spec.implements của recipe là <recipe-implements>, mong đợi <component-type>, hoặc một kiểu mà <component-type> mở rộng))

Mọi lệnh đọc các phụ thuộc của một Release đều thực hiện kiểm tra này; điều khác nhau là mỗi lệnh làm gì với kết quả. aggrega build và aggrega pull dừng lại, vì cả hai đều tạo ra thứ mà bạn sẽ dùng tiếp — các artifact đã kết xuất và một lockfile. aggrega validate và aggrega lint báo cáo phát hiện cùng với mọi chẩn đoán khác mà chúng tìm thấy rồi thoát với mã khác không: nhiệm vụ của chúng là cho bạn biết mọi điều sai trong workspace, nên một lỗi đơn lẻ không cắt ngắn báo cáo. Trong trình soạn thảo, phát hiện được công bố như một chẩn đoán bên cạnh các chẩn đoán khác, và mọi điều khác mà tài liệu đó cần báo cáo không bị ảnh hưởng. Hãy lưu ý nơi nó xuất hiện: trình soạn thảo công bố phát hiện trên Manifest chứa ánh xạ, tại khóa của mục ánh xạ mà phát hiện nêu tên, chứ không phải trên Aggregate — tại dòng đầu tiên của Manifest khi văn bản đang mở của nó không viết mục đó, như với một mục mà nó kế thừa qua extends. Các phát hiện cấp phụ thuộc khác của Release, vốn không nêu tên tài liệu nào trong workspace của bạn, vẫn nằm trên Aggregate. Chạy aggrega validate sẽ báo cáo nó bất kể bạn đang mở tài liệu nào.

Một mục ánh xạ chỉ định một Recipe mà catalog không có thì không thuộc điều kiện này: bước kiểm tra không có gì để so sánh nên bỏ qua mục đó, và Recipe không phân giải được sẽ được báo cáo khi các recipe được phân giải.

Các mục FeatureRecipe tuân theo cùng cấu trúc; bước kiểm tra ánh xạ features.type phát ra manifest feature mapping ... featurerecipe spec.implements is ... (expected ...), và nhánh feature so khớp trên chính khóa ánh xạ, nên nó không nêu phương án extends nào.

Một khóa components.type cũng được xét theo từng instance mỗi khi nó đi tới một instance của phiên bản khác. Một khóa không nêu kiểu chính xác của một instance sẽ đi tới instance đó qua base của kiểu, khi không khóa nào nêu kiểu chính xác đó và không có khóa nào khác được viết cho cùng base — nên một khóa viết không có phiên bản, hoặc một khóa nêu phiên bản khác, có thể đi tới nó. Vì vậy riêng mục đó không thể cho biết Recipe của nó có phù hợp hay không, nên bản build xét lại Recipe cho mỗi instance component mà khóa đi tới theo cách đó, đặt kiểu của chính instance ở phiên bản mà bản build biên dịch nó vào chỗ của khóa: phiên bản mà instance nêu, hoặc, với một instance không nêu phiên bản nào, phiên bản cao nhất của Component đó mà catalog có. Một instance có phiên bản không được spec.implements: của Recipe thỏa mãn — dù chính xác, theo khoảng caret, do không có phiên bản, hay qua một base mà kiểu của instance extends — sẽ gây ra điều kiện này, được báo cáo tại đường dẫn .spec.components.<instance> của instance chứ không phải tại tệp Manifest:

manifest mapping entry’s recipe spec.implements does not match the mapped component-type / feature-type key (Manifest, at .spec.components.<instance>, "<instance>", of type "<component-type>", compiled as "<component-type>:<version>", reached through manifest mapping key "<key>", mapped to recipe "<recipe-uri>", whose spec.implements is "<recipe-implements>"). map this type at this version to a recipe that implements it, with a mapping key naming the version (spec.implements của recipe trong mục ánh xạ Manifest không khớp với khóa component-type hoặc feature-type được ánh xạ (Manifest; kiểu của instance và phiên bản biên dịch, khóa ánh xạ đã đi tới nó, recipe được ánh xạ và spec.implements của nó). hãy ánh xạ kiểu này ở phiên bản này tới một recipe triển khai nó, bằng một khóa ánh xạ nêu phiên bản)

Giá trị compiled as chỉ xuất hiện với một instance có kiểu không nêu phiên bản; một instance có nêu phiên bản sẽ hiển thị phiên bản của nó trong of type. Một khóa nêu đúng phiên bản của instance không cần xét lần thứ hai, vì lần kiểm tra trên mục đã xét nó rồi, và một mục đã bị từ chối vì khóa của nó chỉ được báo cáo một lần, như ở trên, chứ không báo lại cho từng instance. aggrega build và aggrega pull dừng vì nó, còn aggrega validate --release báo cáo nó và thoát với mã khác không. aggrega lint xét các mục ánh xạ của một Manifest chứ không xét các instance mà chúng đi tới, nên nó không báo cáo điều này.

Cách khắc phục: hoặc sửa khai báo spec.implements: của Recipe để nó khớp với khóa component-type của Manifest, hoặc đổi mục Manifest để trỏ tới một Recipe có spec.implements: khớp với khóa component-type. Với một instance mà một khóa đi tới ở phiên bản khác, hãy thêm một khóa ánh xạ nêu phiên bản của instance, ánh xạ tới một Recipe triển khai nó, hoặc trỏ khóa đang đi tới đó tới một Recipe như vậy.

Manifest mapping value is not a shape a recipe reference accepts (Giá trị ánh xạ của Manifest không có hình dạng mà một tham chiếu recipe chấp nhận)

Một giá trị ánh xạ của Manifest chỉ định một Recipe hoặc FeatureRecipe theo một dạng mà ngữ pháp tham chiếu không thể biểu đạt. Một tham chiếu recipe chấp nhận một tên trần, một tên kèm phiên bản, một tên có tiền tố capability, hoặc một tên có tiền tố capability kèm phiên bản — tối đa một /. Một giá trị mang nhiều hơn thế (một đường dẫn kiểu component-type như core/helm/eso-aws-fetcher:1.0.0) không bao giờ có thể chỉ định một thực thể của catalog, bất kể catalog chứa gì.

Dạng này được đánh giá khi Manifest được hợp thành, trước khi bất cứ thứ gì được tra cứu — kết luận đến từ việc đếm các dấu phân cách trong một chuỗi, nên hoàn toàn không cần catalog. Đánh giá ở đó là điều làm cho chẩn đoán trung thực: recipe mà giá trị muốn chỉ tới thường có mặt và được đặt tên đúng, và việc được báo rằng nó bị thiếu sẽ khiến bạn đi tìm sai thứ. Mọi lệnh phân giải các phụ thuộc của một Release đều báo cáo nó theo cùng một cách, nên điều đó không phụ thuộc vào việc bạn tình cờ chạy lệnh nào.

Thông báo được phát ra:

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries <n> slash-separated segments; a recipe reference accepts "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (tham chiếu recipe sai dạng trong một giá trị ánh xạ của Manifest: spec.mappings.components.type.<key> ánh xạ tới <value>, mang <n> phân đoạn phân cách bằng dấu gạch chéo; một tham chiếu recipe chấp nhận “name”, “name:version”, “capability/name” hoặc “capability/name:version”; hãy sửa giá trị ánh xạ trong Manifest)

Phần features tạo ra cùng thông báo đối với tọa độ riêng của nó, và một tham chiếu feature recipe được gọi đúng tên như vậy.

Một giá trị có phân đoạn capability mang một chốt phiên bản — compose:1.2.3/svc:1.0.0 — cũng bị từ chối theo cùng cách, trước khi bất cứ thứ gì được tra cứu, nên không có gì được tải từ registry. Một chốt phiên bản thuộc về capability mà Recipe khai báo, nơi nó chọn phiên bản nào của plugin phục vụ capability đó sẽ render; một tham chiếu nêu Recipe bằng capability trần (compose/svc:1.0.0).

malformed recipe reference in a Manifest mapping value: spec.mappings.components.type.<key> maps to <value>, which carries a version pin in its capability segment <segment>; a pin belongs on the capability the recipe declares, and a recipe reference names the recipe by its bare capability, as "name", "name:version", "capability/name" or "capability/name:version"; correct the mapping value in the Manifest (tham chiếu recipe sai dạng trong một giá trị ánh xạ Manifest: giá trị của khóa này mang một chốt phiên bản trong phân đoạn capability; chốt phiên bản thuộc về capability mà recipe khai báo, và một tham chiếu recipe nêu recipe bằng capability trần; hãy sửa giá trị ánh xạ trong Manifest)

Cách khắc phục: rút ngắn giá trị ánh xạ về một dạng mà ngữ pháp chấp nhận. Một recipe được xác định bằng metadata.name của chính nó — có thể kèm tiền tố là spec.capability của nó và hậu tố là phiên bản của nó — không bao giờ bằng đường dẫn kiểu component mà nó hiện thực. Khóa của ánh xạ là kiểu component; giá trị của ánh xạ là recipe.

Đừng nhầm với một giá trị đúng dạng chỉ định một recipe mà catalog không có: đó là một thực thể thực sự vắng mặt và vẫn được báo cáo như vậy, nêu URI và mục ánh xạ đã tham chiếu tới nó.

Nhiều Recipes cùng hiện thực một kiểu Component

Hai hoặc nhiều Recipes khai báo cùng một kiểu Component dưới spec.implements: — hai Recipes có phiên bản chính xác cho một kiểu, hoặc một Recipe không có phiên bản bên cạnh một Recipe đã được ghim.

Điều này không tự gây ra dừng nào, và cũng không phải là sự mơ hồ mà bản build phải giải quyết. Việc chọn Recipe chỉ dựa trên ánh xạ: không có gì đọc spec.implements: rồi chọn giữa các ứng viên, nên dù có bao nhiêu Recipes hiện thực một kiểu, Recipe kết xuất một thể hiện là Recipe mà Manifest ánh xạ thể hiện đó tới. spec.implements: được đọc như một điểm neo nhất quán — xác nhận Recipe mà tác giả đã ánh xạ là Recipe khai báo đúng kiểu mà họ ánh xạ nó vào — và như nguồn của các ứng viên ghim mà một lần dừng gợi ý. Nó không bao giờ lựa chọn.

Thay vào đó, bạn sẽ gặp lần dừng dành cho một thể hiện mà Manifest không ánh xạ tới gì, và lần dừng đó liệt kê mọi Recipe hiện thực kiểu này để bạn có thể ghim một Recipe — xem “No Recipe is mapped for a component or feature instance (Không có Recipe nào được ánh xạ cho một thể hiện component hoặc feature)” bên dưới. Nó báo cáo theo cùng một cách dù có một hay năm Recipe hiện thực kiểu đó, vì vậy không có điều kiện mơ hồ riêng nào để tra cứu.

Cách khắc phục: thêm ánh xạ. Một mục theo khóa kiểu sẽ định tuyến mọi thể hiện của kiểu đó; một mục theo khóa tên định tuyến một thể hiện được đặt tên và được đọc trước, nên đó cũng là cách để bạn gán cho một thể hiện một Recipe khác với các thể hiện cùng cấp.

Release phân kỳ (extends + con trỏ aggregate)

Một Release dùng extends: để kế thừa từ một Release cơ sở nhưng đồng thời khai báo con trỏ aggregate: của riêng nó. JSON Schema của Release từ chối hình dạng này ở bước xác thực schema (Layer 1, lần kiểm tra envelope) thông qua một ràng buộc allOf: khi có extends:, aggregate: bị cấm; khi không có extends:, cả aggregate: và manifest: đều bắt buộc.

Nó dừng như một vi phạm envelope thông thường, nên chẩn đoán mang hình dạng của lớp đó — xem “The document-envelope failure class” trong error-translation.md — và kết quả chỉ vào khóa không được phép ở đây:

document envelope validation failed (Release, at <path>); <line>:<column>: spec.aggregate: value matches a shape that is not allowed here. correct the document to match its kind’s schema (xác thực envelope tài liệu thất bại (Release, tại <path>); <line>:<column>: spec.aggregate: giá trị khớp với một hình dạng không được phép ở đây. hãy sửa tài liệu cho khớp với schema của kind của nó)

Cách khắc phục: xóa trường aggregate: khỏi Release con. Việc kế thừa cố ý buộc Release con triển khai cùng Developer Intent với Release cha; nếu bạn cần triển khai một Aggregate khác, hãy viết một Release mới không có extends:.

A feature attached by both the Aggregate and the Release cannot be merged (Một feature được gắn bởi cả Aggregate và Release không thể hợp nhất)

Khi một Manifest cục bộ extends một Manifest cơ sở, hai tầng (bản đồ type:, bản đồ name:) được hợp nhất độc lập. Trong mỗi tầng, khóa của con ghi đè khóa của cha ở cấp cao nhất — đây là thay thế nông, không phải hợp nhất sâu. Một mục của con cho một khóa nhất định sẽ thay thế hoàn toàn mục của cha cho khóa đó.

Khi cùng một tên thể hiện feature xuất hiện ở cả phía Aggregate và phía Release với trạng thái xung đột không thể hợp nhất (ngoài việc phân lớp infra được cho phép), trình biên dịch dừng và đặt chẩn đoán tại phần đính kèm mà nó không thể dung hòa. Hai khai báo xung đột theo sau theo thứ tự cố định — kiểu mà Aggregate khai báo trước, rồi kiểu mà Release khai báo — để bạn biết tài liệu nào nói gì mà không cần mở cả hai.

Thông báo được phát ra:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<aggregate-declared-type>", "<release-declared-type>") (xung đột hợp nhất feature: hãy dung hòa các khai báo Aggregate và Release cho feature (kiểu do Aggregate khai báo, kiểu do Release khai báo))

Điều tương tự áp dụng cho phần đính kèm mà một kết nối mang theo. Khi mục kết nối của Aggregate và mục của Release cho cùng kết nối đó đều ghi một phần đính kèm dưới cùng một slot và nêu tên các Features khác nhau, bản build dừng tại mục của Release — nơi kiểu thứ hai được ghi — sau khi thành phần được làm phẳng, nêu tên cả hai kiểu, slot, kết nối, socket và component:

feature merge conflict: reconcile the Aggregate and Release declarations for the feature (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, the Aggregate names "<aggregate-declared-type>", the Release names "<release-declared-type>", for the slot "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Drop the type from the Release’s entry so it sizes the attachment the Aggregate declares, or name the same Feature in both documents. (xung đột hợp nhất feature: hãy dung hòa các khai báo Aggregate và Release cho feature. Bỏ kiểu khỏi mục của Release để nó định cỡ phần đính kèm mà Aggregate khai báo, hoặc nêu cùng một Feature trong cả hai tài liệu.)

Cách khắc phục: dung hòa hai khai báo. Các khai báo phía Aggregate và phía Release của cùng một thể hiện feature kết hợp theo pillar — Aggregate đóng góp values, Release đóng góp infra. Nếu cả hai phía chỉ định cùng một trường không thuộc pillar (chẳng hạn type:), các giá trị phải khớp nhau; hãy sửa một phía cho khớp với phía kia, hoặc bỏ khai báo thừa.

Annotation binding does not resolve against its target Feature (Liên kết annotation không phân giải được với Feature đích của nó)

Trường feature: của một liên kết annotation trong Manifest nêu tên một Feature mà catalog không tải, hoặc các danh sách maps.infra / maps.values của liên kết khai báo các đường dẫn dạng chấm mà spec.schema của Feature được nêu tên thực sự không có. Cả hai điều kiện đều làm dừng việc tải workspace — liên kết sẽ tổng hợp các phần đính kèm Feature định tuyến giá trị vào những đường dẫn mà runtime không thể phân giải.

Một điều kiện bao quát ba cách mà tuyến của một liên kết không phân giải được, và chẩn đoán nêu rõ trường hợp nào đã xảy ra:

  • Không tìm thấy Feature. Giá trị feature: tham chiếu một URI Feature không có trong catalog đã tải.
  • Schema của Feature không phân giải được. Feature được nêu tên có tải, nhưng spec.schema: của nó không phân giải thành một biểu diễn JSON Schema 2020-12 — nội dung bị sai định dạng, hoặc nó nêu một tham chiếu liên tài liệu không thể theo được. Biến thể này mang theo chẩn đoán riêng của lỗi phân giải phía sau, nên lý do schema không phân giải được có thể đọc ngay từ cùng lần dừng.
  • Đường dẫn liên kết không có trong schema đích. Mục maps.infra hoặc maps.values của liên kết nêu một đường dẫn dạng chấm mà spec.schema.<pillar>.<path> của Feature không khai báo.

Thông báo được phát ra (biến thể không tìm thấy Feature):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", which this build’s catalog does not hold; correct or publish the Feature named under "feature") (liên kết annotation không phân giải được với Feature đích của nó; catalog của bản build này không chứa Feature đó; hãy sửa hoặc phát hành Feature được nêu tên dưới “feature”)

Thông báo được phát ra (biến thể schema không phân giải được):

annotation binding does not resolve against its target Feature (Manifest, annotation binding routes to Feature "<feature-uri>", whose declared schema does not resolve: <resolution failure>) (liên kết annotation không phân giải được với Feature đích của nó; schema đã khai báo của Feature không phân giải được)

Biến thể này nêu tên Feature và lỗi phân giải, và không mang theo khóa liên kết cũng như vị trí nguồn — lỗi nằm ở chính spec.schema: của Feature, thứ mà liên kết chỉ nêu tên. Hãy tìm liên kết gây lỗi bằng cách tìm trong mappings.features.annotations URI Feature mà thông báo trích dẫn.

Thông báo được phát ra (biến thể không tìm thấy đường dẫn):

annotation binding does not resolve against its target Feature (Manifest, at .spec.mappings.features.annotations.<key>, "<key>", routes to Feature "<feature-uri>", at pillar "<pillar>", and path "<path>", which that Feature does not declare a property for under "schema") (liên kết annotation không phân giải được với Feature đích của nó; Feature đó không khai báo thuộc tính cho pillar và đường dẫn này dưới “schema”)

Cách khắc phục: xác nhận URI feature: của liên kết tồn tại trong catalog và khớp với URI phân biệt hoa thường mà một Recipe implements:. Nếu biến thể không tìm thấy đường dẫn xảy ra trên một đường dẫn mà schema Feature có khai báo, hãy kiểm tra cách viết đường dẫn dạng chấm (phân biệt hoa thường) và tên pillar (infra hay values).

A bound annotation value does not conform to the target Feature’s schema (Giá trị annotation được ràng buộc không tuân theo schema của Feature đích)

Một annotation bạn viết định tuyến một giá trị, thông qua một binding, tới một đường dẫn trên Feature đích — và giá trị đó không thỏa mãn sub-schema mà Feature khai báo tại đường dẫn ấy, hoặc Feature hoàn toàn không khai báo thuộc tính nào ở đó. Điều kiện này được xét trên giá trị chứ không phải trên binding, đó là lý do nó tách biệt với lần dừng về đích của binding ở trên: lần dừng kia từ chối những gì Manifest khai báo, còn lần dừng này từ chối những gì được viết thông qua nó.

Xác thực đầy đủ tại đường dẫn đã định vị; chỉ bỏ qua mềm khi không thể định vị đường dẫn. Khi sub-schema của subkey được ràng buộc đã được định vị, giá trị được xác thực theo tập ràng buộc JSON Schema 2020-12 đầy đủ tại đường dẫn đó (kiểu, enum, pattern, khoảng số, hình dạng object/array lồng nhau) — một $ref / allOf / oneOf ở cuối được phân giải theo các định nghĩa của schema và được xác thực, không bị bỏ qua. Nguyên tắc bỏ qua mềm chỉ áp dụng cho việc điều hướng: khi bộ duyệt gặp một lối thoát ($ref, patternProperties, oneOf/anyOf/allOf, hoặc additionalProperties có thân schema) trên một phân đoạn trung gian — trước khi tới lá được ràng buộc — đường dẫn không thể phân giải tĩnh, nên bộ xác thực tiếp tục mà không phát lỗi thay vì mạo hiểm dừng sai; runtime vẫn là nơi xác thực cho binding đó.

Thông báo được phát ra (biến thể tuân thủ giá trị):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> value <value> does not conform to Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure> (subkey của annotation không tuân theo schema của Feature đích tại pillar được định tuyến: giá trị <value> của subkey annotation <subkey> không tuân theo Feature <feature-uri> spec.schema.<pillar>.<subkey>: <constraint failure>)

Thông báo được phát ra (biến thể subkey không được khai báo):

annotation subkey does not conform to the target Feature’s schema at the routed pillar: annotation subkey <subkey> is not declared at Feature <feature-uri> spec.schema.<pillar>.<subkey> (subkey của annotation không tuân theo schema của Feature đích tại pillar được định tuyến: subkey annotation <subkey> không được khai báo tại Feature <feature-uri> spec.schema.<pillar>.<subkey>)

Lần dừng được phát ra trên annotation như đã viết, trước khi nó được mở rộng thành một attachment Feature, nên chẩn đoán nêu tài liệu và phạm vi nơi giá trị được viết — boundary và component đối với annotation phía Release, đường dẫn component đối với annotation phía Aggregate — cùng khóa annotation mà nó xuất phát.

Một annotation do plugin quản trị chèn vào cũng được xét theo cùng cách, và chẩn đoán cho biết ai đã viết nó. Một plugin được gắn để chèn annotation sẽ đặt giá trị của nó trên một component của Release, nên giá trị được kiểm tra giống hệt một giá trị mà người vận hành viết ở đó — nhưng dòng Release mà chẩn đoán trỏ tới là dòng không ai viết. Vì vậy chẩn đoán bổ sung plugin nào đã chèn giá trị và vai trò quản trị mà plugin được gắn vào, và việc sửa nằm ở quyết định của plugin đó chứ không phải ở Release.

Cách khắc phục: sửa giá trị được ràng buộc để thỏa mãn sub-schema đã khai báo, hoặc nới rộng schema của thuộc tính đó nếu giá trị là hợp lệ. Biến thể subkey không được khai báo thường bị lần dừng về đích của binding ở trên chặn trước; gặp nó nghĩa là binding khai báo đường dẫn còn schema của Feature không có, vì vậy hãy sửa bên nào sai trong hai bên. Khi một toán tử kết hợp trung gian khiến đường dẫn không thể phân giải và runtime sau đó từ chối nó, hãy thu hẹp schema để đưa thuộc tính lộ ra trực tiếp tại đường dẫn của binding.

An annotation subkey is not routed by its binding (Một khóa con của annotation không được binding của nó định tuyến)

Một annotation bạn viết mang các khóa con dưới một khóa mà một binding annotation của Manifest nhận quyền, và một trong các khóa con đó là một tên mà binding không định tuyến: nó không được liệt kê trong maps.infra cũng không trong maps.values. Mỗi khóa con được định tuyến riêng, tới đường dẫn Feature mà binding khai báo cho nó, nên một khóa con mà binding không nêu sẽ không có chỗ để đi. Mở rộng annotation mà không có nó sẽ khiến một giá trị bạn viết bị loại khỏi bản build mà không có thông báo gì, và nguyên nhân thường gặp là khóa con bị viết sai chính tả — vì vậy bản build dừng lại, nêu khóa con, khóa annotation mà nó được viết dưới đó, và mọi khóa con mà binding thực sự định tuyến.

Lần dừng được phát ra trên annotation như đã viết, trước khi nó được mở rộng thành một attachment Feature, giống hai điều kiện bên cạnh: “A bound annotation value does not conform to the target Feature’s schema (Giá trị annotation được ràng buộc không tuân theo schema của Feature đích)” ở trên từ chối một khóa con mà binding định tuyến khi Feature từ chối giá trị của nó, và “An annotation routes through a pillar its authoring side may not use (Một annotation được định tuyến qua một pillar mà phía viết nó không được dùng)” ở dưới từ chối một khóa con được định tuyến qua sai pillar. Một khóa không binding nào nhận quyền không thuộc điều kiện này: không có gì định tuyến nó, và bản build bỏ qua nó.

Thông báo được phát ra, nêu tài liệu và nơi annotation được viết, khóa con, khóa annotation, và các khóa con mà binding định tuyến:

annotation subkey is not routed by the annotation’s binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<subkey>", written under annotation "<key>", whose binding routes only "<subkey>, <subkey>") (khóa con của annotation không được binding của annotation định tuyến (Release; khóa con được viết dưới annotation này, nhưng binding của nó chỉ định tuyến các khóa con được liệt kê))

Một annotation viết trong một Aggregate được nêu theo cùng cách, tại nơi nó được viết ở đó — (Aggregate <name>, at .spec.subsystems.<subsystem>.annotations, …) đối với annotation viết trên một subsystem. Bản build báo cáo một annotation phía Release dưới thẻ OPS_ERROR và một annotation phía Aggregate dưới thẻ DEVELOPER_ERROR, theo tài liệu đã viết nó.

Cách khắc phục: so sánh khóa con với các khóa con mà thông báo liệt kê. Nếu đó là lỗi chính tả, hãy sửa nó thành khóa con mà binding định tuyến. Nếu giá trị cần tới được Feature, binding phải định tuyến nó: thêm đường dẫn vào maps.infra hoặc maps.values của binding trong Manifest — một đường dẫn mà schema của Feature khai báo — hoặc xóa khóa con khỏi annotation.

A bare annotation value does not route to exactly one path of its binding (Một giá trị annotation trần không được định tuyến tới đúng một đường dẫn của binding của nó)

Một annotation mà bạn viết dưới dạng giá trị trần — feature.aggrega.ai/monitoring: "30s" thay vì một map các khóa con — không nêu tên khóa con nào, nên không có gì trong nó cho biết nó điền vào đường dẫn Feature nào. Nó được đặt tại đường dẫn duy nhất mà binding khai báo, tính gộp cả maps.infra và maps.values. Một binding khai báo nhiều hơn một đường dẫn để lại cho giá trị nhiều nơi có thể đi tới và không có gì để chọn giữa chúng, nên build dừng lại thay vì chọn một. Việc đếm tính trên cả hai danh sách, nên một binding định tuyến một đường dẫn qua infra và một đường dẫn khác qua values sẽ từ chối giá trị trần bất kể nó được viết trong tài liệu nào.

Việc dừng được đưa ra trên annotation đúng như khi được viết, trước khi nó được mở rộng thành một attachment Feature, giống như các điều kiện bên cạnh, nên chẩn đoán nêu tên tài liệu và vị trí giá trị được viết. Việc kiểm tra diễn ra một lần cho mỗi annotation bạn viết: một giá trị được viết trên một boundary hoặc một subsystem bị từ chối tại đó, một lần, bất kể một component bên trong có tiếp nhận nó hay không. Mọi giá trị như vậy trong build đều được báo cáo, không chỉ giá trị đầu tiên. Build báo cáo một annotation phía Release dưới thẻ OPS_ERROR và một annotation phía Aggregate dưới thẻ DEVELOPER_ERROR, theo tài liệu đã viết ra nó. Điều kiện là a scalar annotation value does not route to exactly one path of its binding, chính là nội dung mà aggrega explain in ra cho mã của nó.

Thông báo được phát ra, nêu tên tài liệu và vị trí annotation được viết, khóa annotation, giá trị, và các đường dẫn mà binding định tuyến:

a scalar annotation value does not route to exactly one path of its binding (Release <release-name>, at .spec.boundaries.<boundary>.annotations, "<key>", carrying the bare value "<value>", whose binding routes "<path>, <path>, <path>") (một giá trị annotation dạng scalar không được định tuyến tới đúng một đường dẫn của binding của nó: khóa mang một giá trị trần, trong khi binding của nó định tuyến tới nhiều đường dẫn)

Một giá trị rỗng không ghi gì cả, nên nó được đặt ở bất cứ nơi nào một trong hai danh sách chứa một đường dẫn duy nhất, và chỉ bị từ chối khi không danh sách nào chứa. Một binding không khai báo đường dẫn nào sẽ bị từ chối khi Manifest được nạp, vì schema của Manifest yêu cầu phải có một đường dẫn, nên một build không chạm tới điều kiện này theo cách đó.

Một annotation do một plugin quản trị chèn vào cũng được đánh giá theo cùng cách, và chẩn đoán của nó bổ sung plugin nào đã chèn giá trị và vai trò quản trị mà plugin được gắn vào, như các điều kiện bên cạnh.

Cách khắc phục: hãy viết annotation dưới dạng một map nêu tên khóa con cho từng giá trị — feature.aggrega.ai/monitoring: {interval: 30s} — để mỗi giá trị được định tuyến theo tên riêng của nó; hoặc cho giá trị đơn lẻ đó một binding riêng, dưới một khóa annotation khác, chỉ khai báo đường dẫn mà nó điền vào.

An annotation routes through a pillar its authoring side may not use (Một annotation định tuyến qua một pillar mà phía viết nó không được phép dùng)

Các annotation được phân chia theo phía viết, và sự phân chia này giống với sự phân chia chi phối mọi pillar được viết khác: một annotation phía Aggregate chỉ có thể định tuyến qua một đường dẫn binding nhắm tới values, và một annotation phía Release chỉ qua một đường dẫn nhắm tới infra. Mọi cách ghép cặp khác đều dừng.

Sự phân chia là thứ ngăn lối tắt annotation trở thành cách để viết pillar của phía bên kia. Annotation của nhà phát triển đóng góp values; annotation của người vận hành đóng góp kích thước infra. Một binding khai báo đường dẫn trong cả hai pillar tự nó không phải là lỗi — mỗi phía định tuyến tập con mà nó được phép, và các đường dẫn của phía bên kia đơn giản là không thể tới được từ nó.

Một binding khai báo một đường dẫn trong cả hai danh sách pillar là trường hợp thường gặp lần dừng này nhất. Quy tắc phân xử định tuyến đưa đường dẫn như vậy qua infra, khiến nó không thể tới được từ phía Aggregate, và một annotation phía Aggregate định tuyến tới nó sẽ dừng tại đây. Cảnh báo chỉ ra hình dạng binding đó trước khi một bản build gặp lần dừng này được mô tả trong warnings.md.

Thông báo được phát ra:

annotation routes through a pillar its authoring side may not use: annotation <key> at <source> routes through pillar <pillar> at path <path>, but <side>-side annotations may only route through pillar <permitted-pillar> (annotation định tuyến qua một pillar mà phía viết nó không được phép dùng: annotation <key> tại <source> định tuyến qua pillar <pillar> tại đường dẫn <path>, nhưng annotation phía <side> chỉ có thể định tuyến qua pillar <permitted-pillar>)

Một annotation do plugin quản trị chèn vào nằm trên một component của Release, nên nó là annotation phía Release và cùng sự phân chia áp dụng cho nó. Chẩn đoán của nó bổ sung plugin nào đã chèn nó và vai trò quản trị mà plugin được gắn vào, vì khóa Release mà nó trỏ tới là khóa không ai viết.

Cách khắc phục: định tuyến annotation từ phía có pillar mà binding nhắm tới, hoặc thêm một binding — dưới khóa annotation riêng của nó — có các đường dẫn nhắm tới pillar mà phía viết được phép. Khi một binding khai báo cùng một đường dẫn trong cả hai danh sách pillar, hãy tách nó thành hai binding để mỗi phía có một đường dẫn có thể tới được. Khi chẩn đoán nêu một plugin đã chèn, annotation đến từ quyết định của plugin đó: hãy sửa plugin, hoặc binding mà nó chèn vào dưới đó.

Authored values or infra do not conform to the declared schema (Values hoặc infra được viết không tuân theo schema đã khai báo)

values: hoặc infra: đã phân giải của một instance component — hoặc của một Feature được gắn — không tuân theo schema catalog đã khai báo. Bản build xác thực từng pillar theo schema đã khai báo của nó trước khi render, nên một khóa gõ sai, một giá trị sai kiểu, một số ngoài khoảng, hoặc một trường bắt buộc bị thiếu sẽ bị phát hiện tại nguồn thay vì tạo ra một manifest hỏng lúc triển khai.

Việc kiểm tra bao gồm các ràng buộc schema tiêu chuẩn: một giá trị sai kiểu (một chuỗi nơi schema khai báo số nguyên), một giá trị nằm ngoài khoảng đã khai báo hoặc enum, một giá trị không khớp pattern đã khai báo, một chuỗi không phải instance hợp lệ của format đã khai báo — một trong các định dạng có tên — và một trường bắt buộc không được cung cấp. Một lỗi định dạng nêu tên từ khóa và mang theo giá trị, định dạng và điều sai với nó — như aggrega pull và aggrega validate --release in ra cho một trường uri được gán ::::, "format", "value \"::::\" is not a valid uri: a URI begins with a scheme followed by a colon, such as https:". Nó có tính đến giá trị mặc định: một trường mà schema gán default: được coi là đã cung cấp ngay cả khi bị bỏ qua, nên một trường bắt buộc có mặc định không bao giờ kích hoạt kiểm tra “thiếu”.

Pillar values là bề mặt viết của nhà phát triển. Nó được xác thực đóng — một thuộc tính mà schema không khai báo sẽ bị từ chối vì nhiều khả năng là lỗi gõ. Một schema values kết hợp bên trong chính tài liệu của nó (một $ref cục bộ #/$defs hoặc allOf) được phân giải và xác thực theo ngữ cảnh định nghĩa đó.

Pillar infra là bề mặt định kích thước của người vận hành, và chỉ được kiểm tra khi Component khai báo một pillar schema.infra — khai báo đó là hợp đồng mà component chọn tham gia. Nó được xác thực đóng theo khai báo đó và không theo gì khác, giống hệt cách pillar values được xác thực theo schema.values: một khóa mà Component không khai báo bị từ chối như lỗi gõ, và một khóa mà nó có khai báo sẽ bị áp kiểu và khoảng. Một component muốn một khóa do provider xếp lớp như replicas được xác thực thì khai báo khóa đó trong schema.infra của chính nó; từ vựng được chấp nhận của một provider được tiếp cận thông qua valuesMapping của Recipe của nó thay vì được xếp lớp lên bề mặt infra được viết.

Việc kiểm tra đo kích thước của mọi component mà Release đặt, và một mục không viết khối infra: nào cũng được đo: một khối vắng mặt là một khối rỗng, nên một khóa required: không mang default: được báo là thiếu — đó chính là trường hợp mà một khóa như vậy tồn tại để bắt. Cả hai cách đặt một component đều được tính. Nêu tên nó dưới components của một boundary là đặt nó, và định tuyến sub-module đóng góp nó dưới aggregates cũng vậy; một mục định tuyến đặt các component mà không nói gì về bất kỳ component nào trong số đó, nên một component được đặt theo cách đó bắt đầu từ một khối kích thước rỗng và một khóa required: không có giá trị mặc định trên kiểu của nó được báo là thiếu. Một component mà Release không đặt theo cách nào trong hai cách trên thì hoàn toàn không được đo theo hợp đồng này. Nó có một lỗi khác, và bản build báo lỗi đó thay vào: một component không được đặt trong boundary nào, kèm theo tên hai cách để đặt nó.

Hợp đồng ràng buộc một component bất kể nó được viết ở đâu: một component do sub-module đóng góp được đo giống hệt một component mà chính Aggregate của Release khai báo. Mức độ lồng sâu của một component không thay đổi việc ràng buộc nào của kiểu nó được áp dụng.

Các phần đính kèm Feature được kiểm tra hợp lệ theo cùng cách, đối chiếu với schema.values / schema.infra được khai báo của Feature được đính kèm. Các phần đính kèm dùng chung một bề mặt, nên một Feature thông tin xác thực — Feature được gắn nhãn feature.aggrega.ai/kind: secret — được đối chiếu với schema được khai báo của chính nó, đúng như mọi phần đính kèm khác. Giá trị được kiểm tra là kết quả hợp nhất hiệu lực sau khi các giá trị đính kèm lan truyền qua các phạm vi (component, subsystem, boundary và phạm vi riêng cho từng component) — vì vậy một giá trị được đưa vào hợp lệ ở một phạm vi nhưng bị ghi đè thành giá trị không hợp lệ ở một phạm vi cụ thể hơn sẽ bị phát hiện trên kết quả hợp nhất, chứ không phải trên từng mảnh. Một phần đính kèm có kiểu không khai báo schema thì không được kiểm tra hợp lệ; infra của phần đính kèm được kiểm tra hợp lệ theo schema.infra của chính phần đính kèm đó (một phần đính kèm là một lớp phủ và không mang hợp provider nào).

Phát hiện về một phần đính kèm được báo cáo trong tài liệu đã viết pillar bị lỗi, dưới tên của tài liệu đó, và được quy cho tác giả của nó. values của nó được báo cáo tại khối Aggregate đã viết chúng — mục features: của chính component, .spec.components.<component>.features.<attachment>.values.<field>, được ưu tiên hơn khối của một subsystem bao trùm component đó — như một lỗi của nhà phát triển. infra của nó được báo cáo tại khối Release đã viết nó — mục của Release cho component đó, dưới boundary đặt tên cho nó, được ưu tiên hơn khối features: của chính boundary — như một lỗi của người vận hành. Một pillar mà tài liệu sở hữu nó không viết sẽ được báo cáo tại nơi chính phần đính kèm được viết, tức là nơi type của nó được đặt tên. Vì vậy, một phần đính kèm chỉ do Release tạo ra, vốn không mang values, sẽ báo cáo một trường mà values của Feature yêu cầu tại mục của Release và như một lỗi của người vận hành, tại một đường dẫn mà Release nắm giữ — mục của component, hoặc khối features: của boundary đối với phần đính kèm mà boundary tạo cho mọi component bên dưới nó:

[OPS_ERROR E0168] .spec.boundaries.main.components.app.features.check.values.schema
authored pillar does not conform to its declared schema (Release probe, at .spec.boundaries.main.components.app.features.check.values.schema, values pillar does not conform to the Feature schema: missing required property: schema (required))

Cùng phần đính kèm đó, nếu được viết trên component trong Aggregate, sẽ báo cáo [DEVELOPER_ERROR E0168] tại .spec.components.app.features.check.values.schema, dưới tên của Aggregate. Trình soạn thảo hiển thị mỗi lỗi trên tài liệu đã viết nó, tại khóa sâu nhất của đường dẫn đó mà tài liệu nắm giữ.

Một phần đính kèm do một kết nối mang theo được đo theo cùng cách, và được báo cáo tại mục kết nối của tài liệu đã viết pillar bị lỗi, chứ không phải tại khối features: của chính component, vốn không chứa nó. values của nó được báo cáo tại mục kết nối của Aggregate, .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field> — trong tài liệu riêng của sub-module, đối với component do một sub-module đóng góp — và infra của nó tại mục của Release cho kết nối đó, dưới boundary đặt tên cho component ở nơi Release đặt tên các boundary. Một phần đính kèm chỉ do Release tạo ra được báo cáo tại mục của Release cho cả hai pillar: phần đính kèm như vậy không mang values, nên một Feature có values yêu cầu một trường sẽ báo cáo trường đó bị thiếu tại đó, tại mục mà người vận hành đã viết.

Cấu hình kết nối theo từng cạnh được kiểm tra hợp lệ theo cùng cách, đối chiếu với hợp đồng theo từng cạnh của socket: values do nhà phát triển viết của một cạnh được đối chiếu với valueSchema của socket, và infra do người vận hành viết của một cạnh (từ một Release) được đối chiếu với infraSchema của socket. Một socket không khai báo schema theo từng cạnh cho một pillar sẽ không chấp nhận cấu hình được kiểm tra hợp lệ nào cho pillar đó (bỏ qua = không có hợp đồng, không có gì để kiểm tra). Chẩn đoán đặt tên cạnh theo bên tiêu thụ, socket và alias. Trên một component mà chính Aggregate của Release khai báo, infra của người vận hành được đo cho mọi mục mà Release viết cho một trong các kết nối của nó — kể cả mục không mang infra, đó là cách một khóa required: không có giá trị mặc định được báo cáo là thiếu — và được báo cáo tại mục đó trong Release, dưới boundary đặt tên cho component ở nơi Release đặt tên các boundary, tức là nơi người vận hành chỉnh sửa nó; values của nhà phát triển được báo cáo tại mục kết nối trong Aggregate.

Một lá được khai báo sensitive: true sẽ bị giữ lại nội dung lỗi ràng buộc. Văn bản lỗi trích dẫn giá trị vi phạm, và chẩn đoán của bản build được đọc bởi bất kỳ ai theo dõi bản build, nên trên một lá được khai báo là nhạy cảm — hoặc ở bất kỳ đâu bên trong một đối tượng được khai báo là nhạy cảm — <constraint failure> bên dưới sẽ hiển thị <redacted> thay thế. Điều tương tự áp dụng tại một vị trí có chứa một lá được khai báo là nhạy cảm bên dưới nó, kể cả chính pillar: một $ref được viết bên cạnh các từ khóa khác được kiểm tra trọn vẹn tại nơi nó được viết, nên một lỗi bên trong định nghĩa mà nó trỏ tới được báo cáo tại vị trí đó và nếu không thì sẽ trích dẫn giá trị của lá. Thực thể, đường dẫn trường, pillar và tên hợp đồng vẫn được nêu đầy đủ, nên chẩn đoán vẫn cho bạn biết lỗi nằm ở đâu; chỉ phần văn bản có thể tái hiện giá trị bị lược bỏ. Tính nhạy cảm được đọc theo từng pillar, nên một lá có cùng tên trong values và infra chỉ bị giữ lại ở pillar khai báo nó.

Thông báo được phát ra:

authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (pillar đã viết không tuân theo schema đã khai báo của nó) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (pillar đã viết không tuân theo schema đã khai báo của nó) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pillar đã viết không tuân theo schema đã khai báo của nó: pillar values không tuân theo schema của Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.features.<attachment>.infra.<field>, infra pillar does not conform to the Feature schema: <constraint failure>) (pillar đã viết không tuân theo schema đã khai báo của nó: pillar infra không tuân theo schema của Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.features.<attachment>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pillar đã viết không tuân theo schema đã khai báo của nó: pillar values không tuân theo schema của Feature) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.values.<field>, “values.<field>”, “<keyword>”, “<constraint failure>”) (pillar đã viết không tuân theo schema đã khai báo của nó) authored pillar does not conform to its declared schema (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pillar đã viết không tuân theo schema đã khai báo của nó: pillar values không tuân theo schema của Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>.features.<slot>.values.<field>, values pillar does not conform to the Feature schema: <constraint failure>) (pillar đã viết không tuân theo schema đã khai báo của nó: pillar values không tuân theo schema của Feature) authored pillar does not conform to its declared schema (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>.infra.<field>, “infra.<field>”, “<keyword>”, “<constraint failure>”) (pillar đã viết không tuân theo schema đã khai báo của nó)

Cách khắc phục: sửa giá trị vi phạm để thỏa mãn schema được khai báo, hoặc — nếu giá trị đó hợp lệ — mở rộng schema khai báo (schema.values/schema.infra của Component, hoặc của Feature được đính kèm) để khai báo nó. Kiểm tra schema được khai báo của một Component bằng aggrega inspect <component-type> để xem chính xác các kiểu, phạm vi, giá trị mặc định và các trường bắt buộc mà mỗi pillar yêu cầu.

A declared schema contract cannot be read as a schema (Một hợp đồng schema đã khai báo không thể được đọc như một schema)

Một Component hoặc Feature khai báo một hợp đồng schema không tạo ra thứ gì để xác thực, nên cấu hình mà nó bao phủ được đối chiếu với hư không. Có ba hợp đồng có thể mang lỗi này, mỗi hợp đồng được viết trong trường riêng của nó: spec.schema của chính thực thể, và hai hợp đồng theo từng cạnh mà một socket phụ thuộc khai báo — valueSchema cho phía nhà phát triển của một kết nối và infraSchema cho phía người vận hành. Một mục SchemaLibrary, mà các hợp đồng đó có thể tham chiếu tới, cũng có thể mang lỗi thứ ba trong số các lỗi dưới đây; cách báo cáo trường hợp đó được trình bày ở phần sau.

Có ba lỗi dẫn tới điểm dừng này, và hai trong số đó dễ bị bỏ sót vì hợp đồng trông vẫn ổn. Một hợp đồng socket có thể hoàn toàn không biên dịch được sang JSON Schema 2020-12 — một từ khóa gõ sai là nguyên nhân phổ biến nhất; còn spec.schema của chính một thực thể mà không biên dịch được thì thay vào đó được báo cáo dưới điều kiện compact form mà quá trình biên dịch của nó gặp phải (E0120 cho một từ khóa không xác định, E0116 cho một ràng buộc mà kiểu của nó không nhận). Hoặc nó có thể biên dịch trơn tru mà vẫn không tạo ra validator nào: phần thân đọc được dưới dạng compact form nhưng không phải là một schema mà bất cứ thứ gì có thể dùng để xác thực, chẳng hạn một giá trị vô hướng trần ở chỗ lẽ ra là schema của một thuộc tính (items: nonsense). Hoặc nó có thể đúng cấu trúc về mọi mặt khác nhưng lại nêu một format nằm ngoài tập được hỗ trợ — format: password, hoặc một lỗi chính tả như format: emial — và format đó bị từ chối thay vì được đọc như một ràng buộc không kiểm tra gì, bất kể có giá trị nào tới trường đó hay không; các tên mà một format có thể nhận được liệt kê tại Các format được đặt tên. Cả ba là một điều kiện duy nhất, vì cách khắc phục giống nhau và việc bỏ qua bất kỳ lỗi nào trong số đó đều có cùng hậu quả.

Không khai báo hợp đồng nào và khai báo một hợp đồng không đọc được là hai tình huống khác nhau, và bản build xử lý chúng khác nhau. Một trường không khai báo gì sẽ được bỏ qua: việc kiểm tra tuân thủ theo từng pillar và theo từng cạnh là tùy chọn, nên một socket không ràng buộc pillar nào là cách viết bình thường và không phát sinh chẩn đoán nào. Một trường khai báo thứ gì đó không đọc được sẽ bị từ chối. Bỏ qua nó sẽ khiến mọi payload mà nó bao phủ không được xác thực trong khi bản build báo thành công — một phép kiểm tra đã ngừng chạy mà không có gì báo rằng nó đã ngừng. Vì vậy, chính sự từ chối giữ cho hai trường hợp tách biệt: im lặng nghĩa là không có gì để kiểm tra, còn một điểm dừng nghĩa là có thứ cần kiểm tra nhưng không đọc được.

Lời từ chối nêu tên thực thể đã khai báo hợp đồng thay vì tài liệu đã viết cấu hình, vì đó là nơi cần sửa. Một tác giả Aggregate được giao một kiểu component có hợp đồng không đọc được thì không có gì để thay đổi trong tệp của chính họ. Lỗi xuất hiện khi catalog được đọc, lúc mà thực thể khai báo, pillar, trường đã viết và dòng nguồn đều đã được biết — nên cùng một lỗi được báo cáo giống hệt nhau dù bạn gặp nó từ một bản build, từ aggrega validate, hay từ công cụ build mà aggrega mcp cung cấp. Một hợp đồng mà thực thể đọc thông qua $import: — toàn bộ spec.schema của nó, một pillar của nó, hoặc hợp đồng của một socket — được báo cáo tại tệp được import: vị trí nêu tên tệp đó và dòng trong tệp nơi đoạn được viết, trong khi thông báo vẫn nêu tên thực thể và trường đã khai báo hợp đồng. Các lần dừng compact-form mà chính spec.schema của một thực thể gặp phải cũng được định vị theo cùng cách.

Một mục SchemaLibrary nêu một format nằm ngoài tập được hỗ trợ sẽ dẫn tới điểm dừng này khi thư viện của nó được đọc, và lời từ chối nêu tên thư viện cùng mục đó và trỏ tới mục đó trong tệp thư viện. aggrega validate trên toàn bộ catalog đọc mọi thư viện, nên nó báo cáo mục đó bất kể có schema nào tham chiếu tới nó hay không, trong khi một Release mà quá trình phân giải phụ thuộc không bao giờ chạm tới thư viện thì không đọc nó. Một Release có schema chạm tới mục đó qua một $ref: cũng bị từ chối, nhưng lời từ chối không nêu tên format: aggrega pull báo rằng không tìm thấy thư viện trong catalog (E0114), còn aggrega validate --release báo rằng không tìm thấy đích của tham chiếu (E0121). Hãy chạy aggrega validate trên catalog để thấy mục và tên bị lỗi.

Thông báo mang lỗi đúng như công cụ gặp phải nó đã báo cáo: với lỗi biên dịch là khóa bên trong hợp đồng, dòng nguồn và từ khóa gây lỗi; với phần thân không tạo ra validator là vị trí mà validator đã từ chối; với tên format nằm ngoài tập được hỗ trợ là trường, từ khóa format, tên như đã viết và mọi tên được hỗ trợ. Một $ref: liên tài liệu trong một hợp đồng socket có mục SchemaLibrary không nằm trong tập đóng đã tải sẽ dẫn tới cùng điểm dừng này khi aggrega validate kiểm tra thực thể hoặc Release; trong spec.schema của chính một thực thể, nó được báo cáo như mô tả ở “A $ref: is not written in a form the compiler can resolve (Tham chiếu không được viết ở dạng trình biên dịch có thể phân giải)” phía trên. aggrega pull đọc cả hai nơi để tìm các thư viện mà một Release cần, nên một thư viện vắng mặt trong catalog sẽ dừng lần pull sớm hơn, như mô tả ở “A reference names no entity the catalog holds (Tham chiếu nêu một thực thể mà catalog không chứa)” (E0114), bất kể nơi nào trong hai nơi tham chiếu tới nó — và một thư viện mà catalog có chứa sẽ được ghim trong lockfile cho cả hai nơi.

Một ràng buộc đúng cấu trúc nằm cạnh một ràng buộc không đọc được sẽ không được thực thi. Một hợp đồng được đọc như một tài liệu duy nhất, nên chỉ một đoạn không đọc được cũng vô hiệu hóa mọi ràng buộc được khai báo cùng với nó. Đó là lý do điểm dừng này đáng giá hơn những ràng buộc mà nó làm mất: phương án còn lại là một hợp đồng trông như được thực thi, đọc như được thực thi, nhưng không thực thi gì cả.

Thông báo được phát ra nêu tên thực thể kèm phiên bản và trường khai báo hợp đồng, sau đó là pillar mà hợp đồng đó ràng buộc, rồi đến lỗi — ở đây là một hợp đồng socket mang một từ khóa gõ sai:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.usesSchema.<socket>.valueSchema declares a schema no validator can be built from, so the values it constrains would go unmeasured: compactform at <key>:<line> (keyword "<keyword>"): unknown keyword (hợp đồng schema đã khai báo không thể biên dịch thành một schema dùng được, nên không có gì được xác thực theo nó: hãy sửa hợp đồng ở nơi nó được khai báo, hoặc xóa nó nếu cấu hình mà nó bao phủ không cần xác thực. Component: valueSchema của socket trong spec.usesSchema khai báo một schema không thể dựng validator từ đó, nên các giá trị mà nó ràng buộc sẽ không được đo: compactform tại khóa và dòng đã nêu (từ khóa đã nêu): từ khóa không xác định)

và một tên format nằm ngoài tập được hỗ trợ trong pillar values của một Component:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. Component "<type>:<version>": spec.schema.values declares a schema no validator can be built from, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at values.<field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (hợp đồng schema đã khai báo không thể biên dịch thành một schema dùng được, nên không có gì được xác thực theo nó: hãy sửa hợp đồng tại nơi nó được khai báo, hoặc xóa nó nếu cấu hình mà nó bao phủ không cần xác thực. Component <type>:<version>: spec.schema.values khai báo một schema mà không thể xây dựng validator nào từ đó, nên các giá trị mà nó ràng buộc sẽ không được đo: validator/jsonschema: phân giải schema thất bại (tại values.<field>, từ khóa format, format <format> không được hỗ trợ; các format được hỗ trợ là email, uri, hostname, ipv4, ipv6, uuid, date-time, date))

Một Feature được nêu là Feature "<name>:<version>", hợp đồng của một socket được nêu bằng chính trường của nó, chẳng hạn spec.usesSchema.<socket>.infraSchema, và pillar được nêu bằng pillar mà hợp đồng ràng buộc — values, infra hoặc provides. aggrega validate khi được đưa tệp của chính thực thể sẽ nêu tên thực thể mà không kèm phiên bản. Một mục SchemaLibrary được nêu bằng thư viện và mục của nó:

declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation. SchemaLibrary "<library>": schema "<entry>" names a format no validator can check, so the values it constrains would go unmeasured: validator/jsonschema: schema resolution failed (at <field>, keyword "format", format "<format>" is not supported; the supported formats are email, uri, hostname, ipv4, ipv6, uuid, date-time, date) (hợp đồng schema đã khai báo không thể biên dịch thành một schema dùng được, nên không có gì được xác thực theo nó: hãy sửa hợp đồng tại nơi nó được khai báo, hoặc xóa nó nếu cấu hình mà nó bao phủ không cần xác thực. SchemaLibrary <library>: schema <entry> nêu một format mà không validator nào kiểm tra được, nên các giá trị mà nó ràng buộc sẽ không được đo: validator/jsonschema: phân giải schema thất bại (tại <field>, từ khóa format, format <format> không được hỗ trợ; các format được hỗ trợ là email, uri, hostname, ipv4, ipv6, uuid, date-time, date))

Cách khắc phục: mở trường mà chẩn đoán nêu tên và sửa đoạn tại khóa và dòng được báo cáo — thường gặp nhất là một từ khóa gõ sai, hãy đối chiếu với bộ từ khóa trong vocabulary/compact-form-authoring.md, hoặc một giá trị được viết ở chỗ lẽ ra là một schema lồng nhau. Khi lỗi nêu một format không được hỗ trợ, hãy viết một trong các format được đặt tên hoặc xóa format:; một trường chứa dữ liệu bí mật thì thay vào đó khai báo sensitive: true, vì password không phải là một format. Với một mục SchemaLibrary, việc sửa được thực hiện trong tệp thư viện mà chẩn đoán nêu tên. Khi lỗi nêu một tham chiếu liên tài liệu, hãy xác nhận rằng mục SchemaLibrary tồn tại và thư viện có thể truy cập được từ tập đóng phụ thuộc của Release. Nếu cấu hình mà trường đó bao phủ thực sự không cần xác thực, hãy xóa trường đó thay vì để lại một hợp đồng mà không gì đọc được.

source: của Recipe là một chuỗi rỗng

Một Recipe khai báo source: "" — một chuỗi rỗng. source: của một Recipe chọn giữa hai chế độ soạn thảo: chế độ không nguồn (sourceless), trong đó không có artifact bên ngoài và đầu ra được tạo hoàn toàn từ các loại đầu vào khác của Recipe, và chế độ có nguồn (sourced), trong đó source: chỉ định một chart, module hoặc tệp bên ngoài để render. Bỏ trường này sẽ chọn chế độ thứ nhất, một giá trị không rỗng sẽ chọn chế độ thứ hai, còn một chuỗi rỗng không chọn chế độ nào — vì vậy nó là một sự mơ hồ chứ không phải một giá trị có ý nghĩa. Một source: được viết là null cũng giống như bỏ nó đi.

Recipe bị từ chối thay vì trình biên dịch chọn giúp bạn một trong hai cách hiểu. Cách phổ biến nhất để viết một source: rỗng là xóa một URI nhưng để lại khóa: ý định là chế độ có nguồn, và chấp nhận chuỗi rỗng như chế độ không nguồn sẽ phát hành component thiếu artifact mà không bao giờ cho biết nó đã chọn cách hiểu nào.

Quy tắc này được kiểm tra khi Recipe được tải, đọc giá trị đúng như bạn đã viết, nên mọi lệnh tải Recipe đều nêu điều kiện này trước khi bất cứ thứ gì cố dùng giá trị rỗng. aggrega validate trên tệp Recipe sẽ từ chối nó; aggrega pull, một bản build, aggrega validate --release và công cụ build mà aggrega mcp cung cấp báo cáo nó cho một Release chạm tới Recipe, trước tham chiếu tới Recipe mà vì nó không còn phân giải được nữa. Do đó, một lần pull nêu điều kiện này thay vì báo cáo tham chiếu rỗng như một tham chiếu mà nó không xác định được loại source. Quy tắc này được kiểm tra trước các quy tắc đọc xem một source có được khai báo hay không, nên một Recipe có source: rỗng sẽ được báo về source: thay vì về một valuesMapping không có gì để phủ lên hay về một loại đầu vào bị thiếu.

Thông báo được phát ra, được định vị tại tệp Recipe nơi source: rỗng được viết và tại khóa bên trong nó — .spec.source — thay vì tại một component gắn với Recipe, vì mục này được chia sẻ bởi mọi component gắn với nó:

recipe source is an empty string, which names neither sourceless mode nor sourced mode (Recipe <name>:<version>, at .spec.source). omit the source field for sourceless mode, or name a non-empty path or URI for sourced mode (source của recipe là một chuỗi rỗng, không chỉ định chế độ không nguồn cũng như chế độ có nguồn. hãy bỏ trường source cho chế độ không nguồn, hoặc chỉ định một đường dẫn hay URI không rỗng cho chế độ có nguồn)

Bản build in dòng này dưới thẻ CATALOG_ERROR cùng mã ngắn của điều kiện này, E0251, và tệp Recipe bên cạnh.

Cách sửa: bỏ hoàn toàn trường source: (hoặc đặt nó là null) nếu Recipe không có nguồn, hoặc cung cấp một đường dẫn / URI / đối tượng nguồn có cấu trúc không rỗng nếu Recipe có nguồn.

No Recipe is mapped for a component or feature instance (Không có Recipe nào được ánh xạ cho một instance component hoặc feature)

Kiểu của một instance không có ánh xạ Manifest nào phân giải tới một Recipe mà catalog chứa. Việc chọn Recipe là chỉ qua ánh xạ: trình biên dịch không bao giờ chọn một Recipe bằng cách đọc spec.implements: và chọn trong số các ứng viên, nên một kiểu không được ánh xạ sẽ dừng lại bất kể có bao nhiêu Recipes hiện thực nó. implements cung cấp thông tin cho lựa chọn; tác giả đưa ra lựa chọn; Manifest ghi lại lựa chọn đó.

Cùng điều kiện này bao gồm một ánh xạ có tồn tại nhưng không dẫn tới đâu — một giá trị ở dạng tham chiếu được chấp nhận chỉ định một Recipe mà catalog không chứa, kể cả một Recipe hiện diện dưới một phiên bản khác với phiên bản giá trị ghim, và một Recipe có tên trần được hai capability cùng cung cấp. Không trường hợp nào phân giải tới một Recipe mà có thể nói là tác giả đã chọn. Một giá trị ánh xạ có dạng mà không tham chiếu nào biểu đạt được sẽ được báo cáo riêng, dưới “Manifest mapping value is not a shape a recipe reference accepts (Giá trị ánh xạ Manifest không có dạng mà một tham chiếu recipe chấp nhận)” ở trên, nên khẳng định rằng một thực thể vắng mặt chỉ được đưa ra về một tham chiếu lẽ ra có thể phân giải được.

Các thông báo được phát ra, cho một instance component. Khi một ánh xạ tồn tại và chỉ định một thứ vắng mặt:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", mapped to recipe "<uri>"). correct the mapping value in the Manifest, or publish the recipe it names (không có recipe nào được phân giải cho instance component/feature: hãy thêm một ánh xạ Manifest tường minh cho kiểu của nó. hãy sửa giá trị ánh xạ trong Manifest, hoặc xuất bản recipe mà nó chỉ định)

Khi không có ánh xạ nào và có các Recipes hiện thực kiểu đó, chúng được liệt kê làm các ứng viên để ghim:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>", recipes implementing it "<recipe-uris>"). pin one of them in the Manifest (không có recipe nào được phân giải cho instance component/feature: hãy thêm một ánh xạ Manifest tường minh cho kiểu của nó. hãy ghim một trong số chúng trong Manifest)

Và khi không có gì hiện thực kiểu đó, thì không có gì để liệt kê:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe in the catalog implements this type; write one, then map the type to it (không có recipe nào được phân giải cho instance component/feature: hãy thêm một ánh xạ Manifest tường minh cho kiểu của nó. không có recipe nào trong catalog hiện thực kiểu này; hãy viết một recipe, rồi ánh xạ kiểu tới nó)

Trong một workspace không chỉ định thư mục catalog nào, các Recipes được tìm kiếm chỉ là những cái mà lockfile ghim: những cái của registry không được liệt kê, và một Manifest không ánh xạ cái nào cho kiểu đó thì không ghim cái nào. Khi đó, nếu không có Recipe đã ghim nào triển khai kiểu đó, khẳng định về sự vắng mặt được đưa ra đối với các mục đã ghim chứ không phải đối với catalog, và thông báo nói rõ điều đó:

no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type (Manifest, at .spec.components.<instance>, "<instance>", of type "<type>"). no recipe the lockfile pins implements this type; with no catalog directory, the recipes searched are only those the lockfile pins, not a registry’s; pin one a registry publishes in the Manifest, or write one, then map the type to it (không phân giải được công thức nào cho instance thành phần/tính năng: hãy thêm một ánh xạ tường minh cho kiểu của nó trong Manifest (Manifest, tại vị trí, instance và kiểu được nêu). không có công thức nào được lockfile ghim triển khai kiểu này; khi không có thư mục catalog, các công thức được tìm kiếm chỉ là những cái lockfile ghim, không phải của registry; hãy ghim trong Manifest một công thức do registry phát hành, hoặc viết một công thức, rồi ánh xạ kiểu tới nó)

Một kiểu mà Aggregate viết không kèm phiên bản sẽ được đề xuất các Recipes triển khai phiên bản mà bản dựng biên dịch nó — phiên bản cao nhất của Component đó mà catalog nắm giữ. Một instance của core/datastore/postgres, khi catalog nắm giữ Component đó ở phiên bản 1.0.0, sẽ được đề xuất mọi Recipe khai báo spec.implements: core/datastore/postgres:1.0.0, cũng như mọi Recipe khai báo kiểu không có phiên bản hoặc một khoảng caret chấp nhận 1.0.0. Một kiểu mà catalog không nắm giữ Component nào chỉ được đề xuất các Recipes khai báo chính kiểu không có phiên bản đó.

Một thể hiện tính năng báo cáo các trường hợp này theo một dạng riêng, mỗi trường hợp nằm sau câu của điều kiện. Một kiểu tính năng mà Aggregate viết không kèm phiên bản được so khớp giống như một kiểu thành phần, ở phiên bản mà bản build biên dịch nó — phiên bản cao nhất của Feature đó mà catalog có — và một thông báo nêu <type>:<version> là nêu kiểu ở phiên bản đó, cũng chính là thứ đã được tìm trong catalog. Khi đã biết Recipe mà thành phần của một mục đính kèm được ánh xạ tới, các FeatureRecipes được phân biệt theo khả năng mà Recipe đó liên kết tới: những cái liên kết tới khả năng của thành phần được đề xuất trước, và một FeatureRecipe liên kết tới khả năng khác vẫn được render, thành đầu ra riêng của nó bên cạnh đầu ra của thành phần chứ không phải vào trong đó, vì vậy khi không có cái nào liên kết tới khả năng của thành phần thì những cái đó được đề xuất thay thế. Một ánh xạ không dẫn tới đâu sẽ có dạng feature "<instance>" (type "<type>"): the Manifest maps it to feature recipe "<uri>", which is not in the catalog. Khi có các FeatureRecipes triển khai kiểu đó cho khả năng của thành phần, chỉ những cái đó được liệt kê: feature "<instance>" (type "<type>"); feature recipes implementing it for capability "<capability>", the capability its component's Recipe binds to: [<recipe-uris>]; pin one in the Manifest. Khi chúng chỉ triển khai nó cho các khả năng khác: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; feature recipes implementing it for other capabilities: [<recipe-uris>]; pin one of those in the Manifest, and it renders as its own output beside the component's, or write one for "<capability>", then map the type to it. Khi hoàn toàn không có cái nào triển khai kiểu đó: feature "<instance>" (type "<type>"); no feature recipe in the catalog implements <type>:<version>; write one, then map the type to it. Và khi không biết khả năng — ánh xạ của chính thành phần không phân giải tới Recipe nào, điều này được báo cáo riêng, hoặc mục đính kèm được viết trên một ranh giới mà các thành phần của nó có thể render qua nhiều khả năng — thì mọi bản triển khai đều được liệt kê: feature "<instance>" (type "<type>"); feature recipes implementing it: [<recipe-uris>]; pin one in the Manifest. Trong một workspace không chỉ định thư mục catalog nào, các FeatureRecipes được tìm kiếm chỉ là những cái mà lockfile ghim: những cái của registry không được liệt kê, và một Manifest không ánh xạ cái nào cho kiểu đó thì không ghim cái nào. Khi đó, các khẳng định về sự vắng mặt được đưa ra đối với các mục đã ghim chứ không phải đối với catalog, và các thông báo nói rõ điều đó. Khi không có cái nào triển khai kiểu đó: feature "<instance>" (type "<type>"); no feature recipe the lockfile pins implements <type>:<version> for capability "<capability>", the capability its component's Recipe binds to; with no catalog directory, the feature recipes searched are only those the lockfile pins, not a registry's; pin one a registry publishes in the Manifest, where one for another capability renders as its own output beside the component's, or write one for "<capability>", then map the type to it — và khi không biết khả năng, thông báo không nêu khả năng nào và kết thúc bằng pin one a registry publishes in the Manifest, or write one, then map the type to it. Khi các FeatureRecipes đã ghim chỉ triển khai nó cho các khả năng khác, thông báo cho trường hợp đó có dạng no feature recipe the lockfile pins implements thay cho no feature recipe in the catalog implements, với cùng mệnh đề sau khả năng.

Cách sửa: thêm ánh xạ mà thông báo yêu cầu, dưới spec.mappings.components.type trong Manifest, với khóa là kiểu component và giá trị là Recipe. Khi thông báo liệt kê các ứng viên, hãy chọn một trong số đó — danh sách đó chính xác là các Recipes khai báo rằng chúng hiện thực kiểu ở phiên bản mà bản build phân giải nó. Khi thông báo chỉ định một Recipe không có trong catalog, hãy sửa giá trị hoặc thêm Recipe vào một thư mục catalog mà bản build đọc; phiên bản trong giá trị phải khớp với một phiên bản mà catalog chứa. Khi không có gì hiện thực kiểu đó, phần còn thiếu chính là Recipe. Khi thông báo nói rằng các công thức hoặc công thức tính năng được tìm kiếm chỉ là những cái lockfile ghim, workspace không đọc thư mục catalog nào, nên một registry vẫn có thể phát hành một Recipe hoặc FeatureRecipe hiện thực kiểu đó: chính việc ánh xạ kiểu tới nó trong Manifest là điều khiến bước pull tải về và ghim nó.

A Manifest name mapping names nothing in the build (Một ánh xạ name của Manifest không nêu tên thứ gì trong bản build)

Một khóa dưới spec.mappings.components.name hoặc spec.mappings.features.name không nêu tên instance component hay attachment nào mà bản build có. Tầng name được so khớp theo tên chính xác của thứ đang được hiện thực: một khóa components.name so với tên của một instance component như Aggregate viết nó, và một khóa features.name so với tên riêng của attachment — khóa mà nó được viết dưới đó trong features: của một component, hoặc <alias>.<slot> đối với attachment được viết trên một kết nối — không bao giờ so với tên của component mà attachment nằm trên. Một khóa không nêu tên thứ gì sẽ không bao giờ được tra cứu: mọi instance mà nó nhắm tới sẽ được phân giải qua tầng type, và bản build sẽ hoàn tất mà không nói một lời nào về mục bị bỏ qua. Vì vậy bản build dừng lại trước khi render bất cứ thứ gì.

Thông báo nêu tên Manifest, khóa và phần mà nó được viết trong đó, các tên thuộc loại đó mà bản build thực sự có — thu hẹp về kiểu mà Recipe hoặc FeatureRecipe của mục đó hiện thực, khi kiểu đó đã biết và bản build có một thứ thuộc kiểu đó — và, khi có thể xác định, tên mà bạn có lẽ muốn viết: với một khóa features.name là tên của một component, đó là các attachment thuộc kiểu đó mà component mang; với một khóa components.name là tên của một attachment, đó là component mang nó; còn lại là một tên cách một lần chỉnh sửa.

Thông báo được phát ra, cho một khóa features.name được viết thành tên của component mà attachment nằm trên:

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<component>" under mappings.features.name: no attachment in this build is named "<component>"; a features.name key names an attachment by its own name — the key it is written under in a component’s features, or <alias>.<slot> for one written on a connection — never the component it is attached to; attachments of type "<feature-type>" in this build: "<attachments>"; "<component>" is a component, and a features.name key names the attachment rather than the component it is attached to — did you mean "<attachment>"? (khóa của một ánh xạ name trong Manifest không nêu tên instance component hay attachment nào trong bản build này, nên mục đó không ràng buộc gì: khóa dưới mappings.features.name của Manifest: không có attachment nào trong bản build này mang tên đó; một khóa features.name nêu một attachment bằng tên riêng của nó — khóa mà nó được viết dưới đó trong features của một component, hoặc alias kèm slot đối với attachment được viết trên một kết nối — không bao giờ nêu component mà nó được gắn vào; các attachment thuộc kiểu đã nêu trong bản build này được liệt kê; tên đã nêu là một component, và một khóa features.name nêu attachment chứ không phải component mà nó được gắn vào — có phải bạn muốn nói attachment đã nêu?)

Và cho một khóa components.name cách tên của một instance một lần chỉnh sửa:

a Manifest name mapping’s key names no component instance or attachment in this build, so the entry binds nothing: Manifest "<manifest>", key "<key>" under mappings.components.name: no component instance in this build is named "<key>"; a components.name key names a component instance exactly as the Aggregate writes it; component instances of type "<component-type>" in this build: "<instances>"; did you mean "<instance>"? (khóa của một ánh xạ name trong Manifest không nêu tên instance component hay attachment nào trong bản build này, nên mục đó không ràng buộc gì: khóa dưới mappings.components.name của Manifest: không có instance component nào trong bản build này mang tên đó; một khóa components.name nêu một instance component đúng như Aggregate viết nó; các instance component thuộc kiểu đã nêu trong bản build này được liệt kê; có phải bạn muốn nói instance đã nêu?)

Mọi khóa không nêu tên thứ gì đều được báo cáo trong một bản build, theo thứ tự mà Manifest viết chúng.

Cách khắc phục: đổi tên khóa thành tên mà thông báo gợi ý, hoặc thành một trong các tên nó liệt kê — với một attachment, đó là tên mà attachment được viết dưới đó, không phải tên component của nó. Khi mục đó không còn cần nữa, hãy xóa nó; các instance thuộc kiểu đó khi ấy sẽ được phân giải qua tầng type.

A Manifest maps two version-distinct keys onto one type (Một Manifest ánh xạ hai khóa khác phiên bản lên một kiểu)

Một lần tra cứu kiểu khớp với nhiều hơn một khóa ánh xạ Manifest. Các khóa kiểu được so khớp có dung sai về phiên bản, nên core/api-server, core/api-server:1.0.0 và core/api-server:2.0.0 được viết thành các khóa ánh xạ riêng biệt đều ứng với cùng một kiểu cơ sở — và một lần tra cứu chạm tới hai trong số đó có hai Recipes để chọn mà không có quy tắc nào để ưu tiên một cái.

Bản build dừng lại thay vì phân giải theo khóa nào nó tình cờ đọc trước. Chọn một khóa sẽ khiến đầu ra được render phụ thuộc vào thứ tự duyệt ánh xạ, đó chính là điều mà đầu ra giống hệt từng byte loại trừ.

Thông báo được phát ra:

manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous: type "<type>" matches version-distinct keys [<keys>] — pin the authored type’s version or remove the duplicate mapping keys (manifest ánh xạ nhiều khóa khác phiên bản tới cùng một kiểu cơ sở; việc tra cứu từ kiểu sang recipe là mơ hồ — hãy ghim phiên bản của kiểu đã viết hoặc xóa các khóa ánh xạ trùng lặp)

Cách sửa: có hai hướng, và thông báo nêu cả hai. Xóa các khóa ánh xạ trùng lặp, giữ lại khóa nên ứng với kiểu đó — cách này đúng khi các khóa thừa là phần sót lại từ một lần nâng phiên bản. Hoặc ghim phiên bản ở phía soạn thảo, để kiểu mà component khai báo chỉ định đúng khóa bạn muốn, cách này đúng khi nhiều khóa là có chủ ý và các component khác nhau thực sự muốn các Recipes khác nhau.

Two catalog entities in one directory share an identity (Hai thực thể catalog trong cùng một thư mục có chung một định danh)

Hai thực thể cùng loại, được nạp từ cùng một thư mục catalog, mang cùng một định danh. Định danh là thứ mà một tham chiếu gọi tên, nên hai tệp cùng nhận một định danh khiến mọi tham chiếu tới nó có hai câu trả lời.

Trong một thư mục thì điều này gây dừng; giữa các thư mục thì không. Cùng một định danh có mặt trong hai thư mục catalog khác nhau được giải quyết theo kiểu che khuất ai-đến-trước-thắng — thư mục được liệt kê trước sẽ thắng — đó là điều cho phép một thư mục cục bộ ghi đè có chủ ý một thực thể đã xuất bản. Chỉ một va chạm bên trong một thư mục mới là lỗi soạn thảo mà không có cách hiểu nào khiến nó trở thành có chủ ý.

Quy định này giống nhau cho mọi loại được lập chỉ mục: Component, Feature, Recipe, FeatureRecipe, Plugin, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary và Aggregate. Điểm dừng được định vị tại tệp thứ hai, và nêu tên loại cùng định danh bị va chạm.

Thông báo được phát ra:

duplicate entity identity within a single catalog directory (Component identity "<identity>") (định danh thực thể bị trùng trong một thư mục catalog duy nhất (định danh Component))

với từ riêng của loại đó thay cho Component — recipe identity, feature recipe identity, Plugin identity, SchemaLibrary identity, v.v.

Cách khắc phục: đổi tên một trong hai thực thể, hoặc chuyển nó vào một thư mục riêng. Với một Recipe hoặc FeatureRecipe, định danh bao gồm phạm vi provider và phiên bản, nên hai tệp chỉ khác nhau về phiên bản sẽ không va chạm — một va chạm thật sự ở đó nghĩa là cùng một phiên bản đã được xuất bản hai lần. Nguyên nhân thường gặp là sao chép một tệp thực thể để bắt đầu một tệp mới và quên đổi metadata.name.

Có hai nơi được đọc như một tổng thể thay vì từng tệp một: một thư mục catalog, nơi mà mọi tài liệu bên dưới đều có thể là câu trả lời cho một lần tra cứu theo tên, và thư mục chứa một Release, nơi mà các Aggregates và Manifests của nó được dùng để phân giải một Release gọi tên chúng theo định danh. Một liên kết tượng trưng giữa các tệp đó có thể dẫn tới bất kỳ đâu trên máy, nên mỗi thư mục như vậy có một thư mục mà các lần đọc của nó phải nằm trong, và một liên kết dẫn ra ngoài sẽ không được đọc. Ranh giới workspace nêu quy định mà điều này áp dụng, cùng các đường dẫn khác mà nó chi phối.

Đó là thư mục nào phụ thuộc vào vị trí của thư mục đang được đọc:

  • Workspace, cho một thư mục catalog hoặc thư mục của một Release nằm bên trong nó. Điều này áp dụng cho thư mục catalog theo quy ước của workspace mỗi khi không ai gọi tên nó — khi nó được đọc chỉ vì nó có ở đó: khi đó nó thuộc về chính workspace, nên một catalog mà bản thân là một liên kết dẫn ra ngoài workspace sẽ không được đọc.
  • Một thư mục bạn gọi tên nằm ngoài workspace, cho những gì nằm bên dưới nó: một thư mục catalog bạn truyền bằng --catalog, hoặc cấu hình workspace liệt kê dưới catalog_dirs — cho workspace hoặc cho một Release — và thư mục của một Release bạn gọi tên, hoặc do cấu hình gọi tên, nằm ngoài workspace. Bản thân thư mục được dùng như bạn đã gọi tên — một thư mục là liên kết sẽ được đọc tại nơi nó trỏ tới — và những gì được đọc bên dưới nó phải nằm trong nó. Điều đó bao gồm cả thư mục catalog theo quy ước một khi bạn gọi tên nó: khi được liệt kê dưới catalog_dirs, hoặc truyền bằng --catalog, một catalog là liên kết dẫn ra ngoài workspace sẽ được đọc tại nơi nó trỏ tới, như mọi thư mục khác bạn gọi tên. Việc gọi tên nơi nó trỏ tới thay vào đó, dưới bất kỳ cách viết nào, hoặc một thư mục phía trên nơi đó, cũng là gọi tên nó: thư mục bạn đã gọi tên đã đọc những gì nằm ở đó, nên nó chỉ được đọc một lần, thông qua thư mục đó. Gọi tên một thư mục trong cấu hình là cách một workspace đọc các thực thể được lưu bên ngoài nó.

Những gì được xét là mọi mục mà lần đọc sẽ lấy thứ gì đó từ đó: một liên kết tới một tệp được đặt tên như một tài liệu YAML, và một liên kết tới một thư mục, vốn có thể chứa các tài liệu riêng. Một liên kết dẫn tới đâu đó bên trong thư mục mà lần đọc phải nằm trong sẽ được đọc tại nơi quá trình duyệt gặp nó. Một liên kết tới một tệp mà không lần đọc catalog nào lấy gì từ đó — một tệp ghi chú, một tệp lưu trữ chart — không được xét ở đây, và một liên kết không dẫn tới đâu thì không có gì phía sau để đọc.

Một lần tra cứu mà quá trình biên dịch phụ thuộc vào sẽ dừng ở liên kết như vậy thay vì bỏ qua nó. Thực thể phía sau liên kết có thể chính là thực thể mà một tham chiếu gọi tên, và việc lặng lẽ bỏ qua nó sẽ để một thực thể khác cùng tên, từ một thư mục catalog sau đó, được phân giải thay thế. Vì vậy aggrega build, aggrega pull, aggrega validate, aggrega inspect ở bất cứ đâu nó đọc catalog, một lần lint một Release, và các yêu cầu của trình soạn thảo và của trợ lý để build, xem trước, vẽ đồ thị, xác thực hoặc mô tả một Release đều dừng trước khi bất cứ thứ gì được phân giải, nêu tên liên kết. Một lần lint toàn bộ catalog cũng dừng theo cách đó: kết luận của nó chịu trách nhiệm cho mọi tài liệu mà các thư mục catalog chứa, nên nó không báo cáo một catalog sạch khi một trong số chúng không thể đọc được. Thư mục của Release cũng chịu cùng quy định ở bất cứ đâu một Release gọi tên Aggregate hoặc Manifest của nó theo định danh, hoặc một Manifest gọi tên Manifest mà nó mở rộng theo cách đó, và quá trình quét dừng ở một liên kết giữa các tài liệu bên cạnh Release ngay cả khi liên kết đó không phải là thứ một tham chiếu gọi tên, vì cùng lý do một bản trùng lặp ở đó làm nó dừng: thư mục không thể trả lời cho một tên khi một trong các tài liệu của nó không thể đọc được. Release mà thao tác được gọi tên — hoặc một Manifest bạn kiểm tra riêng — không phải là một trong các tài liệu đó: nó được đọc tại nơi nó được gọi tên, nên một Release mà bản thân là liên kết dẫn ra ngoài sẽ được đọc tại nơi nó trỏ tới, và những gì nó gọi tên được tìm bên cạnh liên kết, trong thư mục mà bạn đã gọi tên nó (Một Release hoặc một Manifest được gọi tên qua một liên kết).

Ngược lại, một danh sách sẽ bỏ qua liên kết như vậy và không liệt kê gì phía sau nó. Chỉ mục thực thể của trình soạn thảo, các gợi ý hoàn thành và các ứng viên mà nó đưa ra không liệt kê một thực thể mà một liên kết dẫn ra ngoài đại diện, và chỉ mục thực thể nêu tên liên kết như vậy bên trong workspace trong số các liên kết mà nó không đọc.

Các tệp cấu hình của workspace cũng bị giới hạn trong workspace theo cùng cách. Mọi .aggrega-config.yaml từ gốc workspace xuống tới thư mục mà một lệnh chạy trong đó, và .aggrega-config-append-ci.yaml mà một pipeline giữ bên cạnh bất kỳ tệp nào trong số đó, đều là nội dung của chính workspace. Một tệp là liên kết dẫn ra ngoài workspace — hoặc được tiếp cận qua một liên kết thư mục dẫn ra ngoài — sẽ không được đọc, và vì mọi lệnh, language server của trình soạn thảo và các công cụ của trợ lý đều đọc cấu hình trước mọi thứ khác, mỗi thứ đều dừng ở đó, nêu tên liên kết, thay vì chạy trên một cấu hình tạo từ những gì còn lại. Language server, và server của trợ lý giao tiếp qua các luồng riêng của nó, vẫn khởi động trên một workspace như vậy: các danh sách Releases và thực thể của nó vẫn trả lời, được đọc mà không có gì được cấu hình, và nêu tên tệp trong số các liên kết chúng không đọc, trong khi mọi yêu cầu khác do cấu hình quyết định đều bị từ chối với điều kiện này, nêu tên liên kết. Biện pháp mà thông báo này nêu là của riêng cấu hình: tệp cấu hình toàn cục là cấu hình duy nhất được đọc từ bất cứ nơi nào nó được lưu, được gọi tên bằng --config hoặc AGGREGA_CONFIG.

Lockfile của một Release cũng bị giới hạn theo cùng cách, khi nó được đọc cũng như khi nó được ghi. Lockfile bên cạnh một Release được đọc để lấy các pin mà một lần build, pull, xác thực, lint, kiểm tra, aggrega cache prune và các yêu cầu của trình soạn thảo và của trợ lý phân giải theo, và nó bị giới hạn trong thư mục mà việc ghi nó bị giới hạn: workspace, hoặc thư mục riêng của Release đối với một Release được gọi tên bên ngoài nó. Một lockfile là liên kết dẫn ra ngoài sẽ không được đọc, và mỗi thao tác đó dừng lại, nêu tên liên kết, thay vì phân giải theo các pin lưu ở nơi khác trên máy, hoặc khi không có chúng. Biện pháp mà thông báo này nêu là của riêng lockfile: nó có một vị trí duy nhất, bên cạnh Release, nơi một lần pull ghi nó.

Một tệp được đọc bên cạnh một thực thể cũng chịu cùng ràng buộc. Có hai thao tác đọc một tệp nằm bên cạnh tài liệu của chính thực thể thay vì một tệp mà tham chiếu chỉ định. Việc ghim (pin) một thực thể, hoặc xuất bản một thực thể, đọc mọi tài liệu YAML khác trong thư mục của thực thể để biết liệu có thực thể nào khác dùng chung thư mục đó hay không. Việc nạp một Plugin entity được soạn trong một thư mục catalog sẽ đọc tệp .wasm đã build đặt bên cạnh nó. Mỗi tệp như vậy bị giới hạn trong thư mục mà tài liệu của chính thực thể được đọc từ đó — workspace, một thư mục catalog bạn chỉ định bên ngoài workspace, hoặc, với một thực thể bạn ghim hay xuất bản bằng cách chỉ định tài liệu của nó bên ngoài workspace, chính thư mục của tài liệu đó — và tệp nào là một liên kết dẫn ra ngoài thư mục đó sẽ không được đọc. aggrega pin, aggrega push có hoặc không có --dry-run, một lần pull có ghim, cùng các yêu cầu ghim và xuất bản của trình soạn thảo và của trợ lý đều dừng lại và nêu tên liên kết, vì một tài liệu bị bỏ qua không đọc có thể chính là thực thể gây xung đột. Một lần build hoặc pull nạp plugin cũng dừng lại và nêu tên liên kết, thay vì chạy các byte được lưu ở nơi khác trên máy hoặc đi tìm plugin ở một chỗ khác. Biện pháp khắc phục mà thông báo này nêu là biện pháp dành riêng cho tệp bên cạnh một thực thể: hãy đặt chính tệp đó tại đấy.

Bộ nhớ đệm artifact của workspace cũng chịu cùng ràng buộc, khi đọc cũng như khi ghi. Mọi thứ được đọc từ bộ nhớ đệm dưới artifact_cache_dir — một thực thể, plugin hoặc thư viện được lưu đệm cùng manifest bên cạnh nó, một kho lưu trữ mã nguồn và siêu dữ liệu của nó, một đầu vào bên ngoài đã ghim, một gói chữ ký, chỉ mục tìm kiếm cục bộ của một registry — và mọi mục workspace mà aggrega cache status, aggrega cache prune và aggrega cache clear liệt kê, đều bị giới hạn trong thư mục mà việc ghi vào bộ nhớ đệm bị giới hạn: chính thư mục bộ nhớ đệm, thư mục mặc định .aggrega/cache cũng như một thư mục do cấu hình chỉ định vượt ra ngoài thư mục gốc của workspace. Bất kỳ thứ gì trong đó là một liên kết dẫn ra ngoài thư mục bộ nhớ đệm — tới nơi khác bên trong workspace cũng như tới bất kỳ nơi nào khác — sẽ không được đọc, và mọi thứ phía sau một thư mục bộ nhớ đệm được ghi bên trong thư mục gốc của workspace mà bản thân nó là một liên kết dẫn ra ngoài workspace cũng vậy: một lần build, pull, validation, tìm kiếm, ba lệnh bộ nhớ đệm, và các yêu cầu của trình soạn thảo và của trợ lý có đọc bộ nhớ đệm đều dừng lại và nêu tên liên kết — kể cả nội dung mà bộ nhớ đệm lưu dưới một digest đã ghi, vì digest cho biết các byte là gì, chứ không cho biết chúng được phép đọc từ đâu. Một thư mục bộ nhớ đệm được ghi bên trong thư mục gốc của workspace mà là liên kết tới nơi khác bên trong workspace thì được đọc tại nơi nó dẫn tới. Thông báo ngừng hỗ trợ mà aggrega inspect in ra, vốn không quyết định điều gì, thì được bỏ qua. Một lần prune hoặc clear gặp một trong các thư mục của chính bộ nhớ đệm là liên kết dẫn ra ngoài thư mục bộ nhớ đệm, hoặc một thư mục bộ nhớ đệm mà bản thân nó là liên kết dẫn ra ngoài workspace, sẽ xử lý nó như thao tác xóa mà nó sẽ thực hiện, theo “A path the operation writes leads through a link out of the directory it must stay inside (Một đường dẫn mà thao tác ghi dẫn qua một liên kết ra ngoài thư mục mà nó phải nằm trong)”, trước khi liệt kê bất cứ thứ gì. Biện pháp khắc phục mà thông báo này nêu là biện pháp dành riêng cho bộ nhớ đệm: khi liên kết đã được gỡ bỏ, một lần pull sẽ làm đầy lại bộ nhớ đệm, và một bộ nhớ đệm đặt ở nơi khác được chỉ định bằng artifact_cache_dir, tương đối với thư mục gốc của workspace, thay vì được truy cập qua một liên kết.

Một repository mà một source tải về bị giới hạn trong bản checkout của chính nó. Khi một lần pull — aggrega pull, hoặc một lần build hay một yêu cầu của trình soạn thảo hoặc của trợ lý có phân giải các phụ thuộc của một Release — tải về một source git-repository, nó checkout repository và đóng gói thư mục mà source chỉ định, và bản checkout là một thư mục riêng: mọi liên kết mà repository chứa, kể cả chính module_subdir, đều bị giới hạn trong đó. Một liên kết tới một tệp hoặc thư mục bên trong repository được đóng gói thành thứ mà nó trỏ tới, dưới tên của liên kết. Một liên kết dẫn ra ngoài repository — có thể trỏ tới bất kỳ tệp nào trên máy đang chạy pull — sẽ không được đọc: lần pull dừng lại, nêu tên liên kết và nơi nó dẫn tới, và không có gì được lưu đệm. Bản checkout là một thư mục tạm bị xóa ngay khi lần pull dừng, nên thông báo nêu tên liên kết theo vị trí của nó trong repository — chart/secret.txt, ở dòng đầu tiên của dòng lệnh và trong câu — và nêu thư mục mà nó phải nằm trong là repository cùng revision mà source chỉ định: which must stay inside the repository <url> at <ref> (commit <commit>), hoặc at commit <commit> khi source không chỉ định ref hoặc chỉ định chính commit đó. Nơi liên kết dẫn tới được nêu là vị trí thực của nó trên máy bạn. Biện pháp khắc phục mà thông báo này nêu là biện pháp dành riêng cho repository: liên kết được commit ở đó, nên phải sửa ở đó — làm cho nó trỏ vào bên trong repository, hoặc thay bằng chính tệp đó — rồi để source chỉ định một revision có chứa thay đổi này. Một liên kết thư mục dẫn ngược trở lại một thư mục mà quá trình đóng gói đang đọc thông qua nó cũng làm lần pull dừng lại, vì cây thư mục mà nó đại diện không có điểm kết thúc; sự từ chối đó là một lỗi thông thường chứ không phải điều kiện này.

Các overlay mà một lần tạo catalog đọc cũng chịu cùng ràng buộc. aggrega plugin gen-catalog --from-embedded đọc mọi overlay bên dưới thư mục overlay được cung cấp cho nó — được gõ bằng --overlay, được chọn trong trình soạn thảo, hoặc được trợ lý chỉ định — và giới hạn mỗi overlay trong thư mục mà thư mục overlay đó được đọc từ đó: workspace, đối với một thư mục overlay bên trong nó, và chính thư mục overlay đối với một thư mục được chỉ định bên ngoài workspace. Thư mục overlay được dùng đúng như bạn chỉ định — một thư mục là liên kết thì được đọc tại nơi nó trỏ tới. Một overlay bên dưới nó là liên kết dẫn ra ngoài thư mục mà nó bị giới hạn sẽ không được đọc, và một liên kết thư mục dẫn ra ngoài thư mục đó, vốn có thể chứa các overlay riêng, cũng vậy: lần tạo dừng lại và nêu tên liên kết, không ghi gì cả, thay vì tạo ra kết quả mà thiếu overlay. Một overlay là liên kết dẫn tới nơi khác bên trong thư mục mà nó bị giới hạn thì được đọc tại nơi nó trỏ tới; một liên kết thư mục dẫn vào bên trong thư mục đó thì không được đi vào. Biện pháp khắc phục mà thông báo này nêu là biện pháp dành riêng cho overlay: hãy đặt chính overlay bên dưới thư mục overlay, hoặc chỉ định một thư mục chứa mọi overlay làm thư mục overlay.

Một thư mục bạn import bị giới hạn trong chính nó. aggrega import khi được cung cấp một thư mục, công cụ import của trợ lý và phương thức aggrega/import của phiên làm việc đều chuyển cho importer các tệp trong thư mục mà các mẫu tệp của nó chọn, mỗi tệp theo vị trí của nó trong thư mục, nên thư mục đó là nơi mà các lần đọc này phải nằm trong, dù nó ở đâu — bên trong workspace cũng như bên ngoài. Thứ được xét là mọi mục mà lần import sẽ lấy dữ liệu từ đó: một liên kết tới một tệp mà một trong các mẫu liên quan chọn — các mẫu của importer phục vụ định dạng được chỉ định, hoặc, khi định dạng được nhận diện, các mẫu của mọi importer mà lần import lựa chọn trong số đó, kể cả các core importers của trình biên dịch — và một liên kết tới một thư mục, vốn không bao giờ được đi vào. Liên kết nào dẫn ra ngoài thư mục, tới nơi khác trong workspace hay bất kỳ nơi nào khác, sẽ không được đọc: lần import dừng lại và nêu tên liên kết trước khi bất kỳ tệp nào của thư mục được mở, không ghi gì cả. Một liên kết được chọn tới một tệp ở nơi khác bên trong thư mục được đọc tại nơi nó trỏ tới, dưới tên của chính liên kết, và một liên kết tới một tệp không mẫu nào chọn thì không được xét cũng không được đọc. Bản thân thư mục được dùng đúng như bạn chỉ định — một thư mục là liên kết thì được đọc tại nơi nó trỏ tới. Khi được truy cập qua một listener, công cụ của trợ lý nêu tên liên kết theo vị trí của nó trong workspace và không nói gì về nơi nó dẫn tới. Biện pháp khắc phục mà thông báo này nêu là biện pháp dành riêng cho thư mục được import: hãy đặt chính tệp trong thư mục thay vì một liên kết tới nó, hoặc import thư mục mà liên kết dẫn tới.

Thông báo được phát ra. Câu riêng của điều kiện này mở đầu thông báo, tiếp theo là đường dẫn mà lần đọc đã tới, thư mục mà nó phải nằm trong, liên kết mà nó gặp trên đường đi và nơi liên kết đó dẫn tới, sau đó là biện pháp khắc phục:

a file this operation reads leads through a link out of the directory it must stay inside (reading <workspace>/catalog-local/component/app/1.0.0/component.yaml, which must stay inside <workspace>, the link <workspace>/catalog-local/component/app/1.0.0/component.yaml leads to <elsewhere>/component.yaml). nothing was read through that link. Remove the link, or make it lead to a place inside <workspace>. To read what is kept outside, list the directory holding it as a catalog directory in the workspace configuration, rather than reaching it through a link beneath one: a listed directory is read where it leads, even when it is itself a link (một tệp mà thao tác này đọc dẫn qua một liên kết ra ngoài thư mục mà nó phải nằm bên trong (đường dẫn đang đọc, thư mục nó phải nằm bên trong, liên kết và nơi liên kết dẫn tới được nêu ở trên). không có gì được đọc qua liên kết đó. Hãy xóa liên kết, hoặc làm cho nó dẫn tới một nơi bên trong thư mục workspace. Để đọc những gì được giữ bên ngoài, hãy liệt kê thư mục chứa nó như một thư mục catalog trong cấu hình workspace, thay vì truy cập nó qua một liên kết bên dưới một thư mục catalog: một thư mục được liệt kê sẽ được đọc tại nơi nó dẫn tới, ngay cả khi bản thân nó là một liên kết)

Chẩn đoán này không mang danh mục nào: thứ có lỗi là cách bố trí trên đĩa chứ không phải bất kỳ tài liệu nào bạn đã viết.

Cách khắc phục: thay liên kết bằng một bản sao của thứ nó dẫn tới, hoặc gỡ bỏ nó; hoặc, khi thực thể được dự định nằm bên ngoài workspace, hãy liệt kê thư mục chứa nó dưới catalog_dirs trong cấu hình workspace, hoặc truyền nó bằng --catalog, để thư mục đó được đọc như một thư mục catalog riêng. Hãy liệt kê thư mục mà liên kết dẫn tới, không phải thư mục chứa liên kết: một liên kết gặp phải bên dưới một thư mục được đánh giá như nhau bất kể thư mục đó được đọc theo cách nào, nên việc liệt kê nó không thay đổi gì. Khi liên kết chính là thư mục catalog theo quy ước của workspace, việc liệt kê catalog — hoặc thư mục mà nó trỏ tới — dưới catalog_dirs, hoặc truyền một trong hai bằng --catalog, là đủ, vì một thư mục bạn nêu tên sẽ được đọc tại nơi nó trỏ tới. Khi liên kết là lockfile của một Release, hãy gỡ bỏ nó và pull lại Release, thao tác này sẽ ghi một lockfile mới bên cạnh nó. Một Manifest không có tầng catalog, nên một Manifest mà Release đọc được giữ bên cạnh chính Release đó. Khi liên kết là một tệp cấu hình, hãy thay nó bằng một bản sao được giữ trong workspace; một cấu hình bạn muốn dùng chung giữa các workspace được đọc bằng cách chỉ định nó làm tệp cấu hình toàn cục, với --config hoặc AGGREGA_CONFIG, bên dưới các tệp riêng của từng workspace. Khi liên kết nằm bên cạnh một thực thể đang được pin hoặc publish, hãy thay nó bằng chính tệp đó, hoặc di chuyển một tài liệu là thực thể vào một thư mục riêng; khi nó là tệp .wasm bên cạnh một thực thể Plugin, hãy đặt chính tệp .wasm đã build vào đó. Khi liên kết là thư mục bộ nhớ đệm artifact hoặc một thứ bên trong nó, hãy gỡ bỏ nó — một lần pull sẽ điền lại bộ nhớ đệm — hoặc, để giữ bộ nhớ đệm ở nơi khác, đặt artifact_cache_dir thành thư mục đó, viết tương đối so với thư mục gốc của workspace (../shared-cache). Khi liên kết được commit trong một kho mà một nguồn git-repository tải về, hãy thay đổi nó trong kho đó — trỏ nó vào bên trong kho, hoặc commit chính tệp đó — và chỉ định revision chứa thay đổi. Khi liên kết là một overlay bên dưới thư mục overlay của một lần tạo catalog, hãy thay nó bằng chính overlay đó, hoặc chỉ định một thư mục chứa mọi overlay làm thư mục overlay. Khi liên kết nằm trong một thư mục bạn import, hãy giữ chính tệp đó trong thư mục thay vì một liên kết tới nó, hoặc import thư mục mà liên kết dẫn tới.

A reference to another file leads out of the directory it must stay inside (Một tham chiếu tới tệp khác dẫn ra ngoài thư mục mà nó phải nằm bên trong)

Một Release và một Manifest có thể gọi tên một tệp khác bằng đường dẫn: aggregate: và manifest: của một Release được viết dạng ./… hoặc ../…, extends: của nó, extends: của một Manifest được viết dạng đường dẫn, và parameters: { $import: … } của một Release. Theo cách đó, một tài liệu trong workspace chỉ tới được các tệp bên trong workspace. Một Release nằm ngoài workspace — một Release bạn chỉ định trên dòng lệnh, hoặc một Release mà cấu hình workspace chỉ định — và một Manifest bạn chỉ định riêng trên dòng lệnh bên ngoài workspace chỉ tới được các tệp bên trong thư mục của chính chúng: thư mục đó là một gốc riêng, giống như một thư mục bạn chỉ định bên ngoài workspace, và mọi Release mà chuỗi extends: của nó dẫn tới đều bị giới hạn trong cùng thư mục đó. Một đường dẫn trèo ra khỏi thư mục đó theo cách được viết, và một đường dẫn nằm bên trong theo cách được viết nhưng gặp một liên kết tượng trưng dẫn ra ngoài trên đường đi, đều bị từ chối, và không có gì được đọc từ tệp mà chúng chỉ tới. Một đường dẫn dẫn tới một tệp chưa tồn tại bên dưới thư mục thì không bị từ chối ở đây; nó được báo cáo là một tệp không thể đọc được. Ranh giới workspace giải thích vì sao một tham chiếu cũng bị giới hạn giống như đường dẫn bạn chỉ định.

Nơi một đường dẫn được phân giải từ đó tuân theo cùng quy tắc mà tài liệu tham khảo ngôn ngữ mô tả cho từng khóa: aggregate: và manifest: của một Release, cùng extends: của một Manifest, được phân giải bên cạnh Release mà một lệnh hoặc một yêu cầu chỉ định — hoặc, với một Manifest bạn chỉ định riêng, bên cạnh chính Manifest đó; extends: của một Release và một $import: của parameters được phân giải bên cạnh Release viết ra nó, nên mỗi mắt xích của một chuỗi extends: chỉ định cha của nó bên cạnh chính nó. Chẩn đoán nêu tên thư mục mà đường dẫn được phân giải từ đó.

Một tên thay vì một đường dẫn không bị xét ở đây — aggregate: payments, extends: base-manifest. Nó được tra cứu trong các tài liệu bên cạnh Release và, với một Aggregate, trong các thư mục catalog, vốn bị giới hạn bởi quy tắc trong “A file the operation reads leads through a link out of the directory it must stay inside” ở trên.

Mọi bề mặt phân giải những gì một Release chỉ định đều dừng lại ở điều kiện này, trước khi tệp được đọc: aggrega pull, aggrega build, aggrega validate, aggrega inspect của một Release hoặc của một Manifest, việc lint một Release, và các yêu cầu của trình soạn thảo và của trợ lý để build, xem trước, vẽ đồ thị, xác thực hoặc mô tả một Release. Trong trình soạn thảo, chẩn đoán được đặt trên khóa trong Release đã dẫn tới tệp.

Thông báo được phát ra. Câu riêng của điều kiện mở đầu nó, tiếp theo là tham chiếu như được viết, tài liệu chứa nó đối với một extends: và một $import: của parameters, thư mục mà nó được phân giải từ đó, nơi nó dẫn tới, thư mục mà nó phải nằm bên trong, và liên kết nếu có một liên kết đưa nó ra ngoài; rồi đến cách khắc phục. Với một tài liệu trong workspace:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../shared/app.yaml, resolved from <workspace>, which leads to <elsewhere>/shared/app.yaml, outside the workspace <workspace>). nothing was read from that file. A document in the workspace reaches only files inside <workspace>: move the file there — or, where a link carries the reference out, make the link lead there — or open the workspace at a directory holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (một tham chiếu mà tài liệu tạo tới một tệp khác dẫn ra ngoài thư mục mà nó phải nằm bên trong (.spec.aggregate: ../shared/app.yaml, được phân giải từ <workspace>, dẫn tới <elsewhere>/shared/app.yaml, nằm ngoài workspace <workspace>). không có gì được đọc từ tệp đó. Một tài liệu trong workspace chỉ truy cập được các tệp bên trong <workspace>: hãy di chuyển tệp vào đó — hoặc, nếu một liên kết đưa tham chiếu ra ngoài, hãy cho liên kết dẫn vào đó — hoặc mở workspace tại một thư mục chứa cả hai tài liệu. Một Aggregate được giữ bên ngoài thư mục đó được truy cập bằng tên thay vì đường dẫn, từ một thư mục catalog mà cấu hình workspace liệt kê)

và với một Release hoặc một Manifest được chỉ định bên ngoài workspace, mà thư mục riêng của nó là thư mục nó phải nằm bên trong:

a reference a document makes to another file leads out of the directory it must stay inside (.spec.aggregate: ../aggregates/app.yaml, resolved from <directory>, which leads to <parent>/aggregates/app.yaml, outside <directory>, the directory of a document named outside the workspace <workspace>). nothing was read from that file. A Release or a Manifest named outside the workspace — on the command line, or by the workspace configuration — reaches only files inside its own directory <directory>: move the file there — or, where a link carries the reference out, make the link lead there — or name the document from a workspace holding both documents. An Aggregate kept outside that directory is reached by its name rather than a path, from a catalog directory the workspace configuration lists (một tham chiếu mà tài liệu tạo tới một tệp khác dẫn ra ngoài thư mục mà nó phải nằm bên trong (.spec.aggregate: ../aggregates/app.yaml, được phân giải từ <directory>, dẫn tới <parent>/aggregates/app.yaml, nằm ngoài <directory>, thư mục của một tài liệu được chỉ định bên ngoài workspace <workspace>). không có gì được đọc từ tệp đó. Một Release hoặc một Manifest được chỉ định bên ngoài workspace — trên dòng lệnh, hoặc bởi cấu hình workspace — chỉ truy cập được các tệp bên trong thư mục riêng <directory> của nó: hãy di chuyển tệp vào đó — hoặc, nếu một liên kết đưa tham chiếu ra ngoài, hãy cho liên kết dẫn vào đó — hoặc chỉ định tài liệu từ một workspace chứa cả hai tài liệu. Một Aggregate được giữ bên ngoài thư mục đó được truy cập bằng tên thay vì đường dẫn, từ một thư mục catalog mà cấu hình workspace liệt kê)

với written in <document> sau tham chiếu đối với một extends: hoặc một $import: của parameters, và the link <link> leads to <place> ở cuối nếu một liên kết đưa đường dẫn ra ngoài. Một tham chiếu aggregate: hoặc manifest: không nêu tài liệu nào: một Release mở rộng Release khác có thể đã thừa kế nó từ một Release ở cao hơn trong chuỗi, và dù thế nào nó cũng được phân giải bên cạnh Release mà lệnh chỉ định.

Danh mục của chẩn đoán là [OPS_ERROR]: tham chiếu được viết trong một Release hoặc một Manifest.

Cách khắc phục: với một Aggregate nằm ngoài workspace, hãy viết metadata.name của nó thay vì một đường dẫn, và liệt kê thư mục chứa nó trong catalog_dirs ở cấu hình workspace, hoặc truyền nó bằng --catalog — thư mục catalog là cách một workspace tới được các thực thể nằm ngoài nó. Một Manifest, một Release mà extends chỉ định và một tệp parameters được đọc bên cạnh Release và không bao giờ được tra cứu theo tên, nên hãy giữ chúng bên trong workspace, hoặc mở workspace tại một thư mục chứa cả Release lẫn tệp đó. Với một Release hoặc một Manifest bạn chỉ định từ bên ngoài workspace, hãy giữ những gì nó chỉ định trong thư mục riêng của nó, hoặc build nó trong workspace chứa cả nó lẫn những gì nó chỉ định. Nếu một liên kết đưa đường dẫn ra ngoài, hãy thay liên kết bằng một bản sao của thứ nó dẫn tới, hoặc làm cho nó dẫn vào bên trong thư mục. Lưu ý: extends: áp dụng tương tự.

No catalog version satisfies a version constraint (Không có phiên bản catalog nào thỏa mãn ràng buộc phiên bản)

Một tham chiếu chỉ định một thực thể mà catalog có và ghim một phiên bản mà catalog không có: một phiên bản chính xác không tồn tại, hoặc một khoảng caret không khớp với phiên bản sẵn có nào. Điều này khác với một lần không tìm thấy đơn thuần, khi chính cái tên là không xác định — ở đây thực thể tồn tại và chỉ có phiên bản là không thể thỏa mãn, đó là lý do thông báo nói như vậy thay vì báo cáo thực thể bị thiếu và khiến bạn đi tìm lỗi gõ trong tên.

Mọi loại thực thể đều đi tới điều này qua cùng một cơ chế chọn, nên một ghim không thể thỏa mãn hành xử giống nhau ở bất cứ đâu nó được viết: một lỗi gõ phiên bản trong ánh xạ Recipe của một Manifest bị từ chối y hệt như cùng lỗi gõ đó trên một component type.

Điều kiện này có thể phục hồi, đó là điều cho phép trình soạn thảo hiển thị nó như một chẩn đoán trong khi bạn tiếp tục gõ thay vì bỏ dở tài liệu. Trên dòng lệnh, nó được gộp thành một lần dừng.

Thông báo được phát ra, cho một tham chiếu mà các phụ thuộc của một Release chạm tới — một kiểu component, một giá trị ánh xạ Manifest — nêu nơi nó được thu thập:

no catalog version satisfies the referenced version constraint: entity "<reference>" (referenced from <referring paths>) (không có phiên bản nào trong catalog thỏa mãn ràng buộc phiên bản được tham chiếu: thực thể đã nêu và các nơi tham chiếu tới nó)

Thông báo được phát ra, với một ghim trên con trỏ extends::

no catalog version satisfies the referenced version constraint (Component <name>, at .extends, no catalog version satisfies extends parent "<reference>") (không có phiên bản catalog nào thỏa mãn ràng buộc phiên bản được tham chiếu (Component <name>, tại .extends, không có phiên bản catalog nào thỏa mãn cha extends “<reference>”))

với Feature thay cho Component khi chuỗi của một Feature mang ghim đó.

Cách khắc phục: đổi ghim thành một phiên bản mà catalog có, hoặc thêm phiên bản đó vào catalog. aggrega inspect liệt kê các phiên bản sẵn có của một thực thể. Một khoảng caret không khớp với gì thường có nghĩa là các phiên bản sẵn có đều thấp hơn mức sàn mà nó nêu — hãy mở rộng khoảng, hoặc phát hành phiên bản mà tham chiếu đang chờ.

Một ghim không thuộc dạng nào mà một ghim có là một điều kiện khác, được mô tả trong “A version pin is none of the forms a pin takes” bên dưới.

A version pin is none of the forms a pin takes (Một ghim phiên bản không thuộc dạng nào mà một ghim có thể có)

Một tham chiếu nêu tên một thực thể khác và có thể ghim phiên bản nó muốn sau dấu hai chấm, theo một trong hai dạng: ghim chính xác, là một phiên bản ngữ nghĩa như 1.0.0 — dạng mà metadata.version của mọi thực thể có — hoặc ghim caret, ^ theo sau là một phiên bản như ^1.0.0, chọn phiên bản cao nhất tương thích với nó. Một ghim không thuộc dạng nào — một caret mà văn bản không đọc được như một dải phiên bản, như ^garbage, hoặc một ghim chính xác không phải phiên bản ngữ nghĩa, như 1.x, 1.0 hay v1.0.0 — không nêu phiên bản nào cả, nên không danh mục nào có thể chứa thứ nó yêu cầu.

Một ghim như vậy được báo là sai định dạng thay vì là một thực thể hay một phiên bản mà danh mục không chứa, nên chẩn đoán đưa bạn đến văn bản bạn đã gõ thay vì đi tìm thứ không tồn tại. Đây là cùng một điều kiện ở bất cứ đâu ghim được viết: type của một component hay feature, extends: của một Component hay Feature, khóa hoặc giá trị ánh xạ của một Manifest, spec.aggregate của một Release, implements: của một Recipe hay FeatureRecipe, phiên bản mà capability: của một Recipe ghim khi plugin phục vụ nó được chọn, và plugin: của một bước pipeline.

Nó được báo ở nơi một tham chiếu không phân giải được được báo, nên một ghim sai định dạng không bao giờ thay đổi việc tham chiếu nào được phân giải — nó thay đổi nội dung của lỗi. Một ghim đúng định dạng nhưng không phiên bản khả dụng nào thỏa mãn vẫn giữ điều kiện mà bề mặt đó báo cho nó: “No catalog version satisfies a version constraint” ở trên, hoặc điều kiện không tìm thấy của bề mặt nơi nó được viết.

Chỉ văn bản sau dấu hai chấm cuối cùng mới là ghim, và chỉ khi nó không chứa /. Vì vậy một tham chiếu đến registry host có cổng, như localhost:5000/core/api-server, không mang ghim — văn bản sau dấu hai chấm của cổng là phần tiếp của tham chiếu — và nó không bao giờ bị báo là ghim sai định dạng.

Thông báo được phát ra, cho một ghim caret trên một kiểu component:

reference carries a malformed version pin (reference "<reference>", pin "<pin>", the text after ^ is not a version range, referenced from <authored location>). write the reference as , as : with a semantic version such as 1.0.0, or as :^ for the highest version compatible with it (tham chiếu mang một ghim phiên bản sai định dạng (tham chiếu, ghim, phần văn bản sau ^ không phải là một khoảng phiên bản, được tham chiếu từ vị trí được viết). hãy viết tham chiếu dưới dạng tên, dạng tên:phiên bản với một phiên bản ngữ nghĩa như 1.0.0, hoặc dạng tên:^phiên bản để chọn phiên bản cao nhất tương thích với nó)

Một ghim chính xác ghi an exact pin must be a semantic version (một ghim chính xác phải là một phiên bản ngữ nghĩa) thay cho mệnh đề về dấu mũ. Giá trị theo sau cho biết tham chiếu được viết ở đâu, bằng lời của bề mặt báo cáo nó — referenced from (được tham chiếu từ) và vị trí được viết, in the Release's spec.aggregate (trong spec.aggregate của Release), hoặc in the recipe's spec.implements (trong spec.implements của recipe). Khi một ánh xạ Manifest được đánh giá dựa trên implements: của Recipe của nó, mục ánh xạ và phía nào của nó mang ghim — in the mapping key (trong khóa ánh xạ) hoặc in the recipe's spec.implements (trong spec.implements của recipe) — sẽ đứng trước tham chiếu thay vào đó, và extends: của một Component hoặc Feature nêu tên thực thể mở rộng và trường đứng trước nó.

Cách khắc phục: viết lại ghim theo một trong hai dạng, hoặc bỏ nó để chọn phiên bản cao nhất khả dụng. Một ký tự đại diện như 1.x được viết thành ghim caret, ^1.0.0; một phiên bản có v đứng đầu hoặc ít hơn ba số được viết đầy đủ, 1.0.0.

Every version a reference could select has been withdrawn (Mọi phiên bản mà một tham chiếu có thể chọn đều đã bị thu hồi)

Một tham chiếu phân giải đến một repository mà registry chứa, và mọi phiên bản mà quá trình khám phá có thể chọn từ đó đều đã bị đánh dấu thu hồi. Không còn gì đủ điều kiện để chọn.

Điều này cố ý không được báo là một thực thể bị thiếu. Repository tồn tại và vẫn chứa các phiên bản đó; gọi nó là vắng mặt sẽ nêu sai vấn đề, khiến bạn đi tìm lỗi chính tả, và trông như một sự dự phòng âm thầm thay vì sự từ chối như bản chất của nó. Thông báo nêu từng phiên bản bị thu hồi cùng lý do được ghi cho nó, nên điều bạn được cho biết chính là điều nhà phát hành đã ghi.

Nêu trực tiếp một phiên bản bị thu hồi không phải là lần dừng này. Một phiên bản chính xác bỏ qua hoàn toàn quá trình khám phá, nên ghim nó là cách bạn chủ ý tiếp tục dùng nó; bản build báo việc thu hồi và tiếp tục.

Thông báo được phát ra:

every published version this reference could select has been withdrawn: <reference>: withdrawn: <version> (<recorded reason>), <version> (<recorded reason>) (mọi phiên bản đã phát hành mà tham chiếu này có thể chọn đều đã bị thu hồi: <reference>: đã thu hồi: <version> (<recorded reason>), <version> (<recorded reason>))

Cách khắc phục: đọc các lý do được ghi, thường nêu thứ cần chuyển sang. Hãy chuyển sang thứ thay thế thực thể bị thu hồi — đó là kết quả mà một lần thu hồi yêu cầu. Khi bạn tạm thời phải giữ cái cũ, hãy ghim một phiên bản chính xác trong tham chiếu: nêu phiên bản là cách cho biết bạn chấp nhận nó, và khi đó bản build báo việc thu hồi mỗi lần thay vì từ chối.

A plugins.providers binding names a plugin that does not serve the capability (Một liên kết plugins.providers nêu một plugin không phục vụ capability đó)

Khối plugins.providers của workspace chọn một định danh plugin cho một capability, và không Plugin kết xuất provider nào phục vụ capability đó mang định danh này. Liên kết là một lựa chọn tường minh mà danh mục không thể đáp ứng, nên nó dừng thay vì âm thầm chuyển sang plugin khác — một sự dự phòng sẽ kết xuất đầu ra của bạn qua một plugin bạn đã nói không dùng, mà không báo gì.

Một liên kết chọn theo định danh tọa độ của plugin — kiểu plugin và tên plugin, cũng là thứ lockfile ghim — và nó có thể mang một phiên bản phía sau.

Nó được kiểm tra bất kể có Recipe nào yêu cầu capability hay không. Nếu không, một liên kết chỉ được đọc khi capability: của một Recipe nêu nó, nên một liên kết có capability viết sai chính tả sẽ không được gì tham khảo và không được gì báo cáo. Vì vậy mọi bản build và mọi aggrega validate --release đều kiểm tra từng liên kết nêu một plugin: một lần pull phân giải liên kết như vậy bất kể có Recipe nào dùng nó hay không, nên bản build giữ plugin và biết nó phục vụ gì, và một capability mà plugin đó không phục vụ chắc chắn là sai. Việc kiểm tra đọc các liên kết trong cấu hình workspace, không phải lockfile, và nó không thay đổi gì về plugin nào kết xuất một Recipe — điều đó vẫn thuộc về lockfile. Một liên kết nêu một plugin mà bản build không giữ — một plugin registry chưa được lần pull nào tải về — không được kiểm tra cho đến khi một lần pull tải nó. Một liên kết không nêu plugin nào được kiểm tra theo cách khác, như một khuyến nghị: xem “A provider binding names a capability no plugin the build reads serves” trong “Conditions that do not halt a build” bên dưới.

Thông báo được phát ra, bổ sung những gì plugin được nêu thực sự phục vụ, và một cách viết cách một lần sửa khi capability của liên kết là như vậy:

plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches: capability "<capability>" is bound to plugin "<plugin-identity>", but no provider-rendering plugin serving "<capability>" matches that identity; "<plugin-identity>" serves "<served capability>", and "<capability>" is one edit from "<served capability>" (mục plugins.providers nêu tên một plugin mà không plugin kết xuất provider nào phục vụ capability khớp: capability <capability> được gắn với plugin <plugin-identity>, nhưng không plugin kết xuất provider nào phục vụ <capability> khớp với định danh đó; <plugin-identity> phục vụ <served capability>, và <capability> cách <served capability> một lần sửa)

Khi plugin mà liên kết nêu không có trong danh mục mà bản build đọc, thông báo kết thúc sau “matches that identity”, vì không có gì để nói về thứ nó phục vụ.

Cách khắc phục: trước hết hãy kiểm tra cách viết của liên kết so với tọa độ của chính plugin — một liên kết nêu capability ở chỗ lẽ ra phải nêu plugin là lỗi thường gặp. Khi thông báo nêu một capability cách một lần sửa so với capability bạn viết, capability: của liên kết là lỗi chính tả. Sau đó xác nhận plugin có trong danh mục mà bản build đọc và nó liệt kê capability này trong spec.provider.capabilities; một plugin từng phục vụ capability và không còn khai báo nó sẽ tạo ra đúng thông báo này. Bỏ liên kết là cách sửa đúng khi chỉ có một plugin phục vụ capability, vì khi đó liên kết không có gì để phân định.

No provider plugin version satisfies a Recipe’s provider pin (Không phiên bản plugin provider nào thỏa mãn ghim provider của một Recipe)

Một Recipe liên kết một provider được ghim phiên bản — helm:1.0.0, hoặc helm:^1.0.0 — và không phiên bản Plugin kết xuất provider nào thỏa mãn ghim đó. Ghim là một yêu cầu tường minh, nên bản build dừng thay vì bỏ qua nó và kết xuất qua bất kỳ phiên bản nào tình cờ phục vụ provider; âm thầm ghi đè một ghim sẽ tạo ra đầu ra mà chính khai báo của tác giả nói là không nên tồn tại.

Hai tình huống dẫn đến lỗi này, và thông báo phân biệt chúng: không có gì phục vụ capability cả, hoặc có thứ phục vụ nó nhưng không phiên bản nào của nó thỏa mãn ràng buộc.

Điều này khác với một phiên bản thực thể không thể thỏa mãn ở trên. Trường hợp đó nói về một thực thể danh mục được nêu ở một phiên bản mà danh mục không chứa; trường hợp này nói về việc chọn plugin kết xuất một capability.

Các thông báo được phát ra:

no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no provider-rendering plugin serves it no provider-rendering plugin version satisfies the recipe’s provider version pin: capability "<capability>" pins "<version>" but no serving plugin version satisfies it

Cách khắc phục: nới rộng hoặc sửa ghim trong trường capability: của Recipe, hoặc thêm phiên bản plugin mà nó yêu cầu vào danh mục. Một ghim caret khớp với các phiên bản bằng hoặc cao hơn mức sàn trong cùng phiên bản chính, nên một ghim ^2.0.0 không được thỏa mãn bởi một plugin 1.x dù mới đến đâu. Khi thông báo nói không có gì phục vụ capability, ghim không phải là vấn đề: plugin bị thiếu hoàn toàn, và bỏ ghim sẽ không giúp được gì.

No plugin advertises a requested parse or import format (Không plugin nào quảng bá định dạng parse hoặc import được yêu cầu)

Một định dạng được yêu cầu và không plugin nào quảng bá nó. Hai socket định tuyến theo định dạng mỗi cái có điều kiện riêng, và chúng chỉ khác nhau ở loại công việc được yêu cầu: một plugin parser đọc một định dạng nguồn ngoại lai, và một plugin importer đưa nội dung ngoại lai vào dưới dạng các thực thể Aggrega.

Không gian định dạng là mở và hoàn toàn thuộc về các plugin. Không socket nào giữ danh sách các định dạng mà trình biên dịch biết: một plugin khai báo các định dạng nó xử lý dưới dạng capability, và một định dạng mới được phát hành dưới dạng một plugin mới mà không cần thay đổi trình biên dịch. Vì vậy lần dừng này báo tập được quảng bá như hiện trạng thay vì một danh sách cố định, và mọi lần không khớp đều được báo rõ: yêu cầu hoặc có bên quảng bá hoặc không thể đáp ứng. Không có gì thay thế cho một plugin bị thiếu, ngoại trừ một trường hợp duy nhất là các parser mà trình biên dịch mang theo, được mô tả bên dưới.

Các thông báo được phát ra:

no parser plugin advertises the requested format: no parser plugin advertises "parse:<format>" no importer plugin advertises the requested format: no importer plugin advertises "import:<format>"

Một plugin parser duy nhất quảng bá định dạng nhưng mang dạng phiên bản không thể phân giải được coi là không có bên quảng bá thay vì một lần thông qua âm thầm, và thông báo nói rõ điều đó:

no parser plugin advertises the requested format: no parser plugin version resolves for "parse:<format>"

Một lần parse dự phòng về các parser mà trình biên dịch mang theo. Một bản build parse từng tệp nó giao cho một chính sách render-verdict ở định dạng mà chính sách đó không đọc được một cách gốc, một importer đọc nguồn của nó qua parser cho cú pháp mà nó nêu, và một lần import không nêu định dạng nào sẽ parse nguồn theo cú pháp mà mỗi chữ ký áp dụng nêu. Với mỗi cú pháp, parser mà danh mục của workspace phục vụ sẽ được dùng, và khi danh mục không phục vụ parser nào, parser mà chính trình biên dịch mang theo cho cú pháp đó sẽ được dùng — trong đó có parser HCL mà một bản build dùng để đọc đầu ra Terraform và parser JSON mà các core importer của trình biên dịch đọc qua, nên cả một chính sách trên đầu ra Terraform lẫn một lần import qua một core importer đều không cần parser nào trong danh mục. Khi danh mục có phục vụ parser cho một cú pháp, parser riêng của trình biên dịch không tham gia, và hai parser khác tên trong danh mục bị từ chối như A parse or import format is advertised by more than one plugin (Một định dạng parse hoặc import được quảng bá bởi nhiều hơn một plugin) mô tả. Vì vậy lần dừng này nêu một cú pháp mà cả danh mục lẫn trình biên dịch đều không phục vụ parser.

Cách khắc phục: xác nhận định dạng được viết đúng như plugin quảng bá — capability là tiền tố của socket cộng với tên định dạng, nên một plugin quảng bá parse:hcl phục vụ định dạng hcl và không gì khác. Sau đó xác nhận plugin có mặt trong danh mục mà bản build đọc. Khi không tồn tại plugin nào cho định dạng, plugin đó chính là phần còn thiếu; trình biên dịch không thể đọc một định dạng mà không gì quảng bá.

A parse or import format is advertised by more than one plugin (Một định dạng parse hoặc import được quảng bá bởi nhiều hơn một plugin)

Hai hoặc nhiều plugin khác nhau quảng bá cùng một định dạng, và yêu cầu không thể được định tuyến mà không đoán nên dùng cái nào.

Một danh mục chứa cả hai là hợp lệ và tải mà không có cảnh báo. Hai nhà phát hành có thể mỗi bên phát hành một parser hoặc một importer cho cùng một định dạng, và liên kết các danh mục của họ là việc được hỗ trợ. Sự mơ hồ là một điều kiện tại điểm sử dụng: nó dừng khi định dạng bị tranh chấp thực sự được yêu cầu, nên một cặp cạnh tranh nằm ngoài phạm vi của bản build không bao giờ chặn nó.

Mọi ứng viên đều được nêu tên và sắp xếp, nên thông báo giống nhau ở mọi lần chạy.

Các thông báo được phát ra:

format is advertised by more than one parser plugin: format "<format>" is advertised by parser plugins [<plugin-names>] format is advertised by more than one importer plugin: format "<format>" is advertised by importer plugins [<plugin-names>]

Với importer, lần dừng còn xuất hiện ở một dạng nữa: các mục plugins.importer của workspace gắn nhiều hơn một importer quảng bá định dạng, và khi đó các importer được nêu là những cái được gắn.

Các importer mà một lần import chọn từ đó là những cái trong danh mục của workspace và các core importer của trình biên dịch, vốn quảng bá định dạng của chúng trong mọi workspace. Vì vậy một danh mục chứa importer riêng có tên khác cho một định dạng mà core importer phục vụ — import:langflow hoặc import:flowise — sẽ gặp lần dừng này khi một lần import không gắn cái nào, và thông báo nêu core importer bên cạnh importer của danh mục. Một importer mà danh mục chứa dưới chính tên của một core importer không phải là bên quảng bá thứ hai: trong cùng một tên, phiên bản cao nhất được chọn, và một importer ở chính phiên bản của core importer, có module của nó bên cạnh, sẽ chạy thay nó. Một importer không có module bên cạnh thì không phải là ứng viên khi một importer cùng tên có thể chạy quảng bá định dạng đó, như Importer nào chạy bên cạnh các importer của riêng bạn mô tả.

Cách khắc phục: với importer, giữ cả hai trong danh mục — hoặc giữ importer của bạn bên cạnh core importer — và gắn cái bạn muốn — một mục plugins.importer có uri nêu nó theo định danh và phiên bản, uri: importer/<name>:<version>, như aggrega plugin add importer ghi ra. Importer được gắn sẽ được chọn trong số những cái quảng bá định dạng, giống như một mục plugins.providers chọn trong số các plugin phục vụ một capability trên socket provider, được mô tả trong “A capability is served by more than one provider plugin (Một capability được phục vụ bởi nhiều hơn một plugin provider)” bên dưới. Khi các importer được nêu là những cái mà các mục của bạn gắn, hãy giữ mục cho cái bạn muốn và xóa mục còn lại. Socket parse không có cơ chế chọn như vậy, nên với parser, cách khắc phục là thu hẹp danh mục mà bản build đọc để chỉ plugin bạn muốn có trong đó — trỏ --catalog vào thư mục chứa lựa chọn của bạn là cách trực tiếp.

Một mục plugins.importer ghim một phiên bản importer mà catalog không có

Một mục plugins.importer gắn một importer theo định danh và một phiên bản — một phiên bản chính xác, uri: importer/<name>:1.2.0, hoặc một khoảng, uri: importer/<name>:^1.2.0 — và importer đó quảng bá định dạng mà lần import yêu cầu, nhưng không phiên bản nào của nó mà lần import lựa chọn thỏa mãn ghim — các phiên bản catalog của workspace chứa, và với một core importer thì cả phiên bản riêng của trình biên dịch: phiên bản chính xác không có ở đó, hoặc không phiên bản nào nằm trong khoảng. Phiên bản là một lựa chọn tường minh, nên lần import bị từ chối trước khi bất kỳ importer nào chạy, thay vì chạy một phiên bản khác của importer thế chỗ.

Điều này khác với trường hợp không importer nào quảng bá định dạng, đã mô tả ở trên: ở đây importer là một trong những importer mà lần import lựa chọn và có quảng bá định dạng, chỉ thiếu phiên bản mà mục chỉ định. Một ghim không thuộc dạng nào mà ghim phiên bản có, chẳng hạn :latest, sẽ được báo là sai định dạng, như “A version pin is none of the forms a pin takes (Một ghim phiên bản không thuộc dạng nào mà ghim có)” mô tả.

Thông báo được phát ra, nêu capability của định dạng và phiên bản mà mục ghim:

no importer plugin version satisfies the plugins.importer entry’s version pin: capability "import:<format>" pins "<version>" but no serving plugin version satisfies it

Cách khắc phục: đổi phiên bản trong uri của mục thành một phiên bản catalog có — với core importer, phiên bản riêng của trình biên dịch cũng là một — hoặc nới rộng khoảng, hoặc thêm phiên bản mà mục chỉ định vào catalog. Một khoảng caret khớp các phiên bản bằng hoặc cao hơn mức sàn trong cùng major, nên ^2.0.0 không được thỏa mãn bởi một importer 1.x dù mới đến đâu.

Một tham chiếu plugin mang host registry hoặc đường dẫn artifact

Một tham chiếu Plugin bắt đầu bằng một đoạn có dạng host registry — chứa dấu chấm hoặc dấu hai chấm, như tên DNS hay host-và-cổng — hoặc bằng một đường dẫn artifact. Một Plugin được định địa chỉ bằng định danh tọa độ của nó: kiểu plugin, một dấu gạch chéo, tên, và tùy chọn một phiên bản. Lần pull gắn định danh đó với một vị trí vật lý bằng cách tự thêm tiền tố registry đã cấu hình và đường dẫn plugin, nên một tham chiếu đã mang sẵn chúng sẽ bị thêm tiền tố hai lần và gắn với một vị trí không thể tải về.

Nó bị từ chối tại nơi vị trí được tạo ra thay vì tại lúc tải, nên thông báo nêu đúng những gì bạn đã viết thay vì xuất hiện muộn hơn dưới dạng một lỗi tag khó đọc.

Thông báo được phát ra, đặt trong khung của lần pull đang tạo vị trí, với cách khắc phục ở dòng bên dưới:

catalog: tier-3 pull <uri>: wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path: "<identity>" remediation: remove the registry host and the artifact path, leaving the coordinate alone — <pluginType>/<name>:<version>, for example provider/helm:1.0.0; the pull prefixes the configured registry itself, so a reference that already carries one is prefixed twice

Cách khắc phục: bỏ mọi thứ phía trước kiểu plugin, chỉ để lại tọa độ — provider/helm:1.0.0, không phải hub.example.com/plugin/provider/helm:1.0.0. Registry mà một build pull về là cấu hình workspace chứ không phải một phần của định danh, điều này cho phép một catalog được phục vụ từ nhiều registry mà không cần sửa các thực thể trong đó.

Một tham chiếu plugin hoặc recipe không có phạm vi

Một tham chiếu Plugin hoặc Recipe không có đoạn phạm vi đứng đầu — hoàn toàn không có dấu gạch chéo, hoặc có một đoạn rỗng trước dấu gạch chéo, như trong /name. Cả hai loại được định danh bằng hai phần, và phần đầu là thứ phân biệt hai thực thể cùng tên: một Plugin theo kiểu plugin và tên của nó, một Recipe theo provider và tên của nó. Hai socket có thể mỗi cái chứa một plugin tên redact, và hai provider có thể mỗi cái phát hành một recipe tên postgres, nên phạm vi là một phần của định danh chứ không phải trang trí thêm.

Một vị trí dựng từ phạm vi rỗng mang một đoạn đường dẫn rỗng — một dấu gạch chéo kép — không thể phân giải, nên tham chiếu bị từ chối tại nơi vị trí được tạo ra thay vì để thất bại muộn hơn dưới dạng một lần tải khó hiểu.

Hai cách khắc phục ngược với trường hợp plugin có tiền tố ở trên và ngược nhau, đó là lý do mỗi cách được diễn đạt riêng: ở đây tham chiếu thiếu một đoạn và bạn thêm vào, còn một tham chiếu có tiền tố mang thừa một đoạn và bạn bỏ đi.

Các thông báo được phát ra, mỗi thông báo đặt trong khung của lần pull và mang cách khắc phục riêng bên dưới:

catalog: tier-3 pull <uri>: wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location: "<identity>" remediation: add the missing pluginType segment — write the reference as <pluginType>/<name>, for example provider/helm or governance/redact, using the pluginType the plugin entity declares under metadata.pluginType

catalog: tier-3 pull <uri>: recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location: "<identity>" remediation: no local catalog directory held this reference, so it was looked for in the registry, where a provider segment is required; re-run as aggrega pull --release <release> --catalog <dir> so the directory that holds it is searched first (--catalog is repeatable)

Cách khắc phục: với plugin, thêm tiền tố là kiểu plugin mà thực thể Plugin khai báo dưới metadata.pluginType. Với recipe, thêm tiền tố là provider mà Recipe khai báo dưới spec.capability. Cách khắc phục cho recipe nêu một khả năng thứ hai đáng đọc: việc đi đến registry có nghĩa là các thư mục catalog cục bộ đã được tìm trước và không thư mục nào chứa tham chiếu, nên nếu recipe được dự định lấy từ một thư mục cục bộ, hãy trỏ build vào thư mục đó thay vì thêm phạm vi.

The build consumes an artifact its publisher has deprecated (Bản dựng sử dụng một artifact mà nhà phát hành đã đánh dấu ngừng hỗ trợ)

Một tham chiếu mà bản dựng này phân giải mang một dấu ngừng hỗ trợ do nhà phát hành ghi lại, và mức độ nghiêm trọng của dấu đó bằng hoặc cao hơn mức mà workspace cấu hình làm ngưỡng dừng. Dấu được gắn vào một artifact đã phát hành sau khi phát hành, nên một artifact hôm qua còn dựng sạch sẽ thì hôm nay có thể mang dấu mà không có gì trong các tệp của bạn thay đổi.

Báo cáo và dừng là hai việc tách biệt, và chỉ việc dừng là cấu hình được. Mọi dấu đã ghi đều được báo cáo, ở mọi mức độ, và không cấu hình nào tắt được điều đó. Việc một dấu có dừng bản dựng hay không là do halt_on_deprecated_severity quyết định, bằng cách so sánh mức độ đã ghi với ngưỡng đã cấu hình theo thứ tự warning < error < retracted. Khi không cấu hình ngưỡng, không có gì dừng và mọi dấu chỉ là khuyến cáo. Một mức độ nằm ngoài ba mức này, hoặc một ngưỡng nằm ngoài chúng, không bao giờ khớp: một giá trị sai định dạng không thể gây ra việc dừng cũng không thể ngăn việc dừng.

Mọi thông báo đều được in ra trước khi bản dựng dừng, không chỉ thông báo gây dừng, nên việc nâng ngưỡng không bao giờ khiến bạn mất một phát hiện — chính việc dừng sẽ nêu tên tham chiếu duy nhất mà nó dừng lại. Các phát hiện được sắp xếp theo tham chiếu, nên cùng một lockfile báo cáo cùng một chuỗi ở mỗi lần chạy và phát hiện gây dừng luôn là một.

Hai kho được kiểm tra và cả hai báo cáo theo cùng một cách: các tham chiếu mà lockfile ghim, và các plugin được ghi là tin cậy cho một phán quyết chấp nhận hoặc từ chối. Không lần kiểm tra nào truy cập registry — cả hai đọc những gì đã được ghi — nên bản dựng vẫn là ahead-of-time.

Thông báo được phát ra. Mỗi phát hiện được in ra khi được duyệt qua, sau đó việc dừng lặp lại phát hiện đã chạm ngưỡng và nêu tên thiết lập đã dừng bản dựng:

deprecation: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run `aggrega pull` to refresh it)

deprecation: build consumes a deprecated entity: <reference> is retracted: <the publisher's recorded message> (recorded in the lockfile at pull, as of <when>; re-run aggrega pull to refresh it): halt_on_deprecated_severity is "error" (deprecation: bản dựng sử dụng một thực thể đã bị ngừng khuyến nghị: tham chiếu đã bị thu hồi, kèm thông điệp do nhà phát hành ghi lại (được ghi vào lockfile khi pull, tại thời điểm đã nêu; chạy lại aggrega pull để làm mới): halt_on_deprecated_severity là “error”)

Một dấu ở một trong hai mức khuyến cáo được ghi là deprecated (warning) hoặc deprecated (error) thay cho retracted. Sự phân biệt được giữ lại vì hai mức mang ý nghĩa khác nhau — không được khuyến khích nhưng vẫn có thể chọn, so với bị loại khỏi việc chọn — và báo cáo mức mạnh hơn như mức yếu hơn sẽ làm nhẹ đi điều đã xảy ra.

Cách khắc phục: đọc thông điệp đã ghi, đó là lời giải thích của chính nhà phát hành về việc cần chuyển sang gì, rồi di chuyển. Khi bạn chưa thể di chuyển, việc nâng halt_on_deprecated_severity — hoặc bỏ thiết lập nó — biến việc dừng trở lại thành một khuyến cáo mà bạn vẫn tiếp tục thấy; đó là một sự chấp nhận có chủ ý chứ không phải một cách lách, và thông báo vẫn tiếp tục được in. Một dấu được ghi cho một phiên bản bạn không còn dùng sẽ biến mất khi lockfile được làm mới bằng aggrega pull.

A trusted plugin’s recorded digest disagrees with the cached artifact (Digest đã ghi của một plugin tin cậy không khớp với artifact trong bộ nhớ đệm)

Một plugin được gắn ở vai trò chấp nhận hoặc từ chối một bản dựng có một digest được ghi là tin cậy cho nó, và manifest của plugin trong bộ nhớ đệm báo cáo một digest khác. Hai giá trị được so sánh trước khi đọc tệp thực thi của plugin, và sự không khớp sẽ dừng việc phân giải tại đó.

Phép so sánh này là điều khiến digest đã ghi trở thành một nguồn có thẩm quyền chứ không chỉ là một sự nhắc lại. Nếu không có nó, các byte của một plugin chỉ được kiểm tra với một giá trị ghim suy ra từ chính manifest mà các byte đó dùng để xác thực — tự nhất quán theo cách xây dựng, và không thể nhận ra rằng toàn bộ artifact đã bị thay thế. So sánh những gì đã ghi với những gì manifest hiện báo cáo là điều mang lại cho phép kiểm tra đó một góc nhìn từ bên ngoài.

Điều này khác với một sự không khớp digest nội dung, vốn báo cáo các byte đã phân giải không khớp với digest được khai báo cho chúng. Ở đây chưa có gì được đọc, và các byte rất có thể khớp với manifest; điều không khớp là chính artifact nào đang được phân giải. Việc tách biệt hai trường hợp là quan trọng vì cách khắc phục trái ngược nhau — một là artifact bị hỏng hoặc bị can thiệp, trường hợp kia là một plugin đã thay đổi hợp lệ mà danh tính mới chưa được xem xét.

Thông báo được phát ra:

resolve cached plugin "<plugin-identity>": the digest recorded as trusted for it is <recorded-digest>, but the plugin manifest in the content cache reports <cached-digest>; review what changed and re-record the trusted digest, or restore the recorded artifact: the digest recorded as trusted for this plugin does not match the digest its cached manifest reports (phân giải plugin đã lưu trong bộ đệm: digest được ghi nhận là tin cậy cho plugin này khác với digest mà manifest của plugin trong bộ đệm nội dung báo cáo; hãy xem xét những gì đã thay đổi và ghi nhận lại digest tin cậy, hoặc khôi phục artifact đã được ghi nhận: digest được ghi nhận là tin cậy cho plugin này không khớp với digest mà manifest đã lưu trong bộ đệm của nó báo cáo)

Cách khắc phục: tìm hiểu điều gì đã thay đổi trước khi ghi lại bất cứ thứ gì — đây là một plugin có thể từ chối các bản dựng của bạn, và digest đã ghi là lời xác nhận rằng đã có người xem xét nó. Khi thay đổi là dự kiến, vì bạn đã chủ ý nâng cấp plugin, hãy xem xét artifact mới và ghi lại digest tin cậy cho nó. Khi thay đổi không được dự kiến, hãy khôi phục artifact mà bản ghi nêu tên; sự không khớp đang cho bạn biết danh tính đã thay đổi mà không ai quyết định điều đó.

An extends: chain cannot be assembled (Không thể lắp ráp một chuỗi extends:)

Chuỗi extends: của một Component, Feature, Manifest hoặc Release nêu tên một entity cha không thể phân giải được, nên không thể biến chuỗi đó thành một entity duy nhất đã được phân giải.

Trường hợp này khác với một chu trình, vốn có điều kiện riêng và cách khắc phục riêng — xem “Cyclic extends chain (Chuỗi extends có chu trình)” ở trên; khác với một chuỗi vượt quá giới hạn độ sâu, vốn có điều kiện riêng ở bên dưới; và khác với một version pin không thể thỏa mãn, khi entity cha tồn tại và chỉ có phiên bản là không tồn tại.

Thông báo được phát ra, nêu tên entity mang extends: không thể phân giải và tham chiếu mà nó khai báo:

inheritance merge failed (Component <name>, at .spec.extends, <entity> extends <reference>, which no catalog entity provides). Verify the extends reference names an entity present in the catalog (hợp nhất kế thừa thất bại (Component <name>, tại .spec.extends, <entity> extends <reference>, mà không entity nào trong catalog cung cấp). Hãy kiểm tra rằng tham chiếu extends nêu tên một entity có trong catalog)

Khi phép kiểm tra báo cáo điều này đọc một thực thể cha từ bộ nhớ đệm artifact theo pin của một lockfile — phép kiểm tra extends của một bản build và của aggrega validate --release, aggrega validate trên toàn bộ catalog, và aggrega inspect, cùng các phép kiểm tra tương tự chạy từ trình soạn thảo và công cụ validate của trợ lý — lời khuyên còn nêu thêm lệnh pull: “a base published to a registry is fetched by aggrega pull --release <release>” (một bản cơ sở được phát hành lên registry sẽ được lấy về bằng lệnh đã nêu). Việc xác thực một tệp thực thể đơn lẻ không đọc lockfile nào, nên một lần pull sẽ không thay đổi gì trong những gì nó đọc, và thông báo của nó dừng ở catalog.

Feature xuất hiện thay cho Component khi chuỗi bị lỗi là chuỗi của một Feature. Cũng như với một vòng lặp, entity được nêu tên đầu tiên là entity mà quá trình phân giải bắt đầu, còn entity được nêu trong cạnh là entity có dòng extends: mà bạn cần mở; trong một chuỗi nhiều tầng, hai entity này khác nhau.

extends: của một Manifest được đối chiếu với một nơi khác, nên nó nhận được lời khuyên khác. Một Manifest là cấu hình của người vận hành, được viết bên cạnh Release chứ không phải nội dung catalog, và extends: của nó nêu tên một tệp theo đường dẫn tương đối hoặc metadata.name của một Manifest trong chính thư mục của Release — không bao giờ là một entity của catalog. Vì vậy, thông báo của nó kết thúc bằng việc tham chiếu đã không phân giải được thành gì và nên tìm ở đâu thay vào đó:

inheritance merge failed (Manifest <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path or the name of a Manifest in the Release’s directory (hợp nhất kế thừa thất bại (Manifest <name>, tại .spec.extends, <entity> extends <reference>, không thể phân giải: <what looking produced>). Hãy kiểm tra rằng tham chiếu extends là một đường dẫn tương đối hoặc tên của một Manifest trong thư mục của Release)

Chi tiết ở cuối đó là lỗi do chính quá trình tra cứu báo cáo — tệp không thể đọc được, hoặc lần quét không lập chỉ mục được Manifest nào dưới tên đó — nên nó thường cho biết dạng nào trong hai dạng đã được thử và vì sao kết quả trả về rỗng.

extends: của một Release được đối chiếu với một thư mục, và nó chấp nhận một dạng duy nhất. Một Release nêu tên entity cha của nó bằng một đường dẫn tương đối — ./base-release.yaml, hoặc ../shared/base-release.yaml. Thư mục dùng để đối chiếu là thư mục chứa Release viết tham chiếu đó, và mỗi mắt xích trong chuỗi được đối chiếu với thư mục của chính nó — nên một Release ở giữa chuỗi đặt trong một thư mục con sẽ nêu tên entity cha nằm bên cạnh chính nó, bất kể Release mà một lệnh nêu tên nằm ở đâu. Một token trơn không phải là đường dẫn và không nêu tên một Release mà trình biên dịch sẽ tìm, nên nó được báo cáo tại đây thay vì được tìm ở một nơi không thể tìm thấy:

inheritance merge failed (Release <name>, at .spec.extends, <entity> extends <reference>, which could not be resolved: <what looking produced>). Verify the extends reference is a relative path to a Release file, such as ./base-release.yaml, resolved from the directory holding this Release (hợp nhất kế thừa thất bại (Release <name>, tại .spec.extends, <entity> extends <reference>, không thể phân giải: <what looking produced>). Hãy kiểm tra rằng tham chiếu extends là một đường dẫn tương đối tới một tệp Release, chẳng hạn ./base-release.yaml, được phân giải từ thư mục chứa Release này)

Cách khắc phục: với một Component hoặc Feature, hãy xác nhận giá trị extends: nêu tên một entity mà catalog có, được viết đúng như metadata.name của chính entity đó — kể cả chữ hoa chữ thường. Một bản cơ sở được phát hành lên registry được đọc từ bộ nhớ đệm artifact theo pin mà lockfile của Release ghi lại cho nó, vì vậy khi bản cơ sở nằm trong một registry, hãy chạy aggrega pull --release <release>: lệnh pull đi theo chuỗi, lấy bản cơ sở về và ghim nó. Với một Manifest, hãy xác nhận tệp nằm ở nơi đường dẫn tương đối trỏ tới, hoặc một Manifest có metadata.name đó nằm trong thư mục của Release và phân tích cú pháp được. Với một Release, hãy xác nhận giá trị bắt đầu bằng ./ hoặc ../ và tệp mà nó trỏ tới tồn tại và phân tích cú pháp được như một Release.

An extends: chain runs past the depth bound (Một chuỗi extends: vượt quá giới hạn độ sâu)

Chuỗi extends: của một Component, Feature, Manifest hoặc Release kết thúc bình thường nhưng đi qua nhiều entity hơn giới hạn mười cho phép.

Nó có điều kiện riêng thay vì dùng chung điều kiện ở trên, vì hai cách khắc phục không có gì chung: một entity cha vắng mặt là một tham chiếu cần sửa, còn một chuỗi quá sâu là một cấu trúc cần làm phẳng. Giới hạn này là biện pháp phòng ngừa một sơ suất khi viết chứ không phải một giới hạn cấu trúc — các kiến trúc sư thường mở rộng một baseline thêm một hoặc hai tầng, và một chuỗi sâu mười tầng thường là một cây cơ sở đã phình ra chứ không phải một thiết kế có chủ đích.

Chỉ một chuỗi có KẾT THÚC mới chạm tới nó. Một chuỗi vòng trở lại chính nó được báo cáo là một vòng lặp bất kể độ dài, nên điều kiện này không bao giờ thay thế cho một chu trình và lời khuyên của nó — rút ngắn chuỗi — không bao giờ được đưa ra cho một chu trình.

Thông báo được phát ra, nêu giới hạn và độ dài mà chuỗi đạt tới:

extends chain exceeds maximum depth (Component <name>, rule extends). the bound is 10 and this chain reaches <length>; shorten the chain, or extend a base that sits closer to its root (chuỗi extends vượt quá độ sâu tối đa (Component <name>, quy tắc extends). giới hạn là 10 và chuỗi này đạt tới <length>; hãy rút ngắn chuỗi, hoặc mở rộng một entity cơ sở nằm gần gốc hơn)

Feature, Manifest hoặc Release xuất hiện thay cho Component khi chuỗi bị lỗi là một trong các chuỗi đó. Giới hạn là mười như nhau cho mọi loại khai báo extends, và nó đếm các entity trong chuỗi chứ không đếm các liên kết giữa chúng: một chuỗi đúng mười entity vẫn build được, và entity thứ mười một là điều mà lỗi này báo cáo. Vì vậy, một entity mở rộng một entity cơ sở, mà entity cơ sở đó lại mở rộng một entity cơ sở khác — ba entity, hai liên kết — đã đạt tới ba.

Cách khắc phục: gộp phần giữa của chuỗi. Một chuỗi sâu đến vậy thường có nghĩa là mỗi tầng chỉ thêm một chút, và gộp nhiều tầng vào một entity cơ sở vừa là cách khắc phục vừa là cấu trúc rõ ràng hơn. Khi các tầng thực sự khác biệt, một entity ở sâu hơn trong chuỗi có thể mở rộng trực tiếp một entity cơ sở gần gốc hơn thay vì kế thừa qua mọi tầng ở giữa. Một chuỗi Manifest sâu đến vậy thường là một chồng lớp phủ theo từng môi trường — hãy gộp các tầng không ai thay đổi vào entity cơ sở mà chúng phủ lên.

An assertion name is declared twice along an extends: chain (Một tên assertion được khai báo hai lần dọc theo một chuỗi extends:)

Một entity và một thứ mà nó mở rộng cùng khai báo một assertion dưới cùng một tên, và hai bên khai báo các quy tắc khác nhau. Các assertion của một entity mở rộng được thêm vào các assertion của entity cơ sở; chúng không bao giờ thay thế một assertion nào. Vì vậy, một tên được khai báo hai lần với hai quy tắc khác nhau sẽ âm thầm loại bỏ bất biến của entity cơ sở, điều ngược lại với mục đích của việc mở rộng một entity.

Khai báo cùng một tên với quy tắc giống hệt không phải là xung đột và vẫn build được. Đó là điều giữ cho việc kiểm tra mang tính idempotent dọc theo một chuỗi: nếu không, một chuỗi sâu ba tầng sẽ luôn xung đột với chính tầng giữa của nó.

Thứ tự là một phần của hợp đồng chứ không phải ngẫu nhiên. Các assertion được đánh giá theo thứ tự đã hợp nhất và assertion thất bại đầu tiên sẽ dừng build, nên bất biến của entity cơ sở được kiểm tra trước bất biến của entity con cháu, và dọc theo một chuỗi, tập hợp được tích lũy từ gốc trở xuống.

Thông báo được phát ra:

assertion name declared twice across the extends chain (Component <name>:<version>, rule assertions, at .spec.assertions.<key>). assertion "<key>" is already declared by the base Component "<base>", carrying a different rule; rename the extending entity’s assertion; an extending entity’s assertions add to the base’s and never replace one (tên assertion được khai báo hai lần trong chuỗi extends (Component <name>:<version>, quy tắc assertions, tại .spec.assertions.<key>). assertion “<key>” đã được khai báo bởi Component cơ sở “<base>”, mang một quy tắc khác; hãy đổi tên assertion của entity mở rộng; các assertion của một entity mở rộng được thêm vào các assertion của entity cơ sở và không bao giờ thay thế một assertion nào)

Cách khắc phục: đổi tên assertion của entity mở rộng, mà thông báo nêu tên cùng với entity cơ sở đã khai báo nó. Khi bạn định thay thế quy tắc của entity cơ sở, đó không phải là điều mà việc mở rộng hỗ trợ — hãy thu hẹp assertion của entity cơ sở để nó đúng với mọi entity mở rộng nó, hoặc chuyển quy tắc xuống các entity thực sự cần nó. Khi hai quy tắc được dự định là giống nhau, hãy làm cho chúng giống hệt nhau về mặt văn bản và xung đột sẽ biến mất.

Một Release định tuyến các component của Aggregate của nó theo một trong hai cách: các ranh giới có tên dưới boundaries:, hoặc các component cấp cao nhất dưới components:. Hai cách này loại trừ lẫn nhau, và một tài liệu khai báo cả hai sẽ bị từ chối ngay khi được đọc. Tình trạng này là cùng quy tắc đó trên một chuỗi extends:: một base khai báo ranh giới có tên và một child khai báo component cấp cao nhất đều hợp lệ khi đứng riêng, và chỉ khi gộp chúng lại thì hai lựa chọn mới nằm trong cùng một Release đã phân giải.

Không tài liệu nào sai khi đứng riêng, đó là lý do thông báo nêu cả hai tài liệu và cả hai khóa. Một chẩn đoán chỉ nêu Release mà bản dựng được trỏ tới sẽ đưa bạn đến tệp không có gì sai.

Một chuỗi có các mắt xích thống nhất thì không bị ảnh hưởng. Mọi mắt xích khai báo ranh giới có tên đều kết hợp bình thường, và mọi mắt xích khai báo component cấp cao nhất cũng vậy. Chính sự pha trộn mới gây dừng.

Thông báo được phát ra, nêu hai tệp và khóa mà mỗi tệp khai báo:

release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both (Release <release-file>, boundaries declared by "<file>", components declared by "<file>") (chuỗi extends của release kết hợp cả ranh giới có tên lẫn component cấp cao nhất: hãy khai báo một hình dạng định tuyến trên toàn chuỗi, không bao giờ cả hai; tệp Release, tệp khai báo ranh giới và tệp khai báo component được nêu ra)

Cách khắc phục: chọn hình dạng định tuyến mà chuỗi nên dùng và viết nó xuyên suốt. Nếu base khai báo ranh giới có tên, một child muốn cấu hình component sẽ chỉ tới chúng bên trong ranh giới chứa chúng thay vì ở gốc Release — đây cũng là điều cho phép nó thay đổi kích thước của một component mà không phải nhắc lại topology. Nếu base khai báo component cấp cao nhất, một child cần ranh giới có tên đang mô tả một hình dạng định tuyến khác với base của nó, và nên được soạn thành một Release riêng thay vì làm child của base đó.

An external input’s URL uses a scheme that is not allowed (URL của một đầu vào bên ngoài dùng một scheme không được cho phép)

Một URL mà một thực thể trỏ tới dùng một scheme nằm ngoài tập được cho phép. Có ba scheme được cho phép: https; http, nhưng chỉ tới một host loopback, để văn bản không mã hóa chỉ có thể đến được máy cục bộ; và oci, cho nội dung được kéo từ một registry.

Các thông báo được phát ra, cho một URL http không phải loopback và cho mọi scheme khác:

externalinputs: "<url>": plain http is allowed for loopback hosts only (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: URL được nêu: http thuần chỉ được phép cho host loopback (các scheme được phép: https, http tới một host loopback, oci): externalinputs: scheme của URL không được phép) externalinputs: "<url>": scheme "<scheme>" is not allowed (allowed schemes: https, http to a loopback host, oci): externalinputs: URL scheme is not allowed (externalinputs: URL được nêu: scheme được nêu không được phép (các scheme được phép: https, http tới một host loopback, oci): externalinputs: scheme của URL không được phép)

Cách khắc phục: chuyển URL sang https, hoặc sang oci khi nội dung được phát hành trong một registry. Một URL http thuần tới một host từ xa bị từ chối chứ không bị hạ cấp, nên trỏ nó tới scheme an toàn chính là cách khắc phục; một máy chủ phát triển cục bộ vẫn tiếp tục hoạt động qua http vì host loopback được cho phép.

A render requests an external input the lockfile does not pin (Một lần render yêu cầu một đầu vào bên ngoài mà lockfile không ghim)

Một thứ mà build cần được tải từ một URL mà lockfile không ghim. Một build render đúng bao đóng mà lockfile của nó ghi lại và không tải gì cả, nên không có thiết lập nào cho phép lần chạy này lấy URL đó thay vào: chính bao đóng cố định là thứ làm cho build có thể tái lập, và lặng lẽ mở rộng tập đầu vào là điều duy nhất nó không được làm.

Vì vậy, gặp điểm dừng này mang tính thông tin chứ không phải một lỗi cấu hình. Các ghim đã đầy đủ khi Release được phân giải, nên một URL chưa được ghim lúc này nghĩa là đã có gì đó thay đổi kể từ đó — một giá trị điều khiển những tham chiếu mà một lần render yêu cầu, một chart bắt đầu trỏ tới nơi mới, hoặc một lockfile được phân giải theo một Release khác.

Thông báo được phát ra:

"<url>" is not pinned in the lockfile; run aggrega pull --release <release> to pin every external input this Release’s render consumes, then build again: externalinputs: acquisition is disabled for unpinned inputs (URL được nêu chưa được ghim trong lockfile; hãy chạy lệnh aggrega pull với cờ —release để ghim mọi đầu vào bên ngoài mà quá trình render của Release này sử dụng, rồi build lại: externalinputs: việc thu nhận bị vô hiệu hóa đối với các đầu vào chưa được ghim)

Cách khắc phục: ghim đầu vào. aggrega pull --release <path> render Release để tìm ra những đầu vào bên ngoài mà nó dùng, tải từng cái, và ghi digest của nó vào lockfile bên cạnh các ghim phụ thuộc — sau đó mọi build về sau phục vụ nó từ bản ghi đã ghim và hoàn toàn không cần mạng. Khi URL là mới vì một thứ bạn viết bắt đầu trỏ tới nó, phân giải lại Release là bước đã bị bỏ qua; khi nó bất ngờ, nên tìm ra tham chiếu đã đưa nó vào trước khi bạn ghim nó.

Fetched bytes do not match a pinned digest (Các byte tải về không khớp với một digest đã ghim)

Một URL đã ghim được tải lại — vì bản sao lưu trữ của nó bị thiếu — và thứ nhận về không phải là thứ lockfile đã ghim. Digest đã ghi lại luôn thắng: không có gì được ghi vào kho lưu trữ, và không byte nào được trả về.

Một lần nạp lại được tải theo digest đã ghi chứ không theo tag của URL, nên một tag đã bị chuyển sang trỏ tới nội dung khác không thể thay đổi thứ mà một mục đã ghim phục vụ. Vì vậy, gặp điểm dừng này có nghĩa là chính nội dung đằng sau digest đã không được trả về nguyên vẹn.

Các thông báo được phát ra, cho nội dung kéo từ một registry và cho nội dung tải qua HTTPS:

externalinputs: "<url>": refilled manifest digest is <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: URL được nêu: digest manifest được nạp lại khác với digest đã ghim: externalinputs: các byte đã tải không khớp với digest đã ghim) externalinputs: "<url>": refetched bytes hash to <digest>, pinned digest is <digest>: externalinputs: fetched bytes mismatch the pinned digest (externalinputs: URL được nêu: hash của các byte tải lại khác với digest đã ghim: externalinputs: các byte đã tải không khớp với digest đã ghim)

Cách khắc phục: trước hết hãy coi đây là một câu hỏi về chuỗi cung ứng chứ không phải một lockfile cần làm mới — ghim là lời khẳng định rằng chính xác những byte này là thứ bạn đã build dựa trên, và việc từ chối là lời khẳng định đó đang được giữ vững. Xác nhận nguồn vẫn phát hành nội dung mà digest chỉ định, và kiểm tra xem có thứ gì giữa bạn và nguồn đang viết lại phản hồi hay không; một proxy hoặc một mirror phục vụ bản thay thế là nguyên nhân phổ biến. Chỉ khi bạn biết điều gì đã thay đổi và chấp nhận nó thì mới nên ghim lại bằng aggrega pull, lệnh này ghi lại digest mới.

A stored external input no longer matches its record (Một đầu vào bên ngoài được lưu trữ không còn khớp với bản ghi của nó)

Một đầu vào đã ghim được đọc lại từ kho lưu trữ cục bộ và không khớp với bản ghi đã ghim cho nó. Việc kiểm tra chạy ở mỗi lần đọc, trước khi các byte được phục vụ, nên một kho lưu trữ bị hỏng hoặc bị can thiệp sẽ lộ ra tại thời điểm sử dụng thay vì lặng lẽ cấp dữ liệu cho một build.

Thứ được so sánh phụ thuộc vào cách đầu vào được ghim. Nội dung tải qua HTTPS được ghim bằng cách băm payload, nên nó được băm lại ở mỗi lần đọc và cả hai digest đều được báo cáo. Nội dung kéo từ một registry được ghim bằng digest manifest của nó, thứ cam kết với payload thông qua chính manifest của registry chứ không bằng cách băm trực tiếp, nên một bản sao lưu trữ được kiểm tra theo kích thước đã ghi — việc xác minh digest đầy đủ thay vào đó được neo tại lúc thu nhận và tại mỗi lần nạp lại theo địa chỉ digest.

Các thông báo được phát ra:

externalinputs: "<url>": store blob sha256 is <digest>, pinned digest is <digest>: externalinputs: store blob mismatches its pinned record (externalinputs: URL được nêu: sha256 của blob trong kho khác với digest đã ghim: externalinputs: blob trong kho không khớp với bản ghi đã ghim của nó) externalinputs: "<url>": store blob sha256/<digest> is <n> bytes but the pinned record says <n>: externalinputs: store blob mismatches its pinned record (externalinputs: URL được nêu: kích thước blob trong kho khác với kích thước mà bản ghi đã ghim nêu: externalinputs: blob trong kho không khớp với bản ghi đã ghim của nó)

Cách khắc phục: xóa blob gây lỗi khỏi kho lưu trữ và để lần chạy tiếp theo nạp lại nó từ nguồn, việc này được xác minh theo digest đã ghi trước khi bất cứ thứ gì được ghi. Nếu sau đó một lần nạp lại cũng báo không khớp digest, sự bất đồng nằm ở phía thượng nguồn chứ không phải cục bộ và mục ở trên là mục cần đọc. Một kho lưu trữ dùng chung giữa các máy, hoặc một kho được khôi phục từ bản sao lưu tạo ra giữa lúc ghi, là nguyên nhân cục bộ thường gặp.

A guard needs a catalog entity the build resolved and cannot see (Một guard cần một thực thể catalog mà build đã phân giải nhưng không thấy được)

Một guard ngữ nghĩa đã tìm tới thực thể catalog đằng sau kiểu của một component, và thực thể đó vắng mặt trong view mà guard được cấp — dù quá trình phân giải đã phân giải kiểu đó như một tham chiếu catalog. Một tham chiếu thực sự không thể phân giải sẽ dừng sớm hơn, ở bước phân giải, nên việc tới được một guard mà thiếu thực thể có nghĩa là tập đã phân giải của build và view của guard đã tách rời nhau.

Build dừng lại thay vì bỏ qua guard. Bỏ qua sẽ loại bỏ một lần kiểm tra mà không có gì cho biết nó đã mất, và các component mà guard liên quan sẽ lọt qua mà không được xem xét trong khi build báo thành công.

Một kiểu được viết dưới dạng đường dẫn tương đối — bắt đầu bằng ./ hoặc ../ — không được xét ở đây: một kiểu không bao giờ được đọc như một tệp, nên một giá trị như vậy hoàn toàn không nêu thực thể catalog nào và bị từ chối sớm hơn, khi các phụ thuộc của Release được phân giải, như một tham chiếu mà không catalog nào chứa. Chỉ một tham chiếu catalog dạng token trần mới gặp điểm dừng này.

Dù điều kiện xảy ra ở đâu, nó cũng báo cáo bằng cùng một câu chữ, nên văn bản nêu kiểu và lỗi chứ không nêu lần kiểm tra đã phát hiện ra nó.

Nó cũng không nêu tài liệu nào và không nêu khóa nào bên trong tài liệu, điều này là có chủ ý và là nơi duy nhất điểm dừng này đọc khác với mọi điểm dừng khác. Mọi điểm dừng khác đều tự định vị trên tệp và trường mà bạn sẽ sửa để gỡ nó; ở đây không có tệp như vậy, nên một vị trí sẽ đưa bạn tới một khóa không có lỗi. Thay vào đó, kiểu mà hai view bất đồng được báo cáo, vì đó là thứ làm cho sự khác biệt có thể tái hiện được với bất kỳ ai điều tra nó.

Thông báo được phát ra:

the compiler’s own views of the catalog disagree (internal error: this build resolved a component type that the catalog it reads then held no entry for. This is a fault in the compiler rather than in an authored document, so there is nothing to correct in the Aggregate, the Release or the catalog. Please report it, naming the command that produced this build and the type the views disagree on: "<type>") (các view của chính trình biên dịch về catalog không thống nhất (lỗi nội bộ: build này đã phân giải một loại component mà catalog nó đọc sau đó không có mục nào. Đây là lỗi của trình biên dịch chứ không phải của một tài liệu được soạn, nên không có gì cần sửa trong Aggregate, Release hay catalog. Vui lòng báo cáo lỗi này, nêu lệnh đã tạo ra build này và loại mà các view không thống nhất được nêu ở trên))

Cách khắc phục: không có gì trong các tệp của bạn — điều này báo cáo một sự không nhất quán bên trong trình biên dịch chứ không phải một lỗi trong những gì bạn viết, và nên báo cáo nó như một khiếm khuyết kèm kiểu mà thông báo nêu. Kiểu của component gần như chắc chắn không có vấn đề.

A reference names no entity the catalog holds (Một tham chiếu không chỉ tới thực thể nào mà catalog chứa)

Trước khi một bản build render bất cứ thứ gì, toàn bộ tập thực thể mà một Release phụ thuộc vào sẽ được duyệt và từng thực thể được ghim, để lockfile ghi lại chính xác những gì bản build sẽ đọc. Một tham chiếu mà catalog không thể trả lời sẽ dừng việc duyệt đó: không có gì có thể được ghim cho nó, và nếu tiếp tục thì sẽ ghi ra một lockfile thiếu một mục mà bản build cần về sau, mà không có gì báo điều đó.

Lời từ chối nêu tên tham chiếu và nơi nó được thu thập, vì một thực thể được tiếp cận từ nhiều nơi và nơi nêu tên nó chính là chỗ cần sửa. Một tham chiếu thư viện được báo cáo riêng, không kèm đường dẫn thu thập — một thư viện được tiếp cận từ các thực thể $ref hoặc $import nó, và cái tên bị lỗi là toàn bộ lỗi.

Thông báo được phát ra, cho một thực thể catalog — phần cuối liệt kê các nơi tham chiếu tới nó:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from <referring paths>) (resolve: không có thực thể nào trong catalog khớp với URI này: thực thể được nêu, được tham chiếu từ các đường dẫn đã liệt kê)

cho một thư viện:

resolve: no entity in the catalog matches this URI: library "<reference>" (resolve: không có thực thể nào trong catalog khớp với URI này: thư viện được nêu)

và cho một plugin được gắn vào một socket provider, được nêu tên bằng khóa cấu hình workspace đã mang nó chứ không phải bằng một tài liệu catalog:

resolve: no entity in the catalog matches this URI: entity "<reference>" (referenced from .aggrega-config.yaml.plugins.providers) (resolve: không có thực thể nào trong catalog khớp với URI này: thực thể được nêu, được tham chiếu từ .aggrega-config.yaml.plugins.providers)

Khi một tệp dưới các thư mục catalog khai báo tên mà tham chiếu yêu cầu dưới một loại mà không catalog nào chứa — chẳng hạn một kind viết sai chính tả — ghi chú bên dưới lỗi này nêu tên tệp đó, loại mà nó khai báo và các loại mà một catalog chứa, và lược bỏ lời khuyên về nơi các thực thể cục bộ được đọc, trên một lần build điền lockfile của nó cũng như trên một lần build đọc lockfile, và trên mọi bề mặt khác báo cáo lỗi này; xem Một tệp catalog bị từ chối và lỗi mà nó giải thích.

Cách khắc phục: đọc tham chiếu đúng như thông báo trích dẫn. Một tên không tồn tại, một phiên bản chưa từng được phát hành, và một tên trần mà workspace không trỏ tới registry của nó đều dẫn đến đây giống hệt nhau, vì vậy hãy kiểm tra ba điều theo thứ tự đó: sửa chính tả; xác nhận phiên bản tồn tại; xác nhận registry chứa nó đã được cấu hình và truy cập được. Nếu thực thể là thứ bạn tự viết cục bộ, hãy xác nhận tệp nằm trong catalog mà bản build duyệt.

Khi aggrega pull, hoặc aggrega build --auto-pull, dừng lại ở một tham chiếu thư viện trong khi bộ nhớ đệm artifact chứa một SchemaLibrary mà không mục lockfile nào ghim và không thư mục catalog nào cung cấp, một dòng remediation: sẽ theo sau thông báo, nêu tên từng thư viện như vậy. Một thư viện trong bộ nhớ đệm chỉ được tính là nội dung catalog khi một mục lockfile bảo chứng cho digest của nó, và lệnh pull ghi lại mục đó từ registry phục vụ thư viện. Ở chế độ ngoại tuyến, lệnh pull không thể tải thư viện cũng như không thể ghi lại mục cho nó, nên dòng đó hướng dẫn chạy aggrega pull --release <release> ở nơi có thể truy cập registry, hoặc tạo thư viện trong một thư mục catalog. Khi có kết nối, không thư mục catalog hay registry nào mà lệnh pull đọc phục vụ thư viện đó, nên không có mục nào để ghi lại, và dòng đó chỉ tới việc tạo thư viện trong một thư mục catalog.

A library reference is not written in the identity form (Một tham chiếu thư viện không được viết theo dạng định danh)

Một $ref: hoặc $import: liên thư viện nêu tên thư viện theo định danh rồi đến mục bên trong nó: tên trần của thư viện, tùy chọn một : và một mức sàn phiên bản, sau đó là # và đường dẫn của mục trên bề mặt mà trường đó đọc. Dạng này không có host registry. Một tên được phân giải qua registry nào là cấu hình workspace, và một bản build dùng phiên bản nào là câu trả lời của lockfile, nên một tham chiếu mang một trong hai thứ đó sẽ cố định trong tài liệu một điều mà bản build phải tự quyết định.

Bị từ chối ở đây: một giá trị mang host registry; một anchor trong tài liệu được viết ở nơi cần một tham chiếu liên thư viện; một tên thư viện rỗng; và @ được viết làm dấu phân cách phiên bản, trường hợp này được báo cáo kèm cách viết đã sửa thay vì một lời phàn nàn chung về hình dạng, vì đây là lỗi mà dạng này hay gặp nhất.

Thông báo được phát ra:

resolve: invalid library reference URI: "<the value as written>" (resolve: URI tham chiếu thư viện không hợp lệ: giá trị như đã viết)

và khi @ được dùng làm dấu phân cách, trích dẫn giá trị lẽ ra phải là:

resolve: invalid library reference URI: version separator is ’:’, not ’@’ — use "<the corrected value>" (resolve: URI tham chiếu thư viện không hợp lệ: dấu phân tách phiên bản là ’:’, không phải ’@’ — hãy dùng giá trị đã sửa)

Cách khắc phục: viết lại giá trị thành <Library>#<entry-path>, chỉ thêm :<version> sau tên thư viện khi bạn cần một mức sàn cho phiên bản có thể được chọn. Bỏ mọi host registry. Nếu tham chiếu nhằm trỏ vào bên trong cùng tài liệu, một anchor trong tài liệu là thứ khác với tham chiếu thư viện, và trường bạn viết nó vào yêu cầu dạng thư viện.

Two consumers of one library require incompatible versions (Hai bên sử dụng một thư viện yêu cầu các phiên bản không tương thích)

Nhiều thực thể có thể tham chiếu tới một thư viện, mỗi thực thể nêu một mức sàn phiên bản hoặc không nêu gì, và phiên bản mà bản build chọn là mức sàn cao nhất mà bất kỳ thực thể nào đã nêu. Điều đó cho phép một bên sử dụng yêu cầu ít hơn vẫn nhận được một phiên bản thỏa mãn nó, và đó là lý do việc thêm một bên sử dụng có mức sàn cao hơn sẽ nâng mọi người lên thay vì chia bản build thành hai bản sao.

Quy tắc này chỉ đúng khi các mức sàn thống nhất ở số phiên bản đầu tiên. Hai bên sử dụng nêu các major khác nhau thực chất đang yêu cầu hai thư viện tình cờ trùng tên, và không lựa chọn đơn lẻ nào thỏa mãn được cả hai — vì vậy thay vì chọn một và để bên kia đọc một hình dạng mà nó không được viết theo, bản build dừng lại và nêu ra sự bất đồng. Một bên sử dụng không nêu mức sàn không tham gia gì ở đây: lựa chọn do các bên đã ghim quyết định.

Thông báo được phát ra. Các bên sử dụng được so sánh theo thứ tự đã sắp xếp: bên đầu tiên nêu mức sàn sẽ đặt major, và thông báo liệt kê từng bên được so sánh, cho đến và bao gồm bên đầu tiên có mức sàn nêu một major khác, cùng với phiên bản mà nó yêu cầu — nên cùng các tài liệu luôn nêu cùng các bên sử dụng:

resolve: minimal version selection conflict — incompatible library version requirements: library "<library>" has consumers requiring incompatible majors: <consumer> wants <version>; <consumer> wants <version> (resolve: xung đột khi chọn phiên bản tối thiểu — các yêu cầu phiên bản thư viện không tương thích: thư viện có các bên sử dụng yêu cầu các phiên bản chính không tương thích)

Cách khắc phục: nâng mức sàn của bên sử dụng thấp hơn lên cùng major, đây là câu trả lời thông thường khi hình dạng mới hơn là thứ mọi người đều muốn. Nếu thực sự cần cả hai major cùng lúc, chúng là hai thư viện: phát hành hình dạng cũ hơn dưới một tên riêng và trỏ bên sử dụng cần nó tới đó, để mỗi tham chiếu nêu đúng thứ mà nó được viết theo.

The chain of module imports is deeper than the pin walk descends (Chuỗi import module sâu hơn mức mà việc duyệt ghim đi xuống)

Việc ghim duyệt qua mọi module mà một Aggregate import, rồi mọi module mà các module đó import, để toàn bộ tập này đến được lockfile chứ không chỉ cấp đầu tiên. Một module đã được ghi lại sẽ không được duyệt lần thứ hai, đó là điều kết thúc một vòng lặp thông thường — một Aggregate import một module rồi module đó import ngược lại sẽ kết thúc mà không báo lỗi, mỗi module được ghi lại một lần.

Giới hạn độ sâu bằng mười chặn chuỗi mà việc phát hiện lặp không thấy được: chuỗi mang một định danh mới ở mỗi cấp, như một module được phát hành lại dưới một phiên bản mới ở mỗi bước. Giới hạn này giống với giới hạn mà bộ dựng đồ thị áp dụng, nên một tổ hợp ghim được cũng là một tổ hợp build được.

Thông báo được phát ra:

resolve: sub-aggregate inclusion depth exceeded: "<module>" at depth <depth> (resolve: vượt quá độ sâu bao gồm sub-aggregate: module được nêu ở độ sâu được nêu)

Cách khắc phục: rút ngắn chuỗi. Một chuỗi sâu như vậy thường phản ánh cách tổ chức được sắp xếp chứ không phải cách triển khai, vì vậy hãy tìm các cấp không đóng góp component nào của riêng chúng và gộp chúng vào cấp cha. Nếu mỗi cấp chỉ tồn tại để phát hành lại cấp bên dưới dưới một phiên bản mới, thì chính các phiên bản là chuỗi: hãy import trực tiếp module bạn thực sự muốn, ở phiên bản bạn muốn.

Đây là giới hạn của việc duyệt ghim. Bộ dựng đồ thị áp dụng giới hạn riêng của nó, được báo cáo dưới “Sub-aggregate nesting depth exceeded” bên dưới, và hai báo cáo này là hai báo cáo riêng của cùng một giới hạn gặp ở hai thời điểm — lần đầu khi lockfile đang được điền, lần thứ hai khi đồ thị đang được dựng.

The catalog view a build was given cannot load the bodies pinning needs (Góc nhìn catalog mà một bản build được cung cấp không thể tải các nội dung mà việc ghim cần)

Hai trong số các trục mà việc ghim duyệt cần nhiều hơn một câu trả lời về phiên bản từ catalog: chúng cần chính các tài liệu. Các module mà một Aggregate import phải được đọc để tìm những gì chúng lần lượt import. Các Recipes, FeatureRecipes và Plugins mà một bản build gắn vào phải được đọc để tìm các artifact và thư viện mà chúng nêu tên. Một góc nhìn catalog có thể phân giải phiên bản nhưng không trả lại được các nội dung đó sẽ khiến cả hai trục không có gì để đọc.

Cả hai đều bị từ chối ngay từ đầu thay vì bị bỏ qua, và lý do là thứ mà việc bỏ qua sẽ tạo ra: một lockfile thiếu cả một lớp mục, được ghi ra mà không báo lỗi, mà một bản build sau đó tái dựng trung thực và thấy không đầy đủ. Không thông báo nào mang giá trị riêng, vì không thông báo nào liên quan đến một tài liệu bạn đã viết — mỗi thông báo nêu trục nào không thể tính được:

resolve: catalog lookup cannot load resolved sub-aggregate bodies (resolve: tra cứu catalog không thể tải nội dung sub-aggregate đã phân giải) resolve: catalog lookup cannot load resolved recipe and plugin bodies (resolve: tra cứu catalog không thể tải nội dung recipe và plugin đã phân giải)

Cách khắc phục: không có gì trong các tệp của bạn gây ra lỗi nào trong hai lỗi này, và không có thay đổi nào khi viết tài liệu giúp xóa được chúng — lỗi nằm ở cách bản build được nối dây chứ không phải ở thứ nó được yêu cầu build. Hãy báo cáo lỗi kèm lệnh bạn đã chạy và cấu hình workspace mà lệnh đó chạy trên.

An annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Một plugin annotation-transform chỉ định một component mà nó không được cung cấp, hoặc chèn một giá trị mà không annotation nào nhận)

Người vận hành có thể gắn một plugin quản trị ở vai trò thêm annotation, và việc gắn đó là một khai báo: người vận hành đã yêu cầu phép biến đổi, nên những gì plugin thêm vào là tường minh chứ không bị chèn vào sau lưng ai. Vai trò này bị giới hạn tương ứng. Plugin được trao các tọa độ component mà tài liệu của bạn khai báo, và có thể thêm annotation lên các tọa độ đó, mỗi annotation mang một giá trị mà bạn cũng có thể tự viết trên annotation đó: một chuỗi, hoặc một đối tượng gồm các khóa con. Cấu trúc mà nó trả về không chấp nhận trường nào khác, nên điều còn phải kiểm tra khi áp dụng đầu ra của nó là mọi lần chèn có chỉ định một tọa độ nó được trao hay không, và mọi giá trị có phải là giá trị mà một annotation nhận hay không.

Một lần chèn chỉ định một cặp boundary-và-component nằm ngoài tập đó sẽ dừng bản build. Một plugin chạm tới một component mà tài liệu của bạn chưa bao giờ phơi ra sẽ là đang cấu hình hạ tầng mà không ai khai báo, và các annotation nó thêm được mở rộng thành các phần gắn Feature y như các annotation được viết tay, nên hậu quả sẽ là các tài nguyên xuất hiện từ một component mà người vận hành không đặt trước nó.

Một lần chèn có giá trị là null, một danh sách, một số, một boolean, hoặc một đối tượng không có khóa con cũng làm dừng bản build. Null và đối tượng rỗng được đọc như giá trị bạn viết để cho một component thoát khỏi một annotation mà nó lẽ ra kế thừa, còn vai trò này chỉ thêm annotation chứ không xóa; các dạng còn lại không phải giá trị mà một annotation nhận. Toàn bộ đầu ra được kiểm tra trước khi bất kỳ phần nào của nó được áp dụng, nên một đầu ra bị từ chối không thay đổi gì.

Mỗi lần chèn được chấp nhận còn mang theo một annotation đi kèm, aggrega.ai/injected-by, chỉ định plugin đã thực hiện nó. Host viết annotation đó; plugin không thể tự cung cấp, nên những gì nó nói về nguồn gốc của một annotation được chèn không phải do plugin định đoạt.

Thông báo được phát ra, cho một tọa độ mà plugin không được trao và cho một giá trị mà không annotation nào nhận:

annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection targets boundary "<boundary>" component "<component>" (annotation "<key>") (đầu ra của plugin annotation-transform bị từ chối: một lần chèn nhắm tới một tọa độ component mà host không cung cấp, hoặc mang một giá trị không phải chuỗi hay đối tượng gồm các khóa con: lần chèn nhắm tới component đã nêu trong ranh giới đã nêu (annotation đã nêu)) annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys: injection for boundary "<boundary>" component "<component>" (annotation "<key>") carries a list; an injected annotation value is a string or an object of subkeys (đầu ra của plugin annotation-transform bị từ chối: một lần chèn nhắm tới một tọa độ component mà host không cung cấp, hoặc mang một giá trị không phải chuỗi hay đối tượng gồm các khóa con: lần chèn cho component đã nêu trong ranh giới đã nêu (annotation đã nêu) mang một danh sách; một giá trị annotation được chèn là một chuỗi hoặc một đối tượng gồm các khóa con)

Cách khắc phục: lỗi thuộc về plugin chứ không phải tài liệu của bạn — hãy sửa plugin để nó chỉ chèn lên các tọa độ được trao, mỗi tọa độ đều có trong đầu vào của nó, và chỉ dùng một chuỗi hoặc một đối tượng gồm các khóa con làm giá trị. Nếu component trong thông báo là component bạn mong plugin nhìn thấy, hãy kiểm tra rằng Release khai báo nó bên trong một boundary: chỉ các tọa độ component đã khai báo mới được trao đi. Gỡ phần gắn khỏi plugins.governance là cách tức thời để bỏ chặn bản build trong khi plugin được sửa.

A plugin reference is not a Plugin entity (Một tham chiếu plugin không phải là một thực thể Plugin)

Một plugin được tham chiếu qua thực thể Plugin của nó, luôn được giới hạn phạm vi theo loại socket của chính plugin: <pluginType>/<name>, có thể kèm phiên bản, như parser/yaml hoặc parser/yaml:1.0.0. Phạm vi là bắt buộc chứ không phải một dạng trong số nhiều dạng — một name:version không có phạm vi sẽ bị từ chối, vì hai socket có thể chứa plugin cùng tên và phạm vi là thứ làm cho thực thể có thể phân giải được. Tệp nhị phân mà thực thể trỏ tới được tiếp cận qua thực thể, không bao giờ được nêu tên trực tiếp, nên thực thể là nơi mang tuyên bố năng lực, các giới hạn runtime và tập lệnh đã ghi nhận mà bước nạp đối chiếu với tệp nhị phân. Vì vậy một tham chiếu không chỉ định thực thể Plugin nào thì không có gì để đối chiếu tệp nhị phân, và bản build dừng lại thay vì nạp các byte theo một tham chiếu chưa được kiểm tra.

Có hai dạng được báo ở đây, và chúng được kiểm tra vào các thời điểm khác nhau. Một tham chiếu mà dạng của nó không thể là một thực thể — một đường dẫn hệ thống tệp, hoặc một tham chiếu artifact như URL oci://, một .wasm trần, hay một digest @sha256: — bị từ chối ngay từ đầu trên các bề mặt chỉ nhận tham chiếu thực thể. Một tham chiếu chỉ định một thực thể mà không nơi nào chứa sẽ bị từ chối sau bước tra cứu, và nội dung thông báo phụ thuộc vào cách nó được viết: một URI thực thể Plugin — <pluginType>/<name>, có thể kèm phiên bản — được báo là một thực thể mà không thư mục catalog nào chứa, tệp nhị phân không mang theo và chưa lần pull nào tải về, còn mọi tham chiếu khác được yêu cầu dùng dạng đó. Cả hai dạng báo cùng một tình trạng, nên cách một bản build xử lý chúng là như nhau.

Một lần pull từ chối dạng thứ hai trước khi bản build gặp nó. Mọi Plugin mà pipeline của một Recipe hoặc FeatureRecipe nêu tên đều được phân giải cùng các phụ thuộc khác của Release — từ một thư mục catalog, bản sao bên trong tệp nhị phân của trình biên dịch, bộ nhớ đệm nội dung, hoặc một registry — và một Plugin mà không nguồn nào chứa sẽ dừng aggrega pull trước khi nó ghi lockfile, với tình trạng này và cùng thông báo, nêu tên Recipe hoặc FeatureRecipe có pipeline chỉ định nó.

Không phải bề mặt nào cũng từ chối dạng không phải thực thể. Bề mặt pipeline-plugin chỉ nhận tham chiếu thực thể; các bề mặt mà người vận hành gắn plugin trực tiếp chấp nhận mọi dạng và chuyển tham chiếu không phải thực thể đi để phân giải như một artifact. Vì vậy cùng một tham chiếu có thể được chấp nhận ở một điểm gắn và bị từ chối ở điểm khác, và sự khác biệt đó thuộc về bề mặt chứ không phải tham chiếu.

Các thông báo được phát ra. Một đường dẫn hệ thống tệp:

plugin reference is not a Plugin entity: "<reference>" is a filesystem path, but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (tham chiếu plugin không phải là một thực thể Plugin: “<reference>” là một đường dẫn hệ thống tệp, nhưng một pipeline plugin phải là một URI thực thể Plugin có phạm vi theo loại plugin (<pluginType>/<name>, có thể kèm phiên bản, như parser/yaml hoặc parser/yaml:1.0.0))

một tham chiếu artifact:

plugin reference is not a Plugin entity: "<reference>" is an artifact reference (an oci:// scheme, a bare .wasm, or an @sha256: digest), but a pipeline plugin must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0) (tham chiếu plugin không phải là một thực thể Plugin: “<reference>” là một tham chiếu artifact (một scheme oci://, một .wasm trần, hoặc một digest @sha256:), nhưng một pipeline plugin phải là một URI thực thể Plugin có phạm vi theo loại plugin (<pluginType>/<name>, có thể kèm phiên bản, như parser/yaml hoặc parser/yaml:1.0.0))

một URI thực thể Plugin mà không nơi nào chứa:

plugin reference is not a Plugin entity: "<reference>" is a Plugin entity URI, but no catalog directory holds the entity it names, the binary does not carry it, and no pull has fetched it into the content cache; place the Plugin entity in a catalog directory, or publish it to a registry and run aggrega pull (tham chiếu plugin không phải là một thực thể Plugin: “<reference>” là một URI thực thể Plugin, nhưng không thư mục catalog nào chứa thực thể mà nó chỉ định, binary không mang nó, và chưa có lần pull nào tải nó vào content cache; hãy đặt thực thể Plugin vào một thư mục catalog, hoặc phát hành nó lên một registry và chạy aggrega pull)

và mọi tham chiếu khác không chỉ định thực thể nào — tham chiếu không có phạm vi loại plugin, có nhiều hơn một / trước phiên bản, hoặc mang một registry host:

plugin reference is not a Plugin entity: "<reference>" must be a plugin-type-scoped Plugin entity URI (<pluginType>/<name>, optionally versioned, as in parser/yaml or parser/yaml:1.0.0); a bare .wasm reference or an artifact reference names no Plugin entity (tham chiếu plugin không phải là một thực thể Plugin: “<reference>” phải là một URI thực thể Plugin có phạm vi theo loại plugin (<pluginType>/<name>, có thể kèm phiên bản, như parser/yaml hoặc parser/yaml:1.0.0); một tham chiếu .wasm trần hoặc một tham chiếu artifact không chỉ định thực thể Plugin nào)

Cách khắc phục: viết tham chiếu dưới dạng danh tính có phạm vi theo loại socket của thực thể Plugin, có thể kèm phiên bản — <pluginType>/<name> hoặc <pluginType>/<name>:<version>. Nếu bạn đang trỏ trực tiếp tới một tệp hoặc một artifact, hãy phát hành hoặc viết một thực thể Plugin cho nó và tham chiếu thực thể đó — thực thể là nơi chứa các tuyên bố mà bước nạp kiểm tra, nên không có dạng tương đương nào bỏ qua nó. Nếu thông báo nói tham chiếu là một URI thực thể Plugin, dạng của nó đã đúng và thứ bị thiếu là thực thể: hãy đặt thực thể Plugin vào một thư mục catalog mà workspace liệt kê, cùng tệp .wasm đã build bên cạnh, hoặc phát hành plugin lên một registry mà workspace đọc và chạy aggrega pull, lệnh này tải nó vào bộ nhớ đệm nội dung — và kiểm tra rằng phiên bản bạn chỉ định là một phiên bản có tồn tại.

A cached signature bundle does not match the digest recorded for it (Gói chữ ký được lưu trong bộ nhớ đệm không khớp với digest được ghi lại cho nó)

Một artifact có chữ ký đã được xác minh khi được tải về sẽ mang thông tin đó theo trên mục lockfile của nó — hoặc, với một plugin được gắn ở vai trò phán quyết, trên mục của nó trong plugins-trust.yaml — dưới dạng một digest được ghi lại của tài liệu chữ ký, được lưu trong bộ nhớ đệm cạnh artifact. Trước khi bất cứ thứ gì được render, bản build đọc lại tài liệu đã lưu đệm đó cho mọi mục nó đọc có ghi lại một digest như vậy — một thực thể catalog thuộc bất kỳ loại nào, một thư viện, một plugin — và băm lại nó, và giá trị băm phải đúng là giá trị đã ghi. Một plugin mà lockfile ghim, và một plugin được gắn ở vai trò phán quyết, sẽ được kiểm tra lại tài liệu khi các byte của nó được nạp, và đó là điều áp dụng cho các lệnh nạp plugin bên ngoài một bản build — trong đó có aggrega lint --release và aggrega validate --release. Một gói bị thiếu, không đọc được, hoặc băm ra giá trị khác có nghĩa là tài liệu đã được xem xét không phải là thứ đang có trên đĩa hiện giờ, và lần chạy dừng lại thay vì dùng một artifact có bằng chứng chữ ký đã thay đổi bên dưới bản ghi.

Việc kiểm tra lại chỉ là so sánh giá trị băm, không hơn. Nó không xác minh lại chữ ký nào, không kết nối mạng và không tham khảo tài liệu tin cậy nào, nên nó vẫn đứng vững trong một bản build hoàn toàn không có truy cập mạng — đây là điều cho phép một artifact được xác minh một lần tiếp tục được coi là đã xác minh qua các bản build ngoại tuyến sau đó.

Lần pull tiếp theo sẽ sửa nó. Một lần pull áp cùng phép kiểm tra đó cho mọi mục mà bộ nhớ đệm nội dung đã cung cấp, và khi phép kiểm tra từ chối một mục, nó hỏi lại registry của artifact về chữ ký — bất kể yêu cầu ký nói gì, qua cùng quy trình xác minh mà một artifact nó tải về phải trải qua — ghi lại kết quả xác minh lên mục đó, và lưu đệm gói mà chữ ký chỉ đến, ghi đè một bản sao đã lưu đệm không còn khớp với digest của nó. Một plugin được gắn ở vai trò phán quyết được xác minh lại ở mọi lần pull bất kể mục của nó ghi gì, và gói của nó được lưu đệm theo cùng cách. Vì vậy thông báo cho một mục do bộ nhớ đệm nội dung cung cấp sẽ nêu tên lần pull đó. Một mục được đọc từ một thư mục catalog, từ bản sao bên trong binary của trình biên dịch hoặc từ bên cạnh Release không bao giờ được hỏi tại một registry, nên một lần pull để nguyên chữ ký được ghi trên nó, và thông báo của nó không nêu lần pull nào.

Các thông báo được phát ra, nêu tên artifact, tệp đã lưu đệm và — với một mục do bộ nhớ đệm nội dung cung cấp — lần pull sửa nó, tệp mà lần pull ghi chữ ký vào và Release mà nó pull. Từ phép kiểm tra của bản build, khi không đọc được hoặc bị thiếu:

artifact "<reference>": cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artifact: không đọc được gói chữ ký đã lưu trong bộ đệm: gói chữ ký đã lưu trong bộ đệm không khớp với digest đã ghi. Cách khắc phục: chạy lệnh pull cho Release để xác minh lại chữ ký của artifact tại registry của nó, ghi chữ ký vào tệp đã nêu và lưu vào bộ đệm gói mà chữ ký đó chỉ đến)

và khi bị lệch:

artifact "<reference>": cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (artifact: gói chữ ký đã lưu trong bộ đệm có digest khác với digest đã ghi: gói chữ ký đã lưu trong bộ đệm không khớp với digest đã ghi. Cách khắc phục: chạy lệnh pull cho Release để xác minh lại chữ ký của artifact tại registry của nó, ghi chữ ký vào tệp đã nêu và lưu vào bộ đệm gói mà chữ ký đó chỉ đến)

và, khi các byte của một plugin được nạp từ bộ nhớ đệm nội dung, nêu thêm nguồn gốc của chúng:

plugin "<reference>" resolved from <source>: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin được phân giải từ nguồn đã nêu: không đọc được gói chữ ký đã lưu trong bộ đệm: gói chữ ký đã lưu trong bộ đệm không khớp với digest đã ghi. Cách khắc phục: chạy lệnh pull cho Release để xác minh lại chữ ký của artifact tại registry của nó, ghi chữ ký vào tệp đã nêu và lưu vào bộ đệm gói mà chữ ký đó chỉ đến)

plugin "<reference>" resolved from <source>: cached signature bundle <path> has digest <actual>, recorded digest is <recorded>: cached signature bundle does not match its recorded digest. remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names (plugin được phân giải từ nguồn đã nêu: gói chữ ký đã lưu trong bộ đệm có digest khác với digest đã ghi: gói chữ ký đã lưu trong bộ đệm không khớp với digest đã ghi. Cách khắc phục: chạy lệnh pull cho Release để xác minh lại chữ ký của artifact tại registry của nó, ghi chữ ký vào tệp đã nêu và lưu vào bộ đệm gói mà chữ ký đó chỉ đến)

<file> là lockfile của Release, hoặc plugins-trust.yaml trong thư mục của Release. Với một mục không có lần pull nào hỏi đến, thông báo kết thúc trước remediation:.

Một lần pull không có registry để hỏi sẽ dừng lại. Một thực thể catalog hoặc một thư viện được nêu tên mà không có registry và được gắn với một registry thông qua default_registry của workspace. Khi workspace không nêu registry nào — nó đã nêu khi chữ ký được ghi lại, và nay không còn nữa — thì không có registry nào được cấu hình để hỏi lại về mục đó, nên lần pull dừng lại với tình trạng này thay vì ghi một lockfile mà bản build tiếp theo sẽ từ chối, và giữ nguyên lockfile như cũ. Thông báo của nó mang, sau bước mà lần pull đang thực hiện:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: cached signature bundle <path> is unreadable: cached signature bundle does not match its recorded digest (xác minh: tham chiếu ghi một chữ ký mà bản build không chấp nhận, và không có registry nào được cấu hình để hỏi lại về nó: không đọc được gói chữ ký đã lưu trong bộ đệm: gói chữ ký đã lưu trong bộ đệm không khớp với digest đã ghi)

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra lỗi này — bộ đệm là của build, không phải của bạn. Hãy chạy aggrega pull --release <release>, lệnh mà thông báo nêu tên: lệnh này xác minh lại chữ ký của artifact và ghi chữ ký cùng gói của nó, nhờ đó sửa được một gói đã bị xóa hoặc bị thay đổi kể từ lần pull đã lưu đệm nó. Ở chế độ ngoại tuyến, lần pull đó dừng lại — với lời từ chối ngoại tuyến, vì sửa chữa nghĩa là phải hỏi registry, hoặc, với một plugin được gắn ở vai trò phán quyết, trước đó nữa, khi nêu tên .wasm của plugin là tệp không phân giải được, vì một lần pull phân giải tệp .wasm đó từ registry của plugin; cho phép mạng trong riêng lần chạy đó sẽ sửa được lỗi. Khi lần pull dừng lại và báo rằng không có registry nào được cấu hình để hỏi về mục đó, hãy đặt default_registry thành registry mà artifact đã được pull về, rồi pull lại. Khi workspace bỏ qua việc xác minh chữ ký cho artifact, lần pull sẽ không ghi chữ ký nào lên mục đó, và build chấp nhận điều này theo cùng thiết lập ấy. Khi chữ ký mà registry cung cấp không xác minh được, lần pull dừng lại với lời từ chối của chính bước xác minh đó: chữ ký đã ghi và dữ liệu mà bên phát hành cung cấp thực sự không khớp nhau, và đó là vấn đề của người phát hành artifact. Với một mục mà thông báo không nêu lần pull nào — mục được đọc từ một thư mục catalog, từ bản sao bên trong binary của trình biên dịch hoặc từ cạnh Release — hãy xóa signature khỏi mục đó: một mục như vậy không bao giờ phải tuân theo yêu cầu ký, nên sau đó build sẽ tiếp tục.

A recorded signature was made for a different artifact (Chữ ký đã ghi được tạo cho một artifact khác)

Một chữ ký cho biết nó được tạo cho artifact nào. Khi một lần pull xác minh chữ ký của một artifact, nó ghi lại thông tin đó trên mục lockfile của artifact — hoặc, với một plugin được gắn ở vai trò phán quyết, trên mục của nó trong plugins-trust.yaml — và lưu đệm chữ ký đã xác minh. Trước khi bất cứ thứ gì được render, bản build đọc, từ chữ ký đã lưu đệm của mọi mục mà bộ đệm nội dung cung cấp, artifact mà chữ ký được tạo cho, và đó phải là artifact mà chính bản build đã đọc cho mục đó: artifact có manifest được giữ bên cạnh các byte của nó trong bộ đệm nội dung, không bao giờ là bất cứ thứ gì mục đó ghi lại. Một chữ ký được tạo cho một artifact khác sẽ dừng bản build. Đây là dấu hiệu của một signature được sao chép từ mục này sang mục khác: chữ ký đã lưu đệm mà nó trỏ tới vẫn nguyên vẹn — vẫn khớp với digest được ghi cho nó — và nó được tạo cho artifact của mục kia.

Điều này không phụ thuộc vào yêu cầu ký. Một chữ ký đã ghi luôn bị đối chiếu với điều nó khẳng định, dù có yêu cầu chữ ký hay không, giống như việc kiểm tra chữ ký đã lưu đệm có khớp với digest đã ghi của nó hay không.

Một plugin được kiểm tra theo cùng cách ở bất cứ nơi nào nó được nạp. Một plugin mà lockfile ghim, và một plugin được gắn ở vai trò phán quyết, có chữ ký đã ghi của nó được đối chiếu với artifact mà các byte của nó được đọc ra khi các byte đó được nạp từ bộ đệm nội dung, điều này áp dụng cho các lệnh nạp plugin bên ngoài một bản build — trong đó có aggrega lint --release và aggrega validate --release, cùng các thao tác tương tự được gọi qua aggrega serve và aggrega mcp.

Những gì bước kiểm tra đọc, và những gì nó không thể phân biệt. Nó đọc chữ ký đã lưu đệm và manifest bên cạnh artifact, rồi so sánh các hash: nó không xác minh chữ ký nào, không kết nối mạng và không tham khảo tài liệu tin cậy nào, nên nó vẫn hoạt động trong một bản build hoàn toàn không có truy cập mạng. Nó đọc artifact mà chữ ký được tạo cho ở cả hai dạng mà một lần pull chấp nhận — chữ ký được tạo trực tiếp trên artifact, là dạng mà các trình ký của chính toolchain tạo ra, và một tuyên bố có ký tên chỉ định artifact — nên một chữ ký sao chép từ mục này sang mục khác bị từ chối ở cả hai dạng. Đây cũng là cách đọc mà một lần pull áp dụng cho mọi chữ ký nó chấp nhận: lần pull từ chối một chữ ký xác minh được nhưng cách đọc này không thấy được tạo cho artifact, hoặc hoàn toàn không đọc được artifact từ đó, nên không có chữ ký nào do pull ghi lại mà bước kiểm tra không đọc được. Một mục được đọc từ một thư mục catalog, từ bản sao bên trong tệp nhị phân của trình biên dịch hoặc từ bên cạnh Release thì không có manifest, nên chữ ký đã ghi của nó chỉ bị đối chiếu với digest đã ghi; điều tương tự áp dụng cho một chữ ký được đặt thủ công vào bộ đệm ở dạng không thuộc hai dạng trên. Và vì không có chữ ký nào được xác minh, một chữ ký được ghi thủ công vào bộ đệm, lập cho chính artifact của mục đó, sẽ không được phân biệt với chữ ký mà một lần pull đã xác minh.

Lần pull tiếp theo sẽ sửa nó. Một lần pull áp cùng bước kiểm tra cho mọi mục mà bộ đệm nội dung cung cấp, và khi bước kiểm tra từ chối một mục, nó hỏi lại registry của artifact về chữ ký — bất kể yêu cầu ký nói gì — và ghi kết quả xác minh được lên mục đó thay cho chữ ký đã sao chép. Một plugin được gắn ở vai trò phán quyết được xác minh lại ở mỗi lần pull bất kể mục của nó ghi gì. Chỉ mục do bộ đệm nội dung cung cấp mới bị kiểm tra chữ ký được tạo cho artifact nào, nên mọi lần từ chối điều kiện này bởi một bản build hoặc một lần nạp plugin đều nêu tên lần pull đó.

Các thông báo được phát ra, nêu tên mục, tệp ghi chữ ký, chữ ký đã lưu đệm, manifest mà bản build đã đọc cho mục đó, và lần pull sửa lỗi. Từ bước kiểm tra của bản build:

artifact "<reference>": signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names

và, khi các byte của một plugin được nạp, nêu thêm nguồn gốc của chúng:

plugin "<reference>" resolved from <source>: signing: the recorded signature was made for a different artifact (<file> records it, cached signature bundle <path>, the artifact read has manifest <manifest-digest>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry again, record it in <file> and cache the bundle it names

<file> là lockfile của Release, hoặc plugins-trust.yaml trong thư mục của Release.

Một lần pull không có registry để hỏi thì sẽ dừng lại, giống như với một gói chữ ký đã lưu đệm không còn khớp với digest của nó: khi một thực thể catalog hoặc một thư viện mang chữ ký sao chép và workspace không còn chỉ định default_registry để gắn nó vào, lần pull dừng với điều kiện này và giữ nguyên lockfile. Thông báo của nó mang, sau bước mà lần pull đang thực hiện:

verify: "<reference>" records a signature a build does not accept, and no registry is configured to ask about it again: signing: the recorded signature was made for a different artifact (cached signature bundle <path>, the artifact read has manifest <manifest-digest>)

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra lỗi này — chữ ký mà mục đó ghi thuộc về một artifact khác. Chạy aggrega pull --release <release>, lệnh mà thông báo nêu tên: nó xác minh chữ ký riêng của mục tại registry và ghi chữ ký đó thay cho chữ ký đã sao chép, áp dụng cho cả mục lockfile lẫn plugin được gắn ở vai trò phán quyết. Khôi phục chữ ký đã ghi của chính mục đó từ hệ thống quản lý phiên bản, nếu tệp đã được commit, cũng có tác dụng. Ở chế độ ngoại tuyến, lần pull sẽ dừng — với lời từ chối ngoại tuyến, vì sửa lỗi nghĩa là phải hỏi registry, hoặc, với một plugin được gắn ở vai trò phán quyết, trước đó, nêu tệp .wasm của plugin là tệp nó không phân giải được, vì một lần pull phân giải .wasm đó từ registry của plugin; cho phép mạng trong một lần chạy đó sẽ sửa được lỗi. Khi lần pull dừng và báo rằng không có registry nào được cấu hình để hỏi về mục đó, hãy đặt default_registry thành registry mà artifact đã được pull từ đó, rồi pull lại. Khi workspace bỏ qua xác minh chữ ký cho artifact, lần pull thay vào đó không ghi chữ ký nào lên mục, điều mà bản build chấp nhận theo cùng thiết lập đó.

No verified signature is recorded for an artifact that requires one (Không có chữ ký đã xác minh nào được ghi lại cho một artifact yêu cầu chữ ký)

Một lần pull tải một artifact từ registry sẽ xác minh chữ ký của nó theo chính sách tin cậy của registry đó và ghi lại sự kiện đã xác minh vào mục lockfile của artifact. Một build không truy cập registry nào, nên nó đọc sự kiện đã ghi thay vì xác minh lại — và trước khi bất cứ thứ gì được render, nó đối chiếu mọi mục nó đọc với yêu cầu mà lần pull đã áp dụng khi tải artifact. Một mục do content cache cung cấp, cho một artifact cần có chữ ký, mà không ghi chữ ký đã xác minh nào sẽ dừng build: không có gì build nắm giữ cho biết artifact mà nó sắp render từ đó đã từng được xác minh.

Yêu cầu là của lần pull, theo từng thiết lập. Chữ ký được yêu cầu khi chính sách ký trên toàn workspace bao gồm loại của artifact, hoặc khi mục riêng của registry trong .aggrega-config.yaml — hoặc, với hub.aggrega.ai không có mục riêng, chính sách tích hợp sẵn của hub chính thức — yêu cầu chữ ký; một artifact không xác định được loại được tính là bắt buộc dưới một chính sách đang hoạt động. Những gì cho phép một lần pull chấp nhận một artifact không có chữ ký cũng cho phép build chấp nhận mục của nó: skip_signature_verification ở cấp cao nhất, cùng công tắc đó trên mục riêng của registry ngoại trừ với một loại mà chính sách toàn workspace yêu cầu, và một registry được đánh dấu advisory.

Nguồn gốc của một mục được đọc từ build, không bao giờ từ lockfile. Mọi mục do content cache cung cấp đều bị kiểm tra, bất kể mục đó ghi gì khác, nên việc xóa manifest digest của một mục cùng với chữ ký của nó không miễn trừ được nó. Một mục được đọc từ một thư mục catalog, từ bản sao bên trong binary của trình biên dịch, hoặc từ bên cạnh Release thì không bao giờ bị kiểm tra, vì không tồn tại chữ ký registry cho các byte không đến từ registry. Các mục của mọi phần đều được kiểm tra như nhau — catalog entity, thư viện và artifact của plugin — và mọi mục bị kiểm tra từ chối đều được nêu tên trong cùng một lần chạy.

Một plugin được gắn ở vai trò verdict cũng bị cùng phép kiểm tra đó, thông qua plugins-trust.yaml. Một attachment plugins.governance ở vai trò ir-verdict hoặc render-verdict, và mọi attachment plugins.linter, không định hình byte nào được render, nên nó không có mục lockfile; bản ghi bên cạnh lockfile mang chữ ký đã xác minh của nó thay vào đó. Mỗi plugin như vậy mà build đọc từ content cache đều bị đối chiếu với cùng yêu cầu, qua cùng các thiết lập: một mục trong bản ghi đó không ghi chữ ký nào sẽ dừng build, và việc không có mục nào cho plugin cũng vậy — xóa bản ghi không miễn trừ được nó. Một plugin được cung cấp từ một thư mục catalog hoặc từ bản sao bên trong binary của trình biên dịch thì không bị kiểm tra. Yêu cầu áp dụng cho plugin như vậy ở bất cứ nơi nào nó được nạp cho một Release, không chỉ trong build: aggrega lint --release và aggrega validate --release, cùng các thao tác tương tự thực hiện qua aggrega serve và aggrega mcp, đều thất bại với điều kiện này khi chúng nạp nó.

Các thông báo được phát ra, nêu tên mục, tệp không ghi chữ ký cho mục đó, các thiết lập yêu cầu chữ ký của nó và lệnh ghi chữ ký vào tệp đó. Với một mục lockfile, nêu tên lockfile:

signing: no verified signature is recorded for an artifact that requires one ("<reference>", <lockfile-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the artifact’s signature at its registry and record it in <lockfile-path> (signing: không có chữ ký đã xác minh nào được ghi cho một artifact yêu cầu chữ ký (“<reference>”, <lockfile-path> không ghi chữ ký nào cho nó, được yêu cầu bởi <the settings that require it>). cách khắc phục: chạy aggrega pull —release <release> để xác minh chữ ký của artifact tại registry của nó và ghi nó vào <lockfile-path>)

và với một plugin được gắn ở vai trò verdict, nêu tên bản ghi của nó:

signing: no verified signature is recorded for an artifact that requires one ("<plugin>", <record-path> records no signature for it, required by <the settings that require it>). remediation: run aggrega pull --release <release> to verify the plugin’s signature at its registry and record it in <record-path> (signing: không có chữ ký đã xác minh nào được ghi cho một artifact yêu cầu chữ ký (“<plugin>”, <record-path> không ghi chữ ký nào cho nó, được yêu cầu bởi <the settings that require it>). cách khắc phục: chạy aggrega pull —release <release> để xác minh chữ ký của plugin tại registry của nó và ghi nó vào <record-path>)

Cả hai tệp đều được nêu bằng đường dẫn của chúng bên cạnh Release mà lệnh được cung cấp: <lockfile-path> là lockfile của Release, và <record-path> là plugins-trust.yaml trong thư mục của Release.

Các thiết lập được nêu bằng chính ngôn từ của tệp cấu hình: `signing.required` at the top level of the workspace configuration, `signing.required` on the `registries` entry for "<host>", hoặc the official hub's built-in signature requirement for "hub.aggrega.ai", được nối với nhau khi có nhiều hơn một thiết lập áp dụng.

Cách khắc phục: chạy lần pull mà thông báo nêu tên. Với một mục do content cache cung cấp mà không ghi chữ ký nào trong khi cần có chữ ký, lần pull hỏi registry của artifact về chữ ký của nó, theo manifest digest mà mục đó ghi, đúng như cách nó làm với một artifact nó tải về, và ghi chữ ký đã xác minh lên mục đó — nên build tiếp theo sẽ đọc được. Một plugin được gắn ở vai trò verdict dù sao cũng được hỏi ở mỗi lần pull, và lần pull ghi những gì nó đã xác minh lên mục của plugin trong plugins-trust.yaml, tạo mục đó nếu chưa có. Một registry không gắn chữ ký nào, hoặc gắn một chữ ký mà cấu hình tin cậy không chấp nhận, sẽ khiến lần pull đó dừng lại thay vào đó, nêu tên artifact, và đó là vấn đề cần hỏi bên phát hành nó. Ở chế độ offline, lần pull không thể hỏi: với một mục lockfile, nó từ chối và nêu cách cho phép mạng trong một lần chạy, còn với một plugin được gắn ở vai trò verdict, nó dừng trước khi hỏi, nêu tên .wasm của plugin là một tệp nó không thể resolve, vì một lần pull resolve .wasm đó từ registry của plugin. Khôi phục chữ ký đã ghi của mục từ hệ thống quản lý phiên bản sẽ xử lý được lỗi mà không cần mạng, nếu cache vẫn còn giữ dữ liệu chữ ký mà bản ghi đó nêu tên. Khi artifact không được dự định để ký, yêu cầu mới là thứ cần thay đổi, và thông báo nêu rõ đó là thiết lập nào — nhưng nới lỏng nó nghĩa là các artifact của registry đó cũng không còn được kiểm tra khi pull nữa, nên hãy ưu tiên thu hẹp các loại của chính sách toàn workspace thay vì tắt hẳn một yêu cầu.

A recorded signature is not the one a pull would record (Chữ ký đã ghi không phải là chữ ký mà một lần pull sẽ ghi)

aggrega pull --verify báo cáo liệu việc chạy aggrega pull lúc này có làm thay đổi các tệp mà một lần pull commit hay không, và chữ ký mà một lần pull đã xác minh cho một artifact là một phần của những gì nó ghi: signature trên một mục lockfile, và trên một mục của plugins-trust.yaml đối với plugin được gắn ở vai trò verdict. Điều kiện này là những gì một lần verify báo cáo cho mỗi chữ ký đã ghi mà một lần pull thông thường sẽ ghi khác đi — một chữ ký nó sẽ ghi ở nơi chưa có chữ ký nào được ghi, một chữ ký nó sẽ thay thế, hoặc một chữ ký nó sẽ xóa. Lần verify không ghi tệp nào, và nêu tên mọi mục như vậy, ở cả hai tệp, trong cùng một lần chạy.

Hai loại mục lockfile được báo cáo mà không cần hỏi registry, vì một lần pull ghi lại chúng bất kể registry trả lời thế nào, nên chúng cũng được báo cáo ở chế độ offline: một mục do content cache phục vụ mà không ghi chữ ký nào trong khi cấu hình tin cậy yêu cầu một chữ ký — lần pull ghi chữ ký của artifact, hoặc dừng lại nếu không xác lập được chữ ký — và một mục có chữ ký đã ghi được tạo cho một artifact khác, mà lần pull thay bằng chữ ký của chính artifact đó.

Mọi mục khác mà một lần pull sẽ tra cứu lại đều được hỏi, vì chỉ câu trả lời của registry mới cho biết lần pull có thay đổi nó hay không: một mục có các byte được lần verify tải về vì content cache không chứa chúng, và một mục có signature bundle đã cache bị xóa, không đọc được hoặc đã bị thay đổi. Lần verify hỏi registry như lần pull sẽ hỏi, báo cáo mục đó khi câu trả lời ghi, thay thế hoặc xóa chữ ký của nó, và cache bundle mà nó đã xác minh giống như một lần pull cache. Ở chế độ offline, một mục như vậy không được hỏi và không được báo cáo: lần verify in ra một dòng nêu tên mục đó và cho biết chữ ký của nó chưa được kiểm tra.

Đối với bản ghi tin cậy plugin, mỗi lần pull đều xác minh chữ ký của từng plugin được gắn ở vai trò verdict tại registry của nó, và một lần verify cũng vậy: một mục mà việc xác minh đó sẽ ghi, thay thế hoặc xóa chữ ký sẽ được báo cáo, và một plugin mà bản ghi không có mục nào cho nó cũng vậy nếu một build từ chối nó vì không ghi chữ ký, vì một lần pull ghi một mục mang chữ ký của nó và build từ chối plugin cho đến lúc đó. Bất kỳ plugin nào khác mà bản ghi chưa chứa là lần xuất hiện đầu tiên và không được báo cáo. Ở chế độ offline, một lần verify không hỏi registry nào về các plugin này: nó đọc từng plugin từ content cache, như một build đọc, và đối chiếu danh tính và các host function của nó như một lần verify có kết nối. Nó báo cáo mà không cần hỏi một plugin mà build từ chối vì không ghi chữ ký — mục của nó không ghi chữ ký nào, hoặc bản ghi không có mục nào cho nó — và một plugin mà build từ chối vì chữ ký mà mục của nó ghi được tạo cho một artifact khác, vì một lần pull ghi lại mục đó bất kể registry trả lời thế nào; nó in ra một dòng nêu tên mọi mục khác và cho biết chữ ký của chúng chưa được kiểm tra.

Các dấu deprecation không được so sánh. Một dấu được gắn vào artifact sau lần pull là trạng thái của registry và thay đổi mà không có gì trong workspace thay đổi, nên một lần verify thất bại vì nó sẽ làm hỏng một bước kiểm tra trên các tệp không ai động đến — đó là lý do một dấu đã ghi chỉ khuyến cáo build chứ không dừng nó lại.

Các thông báo được phát ra, mỗi mục một thông báo, nêu tên mục, tệp và những gì tệp ghi, những gì một lần pull sẽ ghi thay vào đó, và lần pull đưa tệp về trạng thái cập nhật. Khi câu trả lời của registry, hoặc việc xác minh của chính bản ghi, cho biết chữ ký mà một lần pull sẽ ghi:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: chữ ký đã ghi không phải là chữ ký mà một lần pull sẽ ghi (“<reference>”, <file> ghi <signature>, một lần pull sẽ ghi <signature>). Cách khắc phục: chạy aggrega pull —release <release> để cập nhật <file>)

đối với một mục không ghi chữ ký nào trong khi cần có một chữ ký — một mục lockfile, hoặc, ở chế độ offline, một mục của bản ghi tin cậy plugin:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records no signature, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: chữ ký đã ghi không phải là chữ ký mà một lần pull sẽ ghi (“<reference>”, <file> không ghi chữ ký nào, một lần pull sẽ yêu cầu registry của nó cung cấp chữ ký mà một yêu cầu đòi hỏi và ghi lại). Cách khắc phục: chạy aggrega pull —release <release> để cập nhật <file>)

đối với một mục có chữ ký đã ghi được tạo cho một artifact khác — một mục lockfile, hoặc, ở chế độ offline, một mục của bản ghi tin cậy plugin:

signing: a recorded signature is not the one a pull would record ("<reference>", <file> records <signature>, made for another artifact, a pull would ask its registry for this artifact’s own signature and record it). remediation: run aggrega pull --release <release> to bring <file> up to date (signing: chữ ký đã ghi không phải là chữ ký mà một lần pull sẽ ghi (“<reference>”, <file> ghi <signature>, được tạo cho một artifact khác, một lần pull sẽ yêu cầu registry của nó cung cấp chữ ký riêng của artifact này và ghi lại). Cách khắc phục: chạy aggrega pull —release <release> để cập nhật <file>)

và đối với một plugin mà bản ghi không có mục nào cho nó, khi một build từ chối nó vì không ghi chữ ký — dạng thứ hai áp dụng ở chế độ offline, khi lần verify không hỏi registry nào:

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would record <signature>). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: chữ ký đã ghi không phải là chữ ký mà một lần pull sẽ ghi (“<plugin>”, <record-path> không ghi mục nào cho nó và nó cần có chữ ký, một lần pull sẽ ghi <signature>). Cách khắc phục: chạy aggrega pull —release <release> để cập nhật <record-path>)

signing: a recorded signature is not the one a pull would record ("<plugin>", <record-path> records no entry for it and a signature is required for it, a pull would ask its registry for the signature a requirement asks for and record it). remediation: run aggrega pull --release <release> to bring <record-path> up to date (signing: chữ ký đã ghi không phải là chữ ký mà một lần pull sẽ ghi (“<plugin>”, <record-path> không ghi mục nào cho nó và nó cần có chữ ký, một lần pull sẽ yêu cầu registry của nó cung cấp chữ ký mà một yêu cầu đòi hỏi và ghi lại). Cách khắc phục: chạy aggrega pull —release <release> để cập nhật <record-path>)

<signature> mô tả một chữ ký theo chế độ, người ký và digest của bundle của nó — a keyed signature by keyed:sha256:<fingerprint> with bundle digest sha256:<digest>, với issued by <issuer> sau người ký đối với chữ ký keyless — hoặc là no signature. <file> là lockfile của Release, <lockfile-path>, hoặc plugins-trust.yaml trong thư mục của Release, <record-path>.

Cách khắc phục: chạy lần pull mà thông báo nêu tên. Nó ghi vào tệp được nêu chữ ký mà thông báo nói nó sẽ ghi, và cache bundle của chữ ký đó, nên lần verify tiếp theo sẽ thành công. Khi thông báo nói một lần pull sẽ hỏi registry, lần pull ghi những gì registry xác minh — và thay vào đó dừng lại, nêu tên artifact, khi registry gắn một chữ ký mà cấu hình tin cậy không chấp nhận, hoặc không gắn chữ ký nào trong khi cần có, đây là vấn đề cần hỏi bên phát hành nó. Ở chế độ offline, lần pull đó dừng lại: với một mục lockfile thì bằng lời từ chối offline, vì nó phải hỏi registry, và với một plugin được gắn ở vai trò verdict thì dừng trước đó, nêu tên .wasm của plugin là một tệp nó không thể resolve, vì một lần pull resolve .wasm đó từ registry của plugin. Cho phép mạng cho riêng lần chạy đó sẽ cập nhật tệp. Khi thông báo nói một lần pull sẽ không ghi chữ ký nào, registry không còn gắn chữ ký và không có gì yêu cầu nó: lần pull xóa chữ ký của mục, điều mà build chấp nhận theo cùng các thiết lập — nếu bạn không ngờ registry ngừng ký artifact, đó cũng là vấn đề cần hỏi bên phát hành.

A plugin’s .wasm is not on this machine (.wasm của plugin không có trên máy này)

.wasm của một plugin được đọc từ một trong bốn nơi, theo thứ tự sau: các plugin được tích hợp sẵn trong tệp nhị phân của trình biên dịch, một tệp nằm cạnh thực thể Plugin của plugin trong một thư mục catalog, một đường dẫn hệ thống tệp tường minh mà tham chiếu nêu ra, và bộ nhớ đệm nội dung của workspace mà aggrega pull nạp vào. Việc phân giải một plugin chỉ đọc những gì đã có sẵn trên máy và không tải về gì cả, nên điều kiện này báo rằng không nơi nào trong bốn nơi đó chứa các byte — chứ không phải một lần tải về đã thất bại. Có một plugin là ngoại lệ: một core importer mà một lần import cần đến. Module của nó chỉ được đọc từ tệp nhị phân hoặc bộ nhớ đệm nội dung, không bao giờ từ cạnh một thực thể catalog, và khi cả hai đều không chứa nó, lần import sẽ tải nó về một lần từ registry mặc định của workspace; khi đó điều kiện còn báo thêm rằng việc tải về cũng không thực hiện được — workspace đang ngoại tuyến, registry của nó không thể kết nối được hoặc không chứa module, hoặc workspace không nêu registry mặc định nào. Một module đã được tải về nhưng không xác minh được sẽ bị từ chối theo điều kiện riêng của nó, là sai lệch digest hoặc từ chối chữ ký, và không có gì được giữ lại.

Tệp nằm cạnh thực thể được đặt tên theo loại plugin và tên của thực thể, và thông báo từ chối của pull bên dưới cho biết tên đó: với pipeline-step/patch, tên là pipeline-step--patch.wasm, trong thư mục chứa tài liệu của thực thể.

Một thực thể Plugin được viết trong một thư mục catalog của bạn sẽ bị từ chối khi pull phân giải nó. Một lần pull không bao giờ tải về .wasm của một thực thể như vậy: nó tìm trong bốn nơi nêu trên, đúng những nơi một bản build tìm. Một bước pipeline, một provider hoặc một plugin được gắn ở vai trò verdict hoàn toàn không được ghim, và một bản build luôn đọc thực thể của nó từ thư mục catalog. Một plugin được gắn ở vai trò transform thì được ghim, vì các byte của nó định hình đầu ra được kết xuất: pull ghi lại thực thể của nó và digest nội dung của .wasm tìm thấy ở đó, và một bản build sẽ từ chối một .wasm không còn khớp. Vì vậy, một lần pull không tìm thấy artifact ở nơi nào trong bốn nơi sẽ dừng ngay tại đó, trước khi ghi lockfile hay bất kỳ entity.lock nào, thay vì để một bản build thất bại sau này, ở bước nạp plugin. Một .wasm mà tệp nhị phân mang theo, hoặc đã có trong bộ nhớ đệm nội dung, đáp ứng pull đúng như nó đáp ứng bản build, nên một thực thể cho plugin đi kèm trong trình biên dịch không cần tệp nào bên cạnh.

Các thông báo được phát ra. Thông báo từ chối của pull, chỉ tới thư mục mà nó mong đợi chứa tệp, kèm theo phương án phân giải nó đã hỏi ở bên dưới:

plugin artifact not found on this machine (Plugin entity "<reference>" is authored in a catalog directory, expected <file> in <directory>). Place the built .wasm beside the entity under that name, or publish the plugin and reference the published Plugin entity instead of the one in the catalog directory (không tìm thấy artifact của plugin trên máy này (thực thể Plugin “<reference>” được soạn trong một thư mục catalog, cần có <file> trong <directory>). Hãy đặt tệp .wasm đã build cạnh thực thể với tên đó, hoặc xuất bản plugin và tham chiếu thực thể Plugin đã xuất bản thay cho thực thể trong thư mục catalog)

một plugin mà một bản build hoặc một lần import nạp vào nhưng không có nguồn nào chứa các byte của nó — và một plugin được gắn ở vai trò verdict mà aggrega pull --verify trong chế độ ngoại tuyến đọc từ bộ nhớ đệm nội dung như một bản build. Khi thực thể Plugin của plugin nằm trong một thư mục catalog, thông báo nêu phiên bản của nó và nơi module của nó cần được đặt:

plugin "<reference>" at version <version> is not on this machine; place its module, named <file>, beside its Plugin entity in <directory>: plugin artifact not found on this machine (plugin ở phiên bản đã nêu không có trên máy này; hãy đặt module của nó, với tên tệp đã nêu, cạnh thực thể Plugin của nó trong thư mục đã nêu: không tìm thấy artifact của plugin trên máy này)

và trong các trường hợp khác, nêu từng nơi đã tìm module:

plugin "<reference>" is not on this machine: the binary does not carry its module, no catalog folder holds its Plugin entity and the content cache a pull fetches into does not hold it: plugin artifact not found on this machine (plugin không có trên máy này: tệp nhị phân không mang module của nó, không thư mục catalog nào chứa thực thể Plugin của nó và bộ nhớ đệm nội dung mà một lần pull tải vào cũng không chứa nó: không tìm thấy artifact của plugin trên máy này)

Một lần lint, vốn chỉ tìm trong tệp nhị phân, chỉ nêu nơi đầu tiên trong số đó.

và tương tự cho một tham chiếu được viết dưới dạng vị trí registry:

plugin "<reference>" not resolvable: an OCI plugin URI requires a prior aggrega pull --release <release> (so its bytes are cached) or an explicit local path; plugin resolution does not fetch from a registry: plugin artifact not found on this machine (không thể phân giải plugin “<reference>”: một URI plugin OCI cần chạy aggrega pull —release <release> trước đó (để các byte của nó được lưu vào cache) hoặc một đường dẫn cục bộ tường minh; việc phân giải plugin không tải về từ registry: không tìm thấy artifact của plugin trên máy này)

một core importer mà một lần import không đọc được cũng không tải về được, nêu tên importer, phiên bản của nó và lý do — ở đây là workspace đang ngoại tuyến — rồi đến cách đưa module của nó lên máy:

core importer "<importer>" at version <version> is not on this machine, and the workspace is offline, so its registry <host> is not asked for it; run the import once with the network available, which fetches it from the workspace’s default registry, verifies it and keeps it in the content cache for every later import, or place its module, named <file>, beside a Plugin entity of <importer> at <version> in a catalog folder: plugin artifact not found on this machine (core importer “<importer>” ở phiên bản <version> không có trên máy này, và workspace đang ngoại tuyến, nên registry <host> của nó không được hỏi; hãy chạy import một lần khi có mạng, lần chạy đó sẽ tải nó từ registry mặc định của workspace, xác minh và giữ nó trong content cache cho mọi lần import sau, hoặc đặt module của nó, có tên <file>, cạnh một thực thể Plugin của <importer> ở <version> trong một thư mục catalog: không tìm thấy artifact của plugin trên máy này)

Các lý do khác là its registry <host> could not be reached (<cause>), its registry <host> holds no <location>:<version> và the workspace names no default registry to fetch it from; hai lý do sau chỉ nêu biện pháp thứ hai, vì một lần chạy khi có mạng cũng không thay đổi được chúng.

Cách khắc phục: khi thực thể là thực thể do bạn viết, hãy build plugin và đặt .wasm của nó cạnh thực thể với tên mà thông báo đưa ra — hoặc xuất bản plugin bằng aggrega push và tham chiếu thực thể đã xuất bản thay cho bản sao trong catalog, vì cả pull lẫn build đều không tải về .wasm của một thực thể trong catalog của bạn. Khi plugin là plugin bạn dùng từ một registry, hãy chạy aggrega pull cho release đó, lệnh này sẽ lưu đệm nó. Khi bạn mong đợi trình biên dịch tự mang theo plugin, hãy kiểm tra xem tệp nhị phân bạn đang chạy có mang theo không: aggrega plugin list liệt kê các plugin được tích hợp sẵn. Khi đó là một core importer, hãy chạy import một lần ở nơi workspace có thể kết nối tới registry mặc định của nó — lần chạy đó tải về, xác minh và lưu đệm nó, và mọi lần import sau đều ngoại tuyến — hoặc, khi registry đó không chứa nó, hãy đặt module của nó cạnh một thực thể Plugin của importer đó ở phiên bản đó trong một thư mục catalog, với tên mà thông báo đưa ra; khi đó thực thể này sẽ chạy thay cho core importer.

A plugin recorded as a trusted gate is no longer attached (Một plugin được ghi nhận là cổng tin cậy không còn được gắn nữa)

Một plugin trả về phán quyết chấp nhận hoặc từ chối đối với một bản build sẽ được ghi nhận sau khi nó được phân giải, để workspace lưu giữ một bản ghi về những cổng nào đã được xem xét. Điều kiện này là thứ được báo cáo khi một cổng đã ghi nhận không còn được gì gắn vào nữa. Lý do nó dừng bản build thay vì lặng lẽ cho qua là vì nếu không, đầu ra của nó sẽ không thể phân biệt được với đầu ra mà cổng đã phê duyệt: một bản build vắng cổng một cách lặng lẽ và một bản build được cổng cho qua tạo ra cùng các tệp, và không ai xem xét kết quả có thể biết mình đang cầm cái nào.

Đây là một câu hỏi khác với một plugin có các byte đã bị thay đổi. Trường hợp đó từ chối chạy một plugin không phải là plugin đã được xem xét — một câu hỏi về danh tính. Trường hợp này từ chối build khi một cổng đã được xem xét hoàn toàn vắng mặt — một câu hỏi về sự hiện diện. Do đó các cách khắc phục khác nhau: khôi phục artifact, so với khôi phục việc gắn.

Điều nó xác lập, và điều nó không xác lập. Việc đối chiếu cấu hình với bản ghi xác lập rằng mọi cổng đã ghi nhận vẫn được gắn và artifact của mỗi cổng là artifact đã ghi nhận. Nó không xác lập gì về việc một cổng được gắn có trả về phán quyết hay không: một lần gắn có hàm entry chỉ đến một export đã khai báo nhưng không trả về phán quyết nào vẫn chạy, không báo cáo gì và cho bản build đi qua, và không phép so sánh nào với bản ghi nhận ra điều đó — plugin đã chạy chính xác là plugin đã ghi nhận và nó chỉ đơn giản là không chạy gì cả. Hai trường hợp lân cận thì có dừng bản build, và chúng được nêu ra để giới hạn này không bị hiểu là rộng hơn thực tế: một hàm entry chỉ đến một export mà plugin không khai báo sẽ bị từ chối khi plugin được tải, và một đầu ra mang một khóa mà dạng phán quyết không khai báo sẽ bị từ chối thay vì được đọc như một danh sách phán quyết rỗng.

Thông báo được phát ra, nêu tên bản ghi, các cổng bị bỏ và cả hai cách khắc phục:

a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role: <record-path> records <plugin> as trusted, but no verdict attachment in the workspace configuration names it; a gate that was reviewed and is now absent leaves output indistinguishable from output that gate approved. Attach the plugin again under plugins.governance at an ir-verdict or render-verdict role, or under plugins.linter; or, if it was meant to go, run aggrega pull --upgrade --release <release> <plugin> to drop it from the record — an ordinary aggrega pull leaves the record as it is, so only an explicit upgrade removes an entry (một plugin được ghi nhận là tin cậy cho một phán quyết chấp nhận hoặc từ chối không còn được gắn ở bất kỳ vai trò phán quyết nào: <record-path> ghi nhận <plugin> là tin cậy, nhưng không có lần gắn phán quyết nào trong cấu hình workspace nêu tên nó; một cổng đã được xem xét mà nay vắng mặt sẽ để lại đầu ra không thể phân biệt với đầu ra mà cổng đó đã chấp thuận. Hãy gắn lại plugin dưới plugins.governance ở vai trò ir-verdict hoặc render-verdict, hoặc dưới plugins.linter; hoặc, nếu nó vốn được dự định bỏ đi, hãy chạy aggrega pull —upgrade —release <release> <plugin> để loại nó khỏi bản ghi — một lệnh aggrega pull thông thường giữ nguyên bản ghi, nên chỉ một lần nâng cấp tường minh mới xóa một mục)

Khi có nhiều hơn một cổng bị bỏ, chúng được nêu tên cùng nhau trên một lệnh nâng cấp thay vì mỗi cổng một lệnh: một lần nâng cấp có mục tiêu nhận nhiều mục tiêu và giữ nguyên mọi pin mà nó không nêu tên, nên việc nêu tên chúng cùng nhau vừa ngắn hơn vừa hẹp hơn so với lần làm mới toàn bộ mà phương án thay thế sẽ cần.

Cách khắc phục: thông báo đưa ra hai cách khắc phục vì chỉ bạn biết cách nào áp dụng. Nếu cổng bị gỡ do nhầm lẫn, hãy gắn lại plugin dưới plugins.governance ở một vai trò phán quyết, hoặc dưới plugins.linter. Nếu nó được định bỏ đi, hãy nói rõ điều đó bằng lần nâng cấp có mục tiêu mà thông báo nêu ra, đó là thứ bỏ mục của nó. Đừng sửa hoặc xóa bản ghi để gỡ lỗi này — nó là một bản ghi đã commit về những gì đã được xem xét, và một lần pull thông thường cố ý giữ nguyên nó, vì việc chấp nhận một lần gỡ bỏ một cách lặng lẽ chính là điều mà sự từ chối này tồn tại để ngăn chặn.

A gate recorded as trusted resolves to a different identity (Một cổng được ghi nhận là tin cậy phân giải thành một danh tính khác)

Một plugin trả về phán quyết chấp nhận hoặc từ chối đối với một bản build sẽ được ghi nhận sau khi nó được phân giải, cùng với phiên bản và digest artifact mà nó phân giải thành. Điều kiện này là thứ một lần phân giải sau đó báo cáo khi nó đạt tới một phiên bản khác hoặc các byte khác cho một cổng mà bản ghi đã lưu giữ, và lần chạy không hề yêu cầu tiếp nhận danh tính đó.

Một điều kiện bao gồm cả phiên bản bị thay đổi lẫn byte bị thay đổi, vì bản ghi được định địa chỉ theo danh tính của plugin và mang phiên bản cùng digest như các trường của một mục: so sánh một lần phân giải với nó là một phép so sánh duy nhất với một kết quả duy nhất. Một lần phát hành lại không thay đổi byte nào và một lần push lại ở cùng phiên bản là cùng một sự kiện đối với người xem xét — danh tính không còn là danh tính đã được xem xét.

Đây là một câu hỏi khác với một cổng đã ghi nhận mà không còn gì gắn vào nữa, vốn là câu hỏi về sự hiện diện chứ không phải về danh tính. Nó cũng khác với một plugin có các byte đã cache không khớp với digest đã ghi nhận: trường hợp đó từ chối chạy một plugin không phải là plugin đã được xem xét, và cách khắc phục là khôi phục hoặc ghi nhận lại artifact, còn trường hợp này từ chối tiếp nhận một danh tính mới khi không được yêu cầu, và cách khắc phục là nêu tên plugin trong một lần nâng cấp. Hai cách khắc phục, hai điều kiện.

Yêu cầu danh tính mới là điều mà pull đã cung cấp sẵn, và có hai cách để yêu cầu. Một lần làm mới toàn bộ phân giải lại mọi thứ, và một lần nâng cấp có mục tiêu phân giải lại các plugin mà nó nêu tên; cả hai đều được hiểu là danh tính mới đã được yêu cầu, và bản ghi được cập nhật. Mọi lần pull khác giữ danh tính đã ghi nhận và dừng lại, đó chính là mục đích của việc ghi nhận nó — một bản ghi tiếp nhận bất cứ thứ gì được phân giải tiếp theo sẽ đi theo sự phân giải thay vì chi phối nó. Lần gặp đầu tiên không phải là một sự bất đồng: một danh tính mà bản ghi chưa lưu giữ chỉ đơn giản được điền vào.

Phép so sánh cũng chạy trên một lần pull chỉ kiểm chứng, vốn không ghi bản ghi lẫn lockfile. Một lần kiểm chứng bỏ qua bản ghi trong khi kiểm tra lockfile bên cạnh nó sẽ báo cáo một sự khớp mà nó chưa từng tìm kiếm.

Thông báo được phát ra, nêu tên plugin, cả hai danh tính và cả hai cách khắc phục:

plugin "<plugin-identity>": <record-path> records version <recorded-version> with digest <recorded-digest> as trusted for it, but this resolution reports version <resolved-version> with digest <resolved-digest>; review what changed and adopt it with aggrega pull --upgrade --release <release> <plugin>, or restore the recorded identity: the plugin identity recorded as trusted no longer matches what this resolution reports (plugin “<plugin-identity>”: <record-path> ghi nhận phiên bản <recorded-version> với digest <recorded-digest> là tin cậy cho nó, nhưng lần phân giải này báo cáo phiên bản <resolved-version> với digest <resolved-digest>; hãy xem xét những gì đã thay đổi và chấp nhận nó bằng aggrega pull —upgrade —release <release> <plugin>, hoặc khôi phục định danh đã ghi nhận: định danh plugin được ghi nhận là tin cậy không còn khớp với những gì lần phân giải này báo cáo)

Cách khắc phục: hãy quyết định danh tính nào trong hai danh tính là danh tính bạn muốn, vì chỉ bạn mới có thể. Nếu sự thay đổi là điều bạn chủ định — cổng đã được phát hành lại và bạn đã xem xét những gì thay đổi — hãy tiếp nhận nó bằng lần nâng cấp có mục tiêu mà thông báo nêu ra, lệnh này phân giải lại plugin đó và ghi lại mục của nó. Nếu bạn không mong đợi điều đó, danh tính đã ghi nhận là danh tính đã được xem xét: hãy khôi phục phiên bản hoặc artifact mà bản ghi nêu tên, và điều tra vì sao tham chiếu giờ phân giải về chỗ khác. Đừng sửa bản ghi để gỡ lỗi này — nó là một tuyên bố đã commit về những gì đã được xem xét, và một lần pull thông thường cố ý giữ nguyên nó, vì việc tiếp nhận một cổng đã thay đổi một cách lặng lẽ chính là điều mà sự từ chối này tồn tại để ngăn chặn.

Các khẳng định của một thực thể Plugin không khớp với tự báo cáo của chính plugin

Một thực thể Plugin nêu những gì plugin mà nó trỏ tới cung cấp: plugin có những export nào, mỗi export thao tác trên gì và ở phạm vi nào, và — đối với một plugin phục vụ một provider — plugin hoạt động thế nào khi render. Plugin tự báo cáo cùng những điều đó khi được nạp. Điều kiện này là thứ được báo cáo khi hai bên không khớp nhau.

Phép so sánh được thực hiện theo từng export, khóa theo tên, và chỉ theo một chiều: mọi thứ thực thể khẳng định phải khớp, và plugin có thể cung cấp nhiều hơn. Một thực thể mô tả một phần bề mặt của plugin không bắt buộc phải liệt kê phần còn lại, nên một export mà plugin khai báo còn thực thể bỏ qua không phải là sự không khớp. Sự không khớp là một export được khẳng định mà plugin không khai báo, hoặc một export được khẳng định có operates hay scope khác với những gì plugin báo cáo. Bộ chọn dạng tự do không được so sánh.

Khi thực thể còn viết một khối render-behaviour, các trường của khối được so sánh lần lượt — các loại đầu vào, chế độ assembly, cặp dấu phân cách artifact-template, annotation assembly-name, khẳng định reusable-instance, khẳng định cross-boundary-linking, khẳng định omit-entries và thư mục lồng — và trường đầu tiên không khớp là trường được nêu tên. Một thực thể không viết khối nào như vậy sẽ bỏ qua hoàn toàn phép so sánh đó.

Cùng phép kiểm tra này chạy khi publish, nên một sự không khớp thường lộ ra trước khi thực thể được publish thay vì khi một bản build nạp nó.

Các thông báo được phát ra. Một export được khẳng định mà plugin không có:

entity "<entity>" claims export "<export>", which the plugin’s describe() does not declare: wasm: entity contract claim does not match plugin describe() (thực thể khai báo một export mà describe() của plugin không khai báo: wasm: khai báo hợp đồng của thực thể không khớp với describe() của plugin)

một trường trên một export được khẳng định:

entity "<entity>" export "<export>" declares operates "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (export của thực thể khai báo giá trị operates khác với giá trị mà describe() của plugin báo cáo: wasm: khai báo hợp đồng của thực thể không khớp với describe() của plugin)

và một trường render-behaviour, được báo cáo theo cùng dạng, nêu tên trường không khớp:

entity "<entity>" declares boundary_assembly "<claimed>" but the plugin’s describe() reports "<reported>": wasm: entity contract claim does not match plugin describe() (thực thể khai báo giá trị boundary_assembly khác với giá trị mà describe() của plugin báo cáo: wasm: khai báo hợp đồng của thực thể không khớp với describe() của plugin)

Cách khắc phục: đây là khẳng định của thực thể Plugin cần sửa, không phải Aggregate hay Release của bạn. Hãy đưa khẳng định về khớp với những gì plugin báo cáo — thông báo nêu cả hai giá trị, nên hướng cần thay đổi hiện rõ ngay trong thông báo. Khi thực thể là do bạn publish, tạo lại nó từ binary là cách đáng tin cậy để hai bên khớp nhau; khi bạn dùng một thực thể đã được publish, hãy chọn một phiên bản có khẳng định khớp với binary mà nó trỏ tới, và báo cáo sự không khớp cho người đã publish nó.

Tập lệnh được ghi lại của một thực thể Plugin không khớp với plugin

Một plugin đóng góp các lệnh terminal sẽ có các lệnh đó được ghi lại trong thực thể Plugin của nó. Bản ghi đó do máy viết chứ không do người soạn: nó được đọc ra từ plugin rồi ghi xuống, nên phản ánh chính xác binary. Điều kiện này là thứ được báo cáo khi một bản ghi không còn phản ánh binary — một khác biệt về tên của một lệnh, về văn bản trợ giúp ngắn của nó, hoặc về thứ tự khai báo các lệnh.

Phép so sánh là bằng nhau hoàn toàn, và điều đó là có chủ ý. Các khẳng định về khả năng và export ở những chỗ khác trên thực thể là được tuyển chọn: một tác giả có thể hợp lệ mô tả một phần bề mặt và bỏ phần còn lại, nên chúng được kiểm tra như một tập con. Bản ghi lệnh thì không được tuyển chọn, nên bất cứ điều gì kém hơn sự khớp chính xác đều có nghĩa bản ghi đã lệch khỏi những gì plugin thực sự cung cấp, và một danh sách lệnh gần đúng nhưng không đúng chính là thứ sẽ định tuyến sai một lời gọi.

Một plugin được nạp mà không có thực thể thì không được kiểm tra ở đây. Bản ghi nằm trên thực thể, nên các byte được nạp trực tiếp không mang bản ghi nào và phép so sánh không có gì để đối chiếu.

Thông báo được phát ra, nêu tên cả hai tập và cách ghi lại chúng:

wasm: plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>; re-run aggrega plugin sync and commit the result: wasm: recorded command mirror does not match plugin describe() (wasm: bản sao tập lệnh đã ghi nhận của plugin không khớp với các lệnh trong describe() của plugin; hãy chạy lại aggrega plugin sync và commit kết quả: wasm: bản sao tập lệnh đã ghi nhận không khớp với describe() của plugin)

Cùng phép so sánh khi publish báo cáo các tập mà không có chỉ dẫn ghi lại:

plugin "<plugin>": recorded command mirror <recorded set> does not match the plugin describe() commands <reported set>: wasm: recorded command mirror does not match plugin describe() (bản sao tập lệnh đã ghi nhận của plugin không khớp với các lệnh trong describe() của plugin: wasm: bản sao tập lệnh đã ghi nhận không khớp với describe() của plugin)

Cách khắc phục: ghi lại tập lệnh từ binary và commit kết quả — thông báo nêu lệnh thực hiện việc đó. Đừng sửa tay bản ghi cho khớp: nó thuộc quyền của máy, và một chỉnh sửa tay tình cờ khớp hôm nay sẽ bị suy lại và ghi đè vào lần ghi lại tiếp theo. Khi bạn dùng một thực thể đã được publish thay vì publish nó, thực thể đó đã được publish với một bản ghi mà chính binary của nó không hỗ trợ, và đó là vấn đề dành cho người publish nó.

Phiên bản được ghi lại của một thực thể Plugin không khớp với plugin

Một plugin báo cáo phiên bản mà bản build của nó đã ghi vào nó, và thực thể Plugin của nó cũng ghi một phiên bản; hai giá trị phải là cùng một chuỗi. Các công thức build dùng để build các plugin của Aggrega lấy phiên bản đó từ tag phát hành plugin — tag của chính trình biên dịch đối với plugin đi kèm trình biên dịch, một tag riêng của plugin đối với plugin phát hành bên ngoài — nên một bản build của commit mà tag nêu sẽ báo cáo phiên bản phát hành, còn bản build của bất kỳ commit nào khác sẽ báo cáo một phiên bản phát triển như 1.0.0-3-g1a2b3c4. Điều kiện này là thứ được báo cáo khi một cặp đã tách rời nhau, và nó được kiểm tra trước khi bất kỳ byte nào được publish để một cặp lệch nhau không đến được catalog.

Phép so sánh là khớp chuỗi chính xác. Một plugin được build mà không ghi phiên bản build sẽ báo cáo một phiên bản rỗng, và giá trị rỗng đó khi ấy là thứ phiên bản của thực thể phải bằng — phép kiểm tra không coi “không báo cáo phiên bản” là “chấp nhận mọi phiên bản”, vì mục đích của nó là phiên bản của một thực thể đã publish luôn nói đúng những gì binary của nó thực sự báo cáo.

Thông báo được phát ra:

plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (metadata.version đã ghi nhận của plugin không khớp với phiên bản trong describe() của plugin: wasm: metadata.version của thực thể không khớp với describe() của plugin)

Khi publish, lời từ chối còn nêu tên tệp thực thể, tệp .wasm và cách sửa:

Plugin <plugin>: metadata.version in <entity-path> does not match the .wasm describe() version at <path> — set metadata.version to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin "<plugin>": recorded metadata.version "<recorded>" does not match the plugin describe() version "<reported>": wasm: entity metadata.version does not match plugin describe() (metadata.version trong tệp thực thể không khớp với phiên bản trong describe() của tệp .wasm — hãy đặt metadata.version thành bản phát hành bạn đang xuất bản và build plugin từ một bản checkout sạch của commit mà tag của bản phát hành đó chỉ đến, để chính plugin báo cáo phiên bản đó; với một bản phát hành mới, hãy commit thực thể cùng mã nguồn mà nó phát hành và gắn tag cho commit đó trước: metadata.version đã ghi nhận của plugin không khớp với phiên bản trong describe() của plugin: wasm: metadata.version của thực thể không khớp với describe() của plugin)

Cách khắc phục: đặt metadata.version của thực thể thành bản phát hành bạn đang publish, và build plugin từ một checkout sạch của commit mà tag của bản phát hành đó nêu, để nó tự báo cáo phiên bản đó. Với một bản phát hành mới, hãy commit thực thể cùng mã nguồn mà nó phát hành và gắn tag cho commit đó trước — tag phải nêu một commit đã chứa thực thể. Đừng sao chép phiên bản plugin báo cáo vào thực thể: một bản build của bất kỳ commit nào khác báo cáo một phiên bản phát triển, và sao chép nó sẽ publish bản build đó dưới một phiên bản mà không tag phát hành nào nêu. Khi plugin hoàn toàn không báo cáo phiên bản, nó đã được build mà không ghi phiên bản; hãy build nó có ghi phiên bản.

Một plugin được build từ một working tree có thay đổi chưa commit

Bản build của một plugin ghi phiên bản của nó từ commit mà nó được build, và một bản build được tạo từ một working tree có thay đổi chưa commit sẽ mang dấu -dirty ở cuối phiên bản đó — 1.0.0-dirty tại một tag, 1.0.0-3-g1a2b3c4-dirty khi đã vượt qua một tag. Một phiên bản như vậy là một phiên bản ngữ nghĩa hợp lệ, nhưng nó nêu một commit không chứa các byte đã được build, nên không ai có thể build lại thứ sẽ được publish từ phiên bản mà nó sẽ được publish dưới đó. Việc publish một Plugin từ chối một plugin mà chính phiên bản của nó mang dấu này, trước khi bất kỳ byte nào được publish và trước khi liên hệ với registry; một lần chạy thử (dry run) cũng từ chối nó.

Chỉ dấu này bị từ chối. Một phiên bản phát triển được build từ một commit, như 1.0.0-3-g1a2b3c4, nêu một commit thực sự chứa thứ đã được build, và được publish; một bản prerelease như 1.0.0-rc.1 cũng vậy. Việc xác thực một plugin đối chiếu với thực thể của nó bên ngoài một lần publish không gây ra điều kiện này, vì một bản build đang phát triển thường được tạo từ một tree đã chỉnh sửa.

Phép kiểm tra đọc phiên bản mà plugin báo cáo về bản build của chính nó, và chạy trước phép so sánh với metadata.version của thực thể — nên một plugin được build với thay đổi chưa commit dưới một thực thể ghi phiên bản sạch sẽ được báo cáo ở đây, thay vì như một phiên bản được ghi lại không khớp với plugin.

Thông báo được phát ra, nêu tên plugin, phiên bản nó báo cáo và cách khắc phục:

Plugin <plugin>: the .wasm at <path> was built from a working tree with uncommitted changes — set metadata.version in <entity-path> to the release you are publishing and build the plugin from a clean checkout of the commit that release’s tag names, so it reports that version itself; for a new release, commit the entity with the source it releases and tag that commit first: plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports (plugin "<plugin>", describe() version "<version>", which ends with "-dirty")

Cách khắc phục: build plugin từ một checkout sạch của commit mà tag của bản phát hành nêu, để nó báo cáo phiên bản phát hành mà thực thể ghi lại. Để phát hành chính thay đổi đó, hãy đặt metadata.version của thực thể thành bản phát hành mới, commit thực thể cùng thay đổi, gắn tag cho commit đó và build tại đó. Chỉ commit thay đổi rồi build lại thì không mở đường cho một bản phát hành: plugin được build lại báo cáo một phiên bản phát triển, và sao chép phiên bản đó vào thực thể sẽ publish bản build dưới một phiên bản mà không tag phát hành nào nêu.

Các host function được ghi lại của một thực thể Plugin không khớp với binary

Một plugin khai báo những lời gọi nào của chính host mà nó sử dụng, và tập đó được ghi lại trên thực thể Plugin của nó khi plugin được publish — được đọc ra từ chính binary chứ không do người soạn. Khi plugin được tải về, tập này được suy ra lại từ các byte mà nội dung vừa được xác minh, và được so sánh với bản ghi. Một khác biệt theo bất kỳ chiều nào cũng sẽ dừng việc tải về.

Phép kiểm tra này nằm trên ghim nội dung chứ không lặp lại nó, và nó bắt được hai điều mà riêng ghim không bắt được: một binary được publish bởi thứ gì đó khác với đường publish thông thường, mang theo không có bản ghi hoặc một bản ghi không mô tả các byte của chính nó; và một lỗi trong chính bước ghi lại. Ghim xác lập rằng các byte là các byte đã được ghim; phép kiểm tra này xác lập rằng những gì được ghi về chúng là đúng với chúng.

Một thực thể không mang bản ghi nào được so sánh với một tập rỗng, tập này khớp với một plugin không dùng lời gọi nào của host — cùng một sự khớp vô hại theo cả hai chiều, nên một thực thể không có bản ghi không bị từ chối vì thiếu bản ghi.

Thông báo được phát ra, nêu tên plugin, cả hai tập và artifact mà các byte đến từ đó:

plugin "<plugin>": stamped spec.runtime.hostFunctions <recorded set> does not match <derived set> derived from the verified .wasm <artifact>: wasm: stamped host-function record does not match .wasm imports

Cùng phép so sánh khi chạy trong lúc xác thực một plugin báo cáo hai tập mà không có artifact:

plugin "<plugin>": recorded host-function record <recorded set> does not match the .wasm imports <derived set>: wasm: stamped host-function record does not match .wasm imports

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra điều này và không thay đổi soạn thảo nào xóa được nó. Hãy publish lại plugin qua đường publish thông thường, đường này suy ra bản ghi từ binary và ghi cả hai cùng nhau. Khi bạn dùng một plugin đã được publish, thực thể và binary mà nó trỏ tới đã được publish lệch nhau, nên hãy báo cáo sự không khớp cho người publish nó, trích dẫn cả hai tập từ thông báo — và đừng sửa tay bản ghi cho khớp, vì nó được suy ra chứ không do người soạn và lần suy ra tiếp theo sẽ loại bỏ chỉnh sửa đó.

The lockfile no longer matches what the release resolves to (Lockfile không còn khớp với những gì bản phát hành phân giải ra)

Lockfile của một bản phát hành ghim mọi thực thể, thư viện và plugin mà bản phát hành đó với tới, mỗi mục kèm phiên bản được chọn và một digest, đồng thời ghi lại chính các tệp bản phát hành — bản phát hành và từng bản phát hành mà nó mở rộng — theo digest nội dung của chúng. Digest của một thực thể bao trùm những gì một lần xuất bản thực thể đó mang theo: tài liệu của nó và mọi tệp nó nêu tên bên cạnh, mỗi tệp theo đường dẫn và các byte của nó. Digest của một thư viện và của một plugin bao trùm các byte của chúng. Phân giải lại bản phát hành sẽ tạo ra cùng tập hợp đó, và hai tập được so sánh với nhau. Điều kiện này là thứ báo cáo một sự bất đồng.

Mọi sự bất đồng đều được thu thập trước khi bất kỳ sự bất đồng nào được báo cáo, trên toàn bộ những gì lockfile ghim, nên một lần chạy cho bạn thấy toàn cảnh thay vì từng mục một.

Các dạng bất đồng sau được báo cáo, và đáng để phân biệt vì cách khắc phục khác nhau:

  • Một tham chiếu mà lockfile không ghim. Bản phát hành giờ với tới một thứ mà lockfile không có mục nào — một phụ thuộc được thêm vào sau lần pull đã ghi lockfile. Mục báo cáo nêu nơi bản phát hành yêu cầu nó, nên một Recipe hoặc FeatureRecipe mà Manifest ràng buộc được báo cáo kèm mục ánh xạ ràng buộc nó, còn một Recipe được tầng name ràng buộc thì nêu instance hoặc attachment mà nó được chọn cho.
  • Một tham chiếu đã ghim mà cặp giá trị của nó đã thay đổi. Lockfile ghim một cặp phiên bản-và-digest còn kết quả phân giải tạo ra một cặp khác. Đó là nội dung vendored có các byte đã thay đổi, hoặc một thứ trong workspace đã thay đổi: tài liệu của một thực thể hoặc một thư viện bị sửa, một tệp mà thực thể nêu tên — một chart dưới source của nó, một tệp nó import, tệp entity.lock bên cạnh nó — bị sửa, thêm hoặc xoá, hoặc tệp .wasm bên cạnh thực thể của một plugin bị thay thế. Mục báo cáo nêu tên thực thể chứ không phải tệp; một lệnh aggrega pull --release <release> thông thường sẽ nêu tên một tệp đã thay đổi dưới lock của một Recipe hoặc FeatureRecipe, như An entity reads an input the lock beside it records no pin for (Một thực thể đọc một đầu vào mà lock bên cạnh nó không ghi pin nào) mô tả. Một registry phục vụ các byte khác dưới một phiên bản đã ghim không được báo cáo ở đây: lần pull lấy chúng về sẽ từ chối chúng, như Fetched or cached bytes do not match the digest committed for them (Các byte đã tải về hoặc đã cache không khớp với digest được cam kết cho chúng) mô tả.
  • Một tham chiếu đã ghim mà bản phát hành không còn với tới. Lockfile vẫn ghim một thứ mà không còn gì trong bản phát hành phụ thuộc vào.
  • Một tệp bản phát hành bị sửa kể từ lần pull. Bản phát hành, hoặc một bản phát hành mà nó mở rộng, không còn chứa các byte mà lockfile đã ghi cho nó. Mọi thứ bản phát hành yêu cầu — phiên bản source nào cần tải, component nào đặt ở đâu — đều được phân giải từ nội dung tệp, nên các pin đã ghi có thể không còn mô tả những gì nó yêu cầu hiện nay. Điều này được báo cáo ở đây, trước khi bất cứ thứ gì được render, thay vì dưới dạng lỗi mà lần render lẽ ra sẽ gặp: nếu không, một phiên bản source bị sửa sẽ chỉ lộ ra sau đó dưới dạng một lần tải không tìm thấy pin. Một lockfile không ghi tệp bản phát hành nào sẽ báo cáo bản phát hành là chưa được ghi, và một tệp bản phát hành mà bản phát hành không còn mở rộng được báo cáo là không còn được đọc.
  • Một tham chiếu source đã thay đổi tại remote của nó. Một source được viết tại một git ref: được ghi tại commit mà ref đó phân giải tới. Mỗi lần pull không phải là nâng cấp sẽ hỏi remote xem ref hiện trỏ đến đâu, và aggrega pull --verify cũng vậy khi có thể kết nối mạng; một ref phân giải tới commit khác sẽ được báo cáo ở đây thay vì được chấp nhận. Chỉ hai thao tác đó báo cáo điều này: một bản build đọc commit đã ghi và không hỏi.

Việc so sánh dựa trên nội dung, nên nội dung giống hệt được với tới theo một đường khác sẽ không bị coi là sai lệch: thứ phải khác để điều kiện này kích hoạt là các byte. Với một tệp bản phát hành, điều đó bao gồm cả thay đổi về chú thích hay khoảng trắng, đúng như với Aggregate và Manifest mà bản phát hành nêu tên. Với một thực thể, đó là nội dung của những gì nó mang theo, nên cùng một thực thể được đọc từ một thư mục catalog và được tải từ một registry không bị sai lệch, một checkout có các tệp chỉ khác nhau về bit quyền, kể cả bit thực thi, cũng không, và một lần xuất bản có archive được nén theo cách khác cũng không.

Thông báo được phát ra. Câu riêng của điều kiện mở đầu thông báo, và mọi điểm không khớp được thu thập theo sau, mỗi điểm nêu trục của nó — và, với một thực thể, loại của nó, vì một thực thể được xác định bởi loại và URI của nó cùng nhau, nên một Release có Aggregate và Manifest trùng tên sẽ có hai mục, và một chỉnh sửa ở bất kỳ cái nào cũng được báo cáo cho đúng cái đã được chỉnh sửa:

lockfile: out of date; it no longer matches what its Release resolves to: entity "<uri>" (<kind>) not in lockfile (referenced from <site>) (lockfile: đã lỗi thời; không còn khớp với kết quả phân giải Release của nó: thực thể, kèm loại của nó, không có trong lockfile, cùng vị trí tham chiếu tới nó) <axis> "<uri>" changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (tham chiếu đã nêu trên trục đã nêu đã thay đổi: phiên bản và digest trong lockfile khác với hiện tại) entity "<uri>" (<kind>) changed: lockfile=(<version>,<digest>) current=(<version>,<digest>) (thực thể đã nêu, thuộc loại đã nêu, đã thay đổi: phiên bản và digest trong lockfile khác với hiện tại) <axis> "<uri>" no longer used by the release (tham chiếu đã nêu trên trục đã nêu không còn được bản phát hành sử dụng) release document "<file>" was edited after the lockfile was written: its content no longer matches the recorded digest (lockfile=<digest> current=<digest>), so the pins may no longer describe what it asks for; re-resolving the Release records the files it reads as they now stand (tài liệu bản phát hành đã nêu đã bị chỉnh sửa sau khi lockfile được ghi: nội dung của nó không còn khớp với digest đã ghi, nên các pin có thể không còn mô tả những gì nó yêu cầu; phân giải lại Release sẽ ghi lại các tệp nó đọc theo trạng thái hiện tại)

<site> là nơi bản phát hành yêu cầu tham chiếu, được viết dưới dạng đường dẫn tới mục nêu tên nó — chẳng hạn manifest.spec.mappings.components.name.db-primary — với tối đa ba vị trí như vậy được liệt kê theo thứ tự đã sắp xếp và ... sau chúng nếu còn nhiều hơn. Một tham chiếu mà kết quả phân giải không ghi vị trí nào như vậy được báo cáo không kèm phần trong ngoặc.

Một lần pull báo cáo một tham chiếu source đã thay đổi sẽ nêu tên artifact như tác giả đã viết, kèm chart= và module_subdir= nếu source nêu chúng:

source-artifact kind=<kind> url=<url>: reference "<ref>" moved — the lockfile pins <commit>, and it now resolves to <commit>; adopt where it now points with aggrega pull --upgrade --release <release>

Một bản build in ra cách khắc phục sau các mục:

run aggrega pull --release <release> to re-resolve the Release and rewrite its lockfile

Những lệnh nào buộc một bản phát hành phải khớp với lockfile của nó. aggrega build so sánh trước khi render và dừng lại. aggrega validate --release, và mọi lựa chọn aggrega inspect có phân giải một bản phát hành — chế độ xem mặc định, --resolved, --ir-graph và --closure — chạy cùng phép so sánh ngay khi các phụ thuộc của bản phát hành được phân giải, và dừng lại với cùng thông báo và cách khắc phục, không ghi gì ra đầu ra chuẩn; vì vậy không lệnh nào bỏ qua một lockfile mà bản build từ chối vì đã lệch. Các công cụ trợ lý build, validate với một release, và describe với một release từ chối theo cùng điều kiện. aggrega pull chạy phép so sánh với lockfile mà nó sắp ghi, và aggrega pull --verify với lockfile trên đĩa. Một lệnh không phân giải bản phát hành nào — aggrega validate không có đối số (khi đó nó chỉ đọc các pin trong lockfile để tìm thực thể cha extends) hoặc với một đường dẫn thực thể, và aggrega inspect --raw hoặc --output yaml không có --ir-graph — không bị ràng buộc với lockfile, và một bản phát hành không có lockfile bên cạnh cũng vậy. Máy chủ ngôn ngữ của trình soạn thảo dừng các bản build của nó vì điều này, và báo cáo nó trong một yêu cầu đồ thị dưới dạng cảnh báo trên lockfile trong khi vẫn vẽ đồ thị.

Cách khắc phục: phân giải lại bản phát hành và commit lockfile đã được ghi lại. Với mọi thứ một bản build báo cáo, một lệnh aggrega pull --release <release> thông thường — lệnh mà bản build in ra — là toàn bộ cách khắc phục: nó phân giải bản phát hành theo hiện trạng, ghi lại các pin đã thay đổi và giữ nguyên mọi pin khác, nên không có gì trôi đi mà bạn không động tới. Khi thứ thay đổi là một tệp dưới source cục bộ của một Recipe hoặc FeatureRecipe, lần pull đó trước tiên sẽ dừng lại và nêu lệnh aggrega pin cho thực thể, vì ghi pin mới bên cạnh nó là bước của tác giả; hãy chạy lệnh đó, hoặc truyền --pin-sources cho lần pull, và lần pull sẽ xoá sự sai lệch. Mục duy nhất mà một lần pull thông thường không xoá được là một tham chiếu source đã thay đổi tại remote, vì xoá nó nghĩa là chấp nhận commit mà tham chiếu hiện nêu: aggrega pull --upgrade --release <release> làm điều đó, và mục báo cáo cũng nói vậy — khi entity.lock của Recipe ghi source đó, lần nâng cấp sẽ dừng theo cùng cách cho tới khi commit mới được ghim bên cạnh nó. Hãy đọc các mục trước khi làm, vì dạng thứ ba là dạng đáng dừng lại xem xét: một tham chiếu mà bản phát hành không còn với tới thường là một phụ thuộc bạn đã cố ý gỡ bỏ, nhưng nếu bạn không gỡ nó, thì có thứ khác đã thay đổi khiến nó không thể với tới. Một cặp đã thay đổi trên một tham chiếu bạn không động tới nghĩa là nội dung tại phiên bản đó không phải nội dung đã được xem xét, và đó là câu hỏi dành cho bên cung cấp nó chứ không phải thứ để chấp nhận mà không xem xét.

Một lần pull chạy cùng phép so sánh này với lockfile nó sắp ghi và không ghi lockfile mà phép so sánh từ chối, nên một lockfile vừa được một lần pull ghi sẽ vượt qua phép so sánh đối với một bản build được cấp cùng đầu vào. Khi điều kiện này xuất hiện lại ngay sau một lần pull đã hoàn tất, hai lần chạy đã được cấp các đầu vào khác nhau: một thư mục catalog được truyền cho lần này mà không cho lần kia, hoặc cấu hình workspace bị sửa giữa hai lần. Hãy chạy pull và build trên cùng các đầu vào.

An artifact is not at the source the build was told to find it (Artifact không có ở nguồn mà bản build được chỉ định để tìm nó)

Một tham chiếu catalog nêu tên một artifact và một phiên bản. Điều kiện này báo rằng không có gì đáp ứng cặp đó — hoặc tại registry mà tham chiếu phân giải tới, hoặc trong bộ đệm artifact cục bộ mà bản build đọc.

Bản build đọc bộ đệm; nó không tự kết nối ra ngoài. Việc thu nhận là một bước riêng: lệnh pull phân giải một release sẽ tải những gì release cần và ghi vào bộ đệm, rồi bản build đọc những gì có ở đó. Vì vậy điều kiện này đến với bản build dưới dạng không tìm thấy trong bộ đệm, và đến với lệnh pull dưới dạng một registry không có artifact đó. Khi bản build được cấu hình để điền lockfile lúc bắt đầu, bước thu nhận nó chạy chính là lệnh pull đó.

Các thông báo được phát ra. Một registry không có tag đó, và một lần tải đã phân giải được manifest nhưng thiếu blob nội dung:

oci: "<reference>:<version>": oci: artifact not found at remote source (oci: <reference>:<version>: oci: không tìm thấy artifact tại nguồn từ xa)

oci: content for "<reference>:<version>": oci: artifact not found at remote source (oci: nội dung cho <reference>:<version>: oci: không tìm thấy artifact tại nguồn từ xa)

một lần đọc bộ đệm không tìm thấy mục nào, là dạng mà bản build gặp:

oci: cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: không có trong bộ nhớ đệm cho <reference>@<version>: oci: không tìm thấy artifact tại nguồn từ xa)

và tương tự với một artifact trong bộ đệm bị thiếu manifest bên cạnh:

oci: manifest cache miss for <reference>@<version>: oci: artifact not found at remote source (oci: manifest không có trong bộ nhớ đệm cho <reference>@<version>: oci: không tìm thấy artifact tại nguồn từ xa)

Cách khắc phục: trước tiên hãy kiểm tra tham chiếu và phiên bản — một phiên bản không còn tồn tại và một tên bị gõ sai cho ra cùng một câu trả lời, và thông báo trích cả hai để bạn so sánh với catalog. Nếu tham chiếu đúng, artifact chưa được thu nhận: hãy chạy lệnh pull cho release, lệnh này tải những gì release cần và điền vào bộ đệm. Nếu workspace ngoại tuyến, lệnh pull đó phải chạy từ nơi có truy cập mạng; một bản build ngoại tuyến chỉ đọc những gì đã có trong bộ đệm, và đây là điều nó báo khi bộ đệm không chứa artifact.

The registry will not serve an artifact without credentials it accepts (Registry không cung cấp artifact nếu không có thông tin xác thực mà nó chấp nhận)

Registry đã trả lời và từ chối: hoặc không có thông tin xác thực nào được gửi, hoặc thông tin được gửi không được chấp nhận. Điều này khác với một registry hoàn toàn không thể kết nối — ở đây cuộc trao đổi đã diễn ra và câu trả lời là không.

Bốn thời điểm báo điều này, tất cả đều trong lúc artifact đang được thu nhận hoặc xuất bản: phân giải một tham chiếu, kéo nội dung của nó, liệt kê các phiên bản mà một repository có, và kiểm tra thông tin xác thực lúc nó được lưu.

Các thông báo được phát ra, mỗi thông báo nêu điều đang được yêu cầu và trích lời đáp của registry:

oci: resolve "<reference>:<version>": <what the registry replied>: oci: authentication required or failed (oci: phân giải <reference>:<version>: nội dung registry trả lời: oci: cần xác thực hoặc xác thực thất bại)

khi liệt kê các phiên bản của một repository, thông báo nêu mã trạng thái thay vào đó:

oci: tags/list "<repository>": status <code>: oci: authentication required or failed (oci: tags/list <repository>: trạng thái mã: oci: cần xác thực hoặc xác thực thất bại)

và khi kiểm tra thông tin xác thực lúc nó được lưu:

oci: verify credential for "<host>": <what the registry replied>: oci: authentication required or failed (oci: kiểm tra thông tin xác thực cho <host>: nội dung registry trả lời: oci: cần xác thực hoặc xác thực thất bại)

Khi lỗi được đưa ra bởi một bước có cung cấp cách khắc phục, dòng thông báo kết thúc bằng lệnh đăng nhập cần chạy với host mà nó suy ra:

remediation: aggrega login <host> (or docker login <host>) before re-running aggrega pull —release <release> (khắc phục: chạy aggrega login (hoặc docker login) cho host đã nêu trước khi chạy lại aggrega pull —release)

và, khi một lần import đang tải về một trong các core importer của trình biên dịch, cùng lệnh đăng nhập đó trước khi chạy lại import:

remediation: aggrega login <host> (or docker login <host>) before re-running the import (khắc phục: chạy aggrega login (hoặc docker login) trước khi chạy lại import)

Một repository chart Helm cổ điển hoặc một tệp lưu trữ chart, một đoạn compose và một repository Git được tải qua http hoặc https cũng báo cáo điều kiện này khi máy chủ từ chối yêu cầu vì không được ủy quyền, và biện pháp khắc phục của chúng nêu mục netrc cần thêm thay vì một lần đăng nhập, vì đó là tệp mà các lần tải này đọc thông tin xác thực:

remediation: add an entry for <host> (machine <host> login <user> password <secret>) to the netrc file <path>, then run the command again (biện pháp khắc phục: thêm một mục cho host vào tệp netrc (với machine, login và password), rồi chạy lại lệnh)

Cách khắc phục: việc này thuộc về người vận hành chứ không phải tác giả entity — không có gì trong một Aggregate, Component hay Recipe gây ra nó. Hub chính thức, hub.aggrega.ai, cung cấp những gì nó phát hành cho bất kỳ ai, nên đọc từ đó không cần thông tin xác thực, còn phát hành lên đó thì cần; một registry khác có thể yêu cầu thông tin xác thực cả cho việc đọc. Hãy đăng nhập vào host mà thông báo nêu — hoặc, với một nguồn được tải qua http hoặc https, hãy thêm mục netrc mà biện pháp khắc phục nêu — và chạy lại bước thu nhận. Nếu bạn đã đăng nhập rồi, thông tin xác thực trong kho lưu không phải là thông tin mà host đó chấp nhận cho repository ấy: hãy đăng nhập lại để làm mới, và kiểm tra rằng tài khoản có quyền đọc repository mà tham chiếu phân giải tới, vì một repository riêng tư trả lời đúng như vậy với tài khoản không nhìn thấy nó. Nếu tham chiếu phân giải tới một host bạn không mong đợi, alias registry hoặc registry mặc định trong .aggrega-config.yaml đang trỏ tới nơi khác.

The netrc file cannot be read (Không thể đọc tệp netrc)

Một kho chart Helm kiểu cổ điển hoặc một tệp lưu trữ chart, một đoạn compose và một kho Git được tải qua http hoặc https đều lấy thông tin xác thực từ tệp netrc, tệp này được đọc khi một nguồn như vậy được tải — bởi một lần pull, một lần pin, hoặc một bản build đang điền lockfile của nó. Tệp nào được đọc, và mục nào trả lời một yêu cầu, được trình bày tại Authentication. Điều kiện này báo cáo một tệp netrc có tồn tại nhưng không dùng được: không đọc được nó — chẳng hạn nó là một thư mục, hoặc bạn không có quyền đọc nó — hoặc nó không tuân theo định dạng netrc. Định dạng được đọc một cách nghiêm ngặt, vì một từ được đọc sai chỗ sẽ làm lệch mọi từ phía sau nó: một từ khóa viết sai chính tả lẽ ra sẽ biến mật khẩu phía sau nó thành từ khóa kế tiếp, và yêu cầu sẽ được gửi đi không kèm thông tin xác thực, hoặc kèm thông tin sai, trong khi tệp trông vẫn ổn.

Một tệp không tồn tại không thuộc điều kiện này: nó không chứa thông tin xác thực nào, và một yêu cầu cần thông tin xác thực sẽ được trả lời bằng sự từ chối của máy chủ. Một tệp mà những người dùng khác của máy có thể đọc cũng không thuộc điều kiện này: trên Linux và macOS nó gây ra một cảnh báo nêu tên tệp, và vẫn được đọc.

Thông báo nêu tên tệp và, với một lỗi định dạng, cả dòng, và nói điều gì sai chỉ bằng các thuật ngữ của định dạng — không bao giờ nêu một từ nào mà tệp chứa, vì một từ đặt sai chỗ có thể là một mật khẩu. Chẩn đoán này không mang danh mục: tệp netrc là tệp thông tin xác thực của chính bạn chứ không phải một tài liệu mà bản build đọc.

Thông báo được phát ra cho một lỗi định dạng, vốn là một trong các trường hợp: một từ đứng ở chỗ cần một từ khóa, một từ khóa không có giá trị theo sau, một login, password hoặc account đứng trước bất kỳ mục machine hoặc default nào, và một từ trong ngoặc kép không được đóng trên dòng mà nó mở:

the netrc file could not be read (file <path>, line <line>, a word stands where a keyword is expected (machine, default, login, password, account or macdef)). Correct the file, or set NETRC to the path of another netrc file to read instead (không thể đọc tệp netrc (tại tệp và dòng đã nêu, một từ đứng ở chỗ cần một từ khóa (machine, default, login, password, account hoặc macdef)). Hãy sửa tệp, hoặc đặt NETRC thành đường dẫn tới một tệp netrc khác để đọc thay thế)

và cho một tệp không đọc được, trích dẫn lý do:

the netrc file could not be read (file <path>, <why it could not be read>). Correct the file, or set NETRC to the path of another netrc file to read instead (không thể đọc tệp netrc (tệp đã nêu và lý do không đọc được). Hãy sửa tệp, hoặc đặt NETRC thành đường dẫn tới một tệp netrc khác để đọc thay thế)

Cách khắc phục: mở tệp mà thông báo nêu. Với một lỗi định dạng, đi tới dòng mà nó nêu: mỗi mục là machine <host> — hoặc default — theo sau là login <user> và password <secret>, và một từ khóa viết sai chính tả hoặc thiếu giá trị là nguyên nhân thường gặp. Với một tệp không đọc được, hãy biến nó thành một tệp mà bạn đọc được, và chỉ một mình bạn đọc được (chmod 600). Khi tệp đó không phải là tệp bạn muốn được đọc, hãy đặt NETRC thành đường dẫn tới tệp bạn muốn.

The registry could not be reached (Không thể kết nối tới registry)

Cuộc trao đổi với registry chưa bao giờ diễn ra: phân giải tên, kết nối, hoặc bắt tay bảo mật đã thất bại. Đây là trường hợp đối lập với một registry đã trả lời và từ chối — ở đây không có gì được xác lập theo cả hai hướng, nên trạng thái của artifact ở đầu bên kia là chưa biết chứ không phải đã biết là thiếu.

Đây cũng là điều được báo khi có lỗi truyền tải không có nguyên nhân cụ thể hơn trong lúc nguồn của một Recipe đang được thu nhận, nên trên đường đi đó nó là câu trả lời chung “không thể kết nối tới đầu bên kia”, chứ không phải một khẳng định về tầng nào đã thất bại.

Thông báo được phát ra, nêu nguồn đang được thu nhận và trích lỗi truyền tải bên dưới, kèm cách khắc phục mà điều kiện mang theo:

sourceresolver: kind=<kind> url=<url> version=<version>: oci: network unreachable (cause: <the transport failure>); remediation: check network connectivity to <host>; corporate proxies typically need HTTPS_PROXY exported (sourceresolver: kind=loại url=url version=phiên bản: oci: không thể kết nối mạng (nguyên nhân: lỗi truyền tải); khắc phục: kiểm tra kết nối mạng tới máy chủ; proxy doanh nghiệp thường cần export HTTPS_PROXY)

Cách khắc phục: việc khắc phục thuộc về người vận hành và nằm ngoài catalog của bạn. Hãy kiểm tra rằng host trong thông báo có thể kết nối được từ nơi lệnh đang chạy. Nếu môi trường truy cập mạng qua proxy, proxy phải được export vào môi trường, như cách khắc phục đã nêu — một proxy chỉ được cấu hình cho trình duyệt hoặc trình quản lý gói sẽ không được nhận. Nếu host kết nối được bằng tay nhưng không phải từ đây, khác biệt thường là thông tin xác thực tại proxy hoặc một chứng chỉ chặn bắt mà quá trình bắt tay không chấp nhận. Khi các artifact đã được lưu vào bộ đệm, các bản build sau đọc bộ đệm và hoàn toàn không cần mạng.

A server did not answer in time (Máy chủ không trả lời kịp thời)

Một yêu cầu đã chờ mãi máy chủ mà nó gửi tới — một registry, hoặc bất kỳ máy chủ nào khác mà một lệnh truy cập, chẳng hạn nhật ký minh bạch nơi một chữ ký được ghi lại — và đã bị rút lại. Một yêu cầu chờ tối đa 30 giây để máy chủ bắt đầu trả lời sau khi yêu cầu đã được gửi đầy đủ, và tối đa 30 giây cho phần tiếp theo của một câu trả lời đang đến; quá một trong hai mức đó, yêu cầu bị từ chối theo điều kiện này, kèm tên máy chủ và thời gian chờ. Đây là kết quả do một máy chủ chấp nhận kết nối nhưng không bao giờ trả lời tạo ra, và cũng là kết quả do một địa chỉ không bao giờ chấp nhận kết nối nào tạo ra, thay vì một lệnh chờ vô tận. Ngược lại, việc duyệt toàn bộ danh sách repository của một registry chờ ở mỗi trang trong suốt thời gian mà việc duyệt được phép chạy, và bị giới hạn bởi điều kiện riêng của nó, E0377.

Chỉ việc chờ là bị giới hạn. Một lượt tải xuống hoặc tải lên vẫn đang tiếp diễn sẽ mất bao lâu tùy nó, vì thời gian chờ chỉ được tính khi không có gì đến. Một Helm chart mà source: của một Recipe tải qua HTTPS chỉ chịu giới hạn chờ cho đến khi câu trả lời bắt đầu, và việc hết hạn đó được báo bằng chính lời của thư viện mạng chứ không theo điều kiện này. Một yêu cầu mà lệnh vốn đã gửi lại khi hết thời gian chờ — một lần đọc trong aggrega registry update, một lần ghi trong lúc xuất bản — sẽ được gửi lại trước, nên việc từ chối là những gì còn lại sau lần thử cuối cùng của nó.

Thông báo được phát ra, cho một lượt liệt kê phiên bản mà registry không trả lời:

aggrega plugin add: 127.0.0.1:18471: list versions for plugin/cli/mo: oci: list tags: Get “http://127.0.0.1:18471/v2/plugin/cli/mo/tags/list”: 127.0.0.1:18471 did not answer within 30s: egress: the server did not answer in time (aggrega plugin add: 127.0.0.1:18471: liệt kê các phiên bản cho plugin/cli/mo: oci: liệt kê các tag: Get: 127.0.0.1:18471 không trả lời trong vòng 30s: egress: máy chủ không trả lời kịp thời)

và cho một câu trả lời bị dừng giữa chừng:

<host> stopped answering: nothing more of its answer arrived for 30s: egress: the server did not answer in time (đã ngừng trả lời: không có thêm phần nào của câu trả lời đến trong 30s: egress: máy chủ không trả lời kịp thời)

Cách khắc phục: việc khắc phục thuộc về người vận hành và nằm ngoài catalog của bạn. Kiểm tra rằng máy chủ mà thông báo nêu tên đang hoạt động và có thể truy cập từ nơi lệnh chạy; một registry đang quá tải hoặc đang bảo trì sẽ trả lời lại sau, và chỉ cần chạy lại lệnh. Nếu môi trường truy cập mạng qua một proxy, hãy kiểm tra rằng proxy chuyển tiếp yêu cầu thay vì giữ nó lại. Thời gian chờ là cố định; không có thiết lập nào kéo dài nó.

A registry’s repository listing did not end in time (Danh sách repository của một registry không kết thúc kịp thời)

Việc duyệt toàn bộ danh sách repository của một registry đã chạy năm phút mà không tới được cuối danh sách, và đã bị dừng. Có hai lệnh duyệt danh sách: aggrega plugin add, chỉ khi không plugin nào mang đúng tên được đưa cho nó và nó tìm một plugin có tên chứa tên đó, và aggrega registry update, lệnh liệt kê các repository của một registry trước khi đọc từng cái. Một danh sách cứ nêu tên các repository mới không dứt, và một danh sách mà registry phục vụ quá chậm để hoàn tất, đều kết thúc tại đây thay vì giữ chân lệnh; việc duyệt không trả về repository nào cả, nên không có gì được chọn ra hay được lập chỉ mục từ một danh sách bị cắt ngang. Thông báo cho biết danh sách đã nêu tên bao nhiêu repository vào lúc bị dừng.

Thông báo được phát ra, cho một lượt thêm plugin có truy vấn là một phần của tên:

aggrega plugin add: 127.0.0.1:18472: no cli plugin is named “mo”, and searching every repository for a name containing it did not finish; name the plugin exactly, as aggrega plugin add cli <name>: the walk was stopped after 5m0s, before the listing ended (repositories named so far: 146): registry: the repository listing did not end in time (aggrega plugin add: 127.0.0.1:18472: không có plugin cli nào tên là “mo”, và việc tìm trong mọi repository một tên chứa nó đã không hoàn tất; hãy nêu chính xác tên plugin, như aggrega plugin add cli kèm theo tên plugin: việc duyệt đã bị dừng sau 5m0s, trước khi danh sách kết thúc (số repository đã nêu tên đến lúc đó: 146): registry: danh sách repository không kết thúc kịp thời)

Cách khắc phục: với aggrega plugin add, hãy nêu chính xác tên plugin — aggrega plugin add cli moo thay vì aggrega plugin add cli mo — để plugin được tra cứu theo đúng tên đó bằng một yêu cầu duy nhất và danh sách không bao giờ bị duyệt. Với aggrega registry update, nguyên nhân là danh sách của registry: hãy kiểm tra với người vận hành registry rằng danh sách của nó có kết thúc, và chạy lại lượt cập nhật khi điều đó đúng. Giới hạn năm phút là cố định; không có thiết lập nào kéo dài nó.

A registry kept asking to slow down (Registry liên tục yêu cầu giảm tốc độ)

Registry quá bận sẽ trả lời 429 Too Many Requests, hoặc 503 Service Unavailable kèm header Retry-After cho biết cần chờ bao lâu. Mọi yêu cầu mà một lệnh gửi tới registry đều chờ đúng khoảng thời gian registry yêu cầu — mười giây nếu nó không nói rõ — rồi được gửi lại; mọi yêu cầu tới registry đó đều chờ cùng, và số yêu cầu gửi tới nó cùng lúc giảm đi cho tới khi nó trả lời lại. Registry nào trong năm phút không trả lời gì ngoài “giảm tốc độ” sẽ bị từ chối theo điều kiện này, nêu tên registry, câu trả lời cuối cùng của nó và nó đã không trả lời gì khác trong bao lâu; một yêu cầu có giới hạn thời gian riêng hết hạn trong khi chờ cũng vậy. Khi đó aggrega registry update báo cáo registry đó là chưa được lập chỉ mục, và registry đó giữ nguyên chỉ mục nó có trước lần chạy.

Thông báo được phát ra, đối với registry đã yêu cầu giảm tốc độ trong năm phút:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for 5m0s: oci: the registry kept asking to slow down (liên tục yêu cầu giảm tốc độ: câu trả lời cuối cùng của nó là 429 Too Many Requests, và nó đã không trả lời gì khác trong 5m0s: oci: registry liên tục yêu cầu giảm tốc độ)

và đối với một yêu cầu mà giới hạn thời gian riêng của nó đã chấm dứt việc chờ:

<host> kept asking to slow down: its last answer was 429 Too Many Requests, and it had answered nothing else for <how long> when the request’s own time ran out: oci: the registry kept asking to slow down (liên tục yêu cầu giảm tốc độ: câu trả lời cuối cùng của nó là 429 Too Many Requests, và nó đã không trả lời gì khác cho tới khi thời gian riêng của yêu cầu hết: oci: registry liên tục yêu cầu giảm tốc độ)

Cách khắc phục: nguyên nhân là giới hạn tốc độ của registry, không phải bất cứ thứ gì bạn đã viết. Một registry giới hạn tốc độ gửi yêu cầu của client thường giới hạn mọi thứ đến từ cùng một địa chỉ, vì vậy hãy kiểm tra xem các lệnh hoặc máy khác đứng sau địa chỉ đó có đang gửi yêu cầu tới nó cùng lúc hay không, và chạy lại lệnh khi chúng đã xong. Nếu registry là do bạn vận hành, hãy kiểm tra giới hạn tốc độ của nó. Giới hạn năm phút là cố định; không có thiết lập nào kéo dài nó.

Fetched or cached bytes do not match the digest committed for them (Các byte đã tải về hoặc đã lưu đệm không khớp với digest đã cam kết cho chúng)

Mỗi artifact mang một manifest cam kết digest của nội dung nó, và lockfile ghim độc lập digest của manifest đó. Cả hai cam kết đều được kiểm tra bằng cách băm lại các byte đang có và so sánh. Đây là điều mà một phép so sánh thất bại báo cáo, và nó xảy ra theo cùng một cách với các byte vừa tải về và với các byte đọc lại từ bộ nhớ đệm.

Hai điều kiện, và điều kiện nào xảy ra cho biết lớp nào không khớp. Một điều kiện chỉ ra nội dung không khớp với digest mà chính manifest của nó cam kết. Điều kiện kia chỉ ra một manifest trong bộ nhớ đệm không khớp với digest mà lockfile đã ghim cho nó — phép kiểm tra ngăn một manifest bị giả mạo trở thành nguồn tin cậy cho một phép kiểm tra nội dung sau đó. Việc ghim là điều khiến phép kiểm tra thứ hai có ý nghĩa: nó đến từ lockfile chứ không phải từ việc suy lại manifest từ các byte trong bộ nhớ đệm, nên hai bên thực sự độc lập với nhau.

Sau đó một entity được đối chiếu với hàng của chính nó, thay vì với những gì các byte mang. Khi các byte của một entity trong bộ nhớ đệm đã khớp với manifest của chúng, chúng được so sánh với digest mà lockfile ghi cho entity, digest này bao quát các tệp mà bản phát hành của nó mang — mỗi tệp theo đường dẫn và các byte của nó — chứ không phải các byte đã nén. Vì vậy cùng các tệp được phát hành với cách nén khác vẫn khớp, còn các tệp khác dưới cùng một phiên bản thì không, và một sự không khớp được báo cáo theo điều kiện nội dung. Một lần pull tuân theo pin thực hiện cùng phép so sánh đó trên những gì registry cung cấp dưới phiên bản đã ghim.

Không phép kiểm tra nào trong số này cần mạng. Mỗi phép là một so sánh băm trên các byte đã có sẵn, điều này cho phép một bản build hoàn toàn ngoại tuyến vẫn xác lập được rằng những gì nó đang đọc chính là những gì đã được ghim.

Các thông báo được phát ra. Nội dung so với manifest của nó:

oci: content digest <computed> != manifest layer <committed>: oci: content digest mismatch

một plugin entity, mà manifest cam kết ở một vị trí khác:

oci: config digest <computed> != manifest config <committed>: oci: content digest mismatch

một manifest trong bộ nhớ đệm so với digest đã ghim:

oci: cached manifest digest <computed> != pinned <pinned>: oci: cached manifest digest mismatch

một entity trong bộ nhớ đệm so với hàng của nó, và một registry cung cấp nội dung khác dưới một phiên bản đã ghim:

catalog: cached <uri> content digest <computed> does not match lockfile pin <pinned>: oci: content digest mismatch

oci: content digest mismatch: pinned entity "<uri>": registry now serves digest <computed> for the pinned version, not the pinned digest <pinned>; run aggrega pull --upgrade --release <release> to update the pin

Cả hai đều được bao bởi bất cứ thứ gì đang được đọc. Một entity đã ghim mà không nguồn nào giữ đúng pin của nó, mang điều kiện của manifest khi manifest của mục bộ nhớ đệm không khớp, và điều kiện của nội dung trong trường hợp còn lại:

pinned entity <uri>: no source holds the pinned bytes <pinned> (<what each source it read held>); with a registry reachable, aggrega pull --release <release> fetches the pinned version again: <the message above>

Một mục trong archive chỉ ra một đường dẫn thoát ra ngoài archive cũng được báo cáo theo điều kiện nội dung, vì một bundle làm điều đó không phải là bundle đã được cam kết:

path traversal entry "<name>": oci: content digest mismatch

Cả hai mang cùng một biện pháp khắc phục khi bước phát hiện lỗi cung cấp một biện pháp:

remediation: run aggrega pull —upgrade —release <release> to refresh the lockfile and cache

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra lỗi này và không thay đổi soạn thảo nào xóa được nó. Làm mới bộ nhớ đệm và lockfile cùng lúc bằng aggrega pull --upgrade --release <release>, lệnh này tải lại từ nguồn và ghi lại cả hai. Nếu cách đó khắc phục được, bản sao trong bộ nhớ đệm đã bị thay đổi hoặc cắt cụt kể từ khi được ghi. Nếu sự không khớp vẫn còn sau khi làm mới, các byte mà bên phát hành cung cấp thực sự khác với những gì đã ghim — một phiên bản được phát hành lại, đây là câu hỏi dành cho người phát hành nó, và nên hỏi trước khi chấp nhận digest mới chứ không phải sau đó.

A manifest carries no layer of the expected kind, or more than one (Một manifest không mang layer nào thuộc loại mong đợi, hoặc mang nhiều hơn một)

Manifest của một artifact liệt kê các layer của nó, và layer mang nội dung được chọn theo media type chứ không theo vị trí. Đó là điều cho phép một artifact gộp nhiều hơn một layer — chẳng hạn một chart kèm một layer provenance tách rời bên cạnh — mà vẫn chọn ra nội dung một cách tin cậy.

Hai trường hợp khiến không có gì để chọn. Không có layer nào thuộc loại mong đợi nghĩa là manifest mô tả một thứ khác với thứ mà tham chiếu được đọc là. Nhiều hơn một nghĩa là lựa chọn không có câu trả lời, và chọn layer đầu tiên đôi khi sẽ đúng và đôi khi sai một cách âm thầm.

Các thông báo được phát ra, mỗi thông báo nêu media type được mong đợi. Không có:

oci: manifest has no layer of media type "<media-type>": oci: manifest has no layer of the expected content media type

và nhiều hơn một, thông báo này cũng nêu số lượng:

oci: manifest has <count> layers of media type "<media-type>"; expected exactly one: oci: manifest has multiple layers of the expected content media type

Cách khắc phục: việc khắc phục thuộc về bên phát hành chứ không phải bạn — manifest không phải thứ mà tác giả catalog viết. Trước hết hãy kiểm tra rằng tham chiếu trỏ đến đúng nơi bạn muốn: một tham chiếu phân giải đến một loại artifact khác sẽ tạo ra trường hợp thứ nhất, vì manifest là một manifest thật của một thứ khác. Nếu tham chiếu đúng, artifact đã được phát hành với một manifest không mô tả nó là loại mà nó được cho là, vì vậy hãy gửi media type trong thông báo cho người phát hành nó. Phát hành qua đường phát hành thông thường tạo ra một manifest có đúng một layer nội dung, nên một artifact ở một trong hai trường hợp đã được lắp ráp theo cách khác.

A published bundle holds no entity, or holds two (Một bundle đã xuất bản không chứa thực thể nào, hoặc chứa hai thực thể)

Một thực thể khai báo các tệp bên cạnh tài liệu của nó — chart cục bộ hoặc tệp lock của một Recipe, schema được nhập của một Component — được xuất bản dưới dạng một .tar.gz đóng gói thực thể cùng với các tệp đó. Đọc lại nó nghĩa là tìm lại thực thể trong số các tệp ấy — và tệp mà nó được viết trong đó có thể mang bất kỳ tên nào, nên thứ nhận diện nó là phần mở đầu thực thể mà nó mang chứ không phải tên của nó. Tài liệu ở cấp cao nhất của bundle có kind: là một loại thực thể có thể xuất bản chính là thực thể; một đoạn compose, một template chart hay một manifest Kubernetes bên cạnh nó thì không phải, và một tài liệu thực thể nằm sâu hơn bên trong cây source/ cũng không phải, vì đó là nội dung mà thực thể mang theo chứ không phải chính thực thể.

Có hai dạng không để lại gì để chọn, và cả hai đều là đặc tính của cách artifact được xuất bản.

Không có tài liệu thực thể nào ở cấp cao nhất của bundle. Bundle được đóng gói mà không có thực thể ở cấp cao nhất — tài liệu của nó bị bỏ sót, hoặc được đặt trong một thư mục con thay vì bên cạnh các tệp nó mang. Thông báo liệt kê những gì cấp cao nhất của bundle thực sự chứa, thường đủ để thấy điều gì đã xảy ra.

Hai tài liệu thực thể ở cấp cao nhất của bundle. Bundle được đóng gói từ cả một thư mục trong đó có hai thực thể được viết — điều mà aggrega push không bao giờ làm, vì mỗi thực thể chỉ mang các tệp nó khai báo, nhưng một client khác thì có thể. Khi đóng gói như vậy, mỗi tọa độ xuất bản của chúng đều mang cùng các byte — nên trả về bất kỳ cái nào cũng sẽ trao lại thực thể kia dưới cái tên được yêu cầu, mà không có gì ở phía sau có thể nhận ra. Không có lựa chọn an toàn nào, nên không lựa chọn nào được đưa ra.

Các thông báo được phát ra, liệt kê những gì đã tìm thấy. Không có thực thể nào, khi bundle mang các tệp khác:

bundle root carries no entity document among <file>, <file>: oci: published bundle carries no entity document (gốc bundle không chứa tài liệu thực thể nào trong số các tệp đã nêu: oci: bundle đã xuất bản không chứa tài liệu thực thể nào)

không có thực thể nào, khi nó không chứa gì cả:

bundle root carries no files at all: oci: published bundle carries no entity document (gốc bundle hoàn toàn không chứa tệp nào: oci: bundle đã xuất bản không chứa tài liệu thực thể nào)

và nhiều hơn một, khi thông báo nêu cả số lượng lẫn các tài liệu xung đột:

bundle root carries <count> entity documents (<file>, <file>): oci: published bundle carries more than one entity document (gốc bundle chứa nhiều tài liệu thực thể như đã nêu: oci: bundle đã xuất bản chứa nhiều hơn một tài liệu thực thể)

Cách khắc phục: cả hai đều do bên xuất bản xử lý chứ không phải bạn, và cách khắc phục nằm ở thư mục phiên bản mà thực thể được xuất bản từ đó. Cho mỗi thực thể một thư mục phiên bản riêng, để thư mục đó chứa một thực thể và các tệp thuộc về nó — bố cục mà mọi thực thể đã xuất bản đều tuân theo, trong đó thư mục được đặt tên theo metadata.version của thực thể và nằm dưới tên riêng của thực thể. Sau đó xuất bản lại ở một phiên bản mới: các byte đã xuất bản là bất biến, nên việc xuất bản lại đè lên phiên bản hiện có sẽ bị từ chối chứ không được sửa. Nếu bạn đang sử dụng chứ không phải xuất bản, hãy chuyển thông báo cho người xuất bản artifact; các tên tệp trong đó cho biết thư mục cần tách.

A published artifact cannot be read as an entity (Một artifact đã xuất bản không thể được đọc như một thực thể)

Việc đọc một thực thể từ tọa độ nơi nó được xuất bản bắt đầu từ các byte mà registry phục vụ ở đó — aggrega inspect oci://… đọc chúng để bạn xem, và một lần pull phụ thuộc cũng đọc các byte của một archive theo cách tương tự để tìm phiên bản mà nó ghim. Có hai dạng byte như vậy không chứa thực thể nào để đọc.

Một archive không giải nén được. Một thực thể được xuất bản cùng các tệp nó khai báo sẽ được xuất bản dưới dạng .tar.gz, và các byte bắt đầu như một tệp như vậy, nhưng luồng nén hoặc archive bên trong không hợp lệ — thường nhất là vì nó bị cắt ngắn. Các byte vẫn khớp với digest mà chính manifest của artifact ghi cho chúng, nên chúng đúng là những gì đã được xuất bản: hư hỏng xảy ra trước hoặc trong khi xuất bản chứ không phải trên đường đến bạn.

Một tài liệu không phải là thực thể. Tọa độ mang một tài liệu duy nhất, và tài liệu đó không phân tích được, không khai báo kind:, hoặc khai báo một loại không bao giờ được xuất bản, chẳng hạn một Release hay một Manifest. Khi đó tham chiếu chỉ đến thứ gì đó được xuất bản bên cạnh catalog chứ không phải một thực thể — ví dụ một artifact dữ liệu được xuất bản bằng aggrega push-artifact.

Các thông báo được phát ra. Một archive có luồng nén không hợp lệ, kèm lỗi đã làm nó dừng lại:

oci: unbundle gzip: <archive error>: oci: published bundle cannot be unpacked (oci: giải nén gzip: <archive error>: oci: không thể giải nén bundle đã xuất bản)

một archive dừng giữa chừng trong một tệp:

read <file> from the published bundle: <archive error>: oci: published bundle cannot be unpacked (đọc <file> từ bundle đã xuất bản: <archive error>: oci: không thể giải nén bundle đã xuất bản)

một tài liệu khai báo một loại không bao giờ được xuất bản:

the published document declares kind <kind>, which a registry does not publish: oci: published artifact is not an entity document (tài liệu đã xuất bản khai báo loại <kind>, loại mà registry không xuất bản: oci: artifact đã xuất bản không phải là tài liệu thực thể)

và các byte hoàn toàn không phải là một tài liệu:

the published bytes do not parse as a document (<parse error>): oci: published artifact is not an entity document (các byte đã xuất bản không phân tích được thành tài liệu (<parse error>): oci: artifact đã xuất bản không phải là tài liệu thực thể)

Cách khắc phục: một archive không giải nén được là việc bên xuất bản phải thay thế. Các byte đã xuất bản là bất biến, nên cách khắc phục là xuất bản lại thực thể ở một phiên bản mới; nếu bạn đang sử dụng nó, hãy chuyển thông báo cho người xuất bản. Một tài liệu không phải là thực thể hầu như luôn có nghĩa là tham chiếu không phải cái bạn định dùng: hãy kiểm tra rằng nó chỉ đến tọa độ nơi một thực thể được xuất bản, tức là tham chiếu mà aggrega push in ra khi xuất bản một thực thể.

The registry could not answer what is attached to an artifact (Registry không thể trả lời những gì được đính kèm vào một artifact)

Chữ ký và các tệp đính kèm khác gắn với một artifact chứ không nằm bên trong nó, và việc tìm chúng là một câu hỏi gửi đến registry. Tình huống này cho biết câu hỏi không được trả lời — registry không phục vụ truy vấn đó, không định vị được artifact mà các tệp đính kèm gắn vào, hoặc chính yêu cầu bị lỗi.

Điều đó không giống với câu trả lời “không có gì được đính kèm”, và việc nhầm lẫn hai điều này chính là thứ mà tình huống này tồn tại để ngăn chặn. Một artifact thực sự không có chữ ký sẽ được phân giải bình thường và trả về một danh sách rỗng. Tình huống này cho biết danh sách chưa bao giờ được lấy về, nên hoàn toàn không biết gì về những thứ được đính kèm.

Việc nó có dừng bản build hay không phụ thuộc vào việc chữ ký có bắt buộc hay không, và cả hai hướng đều có chủ ý:

  • Chữ ký là bắt buộc. Bản build dừng lại. Một kiểm tra bắt buộc không thể chạy thì chưa được thông qua, và việc chấp nhận artifact sẽ dựa trên một câu hỏi mà không ai đặt ra được.
  • Chữ ký không bắt buộc. Bản build tiếp tục và nói rõ điều đó, thay vì im lặng. Truy vấn không tạo ra gì để xác minh theo cả hai hướng, nên từ chối sẽ là loại bỏ một artifact chỉ dựa trên một câu hỏi chưa được trả lời — nhưng im lặng sẽ bị hiểu như một lần pull không chữ ký sạch sẽ, trong khi thực tế không phải vậy.

Các thông báo được phát ra. Một registry không phục vụ truy vấn:

oci: target does not support referrer discovery: <target kind>: oci: referrer discovery could not be completed (oci: đích không hỗ trợ khám phá referrer: <target kind>: oci: không thể hoàn tất khám phá referrer)

không định vị được chính artifact:

oci: resolve subject "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: phân giải chủ thể theo tham chiếu đã nêu thất bại do lỗi bên dưới: oci: không thể hoàn tất việc khám phá referrer)

và truy vấn bị lỗi:

oci: list referrers of "<reference>": <the underlying failure>: oci: referrer discovery could not be completed (oci: liệt kê các referrer của tham chiếu đã nêu thất bại do lỗi bên dưới: oci: không thể hoàn tất việc khám phá referrer)

Khi chữ ký không bắt buộc, cùng nội dung đó sẽ xuất hiện dưới dạng một thông báo lưu ý:

signature verification could not run for <uri> (the registry could not answer the signature lookup and no signature is required; continuing): <the message above> (không thể chạy xác minh chữ ký cho <uri> (registry không thể trả lời truy vấn chữ ký và không yêu cầu chữ ký; tiếp tục): <the message above>)

Cách khắc phục: việc khắc phục thuộc về người vận hành và nằm ở registry chứ không phải ở catalog của bạn. Khi registry hoàn toàn không phục vụ truy vấn tệp đính kèm, nó không thể mang chữ ký, nên hãy hoặc sao chép artifact sang một registry có thể, hoặc ngừng yêu cầu chữ ký từ host đó trong .aggrega-config.yaml — và ghi nhận bạn đang chọn cách nào, vì cách thứ hai có nghĩa là chữ ký từ host đó không còn được kiểm tra nữa. Khi truy vấn thất bại với một registry có phục vụ nó, đây là vấn đề truyền tải hoặc quyền truy cập riêng trên endpoint tệp đính kèm, và chạy lại khi registry truy cập được là toàn bộ cách khắc phục.

An artifact that must be signed carries no signature (Một artifact bắt buộc phải được ký nhưng không mang chữ ký nào)

Một artifact bắt buộc phải có chữ ký khi chính sách ký của riêng workspace bao trùm kind của nó, hoặc khi registry mà nó đến từ đó được cấu hình để yêu cầu chữ ký. Điều kiện này báo rằng registry đã trả lời truy vấn attachment, không có gì được đính kèm, và một chữ ký là bắt buộc.

Hai yêu cầu này là một lập trường được đọc ở hai phạm vi. Chính sách toàn workspace buộc phải có chữ ký đối với một kind trong phạm vi, kể cả từ một host mà mục cấu hình riêng của nó không yêu cầu chữ ký, nên một host không yêu cầu gì cũng không miễn trừ một artifact mà chính sách toàn workspace bao trùm.

Ở nơi không yêu cầu chữ ký, đây hoàn toàn không phải là lỗi. Artifact được xác minh nếu có chữ ký và lặng lẽ được chấp nhận nếu không có, đó là điều giúp một host không có lập trường được cấu hình dùng được mà không cần thủ tục gì.

Một artifact không xác định được kind trong khi một chính sách toàn workspace đang bật sẽ được coi là cần chữ ký chứ không phải được miễn, nên một artifact không phân loại được không thể lọt qua một chính sách đang bật.

Thông báo được phát ra, đặt trong khung là tham chiếu đang được kiểm tra:

verifying the signature of <uri>: signing: no signature found for an artifact that requires one (đang xác minh chữ ký của <uri>: signing: không tìm thấy chữ ký cho một artifact bắt buộc phải có chữ ký)

Cách khắc phục: việc sửa thuộc về người vận hành hoặc bên phát hành, không phải tác giả entity. Nếu bạn mong artifact đã được ký, thì nó đã được phát hành mà không có chữ ký — hãy gửi tham chiếu cho bên phát hành nó, vì chỉ họ mới đính kèm được chữ ký. Nếu artifact không được dự định ký, thì yêu cầu mới là thứ cần thay đổi: nó đến hoặc từ mục của registry trong .aggrega-config.yaml, hoặc từ chính sách ký toàn workspace, và tham chiếu trong thông báo cho bạn biết cần xem host nào. Tắt một yêu cầu đồng nghĩa với việc artifact từ host đó không còn được kiểm tra, vì vậy hãy ưu tiên thu hẹp phạm vi của chính sách về một kind thay vì tắt hẳn.

A signature does not verify (Một chữ ký không xác minh được)

Một chữ ký đã được tìm thấy và kiểm tra, và việc kiểm tra thất bại. Đây là kết quả phủ định chung của việc kiểm tra đó, bao gồm: một chuỗi chứng chỉ không có gốc trong trust material, một chữ ký không có bản ghi transparency-log ở nơi bắt buộc phải có, một chữ ký trên một artifact khác với artifact đang có, một bundle đã bị thay đổi, và một bundle được kiểm tra bằng một khóa đã ghim nhưng không xác minh được với khóa đó.

Nó được cố ý tách biệt với trường hợp chữ ký có người ký không được tin cậy. Trường hợp kia hợp lệ về cấu trúc nhưng do sai người ký; trường hợp này hoàn toàn không qua được kiểm tra. Tách riêng hai trường hợp là điều giúp bạn phân biệt “artifact không phải là thứ đã được ký” với “artifact đã được ký bởi một người bạn chưa chấp nhận”.

Artifact mà một chữ ký được tạo cho được kiểm tra hai lần. Khi kiểm tra mật mã của chữ ký đạt, toolchain đọc từ chính chữ ký xem nó được tạo cho artifact nào — cũng chính là cách đọc mà mọi build sau đó dùng để đối chiếu chữ ký đã ghi, điều giúp một build từ chối chữ ký bị sao chép từ artifact này sang artifact khác mà không cần xác minh gì — và từ chối chữ ký nếu cách đọc đó không chỉ ra artifact đang có, hoặc nếu chữ ký ở dạng mà cách đọc không thể xác định được artifact. Cả hai dạng mà một lần pull chấp nhận đều được đọc: chữ ký tạo trên chính artifact, và một tuyên bố đã ký có nêu tên artifact. Cách đọc tuân theo chính các quy tắc của kiểm tra mật mã, nên với một chữ ký mà kiểm tra đó chấp nhận thì hai bên sẽ khớp nhau; một lần từ chối kiểu này nghĩa là chúng không khớp, và nên được báo cáo kèm tham chiếu và thông báo thay vì cấu hình để né qua.

Nếu mục của một registry đánh dấu việc xác minh là advisory, cùng văn bản đó được báo dưới dạng thông báo và lần chạy tiếp tục.

Các thông báo được phát ra. Từ chính việc kiểm tra, trích lại những gì bộ xác minh báo cáo:

signing: signature bundle does not verify: <what the verifier reported> (signing: signature bundle không xác minh được: nội dung trình xác minh báo cáo)

và, khi kiểm tra mật mã đạt nhưng cách đọc artifact mà chữ ký được tạo cho không khớp:

signing: signature bundle does not verify: its cryptographic check holds, but it does not name <manifest-digest> as the artifact it was made for (signing: signature bundle không xác minh được: kiểm tra mật mã của nó đạt, nhưng nó không nêu digest manifest đã nêu là artifact mà nó được tạo cho)

signing: signature bundle does not verify: its cryptographic check holds, but it is in a form from which the artifact it was made for cannot be read (signing: signature bundle không xác minh được: kiểm tra mật mã của nó đạt, nhưng nó ở dạng không thể đọc ra artifact mà nó được tạo cho)

mỗi thông báo được đặt trong khung là tham chiếu đang được xác minh:

verifying the signature of <uri>: <the message above> (đang xác minh chữ ký của <uri>: <the message above>)

và, khi mục của registry đặt việc xác minh là advisory, dưới dạng thông báo thay vì dừng:

signature verification failed for <uri> (advisory; continuing): <the message above> (xác minh chữ ký thất bại cho <uri> (advisory; tiếp tục): <the message above>)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra lỗi này và không thay đổi soạn thảo nào xóa được nó. Hãy coi đây là một nhận định về artifact chứ không phải về cấu hình của bạn: các byte đang có không phải là các byte đã được ký, hoặc chữ ký không phải loại mà trust material đã cấu hình kiểm tra được. Trước tiên hãy lấy lại artifact, vì một bản cache bị cắt cụt hoặc bị thay đổi sẽ thất bại đúng theo cách này và một lần fetch mới sẽ xóa được lỗi. Nếu lỗi vẫn còn sau lần fetch mới, hãy gửi tham chiếu và nguyên văn lời của bộ xác minh cho bên phát hành artifact. Đừng dùng thiết lập advisory để vượt qua — thiết lập đó giữ việc kiểm tra chạy nhưng không cho nó dừng build, đó là một lựa chọn có chủ ý để chấp nhận các artifact chưa được xác minh từ host đó chứ không phải cách sửa lỗi.

A signature verifies but its signer is not one the registry trusts (Một chữ ký xác minh được nhưng người ký không phải là người mà registry tin cậy)

Chữ ký đã qua kiểm tra — chuỗi chứng chỉ có gốc trong trust material và bản ghi transparency có mặt — nhưng danh tính trong chứng chỉ đó không khớp với danh tính nào được cấu hình là chấp nhận được cho registry. Artifact đã được ký bởi một người ký thật nhưng chưa được chấp nhận.

Cả hai nửa của một danh tính đều được so sánh, subject và issuer bảo chứng cho nó, và nửa nào cũng có thể là nửa không khớp. Thông báo nêu cả hai khi đọc được chúng từ chứng chỉ, vì một người ký đưa ra subject đúng như mong đợi nhưng dưới một issuer không ai chấp nhận trông giống hệt một subject sai nếu không hiển thị cả hai.

Các thông báo được phát ra. Khi đọc được cả hai nửa:

signing: signature identity is not trusted for this registry: <what the verifier reported>; signer presented issuer "<issuer>" with identity "<subject>", but no trusted identity permits that issuer (signing: danh tính chữ ký không được tin cậy cho registry này: nội dung trình xác minh báo cáo; bên ký đã trình bày bên cấp phát đã nêu với danh tính đã nêu, nhưng không có danh tính tin cậy nào cho phép bên cấp phát đó)

và khi không đọc được, quay về báo cáo riêng của bộ xác minh:

signing: signature identity is not trusted for this registry: <what the verifier reported> (signing: danh tính chữ ký không được tin cậy cho registry này: nội dung trình xác minh báo cáo)

Cách khắc phục: đây là quyết định của người vận hành, và là một quyết định thực sự chứ không phải thủ tục. Hãy so sánh issuer và danh tính trong thông báo với các danh tính tin cậy được cấu hình cho registry đó trong .aggrega-config.yaml. Nếu người ký là người bạn muốn chấp nhận, hãy thêm vào — một mục nêu một danh tính, hoặc một mẫu khớp với danh tính, cùng với issuer, và cả hai đều phải đúng. Nếu không phải, artifact đã được ký bởi một người bạn chưa chấp nhận, và thêm danh tính đó chỉ để build chạy qua chính là phản ứng cần tránh. Các registry công bố chính sách tin cậy riêng có thể được ghim chính sách đó khi thêm registry, đây là cách đưa các danh tính mong muốn vào mà không phải chép tay.

A keyless trust policy names no acceptable signer (Chính sách tin cậy không dùng khóa không nêu tên người ký nào được chấp nhận)

Xác minh không dùng khóa quyết định có chấp nhận một artifact hay không bằng cách đối chiếu danh tính trong chứng chỉ ký của nó với một tập danh tính được cấu hình là chấp nhận được. Một tập rỗng bị từ chối thay vì được coi là một chính sách: đối chiếu với tập rỗng sẽ hoặc chấp nhận mọi người ký hoặc từ chối tất cả, và cả hai đều không phải là điều mà một người vận hành đã cấu hình xác minh muốn.

Thông báo được phát ra, chính là câu mô tả của điều kiện này:

signing: keyless verification requires at least one trusted identity (signing: xác minh không dùng khóa cần ít nhất một danh tính tin cậy)

Cách khắc phục: cấu hình ít nhất một danh tính tin cậy cho registry trong .aggrega-config.yaml. Một mục nêu danh tính — dưới dạng một subject chính xác hoặc một mẫu khớp với nó — cùng với issuer bảo chứng cho nó, và cả hai đều bắt buộc. Khi registry công bố chính sách tin cậy của riêng nó, việc ghim chính sách đó khi thêm registry sẽ điền tập danh tính từ những gì registry công bố. Khi bạn hoàn toàn không định xác minh chữ ký từ registry này, đó là một thiết lập khác với một tập danh tính rỗng, và đặt thiết lập đó một cách tường minh mới là cách nói điều này.

The pinned trust root cannot be read (Không thể đọc trust root đã ghim)

Một trust root được ghim trong workspace là thứ cho phép kiểm tra không dùng khóa xác minh mà không cần truy cập mạng ở bất cứ đâu nó chạy: một tệp có nội dung là tài liệu mà mọi chữ ký được kiểm tra dựa vào. Điều kiện này báo rằng tệp tại đường dẫn đã cấu hình không thể chuyển thành tài liệu tin cậy dùng được — nó không tồn tại, không đọc được, hoặc nội dung của nó không phải là một trust root.

Nó dừng thay vì chuyển sang phương án dự phòng. Một root được ghim là lựa chọn có chủ đích để kiểm tra chữ ký dựa trên tài liệu bạn kiểm soát, nên lặng lẽ tải về một root khác thay thế sẽ thay lựa chọn đó bằng một lựa chọn khác và tạo ra một kết quả xác minh mà không ai yêu cầu.

Thông báo được phát ra, nêu đường dẫn và trích dẫn điều mà thao tác đọc đã báo:

signing: cannot load pinned trust root: <path>: <what the read reported> (signing: không thể tải trust root đã ghim: <path>: <what the read reported>)

Cách khắc phục: việc này thuộc về người vận hành. Kiểm tra rằng đường dẫn được cấu hình cho trust root tồn tại và người chạy lệnh có thể đọc được — một đường dẫn tương đối so với một thư mục làm việc khác, và một tệp có tồn tại nhưng không đọc được, đều được báo ở đây. Khi tệp tồn tại và đọc được, nội dung của nó không phải là một trust root, vì vậy hãy thay nó bằng một bundle hiện hành từ nguồn bạn đã lấy nó thay vì chỉnh sửa nó. Khi không định ghim root, cấu hình là thứ cần thay đổi: bỏ thiết lập ghim và việc xác minh sẽ dùng tài liệu mà nó lẽ ra được cung cấp.

A pinned verification key is not the key profile the verifier accepts (Khóa xác minh đã ghim không thuộc key profile mà bộ xác minh chấp nhận)

Việc ký và xác minh với một khóa được nắm giữ dùng một key profile duy nhất, và khóa thuộc bất kỳ loại nào khác đều bị từ chối thay vì được thử. Đây là nhận định về loại của khóa, không phải về việc nó có xác minh được gì hay không.

Hai thời điểm nó báo là hai công việc khác nhau. Một là tải khóa để ký, diễn ra khi một artifact được công bố; hai là kiểm tra chữ ký với một khóa được ghim cho một registry, diễn ra khi một artifact được xác minh. Sự từ chối là như nhau trong cả hai.

Các thông báo được phát ra, mỗi thông báo nêu thuật toán của khóa thực sự được cung cấp — an RSA key hoặc an Ed25519 key. Một khóa xác minh đã ghim:

signing: unsupported held-key type: pinned key is <the key's algorithm>, want ECDSA P-256 (signing: loại khóa nắm giữ không được hỗ trợ: khóa đã ghim dùng thuật toán đã nêu, cần ECDSA P-256)

và một khóa được tải để ký:

signing: unsupported held-key type: held key is <the key's algorithm>, want ECDSA P-256 (signing: loại khóa nắm giữ không được hỗ trợ: khóa nắm giữ dùng thuật toán đã nêu, cần ECDSA P-256)

Cách khắc phục: cung cấp một khóa thuộc profile mà thông báo nêu. Khi bạn đang xác minh, khóa là khóa được ghim cho registry trong .aggrega-config.yaml và nó phải là nửa công khai của khóa mà nhà phát hành dùng để ký — sự không khớp ở đây thường có nghĩa là đã ghim sai tệp, vì một khóa đúng loại nhưng sai khóa sẽ được báo là một chữ ký không xác minh được. Khi bạn đang ký, hãy tạo một khóa thuộc profile được nêu, hoặc dùng cách không dùng khóa, vốn hoàn toàn không cần khóa nắm giữ.

The workspace is offline and the step needs the network (Workspace đang ngoại tuyến và bước này cần mạng)

Một workspace có thể được đánh dấu ngoại tuyến, và thiết lập đó là một sự từ chối chứ không phải một ưu tiên: mọi bước sẽ truy cập mạng đều bị từ chối ngay tại nơi nó được tạo, trước khi có bất kỳ kết nối nào. Từ chối sớm là điều khiến lỗi nói “workspace này đang ngoại tuyến” thay vì xuất hiện muộn hơn dưới dạng hết thời gian chờ mà không có lời giải thích.

Một quyết định, được đọc ở một nơi. Một bước cần biết trước liệu mạng có thể truy cập được hay không sẽ hỏi cùng câu hỏi mà chính thao tác tải hỏi, nên một phép kiểm tra và thao tác mà nó bảo vệ không thể đi đến kết luận khác nhau.

Nó áp dụng cho nhiều loại công việc, tất cả đều là cùng một sự từ chối: lấy một artifact từ registry, lấy nguồn của một Recipe qua mạng, tải một đầu vào bên ngoài, lấy danh tính để ký, và tải tài liệu tin cậy. Một bản build đọc từ cache đã được điền sẵn không chạm tới bất kỳ việc nào trong số đó, và đó chính là mục đích của thiết lập này.

Khi toàn bộ lệnh là một lượt trao đổi qua mạng, sự từ chối đến trước chứ không phải sau cùng. push, push-artifact và registry update tồn tại để truy cập registry, nên chúng báo điều đó trước khi đọc entity của bạn hoặc duyệt các repository của bạn, và chúng nêu nơi nào trong ba nơi đã đặt trạng thái này — cờ bạn đã gõ, biến môi trường, hoặc tệp và khóa bên trong nó. Một --dry-run là ngoại lệ, và nó là ngoại lệ vì những gì nó làm chứ không phải vì tên gọi của nó: nó báo cáo những gì nó sẽ công bố và không gọi gì cả, nên nó là dạng công bố an toàn khi ngoại tuyến và vẫn tiếp tục hoạt động.

Thông báo được phát ra, mang theo cách khắc phục của riêng nó và chính là câu mô tả của điều kiện này:

egress: network access refused because the workspace is offline; remediation: pass --offline=false to allow the network for this one run, or clear the top-level offline key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run aggrega pull --release <release> from a connected environment first to populate the cache (egress: truy cập mạng bị từ chối vì workspace đang ngoại tuyến; khắc phục: truyền —offline=false để cho phép mạng trong lần chạy này, hoặc xóa khóa offline cấp cao nhất trong tệp cấu hình (hoặc AGGREGA_OFFLINE) để cho phép từ nay về sau; khi công việc là một bản build cần nội dung mà máy không có, hãy chạy aggrega pull —release <release> từ một môi trường có kết nối trước để điền cache)

Được bao bởi bất cứ thứ gì đã cần mạng — chẳng hạn như lấy nguồn của một Recipe:

sourceresolver: kind=<kind> url=<url> version=<version>: <the message above>

Việc thêm hub chính thức trong một workspace ngoại tuyến không bị từ chối: hub được thêm dựa trên baseline tích hợp sẵn của nó, và thông báo cho biết hub không được hỏi về chính sách tin cậy của nó vì workspace đang ngoại tuyến.

Cách khắc phục: thông báo nêu ba cách và việc cách nào áp dụng là do bạn quyết định. Khi trạng thái đã được đặt và bạn muốn vượt qua nó cho riêng lệnh này, hãy truyền --offline=false; đó là mục đích của cờ này, và đó là câu trả lời duy nhất dành cho người không tự viết tệp cấu hình. Khi workspace được định là ngoại tuyến, nội dung còn thiếu là thứ cần khắc phục: chạy pull từ nơi có truy cập mạng để cache chứa mọi thứ mà release cần, sau đó bản build ngoại tuyến không cần gì thêm. Khi nó hoàn toàn không được định là ngoại tuyến, hãy xóa thiết lập tại nguồn của nó — khóa offline cấp cao nhất trong .aggrega-config.yaml, hoặc biến môi trường mà thông báo nêu, và biến này là thứ hay khiến người ta bất ngờ vì nó không nằm trong tệp nào. Lưu ý rằng một workspace ngoại tuyến hoàn toàn không thể ký bằng cách không dùng khóa, vì việc cấp chứng chỉ và ghi nhận nó là các thao tác mạng không có dạng ngoại tuyến.

Khi xây dựng topology

Khi mọi Component đã có một Recipe được phân giải, trình biên dịch ghép các Components lại với nhau thành đồ thị IR bằng cách đọc khối uses: của từng Component và đối chiếu các đích cùng các feature attachment.

Đích uses treo (không tồn tại)

Một cạnh uses: nêu tên một component đích không tồn tại trong topology đã phân giải. Điểm dừng này không phụ thuộc vào nguồn gốc — một cạnh Aggregate do nhà phát triển viết và một cạnh do Release nối đều bị bắt như nhau. Một đích treo là một điểm dừng nghiêm trọng, không phải một sự loại bỏ âm thầm: nếu không, một cạnh tới một đích không tồn tại sẽ biến mất và để các giá trị được inject của bên tiêu thụ trống một cách âm thầm lúc triển khai. Đây là anh em về mặt cấu trúc của điểm dừng socket chưa khai báo ở bên dưới: dù một kết nối được nối vào socket nào, đích của nó phải phân giải tới một component hiện có trước khi cạnh được kiểm tra kiểu.

Thông báo được phát ra. Lời từ chối đứng đầu, sau đó là đích không ứng với thứ gì và socket mà kết nối được nối vào — rồi đến cách xử lý:

uses edge target does not exist ("<target>", wired into socket "<socket>"). Point the target at a component the Aggregate declares, or declare a component under that name. (Đích của cạnh uses không tồn tại (<target>, được nối vào socket <socket>). Hãy trỏ đích tới một component mà Aggregate khai báo, hoặc khai báo một component dưới tên đó.)

Phát hiện được định vị tại mục đã viết mà nó nói đến, trong tài liệu nơi mục đó được viết, nên một kết nối do chính khối uses: của một component vẽ ra, một kết nối do một attachment chiếu ra, và một kết nối do một Release nối đều được báo tại khối riêng của chúng. Mỗi kết nối vi phạm được báo thành một phát hiện riêng, nên một lần build nêu tên tất cả thay vì dừng ở cái đầu tiên.

Cách khắc phục: khai báo component đích còn thiếu, hoặc sửa tên đích trong mục uses: cho khớp với một component hiện có.

Hai kết nối của một component dưới cùng một alias

Một component đọc từng kết nối của nó theo alias — khóa mà kết nối được viết dưới đó, hoặc, với một kết nối được viết như một mục danh sách, chính tên của đích của nó. Một template của Recipe đọc các kết nối của một component theo khóa chỉ là alias, còn một assertion đọc chúng theo khóa socket rồi đến alias, nên hai kết nối của một component dưới cùng một alias sẽ dùng chung một vị trí trong ít nhất một trong các góc nhìn đó: kết nối sau sẽ chiếm nó, và kết nối kia sẽ vắng mặt khỏi những gì template hoặc assertion thấy. Vì vậy một alias đặt tên cho một kết nối của một component — bất kể mỗi kết nối được nối vào socket nào, thứ gì đã vẽ ra nó (chính khối uses: của component, khối uses: của một attachment ở bất kỳ phạm vi nào, hoặc một mục per-edge của Release), và bất kể đích của nó. Một cặp như vậy sẽ dừng build khi đồ thị đã hoàn chỉnh, trước khi bất kỳ assertion nào chạy và trước khi bất cứ thứ gì được render.

Cặp này nảy sinh từ cách viết hợp lệ trên từng bề mặt riêng lẻ: mục riêng của một component và mục của một attachment trên cùng một socket và alias; một danh sách nêu một đích hai lần (models: [llama, llama]); một alias được viết trên hai socket (models: { local: … } bên cạnh databases: { local: … }); hai attachment nối cùng một alias; hoặc một mục Release vẽ một kết nối trên một socket mà Aggregate để chưa gắn, dưới một alias mà Aggregate đã dùng trên một socket khác. Hai dạng lân cận không bao giờ chạm tới điểm dừng này: một khóa được viết hai lần trong một khối các mục có khóa làm tài liệu không tải được, và một mục Release tại một socket và alias mà một khối khác đã vẽ sẽ cấu hình kết nối đó — hoặc, nếu nêu một đích khác, sẽ dừng như một retarget — thay vì vẽ một kết nối thứ hai.

Thông báo được phát ra. Lời từ chối đứng đầu, sau đó là alias và component, rồi socket của kết nối này, đích của nó và nơi mục của nó được viết, rồi điều tương tự cho kết nối đang giữ alias — rồi đến cách xử lý:

connection alias is already used by another connection of the same component ("<alias>", on component "<component>", this connection wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>", the connection already holding the alias wired into socket "<socket>", with target "<target>", written in "<file>", at "<key path>"). Give one of the two connections an alias of its own: a component reads each connection by its alias, whatever socket it is wired into. A list entry takes its target’s name as its alias, so a target listed twice is listed once, or written as two keyed entries under two aliases. (Bí danh kết nối đã được một kết nối khác của cùng component sử dụng (<alias>, trên component <component>, kết nối này được nối vào socket <socket>, với đích <target>, được viết trong <file>, tại <key path>, kết nối đang giữ bí danh được nối vào socket <socket>, với đích <target>, được viết trong <file>, tại <key path>). Hãy cho một trong hai kết nối một bí danh riêng: một component đọc mỗi kết nối theo bí danh của nó, bất kể nó được nối vào socket nào. Một mục danh sách lấy tên đích của nó làm bí danh, vì vậy một đích được liệt kê hai lần thì hãy liệt kê một lần, hoặc viết thành hai mục có khóa dưới hai bí danh.)

Khi cả hai kết nối được viết tại cùng một đường dẫn khóa — một danh sách nêu một đích hai lần — mỗi kết nối còn được nêu theo vị trí của nó trong danh sách đó, list entry "2" bên cạnh list entry "1", đây là thứ duy nhất phân biệt hai mục.

Phát hiện được định vị tại chính mục của kết nối sau — kết nối được vẽ thứ hai, chính là kết nối lẽ ra đã chiếm vị trí của alias — trong tài liệu nơi mục đó được viết. Vì vậy một mục Release, hoặc một attachment mà Release viết, được xếp là lỗi vận hành, còn một mục trong Aggregate là lỗi của nhà phát triển. Mỗi kết nối vi phạm được báo thành một phát hiện riêng, nên một lần build nêu tên tất cả.

Một số dạng được nêu kém chính xác hơn. Một tên attachment được khai báo ở nhiều hơn một phạm vi — chẳng hạn trên một component và trên subsystem chứa nó — vẽ một kết nối từ mỗi khối khai báo, và build ghi nhận cả hai chỉ dưới tên của attachment. Khi đó cả hai kết nối được nêu tại một trong các khối khai báo — chính khối attachment của component, ở bất cứ đâu tên được khai báo tại đó — và không kết nối nào mang vị trí danh sách. Điều tương tự cũng đúng bên trong một Aggregate được import, nơi các khối khai báo — khối của một component và khối của một trong các subsystem của chính module — được nêu trong tài liệu của chính module. Trong mọi dạng này, cặp vẫn bị từ chối.

Cách khắc phục: cho một trong hai kết nối một alias riêng. Với một danh sách nêu một đích hai lần, hãy liệt kê đích một lần, hoặc viết hai kết nối thành các mục có khóa dưới hai alias. Với một alias trên hai socket, hãy đổi tên một trong hai khóa. Một attachment nối một socket dưới một alias mà component đã dùng thì lấy một khóa khác trong chính khối uses: của nó.

uses: socket not declared in the owning entity’s usesSchema (Socket uses không được khai báo trong usesSchema của thực thể sở hữu)

Một khối uses: nêu tên một socket mà thực thể sở hữu bề mặt đó không khai báo trong usesSchema của nó, trên một trong hai bề mặt mà ở đó chỉ được nêu tên socket đã khai báo: uses: của một attachment Feature, nơi socket phải được khai báo trên Feature được gắn, và uses: theo từng cạnh của một Release, nơi socket phải được khai báo trên Component tiêu thụ. Một Release chỉ có thể nối hoặc cấu hình các cạnh trong phạm vi những socket mà usesSchema của Component đã khai báo.

Bề mặt attachment được kiểm tra ở mọi phạm vi mà một attachment được viết: trên một component, trên một subsystem — của Aggregate hoặc của một module mà nó import — trên một boundary của Release, và trên một mục component của Release, bao gồm cả mục cho một component do module đóng góp. Các khai báo của chính module được kiểm tra khi composition import nó được build, và phát hiện nêu Aggregate của module và khóa bên trong tài liệu của nó.

Khối uses: của chính một component cố ý không thuộc các bề mặt đó, nên lỗi dừng này không xảy ra với nó. Nhà phát triển sở hữu topology mà Aggregate khai báo và có thể nêu tên một socket mà catalog không khai báo; việc catalog không nói gì về một socket nghĩa là kết nối đó không được dự liệu trước, chứ không phải bị cấm. Một socket như vậy là hợp lệ và cạnh của nó được dựng — cái nó mất đi là selector và hợp đồng theo từng cạnh mà một socket đã khai báo mang theo. Do đó, một tên socket viết sai chính tả ở đó không phải là lỗi dừng mà là một kết nối ad-hoc riêng, và được báo dưới dạng cảnh báo nêu cả hai cách viết — xem warnings.md “Uses-socket near-miss lint”.

Thông báo được phát ra:

unknown uses socket: name a socket the entity declares in its usesSchema — only a component’s own uses block may name one the catalog did not declare (Release <release-name>, at .spec.components.<component>, "<component-type>", "<socket-name>", "<declared-sockets>") (socket uses không xác định: hãy nêu tên một socket mà thực thể khai báo trong usesSchema của nó — chỉ khối uses của chính một component mới có thể nêu tên socket mà catalog không khai báo; Release, vị trí, kiểu component, tên socket và các socket đã khai báo được nêu ra)

Nhánh attachment nêu loại feature thay cho loại component; một Feature được gắn mà hoàn toàn không khai báo usesSchema thì thay vào đó báo rằng các khai báo uses: không được phép cho nó.

Cách khắc phục: trên một attachment, sửa tên socket thành một socket mà Feature được gắn khai báo, hoặc khai báo socket đó trong usesSchema của Feature. Trên một mục theo từng cạnh của Release, sửa tên socket thành một socket mà Component tiêu thụ khai báo — một Release không thể đưa vào một socket mà Component không khai báo, và chuyển khai báo vào thực thể catalog là cách được hỗ trợ. Nếu thực thể catalog hoàn toàn không khai báo usesSchema, nó không chấp nhận khai báo uses: nào trên bề mặt đó — hãy xóa khối này.

A connection carries an attachment under a name its socket declares no slot for (Một kết nối mang một attachment dưới một tên mà socket của nó không khai báo slot nào)

Khối features: của một mục kết nối nêu tên một attachment mà không slot nào của socket của kết nối khai báo. Các attachment mà một kết nối mang là một tập đóng: socket mà kết nối được nối qua khai báo, trong một featuresSchema trên mục usesSchema của Component tiêu thụ, mọi slot mà một kết nối trên nó có thể điền, và một attachment dưới bất kỳ tên nào khác bị từ chối khi bản build nạp. Một socket không khai báo featuresSchema không chấp nhận attachment nào trên các kết nối của nó, và một socket mà Aggregate nêu tên nhưng Component không khai báo cũng vậy — một socket như thế không khai báo slot nào.

Quy định này áp dụng trên cả hai tài liệu viết attachment của một kết nối: mục kết nối của Aggregate dưới uses: của một component, và mục uses: theo từng cạnh của Release. Với một component do một sub-aggregate đóng góp, các tên của nhà phát triển được kiểm tra khi tài liệu riêng của sub-aggregate đã được đọc, và kết quả nêu tệp của tài liệu đó cùng mục của component trong đó. Các tên của Release được kiểm tra khi composition đã được làm phẳng, cho mọi component mà Release viết vào, và kết quả nêu mục riêng của Release — bên trong boundary chứa nó, hoặc dưới mục định tuyến dẫn tới component của một sub-aggregate. Một mục Release trên socket mà Component không khai báo được báo bởi lỗi dừng socket chưa khai báo ở trên, vốn liệt kê các socket đang tồn tại, chứ không phải bởi lỗi này.

Thông báo được phát ra. Lời từ chối đứng đầu, sau đó là tài liệu và mục, tên của attachment, kết nối, socket, component và các slot mà socket khai báo — rồi đến việc cần làm:

a connection carries an attachment under a name its socket declares no slot for (Aggregate <aggregate-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<attachment>", on the connection "<alias>", through socket "<socket>", of component "<component>", the socket declaring the slots "<slots>"). Write the attachment under one of the slots the socket declares, or declare this slot in the socket’s featuresSchema on the Component. (một kết nối mang một attachment dưới một tên mà socket của nó không khai báo slot nào. Hãy viết attachment dưới một trong các slot mà socket khai báo, hoặc khai báo slot này trong featuresSchema của socket trên Component.)

Khi tên chỉ cách một slot mà socket khai báo một lần sửa — một ký tự bị đảo, bị thiếu, bị lặp hoặc sai, dạng mà một lỗi gõ thường có — slot đó được nêu ngay sau nó, để cách viết có khả năng được dự định nằm trong cùng câu:

a connection carries an attachment under a name its socket declares no slot for (Release <release-name>, at .spec.boundaries.<boundary>.components.<component>.uses.<socket>.<alias>, "credentail", near the declared slot "credential", on the connection "<alias>", …)

Không có thông báo tư vấn riêng nào được đưa ra cho một tên như vậy. Trên khối features: của chính một component, một tên cách một slot đã khai báo một lần sửa là hợp lệ và chỉ kéo theo thông báo tư vấn trong mục “An attachment name is one edit from a declared slot” bên dưới; trên một kết nối, tên đó bị từ chối, và chính lời từ chối mang theo cặp ghép này.

Khi socket không khai báo slot nào, danh sách không có và lời khuyên là “The socket declares no slots, so no connection wired through it carries an attachment: remove the attachment, or declare the slot in the socket’s featuresSchema on the Component.” (Socket không khai báo slot nào, nên không kết nối nào nối qua nó mang attachment: hãy xóa attachment, hoặc khai báo slot trong featuresSchema của socket trên Component.) Khi Component hoàn toàn không khai báo socket, lời khuyên là “The component’s type does not declare this socket, so the socket declares no slots and no connection wired through it carries an attachment: remove the attachment, or declare the socket and its slot in the Component’s usesSchema.” (Loại của component không khai báo socket này, nên socket không khai báo slot nào và không kết nối nào nối qua nó mang attachment: hãy xóa attachment, hoặc khai báo socket và slot của nó trong usesSchema của Component.)

Mỗi attachment vi phạm được báo thành một kết quả riêng, nên một bản build nêu tất cả chúng.

Cách khắc phục: viết attachment dưới một slot mà socket khai báo; hoặc, nếu kết nối cần một slot mà socket không có, hãy khai báo nó trong featuresSchema của socket trên Component. Trên một socket mà Component không khai báo, hãy khai báo socket và slot của nó trong usesSchema của Component, hoặc xóa attachment.

Release retargets a developer-declared edge (Release đổi đích một cạnh do nhà phát triển khai báo)

Một mục uses: theo từng cạnh của Release nêu một đích khác với đích mà nhà phát triển đã nối cho cùng socket và alias đó. Một Release có thể cấu hình một cạnh do nhà phát triển khai báo (đặt infra theo từng cạnh, nêu cùng đích hoặc bỏ qua đích) và có thể nối một cạnh vào một socket đã khai báo nhưng chưa được gắn, nhưng không được đổi đích một cạnh do nhà phát triển khai báo — nhà phát triển sở hữu kiến trúc mà họ đã viết.

Hai đích được so sánh đúng như khi được viết, không phải như khi được phân giải. Một target: có thể nêu alias đã công bố của một sub-aggregate thay vì id của một component, và alias đó phân giải thành component mà module công bố nó cho — vì vậy một mục Release lặp lại chính alias mà nhà phát triển đã viết là một cấu hình và được chấp nhận, giống hệt như việc lặp lại một id component thông thường.

Cạnh giữ nguyên đích mà nhà phát triển đã đặt cho nó dù điểm dừng này có xảy ra hay không, và infra: của mục Release không được áp dụng cho nó. Một lần đổi đích bị từ chối không bao giờ được áp dụng một nửa.

Thông báo được phát ra. Lời từ chối đứng đầu, tiếp theo là đích mà nhà phát triển đã khai báo, đích mà Release nêu, và socket — sau đó là cách xử lý:

release edge retargets a developer-declared edge (declared target "<declared-target>", target the Release names "<release-target>", wired into socket "<socket>"). Drop the target from the Release entry to configure the connection as it was declared, or change the target where the connection is declared. (cạnh của release chuyển đích của một cạnh do nhà phát triển khai báo (đích đã khai báo, đích mà Release nêu, được nối vào socket nêu trên). Hãy bỏ đích khỏi mục Release để cấu hình kết nối như đã khai báo, hoặc thay đổi đích tại nơi kết nối được khai báo.)

Phát hiện được định vị tại mục đã viết nơi kết nối được khai báo, trong tài liệu đã khai báo nó. Mỗi mục vi phạm được báo cáo thành một phát hiện riêng, nên một lần build nêu tất cả thay vì mỗi lần chạy một mục.

Cách khắc phục: bỏ target khác biệt khỏi mục uses: của Release để cấu hình cạnh hiện có (chỉ infra theo từng cạnh), hoặc, nếu kết nối thực sự thuộc về một socket khác, hãy nối nó qua một socket mà nhà phát triển để chưa gắn. Để thay đổi chính đích, hãy thay đổi nó trong Aggregate, nơi topology được viết.

Release per-edge configuration has no edge to apply to (Cấu hình theo từng cạnh của Release không có cạnh nào để áp dụng)

Một mục uses: theo từng cạnh của Release đặt infra:, các attachment dưới features:, hoặc cả hai, nhưng không có cạnh nào tồn tại tại consumer, socket và alias mà nó nêu, sau khi mọi cạnh trong build đã được vẽ.

Hai việc một mục Release có thể làm là nối một cạnh và cấu hình một cạnh, và việc nó làm được quyết định bởi việc nó có nêu target: hay không. Một mục có đích sẽ tạo ra cạnh mà nó cấu hình. Một mục không có đích cấu hình một cạnh phải tồn tại sẵn — do nhà phát triển khai báo trong Aggregate, hoặc do một Feature được gắn đóng góp. Vì vậy một mục không nêu đích và không khớp cạnh hiện có nào thì không áp dụng cho gì cả: khối infra: và các attachment bên dưới nó không bao giờ đến được đầu ra nào. Build dừng lại thay vì chấp nhận phần viết không có tác dụng, vì nếu không, một lần build thành công sẽ được hiểu là xác nhận rằng hạ tầng đã được áp dụng và kết nối mang những gì mục đó đặt lên.

Alias là một phần của những gì một mục nêu, nên một mục cấu hình một alias mà nhà phát triển chưa từng khai báo sẽ không đến được cạnh nào, ngay cả khi socket được gắn dưới một alias khác. Một mục nêu một component mà Aggregate không khai báo cũng vậy.

Hai tình huống lân cận được báo cáo bởi các điểm dừng riêng của chúng thay vì điểm dừng này, vì mỗi tình huống có thêm thông tin cho bạn. Một socket mà usesSchema của Component tiêu thụ không khai báo được báo cáo là socket chưa khai báo, có thể liệt kê các socket thực sự tồn tại. Một target: không nêu component nào được báo cáo là đích treo. Một component bị tắt bởi toggle active: mang theo các cạnh của nó theo thiết kế, nên một mục còn sót lại trên nó được chấp nhận thay vì bị dừng.

Mọi mục vi phạm đều được báo cáo. Một Release có nhiều mục không đến được cạnh nào sẽ dừng với một thông báo như vậy cho mỗi mục trong một lần build, theo thứ tự tài liệu khai báo chúng, thay vì báo cáo mục đầu tiên và để phần còn lại cho lần build sau.

Thông báo được phát ra, khi mục nêu một component có tồn tại. Nó mang đường dẫn đến chính mục đó, nên dòng cần sửa được nêu thay vì component chứa nó:

release per-edge configuration has no edge to apply to (Release <release-name>, at .spec.boundaries.<boundary>.components.<consumer>.uses.<socket>.<alias>, "<consumer>", on socket "<socket>", under alias "<alias>"). Give the entry a target to wire the edge, or remove it: an entry with no target configures an edge that must already exist. (cấu hình theo từng cạnh của release không có cạnh nào để áp dụng (Release, đường dẫn, component, socket và alias nêu trên). Hãy cho mục một đích để nối cạnh, hoặc xóa mục đó: một mục không có đích sẽ cấu hình một cạnh phải đã tồn tại.)

Một Release nêu các component của nó ở cấp cao nhất thay vì dưới các boundary sẽ mang dạng mà tác giả đã viết — .spec.components.<consumer>.uses.<socket>.<alias> — và một component được nêu bên trong một mục định tuyến aggregates: được nêu thông qua mục đó, dưới tên cục bộ mà nó mang ở đó.

Khi mục nêu một component mà Aggregate không khai báo, điểm dừng xuất hiện sớm hơn trong build và có nội dung như sau, nêu những gì mục đặt — infra, features, hoặc infra and features:

release per-edge configuration has no edge to apply to: release edge <consumer>/<socket>/<alias> sets <infra|features|infra and features> on <consumer>, which is not a component in the topology (cấu hình theo từng cạnh của release không có cạnh nào để áp dụng: cạnh release nêu trên đặt infra, features hoặc cả hai trên một thành phần không có trong topology)

Cách khắc phục: thêm một target: vào mục, điều này nối cạnh và áp dụng cấu hình cho nó; sửa alias thành alias mà Aggregate đã khai báo cho kết nối đó, để mục cấu hình cạnh hiện có; sửa tên component thành một tên mà Aggregate khai báo; hoặc xóa mục nếu không còn cần cấu hình đó nữa.

A Release attachment takes the name of a connection’s attachment (Một attachment của Release lấy tên của một attachment thuộc một kết nối)

Một Release viết một attachment dưới cái tên mà một attachment trên một trong các kết nối của một component mang: alias của kết nối, một dấu chấm, và slot mà attachment đó lấp đầy — gpt.credential cho attachment lấp đầy slot credential trên kết nối gpt. Attachment của một kết nối được viết trên mục kết nối của nó — kết nối của Aggregate dưới uses: của component, hoặc mục uses: theo từng cạnh của Release cho cùng kết nối đó — và trở thành một attachment của component tiêu thụ dưới cái tên ghép đó. Release viết attachment ở hai phạm vi khác mà khóa có thể chứa dấu chấm, nên tên ghép cũng có thể được viết ở đó:

  • Khối features: riêng của một mục component, gắn vào component đó.
  • Khối features: riêng của một boundary, gắn vào mọi component được đặt trong boundary đó hoặc trong một boundary lồng bên trong nó — bao gồm các component của một sub-aggregate mà boundary định tuyến vào mà không nêu tên chúng. Một khóa ở đó gây dừng khi nó trùng với tên ghép trên bất kỳ component nào nó chạm tới, dù nó có nêu type: hay không.

Bản build dừng thay vì gộp một trong hai vào attachment của kết nối, vì khi đó không tài liệu nào thể hiện toàn bộ những gì bản build làm với nó. Slot của một socket được lấp đầy theo từng kết nối, bởi mục riêng của kết nối đó, và không bao giờ bởi một attachment lan xuống từ một phạm vi rộng hơn. Một khóa có dấu chấm mà không attachment kết nối nào của các component nó chạm tới mang là một tên attachment thông thường, và không bị từ chối.

Việc kiểm tra bao quát một attachment mà một trong hai tài liệu đặt trên kết nối, và cả component do một sub-aggregate đóng góp lẫn component do Aggregate khai báo.

Thông báo được phát ra, cho một khóa trên một mục component. Lời từ chối đứng đầu, sau đó là Release và mục component, khóa mà Release đã viết, component, kết nối, socket và slot — rồi đến mục kết nối để viết nó lên:

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.components.<component>, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on the connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this entry’s features: an attachment a connection carries is written on that connection and nowhere else. (một attachment của Release lấy tên của một attachment mà một trong các kết nối của một component mang (Release <release-name>, tại .spec.components.<component>, “<alias>.<slot>”, của component “<component>”, trên kết nối “<alias>”, qua socket “<socket>”, trong slot “<slot>”). Hãy viết nó trên mục kết nối, dưới uses.<socket>.<alias>.features.<slot>, và xóa “<alias>.<slot>” khỏi features của mục này: một attachment mà một kết nối mang được viết trên kết nối đó và không ở đâu khác.)

Thông báo được phát ra, cho một khóa trên một boundary. Nó nêu tên khối attachment của boundary và component có kết nối mang attachment đó:

a Release attachment takes the name of an attachment one of a component’s connections carries (Release <release-name>, at .spec.boundaries.<boundary>.features, "<alias>.<slot>", of component "<component>", on the connection "<alias>", through socket "<socket>", in the slot "<slot>"). Write it on component "<component>"’s connection entry, under uses.<socket>.<alias>.features.<slot>, and remove "<alias>.<slot>" from this boundary’s features: an attachment a connection carries is written on that connection and nowhere else. (một attachment của Release lấy tên của một attachment mà một trong các kết nối của một component mang (Release <release-name>, tại .spec.boundaries.<boundary>.features, “<alias>.<slot>”, của component “<component>”, trên kết nối “<alias>”, qua socket “<socket>”, trong slot “<slot>”). Hãy viết nó trên mục kết nối của component “<component>”, dưới uses.<socket>.<alias>.features.<slot>, và xóa “<alias>.<slot>” khỏi features của boundary này: một attachment mà một kết nối mang được viết trên kết nối đó và không ở đâu khác.)

Một khóa trên một boundary chạm tới nhiều component có kết nối mang tên ghép đó được báo cáo một lần cho mỗi component, vì mỗi kết nối là một lần sửa riêng.

Phát hiện được định vị tại khối mà khóa được viết trong đó — mục component, hoặc features: của boundary — vì bản thân khóa chứa dấu chấm và một vị trí không thể trỏ tới khóa như vậy; thay vào đó, khóa được nêu tên trong thông báo. Trong một Release có nêu tên boundary, một mục component có dạng .spec.boundaries.<boundary>.components.<component>, một component được nêu tên bên trong một mục định tuyến aggregates: được nêu tên thông qua mục đó, dưới tên cục bộ mà nó mang ở đó, và khối của một boundary lồng nhau có dạng .spec.boundaries.<outer>.boundaries.<inner>.features.

Cách khắc phục: chuyển attachment sang mục của Release cho kết nối đó — uses.<socket>.<alias>.features.<slot> dưới component — chỉ viết infra: ở đó để định cỡ một attachment mà Aggregate khai báo, hoặc type: và infra: cho một attachment chỉ Release tạo ra; sau đó xóa khóa có dấu chấm khỏi features: của component hoặc của boundary. Một khóa áp dụng toàn boundary dành cho kết nối của nhiều component được viết một lần trên mỗi kết nối đó.

A Release connection attachment names no Feature type (Một attachment kết nối của Release không nêu kiểu Feature nào)

Một mục uses: theo từng cạnh của Release đặt một attachment lên một kết nối, dưới một slot mà Aggregate không khai báo attachment nào cho kết nối đó, và không nêu type:. Một attachment mà Release viết trên một kết nối là một trong hai thứ. Nó định cỡ một attachment mà Aggregate đã khai báo trên cùng kết nối, và không nêu kiểu vì phần khai báo của Aggregate đã nêu; hoặc nó là một attachment chỉ Release tạo ra, và khi đó mục của Release là nơi duy nhất kiểu Feature của nó có thể đến từ đó. Không có kiểu, không gì có thể chọn một FeatureRecipe cho attachment.

Việc kiểm tra bao quát cả component do một sub-aggregate đóng góp lẫn component do Aggregate khai báo. Một component bị tắt bởi một toggle active: kéo theo các kết nối của nó, nên một mục còn sót lại trên đó không được kiểm tra.

Thông báo được phát ra. Lời từ chối đứng đầu, sau đó là Release và mục kết nối, slot, kết nối, socket và component — rồi đến việc cần làm:

a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes (Release <release-name>, at .spec.components.<component>.uses.<socket>.<alias>, "<slot>", on the connection "<alias>", through socket "<socket>", of component "<component>"). Name the Feature this attachment attaches under its type, or declare the attachment on the Aggregate’s connection entry and size it here. (một attachment kết nối của Release không nêu kiểu Feature nào, và kiểu là bắt buộc đối với một attachment chỉ Release tạo ra (Release <release-name>, tại .spec.components.<component>.uses.<socket>.<alias>, “<slot>”, trên kết nối “<alias>”, qua socket “<socket>”, của component “<component>”). Hãy nêu Feature mà attachment này gắn dưới type của nó, hoặc khai báo attachment trên mục kết nối của Aggregate và định cỡ nó tại đây.)

Mỗi attachment vi phạm được báo thành một kết quả riêng, nên một bản build nêu tất cả chúng.

Cách khắc phục: thêm một type: nêu tên Feature mà attachment gắn vào; hoặc, khi attachment là thứ nhà phát triển cần khai báo, hãy khai báo nó trên mục kết nối của Aggregate cùng values: của nó và chỉ giữ infra: trên mục của Release.

Component identity cannot be stamped on what it emits (Không thể đóng dấu định danh của component lên những gì nó phát ra)

Định danh của một component không chỉ là một khóa trong Aggregate của bạn — nó là một tên bên trong cluster. Mọi tài nguyên mà một component phát ra đều được đóng dấu bằng định danh đó, dưới aggrega.ai/component-id và app.kubernetes.io/name, và các bộ tổng hợp workload đặt tên cho những gì chúng phát ra theo định danh đó. Vì vậy định danh phải là một tên mà đích chấp nhận, và phải là một tên mang đúng ý nghĩa của nó.

Một tên bạn đã viết sẽ đến đầu ra đúng như bạn đã viết, và chính điều đó khiến tên trong Aggregate của bạn là tên bạn có thể tìm thấy trong cluster của mình. Điều này đáng giữ, và đó là lý do một định danh mà đích sẽ từ chối được báo cáo ở đây thay vì bị lặng lẽ sửa thành thứ bạn chưa bao giờ viết.

Có một ký tự là ngoại lệ, và đó là ký tự bạn không thể viết: dấu chấm nối tên của một module với tên của một component bên trong nó. Ký tự này được loại khỏi mọi tên bạn viết chính là để phép nối đó không mơ hồ, và nó được viết lại khỏi định danh trước khi đóng dấu — data-layer.main-db được đóng dấu thành data-layer-zdmain-db. Điều đó không làm mất tên nào mà ai đó đã gõ, và chính nó cho phép một component do một Aggregate được import đóng góp có thể được đóng dấu: dấu chấm không phải là ký tự mà tên Service chấp nhận, và bên trong một địa chỉ cluster nó ngăn cách một service với namespace của nó, nên một tên có dấu chấm được giao cho bên tiêu thụ làm host sẽ phân giải tới một service khác thay vì báo lỗi.

Có hai dạng bị từ chối.

Một định danh mà bảng ký tự đóng dấu không thể mang. Định danh được ghi vào giá trị label mà mọi tài nguyên được phát ra đều mang, và bảng ký tự đó chấp nhận chữ cái, chữ số, -, _ và ., đồng thời yêu cầu giá trị bắt đầu và kết thúc bằng một chữ cái hoặc chữ số. Các quy tắc cho tên do người viết gần giống nhưng không hoàn toàn như vậy — chúng cho phép tên bắt đầu hoặc kết thúc bằng - hoặc _ — nên _api và api- đều là tên bạn có thể viết nhưng không tên nào có thể được đóng dấu.

Độ dài tối đa của một tên không được xét ở đây. Điều đó thuộc về đích mà component được triển khai tới, và các đích khác nhau trả lời khác nhau: điều kiện này bao quát những dạng mà không đích nào có thể mang. Một tên bị từ chối vì độ dài sẽ được báo cáo bởi sự từ chối của chính đích đó, kèm lý do của đích đó và độ dài mà nó chấp nhận.

Một định danh mở đầu giống như một định danh được ghép. Các tài nguyên mà một Feature phát ra không thể được đóng dấu bằng một tên component bạn đã viết, nên Aggrega ghép một định danh cho chúng từ các phần bạn đã viết, sau một phần mở đầu cố định cho biết Feature được gắn ở đâu. Khi Feature được gắn vào một component đơn lẻ, định danh được ghép từ component đó và khóa mà Feature được gắn dưới đó, và nó mở đầu bằng cfr--. Khi Feature được gắn vào cả một boundary, không có tên component nào áp dụng được, nên định danh được ghép từ đường dẫn của boundary và tên mà Feature được gắn dưới đó, và nó mở đầu bằng bfr--. Phần mở đầu là thứ cho người đọc biết một tài nguyên đến từ trường hợp nào trong hai trường hợp đó, thay vì từ một component. Vì vậy bfr-- và cfr-- đều được dành riêng ở đầu một định danh component. Một component tên bfr--api hoặc cfr--api sẽ được đóng dấu giống hệt một định danh được ghép, và không có gì trong đầu ra có thể phân biệt hai thứ đó. Chỉ phần mở đầu đầy đủ mới được dành riêng: một component tên bfr, cfr, bfr-api hoặc bfrontend là một tên bình thường và build được.

Phép kiểm tra đọc định danh mà một component thực sự mang, và với một component do một Aggregate được import đóng góp thì đó là định danh đầy đủ — tên của module, một dấu chấm, và tên riêng của component. Vì vậy hai tên mà mỗi tên đều chấp nhận được khi đứng riêng vẫn có thể nối thành một định danh không chấp nhận được: một module tên bfr--x và một component tên y bên trong nó nối thành bfr--x.y, vốn mở đầu giống như một định danh được ghép. Lỗi dừng nêu định danh đã nối nhưng trỏ tới khóa bạn đã viết.

Thông báo được phát ra, cho một định danh mà đích sẽ từ chối:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must "<rule>") (định danh của component không thể là tên được gắn lên các tài nguyên mà nó phát ra: hãy đổi tên component; Aggregate, tại đường dẫn trường nêu trên, định danh nêu trên, vốn phải tuân theo quy tắc nêu trên)

và cho một định danh mở đầu giống như một định danh được ghép, trong đó <opening> là phần mở đầu dành riêng mà tên khớp:

component identity cannot be the name its emitted resources are stamped with: rename the component (Aggregate, at <field-path>, "<identity>", which must not open with the reserved "<opening>") (định danh của component không thể là tên được gắn lên các tài nguyên mà nó phát ra: hãy đổi tên component; Aggregate, tại đường dẫn trường nêu trên, định danh nêu trên, vốn không được mở đầu bằng phần mở đầu dành riêng nêu trên)

Cách khắc phục: đổi tên component trên mọi nơi nêu tên nó — Aggregate khai báo nó và Release đặt và cấu hình nó. Đặt cho nó một tên bắt đầu và kết thúc bằng một chữ cái hoặc chữ số và không mở đầu bằng bfr-- hay cfr--. Đổi tên một component sẽ thay đổi tên mà các tài nguyên của nó mang trong cluster, nên với một ứng dụng đã triển khai, hãy xử lý việc này như bất kỳ lần đổi tên tài nguyên nào khác.

The target will not accept a name derived from an authored identity (Target không chấp nhận một tên được suy ra từ một định danh do tác giả viết)

Mỗi target tự suy ra các tên của riêng nó từ định danh của một component: một trình cài đặt chart suy ra một tên release, một bộ điều phối container suy ra các tên service. Lỗi dừng này là target đó cho biết nó không thể dùng một trong các tên ấy.

Aggrega không nắm giữ quy tắc đặt tên của bất kỳ target nào. Nó không biết một tên được dài bao nhiêu, target chấp nhận những ký tự nào, hay ngữ pháp của target yêu cầu gì ở đầu tên — và nó cố ý không biết, vì những điều đó khác nhau theo target, theo loại tài nguyên mà tên được gán cho, và đôi khi theo từng service bên trong một provider. Vì vậy, trước khi một tên được chốt, trình biên dịch hỏi provider sẽ render component đó, và lỗi dừng này báo cáo câu trả lời của provider. Đó là lý do thông báo mang chính từ ngữ của target cho thứ đã từ chối (release name, Service name) và chính lý do của target, thay vì một quy tắc được viết sẵn trong trình biên dịch.

Vì sao tên bị từ chối thay vì bị rút ngắn. Một tên bạn viết là tên triển khai của workload của bạn: rút ngắn nó sẽ đổi tên mọi tài nguyên trong mọi đầu ra hiện có, và làm vậy thay cho bạn khi bạn không hề yêu cầu. Người có thể chọn một tên khác là người đã viết tên này, nên lỗi dừng trỏ vào khóa spec.components bạn đã viết và giữ nguyên tên. Các tên do chính Aggrega ghép — chẳng hạn định danh của một Feature được gắn vào cả một boundary — thì được rút ngắn, vì chúng được lắp từ các phần viết rải rác trong nhiều tài liệu và không một tác giả đơn lẻ nào thấy được độ dài chúng đạt tới.

Target có thể đưa ra hai câu trả lời, và chúng dẫn tới những hướng khác nhau. Khi một tên ngắn hơn sẽ được chấp nhận, lỗi dừng nêu độ dài sẽ hợp lệ, để bạn chọn tên mới một lần thay vì hai lần. Khi không độ dài nào giúp được — một ký tự mà ngữ pháp của target từ chối ở vị trí nó rơi vào — thì không độ dài nào được nêu, vì rút ngắn không chạm tới được nó. Trường hợp phổ biến nhất của loại thứ hai: một target chỉ chấp nhận tên chữ thường sẽ thoát (escape) từng ký tự nó không chấp nhận, và mỗi chuỗi thoát bắt đầu bằng dấu gạch nối, nên một tên có ký tự đầu tiên bị thoát sẽ tạo ra một tên bắt đầu bằng dấu gạch nối. Một target yêu cầu chữ thường hoặc chữ số ở vị trí đó sẽ từ chối nó dù phần còn lại ngắn đến đâu. Một target cũng có thể áp cho phần đầu của tên quy tắc chặt hơn của các tài nguyên được đặt tên theo nó: target helm từ chối một tên bắt đầu bằng chữ số, được báo cáo là một Service name, vì Helm chấp nhận tên release như vậy trong khi cluster từ chối một Kubernetes Service được đặt tên theo nó.

Dạng thứ ba chỉ xuất hiện với tên được ghép: một target có thể nêu một độ dài ngắn hơn định danh ngắn nhất mà trình biên dịch có thể ghép từ các phần được cung cấp, vì một định danh ghép chừa chỗ cho một phần phân biệt. Lỗi dừng nói rõ điều đó và nêu cách khắc phục — rút ngắn các phần do tác giả viết — thay vì báo cáo provider là bị lỗi.

Một số tên chỉ tồn tại cho workload mà một component render. Nhà cung cấp được hỏi khi Workload của component đó đã được phân giải, và câu hỏi mang theo form của Workload và các khóa Service của nó, để một target cũng có thể đánh giá các tên mà nó tạo ra từ đó. Với target helm, điều này thêm hai tên: một CronJob name, tối đa 52 ký tự và chỉ được đánh giá cho một Workload scheduled, vì cluster đặt tên Job của mỗi lần chạy theo CronJob với một hậu tố được thêm vào; và mỗi Service name, <release name>-<service key>, tối đa 63 ký tự. Một tên Service được tạo từ các phần của hai tác giả — tên component của bạn và khóa mà workload khai báo, trong Recipe hoặc trong một FeatureRecipe — nên lý do của nó nêu khóa đó và nơi workload khai báo nó, spec.workload.services.<key>, bên cạnh trường bạn đã viết. Một khóa dài đến mức không còn chỗ cho bất kỳ tên component nào sẽ không nêu độ dài nào để chọn trong đó, và lý do sẽ nói rằng chính khóa mới là thứ phải ngắn hơn. Các tên này không được đánh giá cho một Feature được gắn vào toàn bộ một ranh giới: danh tính của nó được xác định trước khi Workload của nó được phân giải, vì nơi đầu ra của nó được lắp ráp có thể phụ thuộc vào nó.

Thông báo được phát ra, với một định danh do tác giả viết:

the target will not accept a name derived from this component’s authored identity: rename the component (component "<identity>", written at <field-path>, which the target cannot use as a <name-kind>, <the target's reason>). choose a name of at most <n> characters that the target accepts (target không chấp nhận một tên được suy ra từ định danh do tác giả viết của component này: hãy đổi tên component (component “<identity>”, được viết tại <field-path>, mà target không thể dùng làm một <name-kind>, <the target's reason>). hãy chọn một tên có tối đa <n> ký tự mà target chấp nhận)

Cách khắc phục: đổi tên component thành một tên mà target chấp nhận, trên mọi nơi nhắc tới nó — Aggregate khai báo nó, và Release đặt và cấu hình nó. Nếu thông báo nêu một độ dài, hãy giữ trong giới hạn đó. Nếu không, hãy đọc lý do của target: thường đó là một ký tự target không chấp nhận, và hay gặp nhất là một chữ hoa ở đầu tên — hoặc, với target helm, một chữ số ở đó. Nên dùng chữ thường và chữ số, với dấu gạch nối giữa các từ; chương về đặt tên giải thích cái giá của một tên dưới từng loại target. Khi lý do nêu một khóa Service, độ dài cũng có thể được lấy lại bằng cách rút ngắn khóa đó tại nơi workload khai báo nó — và khi lý do nói rằng khóa không còn chỗ, chỉ cách đó mới có tác dụng. Đổi tên một component sẽ thay đổi tên mà các tài nguyên của nó mang, nên với một ứng dụng đã triển khai, hãy xử lý nó như mọi lần đổi tên tài nguyên khác.

Khi định danh là do trình biên dịch ghép thay vì do bạn viết, cùng lỗi dừng này báo cáo giá trị đã ghép và yêu cầu bạn rút ngắn các phần tạo nên nó — tên mà bạn dùng để gắn một Feature, và đường dẫn boundary mà bạn gắn nó vào.

A provider never accepted a name the compiler composed (Một provider không bao giờ chấp nhận một tên do trình biên dịch ghép)

Lỗi này báo cáo một khiếm khuyết trong một plugin, không phải trong bất cứ thứ gì bạn viết.

Việc chốt một tên ghép là một cuộc trao đổi: trình biên dịch đề xuất một định danh, provider hoặc chấp nhận hoặc cho biết nó cần ngắn đến mức nào, trình biên dịch ghép một định danh ngắn hơn, và provider được hỏi lại. Lần từ chối thứ hai là bình thường và được dự liệu — rút ngắn tới một độ dài có thể đặt một ký tự vào chỗ mà ngữ pháp của target không chấp nhận, và việc provider nói ra điều đó là cách để một trình biên dịch không biết ngữ pháp của target nào và một provider biết ngữ pháp đó đi đến thống nhất.

Điều không bình thường là một provider không bao giờ chấp nhận bất cứ thứ gì: nêu một độ dài, nhận một tên đúng độ dài đó, rồi lại từ chối. Cuộc trao đổi có giới hạn, và khi chạm giới hạn, bản build dừng lại và nêu tên provider thay vì dùng một tên mà provider chưa từng đồng ý. Một tên được chốt bằng cách bỏ cuộc sẽ được gắn lên các tài nguyên thật mà không có gì trong đầu ra ghi lại rằng chưa đạt được thống nhất, và hậu quả sẽ lộ ra lúc apply thay vì trong bản build đã tạo ra nó.

Thông báo được phát ra:

provider guest never accepted a component identity the compiler composed for it (provider guest "<provider>", refused <n> proposals, the last of them "<identity>"). report the defect to whoever maintains that provider plugin (provider guest không bao giờ chấp nhận một định danh component mà trình biên dịch ghép cho nó (provider guest “<provider>”, đã từ chối <n> đề xuất, đề xuất cuối cùng là “<identity>”). hãy báo khiếm khuyết cho người duy trì provider plugin đó)

Cách khắc phục: báo lỗi cho người duy trì provider plugin được nêu tên, kèm đề xuất cuối cùng trích từ thông báo. Không có thay đổi nào trong phần viết có thể né được lỗi này: trình biên dịch đã đưa ra mọi độ dài mà provider yêu cầu. Nếu provider là do bạn duy trì, điều cần kiểm tra là một tên bị cắt tới giới hạn nó nêu phải là một tên mà sau đó nó chấp nhận.

Required uses: socket not populated (Socket uses bắt buộc chưa được điền)

Một Component khai báo một socket trong usesSchema của nó được đánh dấu required: true, và không có gì trong bản build nối một kết nối vào socket đó cho một trong các instance của Component đó.

Có ba nơi có thể nối socket này, và lỗi dừng chỉ xảy ra khi cả ba đều trống. Khối uses: riêng của instance trong Aggregate; một mục uses: theo từng cạnh trong Release có nêu target:, mục này tạo kết nối vào một socket đã khai báo nhưng chưa được gắn; và tập kết nối mà composition tạo ra, là nơi trả lời cho một component do một Aggregate được import đóng góp — khối uses: của component như vậy nằm trong tài liệu riêng của Aggregate đó, chỉ được đọc khi composition đã được lắp ráp xong. Vì nơi thứ ba là nơi hoàn chỉnh sau cùng, việc kiểm tra chạy khi toàn bộ composition đã tồn tại chứ không phải trong lúc hai tài liệu do tác giả viết đang được đọc, và nó đặt cùng một câu hỏi cho mọi component, bất kể tài liệu nào đã khai báo component đó.

Có hai dạng trông như sẽ điền socket nhưng thực ra không. Một mục Release không nêu target: cấu hình một kết nối phải tồn tại sẵn chứ không tạo kết nối mới, nên nó không nối gì cả (và, khi nó mang infra:, sẽ bị báo bởi lỗi dừng riêng của nó ở trên). Và uses: của một attachment Feature nêu các socket được khai báo trên Feature được gắn, một tập socket riêng trên một thực thể riêng, nên một attachment không bao giờ có thể điền socket riêng của một Component.

Thông báo được phát ra:

required uses socket not populated (Component, at .spec.components.<instance>.uses.<socket>, "<socket-name>", declared required by component type "<component-type>") (socket uses bắt buộc chưa được điền: socket tại vị trí đã nêu được kiểu component đã nêu khai báo là bắt buộc)

Phát hiện này được định vị tại mục socket mà tác giả cần viết, .spec.components.<instance>.uses.<socket>. Tên instance trong đó là tên mà component mang trong tài liệu khai báo nó, nên với một component do một Aggregate được import đóng góp, bộ định vị nêu một khóa mà chính tệp của Aggregate đó chứa, chứ không phải tên có tiền tố mà composition đã đặt cho nó.

Mỗi socket bắt buộc chưa được điền đều được báo, trên mọi component: một lần build cho bạn biết về tất cả chúng chứ không chỉ cái đầu tiên.

Cách khắc phục: thêm một mục uses: cho socket bắt buộc, nối nó tới một đích mà selector: của socket chấp nhận; hoặc nối nó từ Release bằng một mục có nêu target:. Nếu socket không còn cần bắt buộc nữa, hãy cập nhật usesSchema của Component để đặt required: false hoặc xóa khai báo required.

Sub-aggregate nesting depth exceeded (Vượt quá độ sâu lồng sub-aggregate)

Một chuỗi import sub-aggregate vượt quá độ sâu lồng tối đa của trình biên dịch. Giới hạn này ngăn việc làm phẳng mất kiểm soát các topology lồng sâu và buộc phải phân rã kiến trúc khi vượt một ngưỡng.

Thông báo được phát ra:

max sub-aggregate nesting depth exceeded: depth <depth> at prefix <flattened-prefix>. (vượt quá độ sâu lồng sub-aggregate tối đa: độ sâu <depth> tại tiền tố <flattened-prefix>.)

Cách khắc phục: cấu trúc lại topology aggregate để giảm mức lồng. Độ sâu lồng lớn như vậy thường cho thấy hình dạng Aggregate phản ánh hệ thống phân cấp tổ chức thay vì topology triển khai — hãy cân nhắc làm phẳng các nhóm sub-aggregate thành các subsystem ngang hàng trong một Aggregate cha.

Feature type mismatch between Aggregate and Release (Kiểu feature không khớp giữa Aggregate và Release)

Cả Aggregate và Release đều gắn một feature với cùng một tên instance, nhưng mỗi bên khai báo một type: khác nhau, và attachment của Release tới được component từ features: của một ranh giới. Khi Release thay vào đó viết nó trên mục của chính nó cho component, cùng xung đột đó bị từ chối sớm hơn và được báo cáo là E0153, dưới “A feature attached by both the Aggregate and the Release cannot be merged (Một feature được cả Aggregate và Release gắn không thể hợp nhất)” ở trên.

Thông báo được phát ra:

feature type mismatch between Aggregate and Release (node <node-id>, attachment <instance-name>, existing type <type-in-aggregate> conflicts with <type-in-release>) (kiểu feature không khớp giữa Aggregate và Release (node <node-id>, attachment <instance-name>, kiểu hiện có <type-in-aggregate> xung đột với <type-in-release>))

Cách khắc phục: hoặc bỏ type: khỏi Release (nó sẽ kế thừa từ Aggregate), hoặc sửa một bên để cả hai khai báo cùng một kiểu. Release được phép bỏ qua type: hoặc lặp lại kiểu của Aggregate, nhưng không thể thay bằng một kiểu khác.

Cyclic extends on Components or Features (Extends vòng lặp trên Components hoặc Features)

Chuỗi extends: của một Component hoặc chuỗi extends: của một Feature vòng lại chính nó.

Thông báo được phát ra, với Feature thay cho Component khi chuỗi bị vòng lặp là chuỗi của một Feature:

cyclic extends chain (Component <name>, rule extends). <entity> extends <reference>, which is already in the chain; remove the extends on <entity>, or point it at an entity outside the chain (chuỗi extends vòng lặp: một thực thể extends một tham chiếu vốn đã nằm trong chuỗi; hãy xóa extends trên thực thể đó, hoặc trỏ nó tới một thực thể nằm ngoài chuỗi)

Cách khắc phục: mở thực thể mà cạnh nêu — với chuỗi gồm ba thực thể trở lên, đây không phải là thực thể được nêu ở đầu thông báo — rồi xóa hoặc trỏ lại extends: của nó.

A component the composition holds is placed in no boundary (Một component mà composition chứa không được đặt vào boundary nào)

Một Release đặt một component vào một boundary theo hai cách, và cách nào cũng được tính. Nó nêu component dưới components của một boundary, được tham chiếu bằng id mà component mang khi toàn bộ composition đã được làm phẳng. Hoặc nó định tuyến module đóng góp component đó vào một boundary dưới aggregates, việc này đặt mọi component mà module chứa cùng một lúc.

Một component không đạt được cách nào sẽ được render bên ngoài mọi boundary mà Release đã khai báo. Khi đó thư mục đầu ra, sync wave, các annotation và infra theo từng component của nó không đến từ đâu cả — và bản build lẽ ra vẫn thành công, phát ra các artifact, và không nói gì về việc cấu hình của người vận hành chưa bao giờ được áp dụng cho nó. Hai component bị ngăn cách bởi ranh giới đó cũng render vào các đầu ra khác nhau và mất thứ tự mà chúng có khi được đặt cùng nhau.

Có hai dạng cố ý không gặp lỗi này. Một Release khai báo components ở cấp cao nhất thay vì các boundary có tên sẽ đặt mọi thứ nó nêu: việc chuẩn hóa một Release như vậy cho nó một boundary riêng chứa đúng những component đó. Và một component mà toàn bộ module của nó không được Release đặt ở đâu sẽ được báo một lần cho module, theo mục bên dưới — một lỗi, một cách khắc phục, một khóa cần sửa — thay vì báo một lần cho mỗi component mà khai báo riêng của nó là đúng.

Thông báo được phát ra. Giá trị ở cuối là id mà component mang khi composition đã được làm phẳng; với một component do một module đóng góp, id đó là tên module, một dấu chấm, và tên riêng của component:

component placed in no boundary: name it under a boundary’s components, or place the sub-module that contributes it under aggregates (Release <name>, at <authored key>, "<component-id>") (component không được đặt vào boundary nào: hãy nêu tên nó dưới components của một boundary, hoặc đặt sub-module đóng góp nó dưới aggregates)

Cách khắc phục: nêu component dưới components của một boundary, dùng đúng id mà thông báo trích dẫn — với một component do module đóng góp, đó là id có tiền tố, không phải tên được viết bên trong tệp riêng của module. Hoặc, khi toàn bộ module thuộc về một boundary, hãy định tuyến nó vào đó dưới aggregates để mọi component nó chứa được đặt cùng một lúc.

A sub-module’s components are placed in no boundary (Các component của một module con không được đặt vào ranh giới nào)

Dạng ở quy mô module của quy tắc ở trên: một module mà thành phần hợp nhất đưa vào đã đóng góp các component, và không ranh giới nào chứa bất kỳ component nào trong số đó. Lỗi được báo một lần cho module thay vì một lần cho mỗi component, vì một module không được đặt ở đâu là một lỗi soạn thảo với một cách khắc phục tại một khóa — và báo lỗi theo từng component sẽ nêu tên những component mà khai báo của chính chúng hoàn toàn đúng.

Quy tắc xét việc đặt chỗ chứ không xét cách viết, nên một module mà các component của nó đều được nêu tên riêng lẻ dưới components của một ranh giới thì được coi là đã đặt và vượt qua: từ chối nó vì thiếu một mục định tuyến sẽ bác bỏ một dạng soạn thảo mà ngôn ngữ cho phép. Một module chỉ được đặt một phần cũng vượt qua — component nào của nó có mục riêng là câu hỏi của quy tắc component, và những component bị bỏ sót được báo ở đó, mỗi cái tại khóa riêng của nó.

Một module không đóng góp component nào thì không gặp lỗi này: không có gì để đặt. Một module bị một toggle active: có giá trị false loại bỏ cũng vậy, vì nó chưa bao giờ được hợp nhất.

Thông báo được phát ra, đặt tại mục aggregates đã khai báo module, dưới tên cục bộ mà tài liệu nhập đã viết:

sub-module placed in no boundary: route it into a boundary under aggregates, or name its components there under components (Release <name>, at <authored key>, "<module-path>") (sub-module không được đặt vào boundary nào: hãy định tuyến nó vào một boundary dưới aggregates, hoặc nêu tên các component của nó tại đó dưới components)

Cách khắc phục: thêm một mục aggregates cho module dưới ranh giới mà nó thuộc về, mục này đặt mọi component mà module đóng góp. Hoặc, khi các component của nó thuộc về các ranh giới khác nhau, hãy nêu tên từng component dưới ranh giới mà nó thuộc về, dùng các id có tiền tố mà chúng mang sau khi được làm phẳng.

A boundary names a component the composition does not hold (Một ranh giới nêu tên một component mà thành phần hợp nhất không chứa)

Đối ứng về phía nêu tên thừa của hai quy tắc ở trên, và là một câu hỏi riêng chứ không phải một nhánh của quy tắc nào: hai quy tắc kia hỏi về một component xem có gì đã đặt nó hay chưa, còn quy tắc này hỏi về một mục mà Release đã viết xem có gì ứng với nó hay không. Không cái nào kéo theo cái kia. Một Release có thể nêu tên một component không tồn tại trong khi mọi component tồn tại đều được đặt đúng, và nó có thể để một component thật không được đặt trong khi mọi mục nó viết đều phân giải được.

Mục không nêu tên gì thì không cấu hình gì: directory, subDirectory, syncWave, các annotation và infra theo từng component của nó được viết cho một component không có ở đó, nên không có gì được kết xuất dưới chúng và nếu không thì bản build sẽ thành công trong khi cấu hình của người vận hành âm thầm không có tác dụng.

Một ranh giới nêu tên một component theo hai cách và cả hai đều được kiểm tra. Dưới components, một mục tham chiếu component bằng id mà nó mang sau khi thành phần hợp nhất được làm phẳng — nên một component do một module đóng góp được viết với tiền tố của module đó đứng trước tên của chính nó. Bên trong một mục định tuyến aggregates, một mục tham chiếu component bằng tên cục bộ mà nó mang bên trong module đó, tên này phân giải thành cùng một id. Thông báo trích dẫn id mà mục đã tham chiếu, mà trên trục định tuyến thì không phải là tên tệp viết: tệp mang nửa cục bộ và module cung cấp phần còn lại.

Một subsystem không đóng góp gì vào id của component, nên một component được khai báo bên trong một subsystem được tham chiếu bằng tên trần của nó. Một mục được viết như thể subsystem là một phần của id thì không tham chiếu gì và gặp lỗi này.

Một component bị tắt bởi một toggle active: có giá trị false thì không gặp lỗi này. Tắt một component là một hành động soạn thảo, và Release cấu hình nó không được kỳ vọng phải viết lại trong cùng lần chỉnh sửa — từ chối mục đó sẽ khiến toggle không dùng được chừng nào còn có Release nêu tên component.

Thông báo được phát ra:

boundary names a component the composition does not hold: correct the name, or remove the entry (Release <name>, at <authored key>, "<addressed id>") (boundary nêu tên một component mà composition không chứa: hãy sửa tên, hoặc xóa mục đó)

Cách khắc phục: so sánh id mà thông báo trích dẫn với các component mà thành phần hợp nhất thực sự chứa. Thiếu tiền tố module và viết tên subsystem vào id là hai nguyên nhân phổ biến; hãy bỏ subsystem, thêm tiền tố module, hoặc sửa chính tả. Khi mục còn sót lại từ một component đã bị xóa hoặc đổi tên, hãy xóa nó.

A uses edge targets a component an active: toggle removed (Một cạnh uses trỏ tới một component mà một toggle active: đã loại bỏ)

Lỗi anh em của lỗi dừng target treo ở trên, được báo riêng để tác giả được cho biết tại sao target bị thiếu. Target không vắng mặt vì chưa bao giờ được khai báo — nó đã được khai báo, và đã bị cố ý loại khỏi bản build này vì toggle active: của nó phân giải thành false, kéo theo các cạnh của nó. Một component còn lại vẫn phụ thuộc vào nó, và để cạnh biến mất sẽ khiến các giá trị được inject của bên tiêu thụ đó âm thầm trống vào lúc triển khai.

Thông báo được phát ra. Lời từ chối đứng trước, sau đó là target mà toggle đã loại bỏ và socket mà kết nối được nối vào — rồi đến việc cần làm:

uses edge target was pruned because its active toggle resolved to false ("<target>", wired into socket "<socket>"). Keep the target’s active toggle true, or drop the dependency on it. (Đích của cạnh uses đã bị loại bỏ vì toggle active của nó được phân giải thành false. Hãy giữ toggle active của đích ở true, hoặc bỏ sự phụ thuộc vào nó.)

Phát hiện được đặt tại mục đã soạn mà nó nói đến, trên cùng các đường dẫn mà lỗi dừng target treo ở trên nêu, và mọi kết nối vi phạm đều được báo chứ không chỉ kết nối đầu tiên.

Cách khắc phục: quyết định cái nào trong hai cái thuộc về môi trường này. Bật lại target — khi toggle của nó đọc một parameter, điều đó có nghĩa là cung cấp parameter đó cho Release này. Hoặc đặt bên tiêu thụ sau cùng toggle đó, để cả hai cùng rời đi và không cạnh nào còn trỏ vào hư không. Hoặc, khi bên tiêu thụ thực sự không còn cần nó, hãy xóa cạnh khỏi khối uses: của bên tiêu thụ.

A uses target names a module’s component the module does not export (Một đích uses nêu tên một component của module mà module không xuất)

Một module công bố giao diện của nó dưới exportedComponents:, và một tài liệu import module chỉ tới được các component của module thông qua những tên đó: tên module, một dấu chấm, và một trong các alias của nó. Một đích uses: tới một component bên trong một module theo bất kỳ cách nào khác — bằng tên của component bên trong module, hoặc bằng một đường dẫn đi xuyên qua module vào một module lồng bên trong nó — sẽ dừng bản build, vì kết nối sẽ bị ràng buộc vào một thứ mà tác giả module không công bố và có thể tùy ý đổi tên hoặc xóa. Khối uses: của chính một component, khối của một attachment, và một kết nối do Release nối đều phải tuân theo như nhau. Việc một kết nối đi vào những module nào được đọc từ nơi bên tiêu thụ của nó nằm, nên một kết nối giữa hai component của cùng một module — kể cả khi Release nối chúng với nhau — không vượt qua giao diện nào và không bị từ chối. Một đích không ứng với component nào thay vào đó được báo cáo bởi điểm dừng đích treo, nên một tên gõ sai chỉ được báo cáo một lần.

Thông báo được phát ra. Sự từ chối đứng đầu, sau đó là đích như được viết, module mà nó đi vào và các alias mà module đó xuất, và socket — rồi đến việc cần làm:

uses edge target names a component its module does not export ("<target>", module "<module>", which exports "<aliases>", wired into socket "<socket>"). Name the component through one of the module’s exported aliases, or list it under the module’s exportedComponents. (đích của cạnh uses nêu tên một component mà module của nó không xuất (đích, module cùng các alias nó xuất, và socket được nối vào được nêu ra). Hãy nêu tên component thông qua một trong các alias mà module xuất, hoặc liệt kê nó dưới exportedComponents của module.)

Một module không xuất gì được nêu là xuất "nothing". Phát hiện được đặt tại mục đã viết trong tài liệu đã vẽ kết nối.

Cách khắc phục: nêu tên component thông qua một alias mà module xuất — finance-db-subsystem.primary_db thay vì finance-db-subsystem.internal-pg-primary — hoặc, khi bạn là người viết module và muốn công bố component đó, liệt kê nó dưới exportedComponents của module, dưới chính tên của nó nếu đó là tên mà bên import nên dùng.

An active: toggle does not resolve to true or false (Một toggle active: không phân giải thành true hoặc false)

Một toggle active: đến bộ dựng đồ thị khi đã được phân giải thành một literal — một boolean được viết trực tiếp, hoặc một tham chiếu parameter mà các giá trị của Release đã được thay vào trước khi tài liệu được đọc. Sau đó nó được đọc một cách nghiêm ngặt: một literal không phải boolean sẽ dừng bản build thay vì mặc định thành bất cứ giá trị nào. Quy tắc này giống nhau cho toggle của một component và của một module.

Một literal rỗng là trường hợp đáng nêu tên, vì đó là thứ mà một parameter chưa được đáp ứng tạo ra. Một toggle đọc {{ .parameters.<key> }} phân giải thành rỗng khi parameter đó chưa có giá trị, và đọc giá trị rỗng là “có mặt” sẽ triển khai chính thực thể mà tác giả đã đặt sau parameter. Chỉ một toggle không ai viết mới mặc định là có mặt, và điều đó được đọc từ sự vắng mặt của toggle chứ không phải từ giá trị của nó — đó là lý do viết active: mà không có gì phía sau không giống với việc bỏ khóa đi.

Thông báo được phát ra:

active toggle did not resolve to a boolean (node "<node>", active resolved to "<value>") (toggle active không được phân giải thành một giá trị boolean)

và, khi nó phân giải thành rỗng hoàn toàn, kèm lời khuyên nêu nguyên nhân thường gặp:

active toggle did not resolve to a boolean (node "<node>", active resolved to ""). a toggle reading a parameter resolves to nothing until that parameter is fulfilled (toggle active không được phân giải thành một giá trị boolean. Một toggle đọc một tham số sẽ được phân giải thành rỗng cho đến khi tham số đó được cung cấp)

Cách khắc phục: viết true hoặc false. Khi toggle đọc một parameter, hãy cung cấp parameter đó trong Release, hoặc cho nó một default: tại nơi nó được khai báo trong Aggregate để mọi môi trường đều có câu trả lời. Để một thực thể luôn có mặt vô điều kiện, hãy xóa khóa active: thay vì để trống.

A module a composition imports cannot be loaded, or imports itself (Một module mà một thành phần hợp nhất nhập vào không thể được tải, hoặc tự nhập chính nó)

Một Aggregate hợp nhất các Aggregates khác bằng cách nêu tên chúng dưới aggregates:, và mỗi cái lần lượt được tải và duyệt để các component của nó gia nhập đồ thị. Có hai điều làm dừng việc duyệt đó tại đây.

Module hoàn toàn không thể được tải — tham chiếu phân giải thành không gì mà catalog có thể trả về, hoặc tài liệu đằng sau nó không thể đọc được. Lý do mà bộ tải đưa ra được mang bên dưới lỗi dừng chứ không gộp vào nó, nên điều gì đã thất bại được báo bằng chính lời của bộ tải.

Hoặc module nêu tên một kiểu đã có trên chuỗi đang được duyệt. Mở rộng nó sẽ tái tạo chuỗi chứa nó, không có điểm dừng. Lỗi được báo tại điểm mà tham chiếu khép vòng lặp, nêu tên cả kiểu lẫn vị trí của nó trong thành phần hợp nhất.

Thông báo được phát ra, cho một tham chiếu vòng:

sub-aggregate load failed (circular sub-aggregate reference "<module-type>", at "<path in the composition>") (tải sub-aggregate thất bại (tham chiếu sub-aggregate vòng "<module-type>", tại "<path in the composition>"))

và cho một lỗi tải, khi lỗi dừng chỉ gồm câu đó, được đặt tại đường dẫn của module, với lý do của chính bộ tải bên dưới:

sub-aggregate load failed (tải sub-aggregate thất bại)

Cách khắc phục: với lỗi tải, hãy đọc lý do bên dưới lỗi dừng — một tên hoặc một phiên bản mà catalog không thể đáp ứng là trường hợp phổ biến, và việc sửa nằm ở mục aggregates: nêu tên nó. Với tham chiếu vòng, hãy phá vòng lặp: đường dẫn trong thông báo là nơi chuỗi khép lại, và một trong các module dọc theo nó phải ngừng nhập module đang nhập nó. Khi hai module thực sự cần component của nhau, phần dùng chung thuộc về một module thứ ba mà cả hai cùng nhập.

Two instances flatten to one identifier (Hai instance được làm phẳng thành cùng một định danh)

Hợp nhất một Aggregate sẽ làm phẳng mọi component vào một tập duy nhất, và một component do một module đóng góp mang tên của module đó, một dấu chấm, và tên của chính nó. Tập này từ chối chứa hai mục dưới cùng một định danh: mục thứ hai sẽ thay thế mục đầu, và một trong hai component sẽ biến mất khỏi đầu ra mà không có thông báo gì.

Lỗi dừng này được đưa ra khi các component của một module được hợp vào, và bề mặt soạn thảo không cung cấp những tên có thể tạo ra nó. Mọi component do một module đóng góp đều mang tên module đó đứng trước tên của chính nó; tên instance được viết từ chữ cái, chữ số, - và _, nên không thể chứa dấu chấm dùng để nối hai phần, và hai định danh được tạo từ các tên module khác nhau không thể trùng nhau. Hai module được nhập dưới cùng một tên là một khóa trùng lặp, và tài liệu bị từ chối khi được tải. Vì vậy đây là lớp bảo vệ cho một thành phần hợp nhất được lắp ráp bởi thứ gì đó khác với con đường soạn thảo thông thường, và nếu gặp nó thì nên báo cáo thay vì tìm cách lách.

Hai component của một Aggregate trùng một định danh là một lỗi dừng khác, và việc soạn thảo thông thường cũng tạo ra nó — xem Two subsystems declare a component under one name (Hai subsystem khai báo một component dưới cùng một tên) bên dưới.

Thông báo được phát ra:

flattened node ID collision: rename one of the colliding instances so their flattened IDs differ (id "<identifier>", path "<path in the composition>", collides with existing entry from "<the other contributor>") (xung đột ID node đã làm phẳng: đổi tên một trong các instance xung đột để ID đã làm phẳng của chúng khác nhau (id "<identifier>", đường dẫn "<path in the composition>", xung đột với mục đã có từ "<the other contributor>"))

Cách khắc phục: đổi tên một trong hai instance mà thông báo nêu, trong tài liệu khai báo nó và trong mọi mục Release tham chiếu nó.

Two subsystems declare a component under one name (Hai subsystem khai báo một component dưới cùng một tên)

Các subsystem nhóm các component của một Aggregate cho người đọc và cho những gì được truyền xuống chúng; chúng không bổ sung tiền tố vào tên mà một component đáp ứng. Một component được khai báo dưới subsystems.frontend được tham chiếu là api, không phải frontend.api, và một component do một module đóng góp mang tên của module đó chứ không phải tên của subsystem. Vì vậy, hai subsystem của cùng một Aggregate có thể mỗi subsystem khai báo một component tên là api, và khi đó cả hai cùng đáp ứng một định danh.

Tài liệu hợp lệ về cấu trúc — hai component là hai khóa riêng trong hai khối riêng, chính vì thế không có gì trước đó từ chối nó — nhưng chỉ một component có thể mang một định danh. Bản build dừng lại thay vì giữ cái được đọc sau cùng và kết xuất như thể chỉ một component được khai báo.

Cùng một tên hai lần bên trong một subsystem là một lỗi khác: đó là hai mục dưới cùng một khóa, và tài liệu bị từ chối khi được đọc.

Thông báo được phát ra:

components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component’s identity (Aggregate, at .spec.subsystems.<second>.components.<identifier>, "<identifier>", declared under subsystems "<first>, <second>") (các component trong các subsystem khác nhau có cùng định danh: hãy đổi tên một trong số chúng, vì subsystem không đóng góp gì vào định danh của component)

Cách khắc phục: đổi tên một trong hai component, trong tài liệu khai báo nó và trong mọi mục Release tham chiếu nó. Khi hai cái thực sự là cùng một component cần ở hai nơi, hãy khai báo nó một lần và phụ thuộc vào nó từ subsystem kia. Đổi tên subsystem không có ích: subsystem không phải là một phần của tên.

A re-published component alias points back at itself (Một alias component được công bố lại trỏ ngược về chính nó)

Một module công bố một phần của nó bằng cách xuất các component dưới các alias, và một Aggregate nhập nó có thể công bố lại một trong các alias đó dưới một tên riêng. Việc phân giải một alias như vậy đi theo chuỗi công bố lại tới component mà cuối cùng nó nêu tên, để một cạnh trỏ tới tên công khai đến được một component thật.

Một chuỗi quay lại một alias trước khi tới một component thì không bao giờ kết thúc. Việc duyệt dừng lại thay vì đi theo nó mãi mãi, và nêu tên chuỗi đã duyệt để thấy được mắt xích khép vòng lặp.

Không gì bạn có thể viết tạo ra một chuỗi như vậy. Cây nhập là không có chu trình, và mỗi mắt xích nêu tên thứ được lồng sâu hơn mắt xích trước nó, nên một chuỗi được lắp từ các lần nhập sẽ đi xuống và kết thúc. Do đó đây là lớp bảo vệ cho một bảng alias được lắp ráp bởi thứ gì đó khác với con đường soạn thảo thông thường chứ không phải một dạng mà Aggregate có thể khai báo.

Thông báo được phát ra:

re-exported component alias forms a cycle (alias chain <first> -> <second> -> <first>) (bí danh component được xuất lại tạo thành một chu trình)

Cách khắc phục: không có gì trong các tệp của bạn tạo ra nó, và không có thay đổi soạn thảo nào xóa được nó. Hãy báo cáo nó kèm lệnh bạn đã chạy và chuỗi alias mà thông báo nêu, đó là chi tiết cho biết vòng lặp khép lại ở đâu.

An Aggregate reached graph building without being normalised (Một Aggregate đến bước dựng đồ thị mà chưa được chuẩn hóa)

Một Aggregate được viết với các component ở cấp cao nhất và một Aggregate được viết với các subsystem có tên sẽ trở thành cùng một dạng khi được đọc: các component cấp cao nhất được gộp vào một subsystem do trình biên dịch cung cấp, và cấp cao nhất được xóa trống. Việc gộp đó cho phép mọi thứ phía sau đặt một câu hỏi cho một dạng duy nhất.

Một Aggregate đến bước dựng đồ thị với cả hai đều có nội dung thì không phải do việc đọc đó tạo ra. Hai dạng loại trừ lẫn nhau tại nơi chúng được soạn — một tài liệu khai báo cả hai bị từ chối khi được tải — và việc gộp là điều khiến chúng thành một dạng sau đó, nên không gì tác giả có thể viết đến được đây. Đây là lớp bảo vệ cho một Aggregate được lắp ráp bởi thứ gì đó khác với con đường tải thông thường, và nếu gặp nó thì nên báo cáo thay vì tìm cách lách.

Thông báo của nó bắt đầu bằng:

aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) (aggregate đến bước topology khi chưa được chuẩn hóa (các component gốc không rỗng cùng với một subsystem mặc định được tổng hợp))

và tiếp tục với con đường xây dựng mà trình biên dịch mong đợi, đó là ghi chú cho người đang gỡ lỗi bản build chứ không phải chỉ dẫn soạn thảo.

Cách khắc phục: không có gì trong các tệp của bạn tạo ra nó, và không có thay đổi soạn thảo nào xóa được nó. Hãy báo cáo nó kèm lệnh bạn đã chạy.

Bản vá của một plugin label-transform vượt ra ngoài nhãn của node

Một plugin quản trị được gắn ở vai trò label-transform được trao một phép chiếu của đồ thị — mỗi node một mục, mang các nhãn của node đó và các giá trị mà instance của nó khai báo, trong đó mọi giá trị mà Component của nó khai báo là nhạy cảm đều bị giữ lại — và trả về các bản vá áp lên nhãn của các node. Host chỉ áp dụng chúng lên nhãn rồi kiểm tra rằng kết quả trả về vẫn là khung nhìn nhãn đó: cùng các node, mỗi node chỉ mang nhãn, mỗi giá trị nhãn là một chuỗi.

Mọi thứ khác đều bị từ chối và bản build dừng lại. Thêm hoặc xóa một node, hoặc thay đổi một trường của node ngoài nhãn, chính là sự xuất hiện âm thầm của hạ tầng mà không ai khai báo — vì vậy thay vì tiếp nhận một thay đổi nằm ngoài phạm vi của vai trò, bản build cho biết bản vá đã vi phạm quy tắc giới hạn nào. Nhãn là toàn bộ bề mặt của vai trò, và người vận hành gắn plugin đã khai báo đúng chừng đó, không hơn.

Các thông báo được phát ra. Bản vá bị từ chối trước khi được áp dụng:

mutator patch rejected: patch <n> does not decode as a JSON Patch document: <what the reader could not do> (bản vá của mutator bị từ chối: bản vá <n> không giải mã được thành một tài liệu JSON Patch: <what the reader could not do>) mutator patch rejected: patch <n> does not apply to the node-label surface: <what the patch engine refused> (bản vá của mutator bị từ chối: bản vá <n> không áp dụng được lên bề mặt nhãn node: <what the patch engine refused>)

hoặc kết quả áp dụng bản vá không phải là khung nhìn mà host đã trao:

mutator patch rejected: mutated node set changed size (a mutator may not add or remove nodes) (bản vá của mutator bị từ chối: tập node sau khi biến đổi đã thay đổi kích thước (mutator không được thêm hoặc xóa node)) mutator patch rejected: mutated node set introduced node "<node>" (a mutator may not add nodes) (bản vá của mutator bị từ chối: tập node sau khi biến đổi có thêm node "<node>" (mutator không được thêm node)) mutator patch rejected: node "<node>" gained a field outside "labels" (a mutator may only touch labels) (bản vá của mutator bị từ chối: node "<node>" có thêm một trường ngoài “labels” (mutator chỉ được chạm vào nhãn)) mutator patch rejected: node "<node>" lost its "labels" field (bản vá của mutator bị từ chối: node "<node>" mất trường “labels”) mutator patch rejected: node "<node>" carries a non-string label value after patching: <what the reader found> (bản vá của mutator bị từ chối: node "<node>" mang một giá trị nhãn không phải chuỗi sau khi vá: <what the reader found>)

Cách khắc phục: lỗi nằm ở plugin chứ không phải ở tài liệu của bạn. Hãy sửa plugin để mọi thao tác nó trả về đều nhắm tới một mục dưới labels của một node nào đó, và chỉ đặt giá trị chuỗi — giá trị nhãn kiểu số hoặc boolean là trường hợp thường gặp, vì bề mặt này chỉ chấp nhận chuỗi. Gỡ phần gắn khỏi plugins.governance là cách tức thời để bỏ chặn bản build trong khi plugin đang được sửa.

Cố ý bỏ qua: topology không bắt buộc phải không có chu trình

Aggrega cho phép chu trình trong topology: nó không đòi hỏi đồ thị phụ thuộc phải là một đồ thị có hướng không chu trình (Directed Acyclic Graph). Kiến trúc agent-với-agent, mẫu callback và các cặp xác thực lẫn nhau đều tạo ra các cạnh có chu trình, và trình biên dịch chấp nhận chúng. Thứ tự khi triển khai là việc của renderer (thông qua syncWave theo từng boundary hoặc cơ chế tương đương), không phải của đồ thị IR.

Khi kiểm tra các hợp đồng inject

Trình biên dịch duyệt qua mọi khối inject: — cả self-inject (một Component inject vào chính nó) lẫn uses-inject (kết nối giữa các Component) — và xác thực hợp đồng phân phối dựa trên schema provides: của Component đích, phân vùng nhãn của Feature và tập các khóa phân phối đã khai báo. Một khóa from: trên một khối do chính component của Aggregate viết được kiểm tra ngay khi catalog được phân giải, nên nó thất bại tại đúng dòng bạn đã viết; một khóa như vậy trên khối của một component do module đóng góp được kiểm tra khi composition import module đó được build, và thất bại tại dòng trong tài liệu của chính module; một khóa from: trên một kết nối do một Feature được gắn đóng góp được kiểm tra khi mọi bề mặt có thể tạo kết nối đều đã đóng góp, đó là thời điểm sớm nhất mà một kết nối như vậy tồn tại để kiểm tra.

Inject from key is not in the target’s provides (Khóa from của inject không có trong provides của đích)

Một mục inject: tham chiếu đến một khóa from: mà nguồn nó đọc không công bố: schema provides: của Component đích đối với khối riêng của một component hoặc một kết nối, và FeatureRecipe của Feature được gắn đối với khối inject: riêng của một Feature được gắn.

Việc kiểm tra áp dụng ở bất cứ nơi nào kết nối được viết. Một kết nối uses: đến được topology đã dựng từ nhiều bề mặt soạn thảo — khối uses: của chính một Component, và khối uses: của một Feature được gắn vào nó, dù việc gắn đó được viết trên component, trên một subsystem, trên một boundary của Release hay trên mục component của một boundary của Release — và cùng một khóa viết sai đều bị từ chối trên mọi bề mặt đó. Chẩn đoán trỏ đến khối mà tác giả của nó đã viết khóa: mục uses: riêng của một attachment, tại nơi chính attachment đó được khai báo, thay vì khối uses: của component tiêu thụ, vốn không chứa gì cả đối với một kết nối được đóng góp.

Nơi tham chiếu được phân giải phụ thuộc vào nơi nó nằm. Một from: self-inject ở cấp Component được phân giải dựa trên chính provides: của Component đó. Một from: trên một kết nối uses: được phân giải dựa trên provides: của component mà kết nối đó trỏ tới — và khi hai bề mặt viết cùng một socket và cùng một alias, mỗi kết nối được phân giải dựa trên đích mà chính nó nêu tên, trong cùng bản build từ chối cặp đó vì dùng chung một alias. Một Component không khai báo provides: nào sẽ từ chối mọi tham chiếu from: nhắm vào nó.

Khối inject: riêng của một Feature được gắn. Ở đó, một from: được phân giải theo các khóa mà FeatureRecipe của Feature công bố trong provides: của nó, như được đánh giá cho component mà Feature được gắn vào, và được kiểm tra khi component đó được render. Một khóa mà FeatureRecipe không công bố sẽ không đưa gì vào môi trường, tệp hoặc đối số của component, nên thay vào đó bản build dừng lại — trừ khi FeatureRecipe tự đọc các mục của Feature được gắn, tại .inject, trong một template mà nó đánh giá theo ngữ cảnh render riêng của Feature được gắn — ngữ cảnh mang .inject: ánh xạ giá trị, khối lượng công việc, artifact, danh sách loại trừ của nó, hoặc with: hay when: của một bước pipeline, được viết trực tiếp hay được nhập vào. locals:, provides:, source: và assertions: của nó không mang .inject, và injectMapping: của nó được đánh giá theo ngữ cảnh của component, nên việc đọc ở bất kỳ chỗ nào trong số đó đều không được tính. Một FeatureRecipe như vậy nhận mọi mục đúng như được viết và phân phối theo cách riêng của nó, nên các mục của nó không bị từ chối, và một khóa mà nó không công bố sẽ không phân phối gì qua cơ chế phân phối riêng của component và thuộc về FeatureRecipe để sử dụng. Việc một FeatureRecipe có đọc .inject hay không được quyết định từ các đường dẫn mà template của nó nêu: một template chuyển tiếp toàn bộ ngữ cảnh của nó (toJson .) hoặc truy cập các mục thông qua một hàm như index . "inject" không được tính là đọc chúng, và các mục của nó nêu một khóa chưa công bố sẽ bị từ chối. Một Feature được gắn tại một ranh giới mà FeatureRecipe của nó render một lần cho ranh giới đó sẽ được kiểm tra theo lần đánh giá duy nhất đó; khi không có ranh giới nào chứa component tạo ra lần đánh giá như vậy, không có gì để kiểm tra các khóa của nó và chúng không bị từ chối. Một from: nêu một khóa đã công bố vẫn phân phối như trước. Phát hiện được định vị tại mục riêng của Feature được gắn, trong tài liệu đã viết nó — ví dụ .spec.components.<component>.features.<attachment> trong Aggregate — và một mục có khóa phân phối cũng đã được một nguồn inject khác nắm giữ sẽ được báo cáo thêm ở “An attachment delivers a key another inject source already claimed (Một phần gắn phân phối một khóa mà nguồn inject khác đã chiếm)”, vì mỗi trường hợp cần cách sửa riêng.

Trên khối inject: của chính một component, một mục value: mang một giá trị literal và không được phân giải dựa trên gì cả, nên một literal tình cờ trông giống một khóa provides sẽ không bị từ chối ở đó; trên một kết nối, một mục value: bị từ chối, như mô tả ở “An inject: entry on a connection carries a literal (Một mục inject trên kết nối mang một literal)” bên dưới. Chỉ from: mới nêu tên một khóa.

Bề mặt uses: theo từng cạnh của chính Release mang target và infra và không có inject:, nên một kết nối được nối ở đó không quy định phân phối nào và không có khóa from: nào để kiểm tra.

Thông báo được phát ra, cho một from: được đọc trên khối inject: của chính một Component. Lời từ chối đứng đầu, sau đó là khóa bị lỗi, kiểu component mà nó được phân giải dựa vào, và các khóa đã khai báo của kiểu đó theo thứ tự đã sắp xếp — các lựa chọn thay thế để bạn chọn:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<delivery-key>, "<from-key>", "<component-type>", "<key-1>", "<key-2>") (khóa inject không hợp lệ: from-key phải nêu tên một khóa provides mà nguồn của nó công bố)

Đối với một from: được đọc trên một kết nối uses:, cùng lời từ chối đó đứng đầu, và cơ chế cùng khóa phân phối mà mục được viết dưới đó đứng trước khóa bị lỗi:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.uses.<socket>.<alias>, "<mechanism>", "<delivery-key>", "<from-key>", "<component-type>", "<key-1>") (khóa inject không hợp lệ: from-key phải nêu tên một khóa provides mà nguồn của nó công bố)

Đối với một from: được đọc trên khối inject: riêng của một Feature được gắn, khóa bị lỗi đứng đầu, sau đó là in: và cơ chế của mục, FeatureRecipe mà nó được phân giải theo, và từng khóa mà FeatureRecipe đó công bố, theo thứ tự đã sắp xếp:

invalid inject key: the from-key must name a provides key its source publishes (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<from-key>", in "<in>", mechanism "<mechanism>", FeatureRecipe "<feature-recipe>", publishes "<key-1>", publishes "<key-2>") (khóa inject không hợp lệ: from-key phải nêu tên một khóa provides mà nguồn của nó công bố)

Khi đích hoàn toàn không khai báo khóa provides: nào thì không có lựa chọn thay thế nào để liệt kê, nên thông báo kết thúc sau kiểu component — hoặc, trên khối của một Feature được gắn, sau FeatureRecipe.

Cách khắc phục: hoặc đổi khóa from: cho khớp với một trong các khóa đã khai báo được liệt kê trong thông báo, hoặc mở rộng schema provides: của Component đích để khai báo khóa bạn cần. Trên khối của một Feature được gắn, hãy đổi khóa from: thành một khóa mà FeatureRecipe công bố, hoặc — nếu FeatureRecipe là của bạn — công bố khóa đó trong provides: của nó, hoặc để nó tự đọc mục tại .inject nếu nó phân phối giá trị theo cách riêng.

Required feature not attached (Feature bắt buộc chưa được gắn)

Component khai báo một yêu cầu hiện diện — một annotation features.aggrega.ai/requiredType.<label> — nêu tên một kiểu Feature không có mặt trong số các attachment mà instance component này cuối cùng có được, tính trên mọi phạm vi: các khối cấp component và cấp subsystem của Aggregate, các khối cấp boundary và cấp component của Release, và phần mở rộng do annotation điều khiển.

Thông báo được phát ra:

missing required feature: attach a Feature of the required type to the component (<required-type>, required by component type <component-type>, under the requirement label <label>) (thiếu feature bắt buộc: hãy gắn một Feature thuộc kiểu bắt buộc vào component (<required-type>, được yêu cầu bởi kiểu component <component-type>, dưới nhãn yêu cầu <label>))

Ba giá trị là kiểu Feature mà yêu cầu đòi hỏi — vốn đã được câu phía trước nêu tên, nên nó đứng trơn — sau đó là kiểu component khai báo yêu cầu và nhãn mà yêu cầu mang, mỗi giá trị đều có chú thích để người đọc phân biệt được hai tham chiếu thực thể. Một component đòi hỏi hai kiểu khác nhau sẽ báo hai thông báo khác nhau, và hai component khai báo yêu cầu từ các kiểu khác nhau sẽ được cho biết kiểu nào đưa ra từng đòi hỏi. Báo cáo được định vị tại khóa riêng của component dưới components:, và một component được viết bên trong một subsystem thì trước hết được định vị dưới khóa của subsystem đó.

Tên mà một attachment được viết dưới đó không quan trọng ở đây: yêu cầu chỉ hỏi liệu có một attachment thuộc kiểu được nêu tên hay không. Việc bind một slot thỏa mãn nó, và một attachment dưới bất kỳ tên nào khác cũng vậy.

Cách khắc phục: gắn một Feature thuộc kiểu bắt buộc vào component trong Aggregate hoặc Release, hoặc ở một phạm vi rộng hơn mà component kế thừa. Nếu Component không còn cần yêu cầu nó nữa, hãy xóa annotation yêu cầu khỏi khai báo catalog của nó.

Malformed attachment requirement (Yêu cầu attachment sai định dạng)

Không thể đánh giá khai báo của một yêu cầu hiện diện. Giá trị annotation là một chuỗi không minh bạch, nên không có gì xác thực hình dạng của nó trước khi trình biên dịch đọc: một giá trị không phải URI kiểu Feature, hoặc một khóa nêu tên họ yêu cầu mà không có nhãn sau tiền tố, sẽ được báo là một khai báo hỏng thay vì một yêu cầu chưa được thỏa mãn — một lỗi gõ không bao giờ được đọc như một yêu cầu đã được thỏa mãn.

Các thông báo được phát ra:

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the value must be a Feature type URI of the form <publisher>/<name> in lower-case kebab segments, as in core/prometheus-exporter). Correct that annotation on the component type’s catalog entity. (yêu cầu đính kèm không hợp lệ (khóa do kiểu component khai báo, không thể đánh giá vì giá trị phải là một URI kiểu Feature có dạng nhà phát hành/tên, gồm các đoạn kebab chữ thường, như core/prometheus-exporter). Hãy sửa annotation đó trên entity catalog của kiểu component.)

malformed attachment requirement (<key>, declared by component type <component-type>, which cannot be evaluated because the key needs a label naming the requirement, as in features.aggrega.ai/requiredType.database). Correct that annotation on the component type’s catalog entity. (yêu cầu attachment sai định dạng (<key>, được khai báo bởi kiểu component <component-type>, không thể đánh giá vì khóa cần một nhãn nêu tên yêu cầu, như features.aggrega.ai/requiredType.database). Hãy sửa annotation đó trên thực thể catalog của kiểu component.)

Thông báo bắt đầu bằng khóa annotation — khai báo mà lần dừng này nói đến — và sau đó nêu tên kiểu component có khai báo bị hỏng, nên nó nêu đúng thực thể cần sửa dù báo cáo được định vị tại instance component sử dụng kiểu đó: instance là nơi bạn thấy lỗi, còn thực thể catalog là nơi khắc phục.

Lần dừng này được đưa ra ngay khi composition được lắp ráp, sớm hơn mọi kiểm tra đọc đồ thị hoàn chỉnh. Vì vậy, một bản build mang một yêu cầu hỏng sẽ chỉ báo riêng lỗi đó: các kiểm tra lẽ ra chạy sau không được tới, vì chúng suy luận dựa trên nội dung khai báo mà khai báo thì không đọc được. Hãy sửa nó và build lại để thấy phần còn lại.

Cách khắc phục: sửa thực thể catalog của Component. Việc khắc phục nằm trong catalog, không phải trong Aggregate — đó là lý do lần dừng này khác với “Required feature not attached (Feature bắt buộc chưa được gắn)”, nơi chính các tài liệu của bạn là thứ cần thay đổi.

Required attachment slot not bound (Khe gắn bắt buộc chưa được ràng buộc)

Một thực thể catalog khai báo một khe gắn với required: true trong featuresSchema của nó, và không có gì ràng buộc tên của khe đó trên một thể hiện của thực thể. Việc kiểm tra chạy trên các phần gắn mà thể hiện có được sau khi mọi phạm vi đã được gộp — các khối features: cấp component và cấp subsystem của Aggregate, các khối cấp boundary và cấp component của Release, và các phần gắn do mở rộng dựa trên annotation tạo ra — nên một thông tin xác thực được gắn một lần ở một phạm vi mà thể hiện kế thừa sẽ ràng buộc khe đúng như một phần điền được viết trên chính thể hiện.

Thông báo được phát ra:

required attachment slot unfilled (<slot>, declared required by component type <component-type>). Attach a Feature at that name, in the Aggregate or in the Release, on the component or at a scope above it. (khe gắn bắt buộc chưa được điền (<slot>, được khai báo là bắt buộc bởi kiểu component <component-type>). Hãy gắn một Feature tại tên đó, trong Aggregate hoặc trong Release, trên component hoặc ở một phạm vi phía trên nó.)

Hai giá trị là tên của chính slot và kiểu component khai báo nó, nên một instance để trống hai slot sẽ báo hai thông báo khác nhau. Báo cáo được định vị tại khóa của slot dưới khối features: của component trong Aggregate; vì chính khóa đó là thứ bị thiếu, trình soạn thảo đặt báo cáo lên khóa gần nhất có tồn tại — khối features: nếu component có viết một khối như vậy, và chính component nếu không có. Không có gì đã viết attachment bị thiếu, nên không tác giả tài liệu nào bị chỉ ra vì nó: báo cáo nằm ở component và được xếp là lỗi của nhà phát triển, và cách khắc phục nêu tên cả hai tài liệu, vì tài liệu nào cũng có thể lấp slot — Aggregate trên component hoặc trên một subsystem chứa nó, Release trên mục của nó cho component hoặc trên một boundary chứa nó.

Một khe do socket khai báo — trong featuresSchema của một mục usesSchema — là bắt buộc đối với từng kết nối được nối qua socket chứ không phải đối với component: mỗi kết nối tự điền khe cho mình, trên mục riêng của nó trong Aggregate hoặc trong Release, và không phạm vi nào phía trên chạm tới nó. Vì vậy một socket có hai kết nối, trong đó một kết nối điền khe, chỉ báo kết nối còn lại và nêu tên nó:

required attachment slot unfilled ("<slot>", declared required by socket "<socket>", of component type "<component-type>", left unfilled by the connection "<alias>"). Attach a Feature under that slot in this connection’s features, on its entry in the Aggregate or in the Release. (slot attachment bắt buộc chưa được lấp (<slot>, được socket <socket> của kiểu component <component-type> khai báo là bắt buộc, bị kết nối <alias> để trống). Hãy gắn một Feature dưới slot đó trong features của kết nối này, trên mục của nó trong Aggregate hoặc trong Release.)

Báo cáo đó được định vị tại mục của kết nối trong tài liệu đã vẽ kết nối — mục uses: của Aggregate, hoặc mục theo từng cạnh của Release cho một kết nối mà Release đã nối. Một kết nối do một Feature được gắn vẽ ra được nối vào một socket mà Feature khai báo, không phải socket của component, nên các khe socket của component không phải do nó điền.

Cách khắc phục: gắn một Feature dưới tên của khe, trong Aggregate hoặc trong Release — trên component, hoặc ở một phạm vi rộng hơn mà mọi bên dùng khe cùng chia sẻ; với khe của socket, trên kết nối mà báo cáo nêu tên. Một phần gắn dưới tên khác không ràng buộc khe: khe là một điểm ràng buộc có tên, nên chính tên là sự ràng buộc. Nếu khe không còn cần bắt buộc nữa, hãy cập nhật featuresSchema của thực thể catalog — của chính component, hoặc của socket — để bỏ khai báo required.

Two Features declared to conflict reach one component (Hai Features được khai báo là xung đột cùng tới một component)

interoperability.conflictsWith của một Feature nêu tên các Features mà nó không thể được gắn cùng, và một component cuối cùng mang cả Feature đó lẫn một Feature mà nó nêu tên. Việc kiểm tra chạy trên các phần gắn mà component có được sau khi mọi phạm vi đã được gộp — các khối features: cấp component và cấp subsystem của Aggregate, các khối cấp boundary của Release (mọi boundary chứa component, kể cả các boundary lồng nhau) và các mục cấp component, cùng các phần gắn do mở rộng dựa trên annotation tạo ra. Vì vậy một cặp sẽ dừng build khi cả hai được viết trên component, khi một cái nằm trên một boundary hoặc subsystem chứa nó, hoặc khi một cái nằm trên boundary ngoài và cái kia trên một boundary lồng bên trong. Hai Features được gắn vào các boundary anh em không chung component nào thì không bao giờ gặp nhau, và một boundary không chứa component nào thì không chạm tới gì, nên cả hai trường hợp đều không dừng.

Một khai báo là đủ: việc dừng xảy ra khi danh sách của một trong hai Feature nêu tên Feature kia. Các tên được so sánh sau khi bỏ mọi phiên bản, ở cả hai phía, nên một mục khớp với mọi phiên bản của Feature mà nó nêu tên. Trình biên dịch so sánh các tên mà tác giả Feature đã khai báo với các Features mà component mang và không suy diễn thêm gì từ bên nào.

Thông báo được phát ra:

a Feature reaches a component alongside a Feature it declares a conflict with ("<feature>", attached in the Release on boundary "<boundary-path>", conflicts with "<other-feature>", attached in the Aggregate on component "<component>", on component "<component>"). Attach only one of the two where they meet: remove one attachment, or move it to a scope that does not hold this component. (một Feature đến một component cùng với một Feature mà nó khai báo xung đột (<feature>, được gắn trong Release trên boundary <boundary-path>, xung đột với <other-feature>, được gắn trong Aggregate trên component <component>, trên component <component>). Chỉ gắn một trong hai tại nơi chúng gặp nhau: gỡ bỏ một attachment, hoặc chuyển nó sang một phạm vi không chứa component này.)

Giá trị đầu tiên là Feature có danh sách nêu tên Feature kia — Feature mà câu ở trên nêu tên — và theo sau là mọi nơi nó được gắn; tiếp đến là Feature mà nó xung đột, cùng mọi nơi Feature đó được gắn; và cuối cùng là component nơi chúng gặp nhau. Mỗi nơi được diễn đạt bằng từ ngữ của tài liệu bạn sẽ mở để thay đổi nó: attached in the Aggregate on component, attached in the Aggregate on subsystem, attached in the Release on boundary (đường dẫn của một boundary lồng nhau nối các cấp của nó bằng /), attached in the Release on the entry for component theo sau là in boundary, hoặc attached by annotation-driven expansion of annotation, theo sau là declared at nơi nó được viết. Một attachment viết trên một kết nối được diễn đạt là mục của kết nối đó, vì chính mục đó chứ không phải khối riêng của component là nơi nó được chỉnh sửa: attached in the Aggregate on the connection theo sau là through socket và of component, hoặc attached in the Release on the connection theo sau là through socket, of the entry for component và in boundary. Một Feature được gắn ở hai nơi sẽ liệt kê cả hai. Báo cáo được định vị tại khóa riêng của component dưới components:, và một cặp gặp nhau trên nhiều component sẽ báo một lần cho mỗi component, theo thứ tự Aggregate khai báo các component.

Cách khắc phục: chỉ gắn một trong hai tại nơi chúng gặp nhau — xóa một trong các phần gắn, hoặc chuyển một cái sang một phạm vi không chứa component này, chẳng hạn một boundary anh em. Nơi phần gắn đến từ mở rộng dựa trên annotation, thứ cần thay đổi là annotation, không phải khối mà nó được mở rộng vào. Nếu thực ra hai Features có thể được kết hợp, thì khai báo mới là chỗ sai: hãy xóa Feature kia khỏi danh sách conflictsWith trên thực thể catalog của Feature khai báo.

Attachment does not conform to its declared slot shape (Attachment không khớp với hình dạng slot đã khai báo của nó)

Một attachment gắn vào một slot đã khai báo nhưng không khớp với hình dạng mà slot đó khai báo. Trường hợp thường gặp là việc chuyển giao: danh sách cho phép inject của một slot nêu tên các cơ chế mà một lần điền có thể chuyển giao tài liệu của nó qua đó, và một danh sách cho phép rỗng là hộp đen — Recipe chuyển giao tài liệu ở bên trong và một lần điền hoàn toàn không thể quy định việc chuyển giao nào. Một khối inject: {} rỗng không quy định việc chuyển giao nào, nên nó khớp với hình dạng của mọi slot, kể cả slot có danh sách cho phép rỗng, và nhận cùng một phán quyết bất kể attachment được viết ở đâu: trên một component do Aggregate khai báo, trên một component do một module được import đóng góp, hay ở một phạm vi rộng hơn. Một attachment dưới một tên mà không slot nào khai báo là một attachment tự do và không mang ràng buộc slot nào.

Thông báo được phát ra, khi attachment áp đặt một cách phân phối mà slot của nó không chấp nhận — slot trước, rồi đến cơ chế, rồi đến từng cơ chế mà danh sách cho phép inject của slot chấp nhận, theo thứ tự slot khai báo chúng (không có cơ chế nào theo sau nếu danh sách cho phép rỗng):

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>, "<slot>", "<mechanism>", "<permitted-mechanism>") (attachment không tuân theo hình dạng slot đã khai báo của nó)

Một component do một module được import đóng góp sẽ được kiểm tra khi thành phần ghép import nó đã được dựng xong, và được báo cáo theo dạng thứ hai. Dạng này nêu tên Aggregate của module và khóa bên trong tài liệu của module mà slot không khai báo — một cơ chế dưới khối inject: của attachment, hoặc chính khối inject: khi nó nêu bất kỳ cơ chế nào trên một slot có danh sách cho phép rỗng:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.components.<component>.features.<attachment>.<key>, attachment does not conform to the declared slot shape: this key is not part of the slot’s declaration — <remedy>) (phần đính kèm không tuân theo hình dạng slot đã khai báo: khóa này không thuộc phần khai báo của slot)

trong đó <remedy> phụ thuộc vào khóa:

  • remove it, cho một khối inject: nêu một cơ chế trên một slot có danh sách cho phép rỗng;
  • remove it, or add it to the slot's inject allowlist in the entity's featuresSchema, cho một cơ chế mà danh sách cho phép của slot có thể nêu tên — env, file hoặc arg;
  • remove it: a slot's inject allowlist in the entity's featuresSchema accepts only env, file and arg, cho bất kỳ cơ chế nào khác, là cơ chế mà không slot nào có thể khai báo.

Một attachment được khai báo ở một phạm vi rộng hơn — trên toàn subsystem, lan xuống mọi component bên dưới nó — cũng phải tuân theo cùng hình dạng, và nó được kiểm tra đối chiếu với slot trên từng component mà nó chạm tới. Do đó cùng một attachment có thể đúng hình dạng với component này và sai hình dạng với component khác, nên dạng này nêu tên component và slot mà nó không đạt, và định vị attachment tại phạm vi nơi nó được khai báo thay vì tại một khóa bên trong khối chuyển giao của nó:

attachment does not conform to its declared slot shape (Aggregate <name>, at .spec.subsystems.<scope>.features.<attachment>, this attachment is declared at a scope that reaches component <component>, whose attachment slot <slot> does not accept the delivery it carries: move the attachment down to the components that may receive it) (phần đính kèm không tuân theo hình dạng slot đã khai báo: phần đính kèm này được khai báo ở một phạm vi chạm tới một component mà slot đính kèm của nó không chấp nhận cách phân phối mà phần đính kèm mang theo: hãy chuyển phần đính kèm xuống các component có thể nhận nó)

Một attachment do một connection mang theo không bao giờ gặp lệnh dừng này. Hình dạng của nó được đóng lại ngay nơi nó được viết: trên mục connection của Aggregate, nó nhận type, description và values, còn trên mục của Release thì nhận type, description và infra, nên nó hoàn toàn không thể quy định việc chuyển giao nào — một inject: viết ở đó bị từ chối khi tài liệu được tải, kèm tên khóa — và thay vào đó, mục Workload chuyển giao nó phải tuân theo danh sách cho phép inject của slot socket. Cũng không phạm vi nào chạm tới slot của một socket, nên dạng theo phạm vi ở trên không có dạng tương ứng trên một connection.

Cách khắc phục: các dạng này đòi hỏi hai chỉnh sửa khác nhau, và đường dẫn trường cho bạn biết mình đang gặp dạng nào. Khi nó nêu tên một attachment trên một component, hoặc một khóa bên trong attachment đó, việc chuyển giao là lỗi: hãy xóa nó, hoặc chuyển các mục của nó xuống dưới một cơ chế mà danh sách cho phép inject của slot nêu tên. Khi nội dung thực sự cần tới workload thông qua một cơ chế mà slot không liệt kê, danh sách cho phép trong featuresSchema của thực thể catalog có thể được mở rộng — nhưng chỉ với env, file hoặc arg, những cơ chế mà một slot có thể khai báo; một Component nêu tên bất kỳ cơ chế nào khác ở đó sẽ không vượt qua kiểm tra hợp lệ khi được nạp, nên với bất kỳ cơ chế nào khác thì xóa nó là cách khắc phục duy nhất. Khi nó nêu tên một attachment tại một phạm vi, attachment đó đúng định dạng và vị trí đặt nó mới là lỗi: hãy chuyển nó xuống các component có slot chấp nhận việc chuyển giao, để nằm ngoài phạm vi của nó những component dành việc chuyển giao cho Recipe của chúng.

Duplicate delivery key across inject sources (Khóa phân phối trùng lặp giữa các nguồn inject)

Cùng một khóa phân phối (ví dụ, cùng một tên biến môi trường) được khai báo hai lần trong số các nguồn inject do nhà phát triển viết cho một component — ở cấp Component và dưới một mục uses[], bởi hai mục uses[] trên cùng một component, hoặc dưới hai cơ chế phân phối thuộc khối inject: riêng của Component. Việc phân phối không thể đến từ hai nơi cùng lúc, nên một khóa được khai báo hai lần là một mâu thuẫn chứ không phải câu hỏi bên nào thắng.

Bản build đọc điều này ở bốn nơi, vì chúng thấy các tập nguồn do bạn viết và các kết nối phụ thuộc khác nhau và đặt ra những câu hỏi khác nhau, và mỗi nơi báo cáo theo dạng riêng.

Nơi thứ nhất đọc các kết nối bạn đã viết trong Aggregate, và báo cáo khi các tệp của bạn được phân giải. Nó nêu cơ chế phân phối, khóa, rồi socket và alias của kết nối đầu tiên theo thứ tự viết cũng khai báo khóa đó:

duplicate delivery key across inject sources (khóa phân phối trùng lặp giữa các nguồn inject) (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<socket>", "<alias>")

Nơi thứ hai đọc cùng khối do bạn viết đó và đặt ra một câu hỏi khác: liệu component có khai báo một khóa dưới hai cơ chế phân phối của chính nó hay không, mà không có kết nối nào liên quan. Nó báo cáo một lần cho mỗi cơ chế khai báo khóa, đặt tại mục riêng của cơ chế đó, và nêu cơ chế mà báo cáo nói đến, khóa, rồi mọi cơ chế khác khai báo khóa đó, theo thứ tự viết:

duplicate delivery key across inject sources (khóa phân phối trùng lặp giữa các nguồn inject) (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>.<key>, "<mechanism>", "<key>", "<other-mechanism>")

Không cơ chế nào là bên vi phạm và cả hai báo cáo đều do bạn sửa: đổi tên khóa dưới một trong hai cơ chế, hoặc bỏ một trong hai lần phân phối. Một component được phép dùng những cơ chế nào là một câu hỏi riêng, được trả lời bởi danh sách cho phép spec.inject của nó — xem “Self-inject mechanism not in the component’s allowlist (Cơ chế tự inject không nằm trong danh sách cho phép của component)” bên dưới.

Một component do module đóng góp cũng gặp hai dạng đầu tiên này, được đọc từ tài liệu của chính module khi composition import nó được build; khi đó chúng nêu Aggregate của module và khóa bên trong tài liệu của nó.

Nơi thứ ba đọc các kết nối mà topology hoàn chỉnh mang theo, bao gồm mọi kết nối mà một attachment Feature đóng góp thay cho bạn. Nó chạy trước khi bất cứ thứ gì được render, và nêu khóa phân phối bạn đã viết cùng với socket phụ thuộc cũng phân phối khóa đó:

duplicate delivery key across self-inject and uses-inject (khóa phân phối trùng lặp giữa self-inject và uses-inject) ("<key>", socket "<socket>")

Một khóa do bạn viết được phân phối qua hai socket phụ thuộc sẽ báo cáo một lần cho mỗi socket, nên một bản build duy nhất cho bạn biết về tất cả chúng thay vì chỉ socket nào được gặp trước.

Nơi thứ tư đọc cùng topology hoàn chỉnh đó và đặt ra một câu hỏi khác: liệu hai kết nối phụ thuộc của chính một component có cùng phân phối một khóa hay không, trong khi bản thân component không khai báo gì. Nó báo cáo một lần tại mỗi kết nối, đặt tại mục phân phối riêng của kết nối đó, và nêu đường dẫn của mục, theo sau là mọi socket phân phối khóa:

duplicate delivery key across inject sources (khóa phân phối trùng lặp giữa các nguồn inject) ("inject.<mechanism>.<key>", "<socket>", "<socket>")

Một socket được nêu hai lần cho bạn biết hai kết nối nằm trên một socket dưới các alias khác nhau — khi đó vị trí là thứ duy nhất phân biệt chúng, nên hãy đọc đường dẫn trường của từng báo cáo trong hai báo cáo thay vì tên socket.

Không kết nối nào là bên vi phạm và cả hai đều do bạn sửa: đổi tên một trong các khóa, hoặc bỏ một trong hai lần phân phối.

Khi khóa là một đường dẫn, đường dẫn trường sẽ nêu khối của cơ chế thay thế. Một khóa phân phối viết gì là việc riêng của cơ chế, và cơ chế file phân phối vào một đường dẫn mount — nên khóa như vậy chứa dấu chấm trong khi đường dẫn trường dùng dấu chấm để phân tách các bước của nó. Đường dẫn trường dừng ở bước cuối cùng mà nó có thể nêu mà không mơ hồ, thay vì viết ra một đường dẫn trông như đi qua các khóa mà tài liệu của bạn không chứa, nên với một khóa như /etc/app/config.yaml nó đọc là .spec.components.<component>.inject.<mechanism> và dừng ở đó. Thông báo vẫn nêu khóa trong mọi trường hợp, điều giúp báo cáo vẫn có thể hành động được như nhau — nhưng vị trí đọc khóa trong thông báo khác nhau giữa bốn dạng trên, nên hãy đọc đường dẫn trường để biết khối rồi lấy khóa từ dạng bạn gặp: khi phần chi tiết bắt đầu bằng cơ chế phân phối, khóa là giá trị trong dấu ngoặc kép ngay sau đó; khi phần chi tiết bắt đầu bằng riêng khóa, nó là giá trị trong dấu ngoặc kép đầu tiên; và khi phần chi tiết bắt đầu bằng đường dẫn riêng của mục phân phối, khóa là bước cuối của đường dẫn đó.

Cách khắc phục: đổi tên một trong các khóa xung đột, hoặc bỏ khai báo trùng lặp. Lưu ý rằng việc injectMapping của một FeatureRecipe ghi đè một khóa mà khối inject: của chính component hoặc một trong các khối inject: của các kết nối của nó đã phân phối là sự chặn bắt có chủ ý và không bị báo lỗi ở đây hay ở bất kỳ nơi nào khác.

Một khóa được khai báo bởi một Feature gắn vào component gặp cùng không gian dùng chung từ bề mặt viết thứ ba trong ba bề mặt, và được báo cáo dưới “An attachment delivers a key another inject source already claimed (Một attachment phân phối một khóa mà nguồn inject khác đã khai báo)” bên dưới; một khóa mà hai Features được gắn cùng phân phối, trong đó Feature sau phân phối nó qua injectMapping của FeatureRecipe của nó, được báo cáo dưới “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Hai Features được gắn phân phối một khóa, Feature sau qua injectMapping của FeatureRecipe của nó)”.

Self-inject on a component without an allowlist (Tự inject trên một component không có danh sách cho phép)

Nhà phát triển đã viết một khối inject: ở cấp component, nhưng thực thể catalog của Component không khai báo spec.inject. Các Components không có allowlist spec.inject là các kiểu Black-Box — chúng không nhận bất kỳ injection nào do nhà phát triển viết.

Thông báo được phát ra:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject, "inject", "<component-type>") (self-inject trên component không có allowlist spec.inject)

Báo cáo được đặt tại chính khối inject:, là phần tử cần xóa.

Cách khắc phục: xóa khối inject: khỏi instance Component này, hoặc chuyển sang một kiểu Component White-Box có khai báo catalog bao gồm spec.inject.

Self-inject mechanism not in the component’s allowlist (Cơ chế tự inject không nằm trong danh sách cho phép của component)

Nhà phát triển đã viết một khối inject: ở cấp component dùng một cơ chế (ví dụ, env hoặc một dạng mount tệp cụ thể) không được liệt kê trong danh sách cho phép spec.inject của Component.

Thông báo được phát ra:

self-inject on component without spec.inject allowlist (Aggregate <name>, at .spec.components.<component>.inject.<mechanism>, "<component-type>", "<mechanism>", "<allowlisted-mechanism-1>", "<allowlisted-mechanism-2>", …) (self-inject trên component không có allowlist spec.inject)

Các cơ chế mà kiểu đó cho phép đứng sau cơ chế đã được chỉ định, nên thông báo mang cả những gì đã viết lẫn những gì kiểu đó cho phép. Một kiểu không khai báo danh sách cho phép nào sẽ báo cáo cơ chế được chỉ định mà không có gì phía sau.

Cả quy tắc này và quy tắc ở trên đều áp dụng cho một component do module đóng góp, khi composition import module đó được build; khi đó báo cáo nêu Aggregate của module và khóa bên trong tài liệu của nó.

Cách khắc phục: chuyển sang một cơ chế nằm trong danh sách cho phép, hoặc, nếu Component nên hỗ trợ cơ chế bạn cần, mở rộng danh sách cho phép spec.inject trong catalog của nó.

uses edge dictates delivery on a socket that allowlists none (Cạnh uses chỉ định cách phân phối trên một socket không có danh sách cho phép nào)

Một khối inject: trên một cạnh uses: nối vào một socket mà mục usesSchema của nó không khai báo danh sách cho phép inject: nào, hoặc khai báo một danh sách rỗng. Một socket như vậy là một kết nối Black-Box: thực thể đã khai báo nó tự xử lý nội bộ các giá trị của phụ thuộc, nên bên tiêu thụ nhận bất cứ thứ gì Recipe của bên sản xuất phát ra và không chọn hình thức phân phối. Một khóa inject: vắng mặt và inject: [] là cùng một khai báo.

Socket được đọc trên thực thể nào đã khai báo nó: một cạnh được viết trên một attachment của Feature được phân giải theo usesSchema của Feature được gắn, và mọi cạnh khác theo usesSchema của Component tiêu thụ.

Thông báo được phát ra. Lời từ chối đứng đầu, sau đó là các cơ chế mà cạnh chỉ định, socket, và thực thể có khai báo được đọc — rồi đến cách xử lý:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", declared on the component type "<component-type>"). The socket declares no delivery allowlist, so it permits no dictation at all — the entity that declared it delivers the dependency’s values itself. Remove the inject block from this connection and read the values from the connection’s provides in the consuming Recipe, or declare the mechanisms the socket permits in its usesSchema entry. (uses-edge inject chỉ định một cơ chế phân phối mà socket không cho phép (mechanism, trên socket socket, được khai báo trên loại component component-type). Socket không khai báo danh sách cho phép phân phối, nên nó hoàn toàn không cho phép chỉ định — thực thể khai báo nó tự phân phối các giá trị của phụ thuộc. Hãy xóa khối inject khỏi kết nối này và đọc các giá trị từ provides của kết nối trong Recipe tiêu thụ, hoặc khai báo các cơ chế mà socket cho phép trong mục usesSchema của nó.)

Phát hiện được định vị tại mục được viết mà nó đề cập, trong tài liệu nơi mục đó được viết: .spec.components.<consumer>.uses.<socket>.<alias> cho một cạnh do chính khối uses: của một component vẽ ra, và .spec.components.<consumer>.features.<attachment>.uses.<socket>.<alias> cho một cạnh do một attachment vẽ ra — bắt nguồn tại khối đã khai báo attachment, có thể là khối của một subsystem hoặc một boundary thay vì của chính component. Khi socket được khai báo trên Feature được gắn, thông báo nêu loại feature thay cho loại component. Mỗi cạnh vi phạm được báo cáo thành một phát hiện riêng, nên một lần build nêu tên tất cả.

Cách khắc phục: xóa khối inject: khỏi cạnh và thay vào đó đọc các giá trị của phụ thuộc từ .context.uses.<alias>.provides.<name> trong Recipe tiêu thụ; hoặc, nếu kết nối được thiết kế để trong suốt, hãy khai báo các cơ chế phân phối mà socket cho phép trong danh sách cho phép inject: của mục usesSchema của nó.

Một socket mà thực thể khai báo chưa từng khai báo là một trường hợp khác và không bị từ chối ở đây: một socket ad-hoc không mang danh sách cho phép, nên không có gì để cạnh nằm ngoài.

uses edge dictates a delivery mechanism outside the socket’s allowlist (Cạnh uses chỉ định một cơ chế phân phối nằm ngoài danh sách cho phép của socket)

Một khối inject: trên một cạnh uses: nêu tên một cơ chế phân phối mà danh sách cho phép inject: của socket không liệt kê. Danh sách cho phép là tuyên bố của thực thể khai báo về những hình thức phân phối mà entrypoint của nó thực sự có thể đọc các giá trị của phụ thuộc từ đó, nên một cơ chế nằm ngoài danh sách sẽ phân phối những giá trị không có gì tiêu thụ.

Mọi cơ chế mà khối nêu đều được kiểm tra, và mỗi cơ chế nằm ngoài danh sách cho phép đều được báo cáo, nên một lần build nêu tên tất cả thay vì mỗi lần chạy một cái.

Thông báo được phát ra. Lời từ chối đứng đầu, sau đó là cơ chế bị từ chối, socket, những gì socket đó cho phép, và thực thể có khai báo được đọc:

uses-edge inject dictates a delivery mechanism the socket does not permit ("<mechanism>", on socket "<socket>", which permits "<mechanism-1>, <mechanism-2>", declared on the component type "<component-type>"). Dictate one of the mechanisms the socket permits, or widen that socket’s inject allowlist in the declaring entity’s usesSchema entry. (uses-edge inject chỉ định một cơ chế phân phối mà socket không cho phép (mechanism, trên socket socket, vốn cho phép mechanism-1, mechanism-2, được khai báo trên loại component component-type). Hãy chỉ định một trong các cơ chế mà socket cho phép, hoặc mở rộng danh sách cho phép inject của socket đó trong mục usesSchema của thực thể khai báo.)

Phát hiện được định vị tại mục được viết mà nó đề cập, trên cùng các đường dẫn mà lời từ chối ở trên nêu. Khi socket được khai báo trên Feature được gắn, thông báo nêu loại feature thay cho loại component.

Cách khắc phục: chuyển sang một trong các cơ chế có trong danh sách cho phép, hoặc, nếu thực thể cần hỗ trợ cơ chế bạn cần, mở rộng danh sách cho phép inject: của socket đó trong mục usesSchema của catalog.

An inject: entry carries both a literal and a source key (Một mục inject: mang cả một giá trị literal lẫn một khóa nguồn)

Một mục inject: phân phối một trong hai thứ: một giá trị literal, được viết dưới value: — trên khối riêng của một component, nơi duy nhất một literal được phân phối — hoặc một khóa được đọc từ component mà kết nối trỏ tới, được viết dưới from:. Một mục mang cả hai nói hai điều cùng lúc và không đưa ra quy tắc nào để chọn giữa chúng, nên nó bị từ chối thay vì để một trong hai lặng lẽ thắng.

Các schema soạn thảo chỉ chấp nhận đúng một trong cặp này, nên một tài liệu được đọc từ tệp bị từ chối khi được tải. Đây là phép kiểm tra đứng sau phép kiểm tra đó: nó đọc mọi khối inject: mà Aggregate và Release mang trong khi hai tài liệu được phân giải, nên một tài liệu được dựng theo con đường khác ngoài tệp vẫn bị từ chối trước khi bất cứ thứ gì được build từ nó, thay vì âm thầm chọn một trường. Nó bao quát cùng các khối như phép kiểm tra hình dạng bên dưới.

Mỗi cơ chế phân phối chứa một mục vi phạm được báo cáo thành một phát hiện riêng, đặt tại cơ chế đó trong tài liệu đã viết nó — .spec.components.<component>.inject.env cho khối riêng của một component — và mọi phát hiện trong build được báo cáo cùng lúc. Phát hiện nêu tên cơ chế rồi đến in: của từng mục vi phạm trong danh sách của cơ chế đó.

Thông báo được phát ra:

inject entry carries both value: and from:; schema requires exactly one ("<mechanism>", "<in-1>", "<in-2>") (mục inject mang cả literal lẫn khóa nguồn; schema yêu cầu đúng một)

Cách khắc phục: mở từng mục mà thông báo nêu và xóa cái nào trong hai mà mục không cần. Giữ from: khi giá trị cần đến từ component mà kết nối trỏ tới — nó nêu một khóa mà provides: của component đó khai báo. Giữ value: khi giá trị là một literal do phía này cung cấp, trên khối riêng của một component; trên một kết nối và trên khối riêng của một Feature được gắn, literal bị từ chối, nên ở đó hãy giữ from:.

An inject: entry on a connection carries a literal (Một mục inject trên kết nối mang một literal)

Một kết nối phân phối vào component sử dụng những gì mà component nó trỏ tới công bố: mỗi mục trong khối inject: của kết nối nêu một trong các khóa provides: của component đó dưới from:. Một literal được viết dưới value: không nêu gì mà đích công bố, nên nó không có chỗ trên một kết nối, và mục đó bị từ chối thay vì bị bỏ qua. Một literal mà component phân phối cho chính nó thuộc về khối inject: riêng của component, nơi value: được chấp nhận.

Mọi kết nối đều được kiểm tra, bất kể tài liệu nào vẽ nó: kết nối trên khối uses: riêng của một component, kết nối mà một Feature được gắn vẽ trong Aggregate, và kết nối mà một attachment được viết trong Release vẽ. Nó bị từ chối trước khi bất cứ thứ gì được render, nên aggrega validate --release cũng báo cáo nó như aggrega build.

Mỗi mục vi phạm được báo cáo thành một phát hiện riêng, đặt tại mục của kết nối trong tài liệu đã vẽ nó — .spec.components.<component>.uses.<socket>.<alias> cho kết nối riêng của một component, .spec.components.<component>.features.<attachment>.uses.<socket>.<alias> cho kết nối do một attachment vẽ, và trong Release là cùng đường dẫn đó bên dưới mục của attachment, chẳng hạn .spec.boundaries.<boundary>.components.<component>.features.<attachment>.uses.<socket>.<alias> — và mọi phát hiện trong build được báo cáo cùng lúc. Một phát hiện trong Aggregate được xếp vào DEVELOPER_ERROR, một phát hiện trong Release vào OPS_ERROR. Phát hiện nêu tên cơ chế và in: của mục.

Thông báo được phát ra:

inject entry on a connection carries value:; a connection delivers the target’s published keys, each named with from: ("<mechanism>", "<in>") (mục inject trên một kết nối mang literal; một kết nối phân phối các khóa mà đích công bố, mỗi khóa được nêu bằng khóa nguồn)

Cách khắc phục: khi giá trị là thứ mà đích công bố, hãy thay value: bằng from: nêu khóa provides: đó. Khi nó là một literal mà component sử dụng cần, hãy chuyển mục sang khối inject: riêng của component đó, nơi các cơ chế được quản lý bởi danh sách cho phép spec.inject của kiểu Component của nó.

An inject: entry on an attached Feature carries a literal (Một mục chèn trên Feature được gắn mang một literal)

Khối inject: được viết trên một Feature được gắn phân phối vào component những gì FeatureRecipe của phần gắn đó công bố: mỗi mục nêu một trong các khóa mà provides: của FeatureRecipe công bố, dưới from:. Một literal được viết dưới value: không nêu gì mà phần gắn công bố, nên sẽ không có gì đến được component dưới in: của mục đó; mục bị từ chối thay vì được build rồi bị bỏ đi. Một literal mà component cần thuộc về khối inject: riêng của component, nơi value: được chấp nhận và được phân phối.

Mọi phần gắn mà một Aggregate viết khối inject: lên đều được kiểm tra: phần gắn trong khối features: riêng của một component và phần gắn trong khối features: của một hệ thống con, vốn áp dụng cho mọi component mà hệ thống con đó chứa — trong Aggregate mà Release nêu tên và trong mọi module mà Aggregate đó nhập dưới aggregates:, ở bất kỳ độ sâu nào. Một kết nối mà phần gắn vẽ ra mang khối inject: riêng của nó, và literal ở đó thuộc về trường hợp từ chối kết nối ở trên. Một phần gắn của Release không viết khối inject: riêng nào. Mục bị từ chối trước khi bất cứ thứ gì được render, nên aggrega validate --release báo cáo nó cũng như aggrega build.

Mỗi mục vi phạm được báo cáo thành một phát hiện riêng, được xếp vào DEVELOPER_ERROR đối với Aggregate có tài liệu đã viết khối đó — tài liệu riêng của một module đối với phần gắn được viết trong một module — và được định vị tại cơ chế phân phối bên trong khối của phần gắn trong tài liệu đó: .spec.components.<component>.features.<attachment>.inject.<mechanism>, hoặc .spec.subsystems.<subsystem>.features.<attachment>.inject.<mechanism> đối với phần gắn của một hệ thống con. Mọi mục trong một tài liệu được báo cáo cùng lúc; các mục trong một module được nhập sẽ được báo cáo khi Aggregate nhập nó vượt qua kiểm tra. Phát hiện nêu cơ chế và in: của mục. Một mục mang cả value: lẫn from: chỉ được báo cáo một lần, ở “An inject: entry carries both a literal and a source key (Một mục chèn mang cả literal lẫn khóa nguồn)” ở trên.

Thông báo được phát ra:

inject entry on an attachment carries value:; an attachment delivers the keys its FeatureRecipe publishes, each named with from:, and a literal belongs in the component’s own inject block ("<mechanism>", "<in>") (mục inject trên một phần gắn mang một literal; một phần gắn phân phối các khóa mà FeatureRecipe của nó công bố, mỗi khóa được nêu như một khóa nguồn, và literal thuộc về khối inject riêng của component)

Cách khắc phục: khi giá trị là một giá trị mà FeatureRecipe của phần gắn công bố, hãy thay value: bằng from: nêu khóa provides: đó. Khi đó là một literal mà component cần, hãy chuyển mục sang khối inject: riêng của component, nơi các cơ chế được quy định bởi allowlist spec.inject của kiểu Component của nó:

components:
api:
type: core/api
inject:
env:
- in: LITERAL_NAME
value: a-literal # the literal, delivered by the component's own block
features:
token:
type: core/token
inject:
env:
- in: TOKEN_NAME
from: name # a key the attachment's FeatureRecipe publishes

An inject: delivery is not a list of entries (Một phân phối inject không phải là danh sách các mục)

Mỗi cơ chế phân phối trong một khối inject: — env, file, arg, hoặc một cơ chế được đặt tên bên cạnh chúng — là một danh sách các mục, mỗi mục mang in: và đúng một trong from: hoặc value:. Một cơ chế chứa bất kỳ thứ gì khác, chẳng hạn một ánh xạ từ tên sang khóa, không phân phối gì mà compiler có thể đọc, nên nó bị từ chối thay vì bị bỏ qua. Một cơ chế được viết mà không có giá trị nào thì không phân phối gì và không bị từ chối.

Các schema soạn thảo chỉ chấp nhận danh sách, nên một tài liệu được đọc từ tệp bị từ chối khi được tải, như một tài liệu không khớp với schema của kind của nó. Đây là phép kiểm tra đứng sau phép kiểm tra đó: nó đọc mọi khối inject: mà Aggregate và Release mang trong khi hai tài liệu được phân giải, nên một tài liệu được dựng theo con đường khác ngoài tệp vẫn bị từ chối trước khi bất cứ thứ gì được build từ nó, thay vì để việc phân phối biến mất. Nó bao quát mọi khối mà một trong hai tài liệu mang: trong Aggregate là khối riêng của một component, khối của một attachment, và các khối trên những kết nối mà một trong hai vẽ; trong Release là các khối trên những kết nối mà các attachment của nó vẽ.

Mỗi cơ chế vi phạm được báo cáo thành một phát hiện riêng, đặt tại cơ chế đó trong tài liệu đã viết nó và nêu tên cơ chế, và mọi phát hiện trong build được báo cáo cùng lúc. Các phát hiện của Aggregate được báo cáo trước các phát hiện của Release.

Thông báo được phát ra:

inject delivery: shape must be a list of entries, each in: with exactly one of from: or value: ("<mechanism>") (phân phối inject: hình dạng phải là một danh sách các mục, mỗi mục có vị trí đích và đúng một trong khóa nguồn hoặc literal)

Vị trí là đường dẫn khóa mà tác giả đã viết. Trong Aggregate, .spec.components.<component>.inject.<mechanism> cho khối riêng của một component, .spec.components.<component>.uses.<socket>.<alias>.inject.<mechanism> cho một khối trên một trong các kết nối của nó, và .spec.components.<component>.features.<attachment>… cho khối của một attachment, với .subsystems.<name> cho mỗi subsystem mà một component hoặc một attachment được khai báo trong đó. Trong Release, là khối trên một kết nối mà một attachment vẽ, thông qua attachment đó — .spec.boundaries.<boundary>.features.<attachment>.uses.<socket>.<alias>.inject.<mechanism> cho attachment gắn trên toàn boundary, .spec.boundaries.<boundary>.components.<component>.features.<attachment>… cho attachment trên một component, với .boundaries.<name> cho mỗi boundary lồng nhau và .aggregates.<module> cho mỗi mục định tuyến mà một component được nêu tên qua đó.

Cách khắc phục: viết mỗi cơ chế mà thông báo nêu dưới dạng một danh sách. Một mục DB_URL: host dưới env: trở thành - in: DB_URL với from: host khi host nêu một khóa provides: — của component được kết nối trên một kết nối, của chính component trên khối riêng của nó — hoặc, trên khối riêng của component, với value: host khi đó là một literal do phía này cung cấp.

The Feature filling an attachment slot does not satisfy the slot’s selector (Feature lấp một attachment slot không thỏa mãn selector của slot)

Một Component khai báo các điểm liên kết có tên cho các Features mà nó mong đợi, và một slot có thể khai báo một selector: ràng buộc các nhãn của bất cứ thứ gì lấp nó. Một attachment liên kết một slot bằng cách mang tên của slot đó; khi đó, các nhãn của Feature mà nó nêu tên được đối chiếu với ràng buộc ấy, và một phần lấp không thỏa mãn ràng buộc sẽ dừng bản build. Một slot không khai báo ràng buộc nào chấp nhận mọi phần lấp.

Việc một slot có được phép để trống hay không là một câu hỏi khác với cách khắc phục khác, được báo cáo bởi điểm dừng riêng của nó ở trên: điểm dừng này giả định đã có phần lấp và hỏi phần lấp đó có được chấp nhận hay không, nên một slot chưa được liên kết không thuộc phạm vi của nó.

Hai kết quả được báo cáo dưới cùng một điều kiện này, và thông báo phân biệt chúng qua nội dung của giá trị cuối cùng. Một phần lấp không thỏa mãn ràng buộc sẽ nêu tên Feature có các nhãn không khớp. Một ràng buộc hoàn toàn không đọc được sẽ nêu lý do thay vào đó — một biểu thức mà bộ so khớp nhãn không thể đánh giá — đây là lỗi trong chính khai báo của slot chứ không phải trong thứ được gắn vào nó.

Thông báo được phát ra, khi các nhãn của phần lấp không thỏa mãn ràng buộc:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (selector của slot attachment không được thỏa mãn (<selector>, khai báo trên slot <slot>, không được thỏa mãn bởi các nhãn của Feature lấp đầy nó, <feature-type>). Hãy thêm các nhãn mà selector của slot yêu cầu vào các nhãn của Feature, hoặc lấp đầy slot bằng một Feature đã mang sẵn các nhãn đó.)

và khi bản thân ràng buộc không thể được đánh giá:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the component’s catalog entity. (selector của slot attachment không được thỏa mãn (<selector>, khai báo trên slot <slot>, không thể đánh giá được: <why it could not be evaluated>). Hãy sửa selector trong phần khai báo slot ở thực thể catalog của component.)

Lỗi được định vị tại khóa của phần lấp trong tài liệu đã viết phần lấp đó, và được quy cho tác giả của tài liệu ấy: khối features: của component trong Aggregate là lỗi của developer, còn một phần lấp chỉ Release tạo ra — trên mục của nó cho component, hoặc trên một boundary chứa component — là lỗi của operator, được báo cáo tại đường dẫn riêng của Release:

[OPS_ERROR E0008] release.yaml at .spec.boundaries.main.components.app.features.identity
attachment slot selector unsatisfied ("feature.aggrega.ai/kind!=secret", declared on slot "identity", not satisfied by the labels of the Feature filling it, "core/secret-value"). Add the labels the slot's selector requires to the Feature's labels, or fill the slot with a Feature that already carries them.

Cùng phần lấp đó nếu viết trên component trong Aggregate sẽ báo cáo [DEVELOPER_ERROR E0008] aggregate.yaml at .spec.components.app.features.identity.

Một slot do socket khai báo — trong featuresSchema của một mục usesSchema — cũng buộc phần lấp của mỗi kết nối tuân theo selector: của nó theo cùng cách. Attachment mà một kết nối mang trong slot được đối chiếu với ràng buộc, và một phần lấp không được chấp nhận sẽ dừng bản build, nêu tên socket và kết nối cũng như slot:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", filled on the connection "<alias>", not satisfied by the labels of the Feature filling it, "<feature-type>"). Add the labels the slot’s selector requires to the Feature’s labels, or fill the slot with a Feature that already carries them. (selector của slot attachment không được thỏa mãn (<selector>, khai báo trên slot <slot>, thuộc socket <socket>, được lấp đầy trên kết nối <alias>, không được thỏa mãn bởi các nhãn của Feature lấp đầy nó, <feature-type>). Hãy thêm các nhãn mà selector của slot yêu cầu vào các nhãn của Feature, hoặc lấp đầy slot bằng một Feature đã mang sẵn các nhãn đó.)

Lỗi được định vị tại khóa của attachment dưới features: của kết nối đó, trong tài liệu đã viết phần lấp: mục kết nối của Aggregate, hoặc mục theo từng cạnh của Release đối với phần lấp chỉ Release tạo ra.

Một selector của slot mà ngữ pháp không đọc được cũng bị từ chối trước khi có bất cứ thứ gì lấp đầy slot. aggrega validate, trên toàn bộ catalog hoặc trên một Component hay Feature, đọc mọi selector slot mà chính tài liệu của thực thể khai báo — các slot riêng của một Component, các slot mà các socket của nó khai báo, và các slot của một Feature — và từ chối, theo cùng điều kiện này, selector mà ngữ pháp không đọc được, dù có thứ gì lấp đầy slot hay không. Thông báo là dạng “không thể đánh giá” ở trên; một slot do socket khai báo sẽ thêm socket đó:

attachment slot selector unsatisfied ("<selector>", declared on slot "<slot>", of socket "<socket>", which could not be evaluated: "<why it could not be evaluated>"). Correct the selector on the slot’s declaration in the socket’s featuresSchema on the component’s catalog entity. (selector của slot attachment không được thỏa mãn, được khai báo trên slot của một socket, và không thể đánh giá được. Hãy sửa selector trong khai báo của slot ở featuresSchema của socket trên thực thể catalog của component.)

Trên slot của một Feature, cách khắc phục sẽ nêu thực thể catalog của Feature thay vào đó. Chưa có gì lấp đầy slot, nên lỗi thuộc về thực thể catalog: nó được xếp vào CATALOG_ERROR và nêu tệp của thực thể.

Cách khắc phục: với phần lấp không thỏa mãn ràng buộc, hãy gắn một Feature có các nhãn thỏa mãn — selector trong thông báo cho biết những nhãn nào đang được yêu cầu — hoặc nới rộng selector: của slot trong Component khai báo nó. Khi thông báo cho biết ràng buộc không thể được đánh giá, lỗi nằm ở biểu thức selector: hãy sửa nó trong khai báo slot của Component, hoặc của socket.

An attachment written under another name fits a slot its component leaves empty (Một attachment được viết dưới tên khác khớp với một slot mà component của nó để trống)

Bề mặt attachment riêng của một Component là mở: một attachment dưới một tên không slot nào khai báo là một attachment tự do, và hợp lệ. Một dạng trên bề mặt đó gây dừng, vì đó là dạng mà một phần lấp dành cho một slot mang khi bị viết sai tên. Bản build dừng khi tất cả các điều sau đúng với một attachment:

  • nó được viết trên chính component — trên khối features: riêng của component trong Aggregate, hoặc trên mục của Release cho đúng component đó;
  • tên của nó không phải là một slot mà kiểu của component khai báo;
  • các nhãn của Feature của nó thỏa mãn selector: của một slot mà kiểu đó khai báo;
  • không có gì liên kết slot đó trên component sau khi mọi phạm vi đã được gộp lại.

Nếu để nguyên, attachment như vậy là một attachment tự do trong khi slot dành cho nó vẫn trống — và một slot tùy chọn để trống vẫn build thành công mà không phân phối gì. Quy định này áp dụng cho mọi Feature, không chỉ cho thông tin xác thực.

Mọi thứ khác trên bề mặt vẫn tự do. Một attachment có Feature không khớp slot đã khai báo nào vẫn build được; một attachment bổ sung bên cạnh một slot đã được liên kết cũng vậy, miễn là không có slot nào khác mà nó khớp bị để trống. Một attachment mà component kế thừa từ một subsystem hoặc một boundary của Release không bao giờ bị xét, nên dạng dùng chung — một thông tin xác thực được gắn một lần tại một phạm vi chứa nhiều component, không component nào lấp slot — vẫn build được. Một slot không khai báo selector: không nói gì về việc nó dành cho Feature nào, nên không attachment nào bị xét theo cách này với slot đó. Một attachment mà kết nối mang cũng không bị xét ở đây: các slot của một socket là một tập đóng, và mọi tên khác trên một kết nối sẽ dừng dưới “A connection carries an attachment under a name its socket declares no slot for (Một kết nối mang một attachment dưới tên mà socket của nó không khai báo slot nào)”.

Thông báo được phát ra. Câu mô tả điều kiện đứng trước, sau đó là tên mà attachment được viết dưới, component, Feature mà nó gắn và slot trống mà nó khớp — rồi đến việc cần làm:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>"). Attach it as "<slot>" to fill the slot. (attachment được viết dưới một tên không slot nào khai báo lại khớp với một slot mà component của nó để trống (<attachment>, trên component <component>, gắn Feature <feature-type>, khớp với slot trống <slot>). Hãy gắn nó dưới tên <slot> để lấp đầy slot.)

Khi Feature khớp với nhiều hơn một slot trống, thông báo nêu tên từng slot, theo thứ tự kiểu của component khai báo chúng, và để bạn lựa chọn:

attachment written under a name no slot declares fits a slot its component leaves empty ("<attachment>", on component "<component>", attaching the Feature "<feature-type>", which fits the empty slot "<slot>", and the empty slot "<another-slot>"). Attach it under the name of the slot it is meant to fill. (attachment được viết dưới một tên không slot nào khai báo lại khớp với một slot mà component của nó để trống (<attachment>, trên component <component>, gắn Feature <feature-type>, khớp với slot trống <slot> và slot trống <another-slot>). Hãy gắn nó dưới tên của slot mà nó cần lấp đầy.)

Lỗi được định vị tại khóa của attachment trong tài liệu đã viết nó, và được quy cho tác giả của tài liệu ấy. Một attachment trên khối features: riêng của component trong Aggregate được báo cáo tại .spec.components.<component>.features.<attachment> như lỗi của developer; một attachment chỉ Release viết, trên mục của nó cho component, được báo cáo tại đó — dưới boundary nêu tên component, .spec.boundaries.<boundary>.components.<component>.features.<attachment> — như lỗi của operator:

[OPS_ERROR E0328] release.yaml at .spec.boundaries.main.components.app.features.metrics
attachment written under a name no slot declares fits a slot its component leaves empty ("metrics", on component "app", attaching the Feature "core/prometheus-exporter", which fits the empty slot "identity"). Attach it as "identity" to fill the slot.

Bản thân slot trống là một phát hiện riêng khi nó là bắt buộc, được báo cáo tại component trong Aggregate dưới “Required attachment slot not bound (Attachment slot bắt buộc chưa được liên kết)”.

Điều này khác với cảnh báo gần khớp như thế nào. Cảnh báo dưới “An attachment name is one edit from a declared slot (Tên attachment cách một slot đã khai báo một lần chỉnh sửa)” liên quan đến cách viết một tên: một tên cách một lần chỉnh sửa so với một slot có selector: mà Feature của attachment không thỏa mãn, trường hợp này vẫn build và báo một cảnh báo. Điểm dừng này liên quan đến việc Feature khớp với gì, bất kể tên: tên có thể là bất cứ gì, và slot mà nó khớp phải bị để trống. Khi một tên cách một slot một lần chỉnh sửa và Feature của nó thực sự khớp slot đó, không có cảnh báo nào được đưa ra, và nếu slot bị để trống thì điểm dừng này là phát hiện duy nhất được báo cáo.

Cách khắc phục: gắn nó dưới tên của slot để nó lấp slot — thông báo nêu tên slot, hoặc mọi ứng viên khi có nhiều slot. Nếu đó thực sự là một attachment riêng, hãy lấp cả slot, vì một attachment bổ sung là tự do khi mọi slot mà nó khớp đã được liên kết; hoặc, khi nó cần đến nhiều component, hãy gắn nó tại subsystem hoặc boundary của Release chứa chúng. Nếu Feature không bao giờ nên lấp slot đó, hãy thu hẹp selector: của slot trong Component khai báo nó.

An attachment delivers a key another inject source already claimed (Một attachment phân phối một khóa mà một nguồn inject khác đã chiếm)

Ba bề mặt soạn thảo phân phối vào đường ống inject của một component thông qua một khối inject:: khối inject: riêng của component, các khối inject: trên các mục của khối phụ thuộc của nó, và khối trên mỗi Feature được gắn vào nó. Chúng dùng chung một không gian khóa cho mỗi cơ chế phân phối, nên một khóa mà hai trong số chúng cùng chiếm sẽ mơ hồ về việc giá trị nào được đưa tới, và bản build dừng lại thay vì để một bề mặt âm thầm thay thế bề mặt khác. Một Feature được gắn cũng có thể phân phối theo cách thứ hai, thông qua injectMapping của FeatureRecipe của nó; con đường đó gặp cùng không gian sau khi mọi khối đã phân phối, và được báo cáo dưới mục “Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Hai Features được gắn phân phối cùng một khóa, Feature sau thông qua injectMapping của FeatureRecipe của nó)” bên dưới.

Điều kiện này là phía khối attachment của không gian đó. Nó được báo cáo khi khối inject: riêng của một attachment chiếm một khóa mà một lần phân phối trước đó đã giữ — mục ở trên “Duplicate delivery key across inject sources (Khóa phân phối trùng lặp giữa các nguồn inject)” là cùng quy tắc đó nhìn từ phía do nhà phát triển soạn, và giữa hai mục này, mọi yêu cầu chiếm khóa của các khối đều được bao quát.

Thứ tự là yếu tố quyết định ai va chạm. Yêu cầu đầu tiên dưới một khóa là yêu cầu giữ khóa đó, và các yêu cầu sau là những yêu cầu bị báo cáo — nên một attachment có khóa đã bị chiếm sẽ được thông báo, trong khi một attachment đã chiếm trước sẽ không được thông báo về một yêu cầu sau không thay thế gì cả. Một yêu cầu không phân phối gì cả sẽ để khóa trống và không tham gia vào bất kỳ điều nào ở đây.

Phát hiện được định vị tại mục riêng của attachment bên trong khối của component, đó là vị trí cần chỉnh sửa; thông báo nêu tên khóa và cơ chế mà không gian khóa của nó chứa khóa đó. Mỗi khóa va chạm được báo cáo riêng, nên một attachment trùng lặp hai khóa sẽ báo cho bạn về cả hai.

Thông báo được phát ra:

duplicate delivery key across attachment-inject and another inject source ("<key>", mechanism "<mechanism>") (khóa phân phối trùng lặp giữa attachment-inject và một nguồn inject khác (“<key>”, cơ chế “<mechanism>”))

Cách khắc phục: không bên nào là bên vi phạm và bạn có thể thay đổi cả hai. Đổi tên khóa ở bên mà bạn kiểm soát — thường là mục inject: của chính component, vì ánh xạ của Feature được viết trong một tài liệu catalog — hoặc bỏ một trong hai lần phân phối. Khi attachment thực sự được dùng để cung cấp giá trị, hãy xóa khai báo do nhà phát triển viết thay vì khai báo của attachment. Lưu ý rằng việc injectMapping trong FeatureRecipe của một Feature ghi một khóa là một con đường khác và không được báo cáo ở đây: việc ghi lại một khóa mà khối inject: của chính component hoặc một trong các kết nối của nó đã phân phối là sự chặn bắt và hoàn toàn không được báo cáo, còn việc ghi một khóa mà một Feature được đính kèm khác đã phân phối được báo cáo trong mục bên dưới.

Two attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Hai Features được gắn phân phối cùng một khóa, Feature sau thông qua injectMapping của FeatureRecipe của nó)

Một Feature được gắn phân phối vào đường ống inject của component của nó theo hai con đường: khối inject: được viết trên attachment, và injectMapping của FeatureRecipe của nó, có đầu ra nêu tên khóa phân phối — thường từ một giá trị mà attachment mang theo, chẳng hạn biến môi trường được chọn của một thông tin xác thực. Khi hai Features được gắn cùng đến một khóa dưới một cơ chế phân phối, và Feature sau trong hai đến đó thông qua ánh xạ của nó, bản build dừng lại. Nếu để chạy tiếp, component sẽ đọc bất kỳ giá trị nào tình cờ được ghi sau cùng, nên một thông tin xác thực có thể được trình ra thay cho một thông tin khác mà không có gì trong đầu ra cho biết điều đó.

Điều kiện này áp dụng cho mọi Feature được đính kèm, bất kể nó được đính kèm ở đâu: khối features: của chính component, một subsystem, một boundary hoặc mục component của Release, phần mở rộng của một annotation, và mục features: của một kết nối. Lần phân phối sớm hơn trong hai lần có thể là ánh xạ của Feature kia hoặc chính khối inject: của nó — bản build báo cáo cả hai cách ghép cặp dưới cùng một điều kiện này.

Thứ tự là yếu tố quyết định ai va chạm. Mọi khối inject: phân phối trước khi bất kỳ ánh xạ nào được kết xuất, và các ánh xạ kết xuất theo một thứ tự cố định — thứ tự mà inject mapping duyệt qua các Features được gắn của một component, được mô tả trong pipeline biên dịch — nên lần phân phối đầu tiên dưới một khóa là lần giữ khóa đó, và Feature sau là Feature bị báo cáo. Chỉ sự hiện diện quyết định: các giá trị không được so sánh, nên hai Features phân phối cùng một giá trị dưới một khóa vẫn bị báo cáo. Một khóa mà đầu ra của ánh xạ hoàn toàn không mang thì không phải là một lần phân phối; một khóa nó mang với giá trị rỗng thì là một lần phân phối, vì giá trị rỗng thay thế bất cứ thứ gì đã có ở đó. Một khóa dưới hai cơ chế phân phối khác nhau là hai khóa, không phải một va chạm.

Những gì không được báo cáo. Việc injectMapping của một FeatureRecipe ghi lại một khóa mà khối inject: của chính component hoặc khối inject: của một trong các kết nối của nó đã phân phối là sự chặn bắt — một Feature định tuyến chỉ định rõ một host, một guard chuyển hướng một upstream — và giá trị của ánh xạ thay thế đúng mục đó. Việc ánh xạ của một Feature ghi lại một khóa mà chính khối inject: của nó đã phân phối là Feature đó đang biến đổi lần phân phối của chính nó, và cũng không được báo cáo.

Phát hiện được định vị tại mục riêng của Feature sau — bên trong khối features: của component, hoặc, với một Feature mà một kết nối mang theo, tại mục của nó dưới kết nối đó trong tài liệu đã viết nó, chẳng hạn .spec.components.<component>.uses.<socket>.<alias>.features.<slot> trong Aggregate. Thông báo nêu tên khóa, cơ chế phân phối, và cả hai Features theo tên mà chúng mang trên component; một Feature mà một kết nối mang theo được gọi tên bằng alias của kết nối và slot mà nó lấp đầy, nối với nhau bằng một dấu chấm. Mỗi khóa va chạm được báo cáo riêng.

Thông báo được phát ra:

duplicate delivery key across two attachments: an attachment’s FeatureRecipe writes a delivery key another attachment already delivered ("<key>", mechanism "<mechanism>", attachment "<attachment>", delivered first by attachment "<other-attachment>"). Give one of the two attachments a key of its own, or attach one fewer: the key this attachment delivers under is chosen by its FeatureRecipe, which can read the attachment’s own values and infra, and the other’s is chosen the same way or by its own inject block where it delivered through one. A Release sets an attachment’s infra and never its values, so where a key is chosen by a value, attach that attachment in the Aggregate with the value, and keep giving the rest from the Release. (khóa phân phối trùng lặp giữa hai attachment: FeatureRecipe của một attachment ghi một khóa phân phối mà một attachment khác đã phân phối. Hãy cho một trong hai attachment một khóa riêng, hoặc gắn bớt một attachment: khóa mà attachment này dùng để phân phối do FeatureRecipe của nó chọn, FeatureRecipe này có thể đọc values và infra của chính attachment, còn khóa của attachment kia được chọn theo cùng cách hoặc bởi khối inject của chính nó nếu nó phân phối qua một khối như vậy. Một Release đặt infra của attachment và không bao giờ đặt values của nó, nên khi một khóa được chọn bởi một giá trị, hãy gắn attachment đó trong Aggregate cùng với giá trị, và tiếp tục cung cấp phần còn lại từ Release.)

Cách khắc phục: cho một trong hai Features một khóa riêng — với một Feature thông tin xác thực, đó thường là khóa mà các giá trị của nó nêu tên — hoặc xóa một trong hai attachment. Khi cả hai đều nhằm cung cấp một biến, hãy quyết định component nên đọc cái nào và chỉ gắn cái đó. Hai thông tin xác thực mà một Release tự gắn đều đến dưới khóa mà Feature của chúng nêu tên theo mặc định, vì một Release không thể ghi values của một attachment: hãy gắn một trong hai trong Aggregate cùng với giá trị nêu tên khóa của nó, và cung cấp nguồn gốc của nó từ Release trên cùng mục đó.

A component declares an inject mechanism the attached Feature maps nothing to (Một component khai báo một cơ chế inject mà Feature đã gắn không ánh xạ gì vào)

Danh sách cho phép spec.inject của một Component có thể nêu các cơ chế phân phối ngoài các cơ chế tiêu chuẩn — một cơ chế mà hệ thống nội bộ của component hiểu, và mọi thứ phân phối vào nó phải tạo ra một giá trị cho cơ chế đó. Khi một Feature được gắn vào component như vậy, injectMapping của FeatureRecipe là thứ cho biết mỗi giá trị nó tạo ra được phân phối theo cơ chế nào. Một cơ chế mà component đã khai báo nhưng ánh xạ không tạo khóa nào cho nó là một lần phân phối sẽ âm thầm không bao giờ xảy ra, nên bản build dừng lại.

Một ánh xạ không nói gì về cơ chế không phải là ánh xạ nói rằng không có cơ chế nào. Một FeatureRecipe có ánh xạ render thành một từ điển phẳng các lần phân phối hoàn toàn không khẳng định gì về cơ chế — đó là cách viết thông thường cho một Feature tạo ra các lần phân phối biến môi trường — và một attachment gắn một FeatureRecipe không có ánh xạ để đánh giá cũng vậy. Cả hai đều không được báo cáo ở đây; điều kiện này chỉ liên quan đến một ánh xạ có nêu cơ chế và bỏ sót một cơ chế mà component đã khai báo.

Mỗi cơ chế chưa được ánh xạ là một kết quả riêng, nên một component khai báo hai cơ chế mà attachment không ánh xạ cái nào sẽ báo cho bạn cả hai. Kết quả được định vị tại mục của attachment trong chính tệp của bạn, và cũng nêu FeatureRecipe — vì đó là tài liệu chứa ánh xạ, và nó nằm ở một nơi hoàn toàn khác.

Thông báo được phát ra:

custom inject mechanism has no matching key in injectMapping output; add the mechanism’s key to the Recipe injectMapping ("<mechanism>", recipe "<featurerecipe>") (cơ chế inject tùy chỉnh không có khóa tương ứng trong đầu ra của injectMapping; hãy thêm khóa của cơ chế vào injectMapping của Recipe (<mechanism>, recipe <featurerecipe>))

Cách khắc phục: thông báo nêu cả hai phía. Thêm khóa của cơ chế vào injectMapping của FeatureRecipe để Feature tạo ra giá trị cho nó, hoặc bỏ cơ chế khỏi danh sách cho phép spec.inject của Component nếu không có gì được kỳ vọng phân phối theo nó. Nếu FeatureRecipe thuộc catalog của người khác, gắn một Feature có ánh xạ bao phủ cơ chế đó là cách thứ ba.

An attached Feature’s injectMapping output cannot be read (Không thể đọc đầu ra injectMapping của một Feature được gắn kèm)

injectMapping của một FeatureRecipe là một template, và những gì nó tạo ra được đọc dưới dạng YAML: một từ điển có khóa theo cơ chế chuyển giao — env, file, arg hoặc một cơ chế riêng của component — hoặc một từ điển phẳng gồm các mục chuyển giao vào environment. Khi đầu ra không đọc được theo dạng nào trong hai dạng đó, không khóa nào của nó có thể được chuyển giao, nên bản build dừng lại thay vì render component như thể Feature được gắn kèm không chuyển giao gì. Thông tin xác thực là trường hợp quan trọng nhất: nếu không, một component chờ một mật khẩu mà nó chưa bao giờ nhận được có thể chạy mà không có mật khẩu đó, và không có gì trong đầu ra cho biết điều đó.

Nguyên nhân thường gặp là một giá trị mà template viết nguyên trạng giữa hai dấu nháy. Một dấu nháy kép bên trong nó kết thúc scalar trong dấu nháy quá sớm, và một dấu gạch chéo ngược bắt đầu một chuỗi escape mà YAML có thể không biết, nên một mapping render đúng với hầu hết các giá trị lại hỏng với giá trị chứa ký tự như vậy — thường là một mật khẩu. Một đầu ra rỗng, hoặc được phân tích thành một từ điển không chuyển giao gì, không phải là điều kiện này: nó không chuyển giao gì, và đó chính là điều nó nói.

Khung phía trên thông báo nêu component đang được render, sau đó là attachment theo tên mà nó mang trên component và FeatureRecipe nơi mapping được viết, dưới dạng feature "<attachment>" (recipe "<featurerecipe>") injectMapping output. Bên dưới thông báo là lý do đầu ra không đọc được — dòng và những gì YAML tìm thấy ở đó, chẳng hạn yaml: line 2: found unknown escape character. Khi template đọc một giá trị mà tác giả đã khai báo là nhạy cảm và lý do phụ thuộc vào nội dung của giá trị đó, lý do bị giữ lại và một câu nói rõ điều này được đặt vào chỗ của nó, nên lần dừng này không bao giờ trích dẫn giá trị đã làm hỏng đầu ra. Bản build báo cáo lần dừng này dưới thẻ CATALOG_ERROR, vì mapping được viết bởi tác giả của FeatureRecipe.

Thông báo được phát ra:

FeatureRecipe injectMapping output could not be read as a dictionary of deliveries (Không thể đọc đầu ra injectMapping của FeatureRecipe dưới dạng một từ điển các mục chuyển giao)

Cách khắc phục: trong injectMapping của FeatureRecipe, hãy viết mỗi giá trị qua toJson — {{ .values.key }}: {{ .values.origin | toJson }} — để giá trị được viết thành một chuỗi JSON mà YAML đọc lại chính xác, bất kể nó chứa ký tự gì. Khi FeatureRecipe thuộc về catalog của người khác, cũng có thể thay đổi giá trị để nó không chứa dấu nháy kép hay dấu gạch chéo ngược cho đến khi mapping được sửa.

An attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Đầu ra injectMapping của một Feature được gắn kèm ghi các mục chuyển giao dưới một khóa mà không gì chuyển giao)

Đầu ra injectMapping của một FeatureRecipe được hợp nhất vào inject pipe của component theo các khóa cấp cao nhất của nó. env, file và arg được chuyển giao như chính các cơ chế đó, còn mọi khóa khác được chuyển giao như một cơ chế riêng dưới tên đó, mà Recipe của component đọc tại .context.inject.<name>. Khung nhìn all thì khác: nó được xây dựng từ các cơ chế sau khi hợp nhất, không bao giờ được hợp nhất từ một đầu ra, nên các giá trị mà một mapping ghi dưới all: không đến được đâu cả. Đầu ra vẫn đọc được bình thường, nên nếu không có lần dừng này, một bản build đọc các giá trị đó theo kiểu tùy chọn sẽ thành công trong khi thiếu chúng — một thông tin xác thực được ghi ở đó không bao giờ đến được component, và không có gì trong bản build nêu tên mapping đã làm mất nó.

Điều kiện này áp dụng ở bất cứ đâu all: mang ít nhất một mục, đứng riêng hoặc bên cạnh các cơ chế khác; các cơ chế khác trong cùng đầu ra không phải là vấn đề, và một all: được viết rỗng không làm mất gì và không bị báo cáo. Một từ điển phẳng tình cờ mang một khóa tên all với một giá trị duy nhất là một mục chuyển giao environment tên all, không phải điều kiện này.

Phát hiện được định vị tại mục attachment trong chính tệp của bạn, và nêu tên khóa cùng FeatureRecipe nơi mapping được viết — vì đó là tài liệu cần thay đổi, và nó nằm ở một nơi hoàn toàn khác — cùng với các khóa mà một đầu ra có thể mang. Mỗi khóa như vậy là một phát hiện riêng. Bản build báo cáo nó dưới thẻ CATALOG_ERROR.

Thông báo được phát ra:

FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads ("all", recipe "<featurerecipe>", an output may carry "env, file, arg, or a custom mechanism the host's Recipe reads under its own name") (Đầu ra injectMapping của FeatureRecipe ghi một khóa mà không cơ chế chuyển giao nào của host đọc)

Cách khắc phục: trong injectMapping của FeatureRecipe, hãy chuyển các mục từ dưới all: sang cơ chế mà component đọc chúng — thường là env:, hoặc tên của cơ chế mà Recipe của component đọc. Khi FeatureRecipe thuộc về catalog của người khác, thay vào đó hãy gắn một Feature có mapping chuyển giao giá trị đó.

Khi kết xuất đầu ra

Sau khi mọi hợp đồng đã được xác thực, trình biên dịch đánh giá các template Go trên các giá trị của Component, các khối injectMapping của FeatureRecipe, và các nguồn của Recipe và FeatureRecipe, rồi chuyển kết quả cho trình kết xuất.

Template provides: tham chiếu một gốc không tự chứa

Template provides: của một Recipe tham chiếu một gốc nằm ngoài tập tự chứa. Khối provides được đánh giá ở bước đánh giá provides, trước khi đường ống inject được nạp dữ liệu và trước khi các cạnh liên nút được duyệt, nên nó chỉ có thể tham chiếu dữ liệu thuộc về chính nút của nó: .context.instance_id, .context.rendered_name khi provider của nút báo cáo một giá trị như vậy, .values, .infra, các .locals đã được phân giải của nút, và các chuỗi tĩnh. Phép kiểm tra là một danh sách cho phép mang tính khẳng định, nên mọi gốc khác đều dừng build — .context.inject và .context.uses (liên nút), .context.annotations.*, .context.labels, .context.metadata, và .metadata.* (dữ liệu gắn với vị trí đặt hoặc việc triển khai mà bề mặt provides không phơi bày), và .attachment_name (lượt provides của một Recipe cơ sở không phân giải attachment nào). Việc tham chiếu một trong các gốc này sẽ dừng build một cách rõ ràng thay vì âm thầm kết xuất một giá trị rỗng.

.locals nằm trên bề mặt: locals của một nút được phân giải ở phần mở đầu của cùng giai đoạn, trước provides của nút đó, nên một template provides đọc được chúng và nhận các giá trị đã được phân giải.

Thông báo được phát ra:

provides block references a root outside the self-contained set ("<expression>") (khối provides tham chiếu một gốc nằm ngoài tập tự chứa ("<expression>"))

Điểm dừng được định vị tại Recipe khai báo mục đó và tại khóa được viết bên trong nó — .spec.provides.<name> — nên nó chỉ ra khối cần sửa thay vì component đã gắn Recipe. Mọi mục vượt ra ngoài bề mặt đều được báo cáo trong cùng một build; khi có nhiều hơn một mục như vậy, các phát hiện được nhóm dưới provides entries that reach outside the data they are evaluated against.

Cách khắc phục: tái cấu trúc template để chỉ lấy dữ liệu từ các trụ cột của chính Recipe. Nếu giá trị phụ thuộc vào đầu ra của một nút khác, sự phụ thuộc đó thuộc về khối uses[].inject của bên gọi, không thuộc về provides của đích. Nếu giá trị được tính toán, hãy đặt biểu thức vào một mục locals: và đọc nó từ provides — khi đó biểu thức chỉ nằm ở một chỗ. Nếu bạn đang cần đến namespace triển khai (hoặc dữ liệu vị trí đặt khác) để dựng một host liên namespace, hãy công bố host trần ở đây và bổ sung định danh cho nó ở phía bên tiêu thụ bằng một feature định tuyến — provides của bên sản xuất không được phụ thuộc vào nơi nó được triển khai.

provides: của một FeatureRecipe tuân theo cùng quy tắc về locals: các locals: của chính nó được phân giải trước provides: của nó, nên một mục provides của FeatureRecipe cũng đọc được .locals.

Mục locals: tham chiếu một mục cùng cấp được định nghĩa sau trong cùng khối

Một khối locals: được phân giải theo thứ tự các mục được viết, và một mục chỉ đọc được mục cùng cấp được định nghĩa phía trên nó. Một tham chiếu trực tiếp .locals.<key> tới một mục mà khối định nghĩa sau sẽ dừng build: trình biên dịch không bao giờ sắp xếp hay đổi thứ tự khối để tham chiếu được phân giải, vì khi đó đầu ra được phát ra sẽ theo một suy luận thay vì theo những gì đã được viết. Nếu không dừng, tham chiếu sẽ được phân giải qua chính sách khóa thiếu thành một chuỗi rỗng, khiến một hostname hay tên secret được suy ra âm thầm mất đi phần được dùng để dựng nó.

Cả hai lần phân giải một khối locals: đều quyết định lỗi này, và một trong hai là việc ghim. Một khối được phân giải cho hai mục đích khác nhau: để các template của chính Recipe có thể đọc nó trong khi một artifact được render, và để một tọa độ source: có cấu trúc có thể được phân giải và artifact mà nó chỉ đến được ghim. Lỗi được quyết định từ thứ tự khóa đã khai báo và văn bản đã viết, vốn là tất cả những gì nó cần, nên cả hai lần phân giải đều chạm tới nó và báo cáo cùng một điều kiện — aggrega pull, và một bản build điền lockfile, từ chối khối này đúng như một lần render. Có hai hệ quả đáng biết khi viết. Toàn bộ khối được đọc trong khi một tọa độ được phân giải, nên một mục sai thứ tự sẽ dừng build ngay cả khi mọi trường source: đều là giá trị literal và không đọc local nào. Và một Recipe có source: là một chuỗi thuần, hoặc không khai báo source: nào, thì không phân giải tọa độ nào, nên trên Recipe đó lỗi được báo cáo khi output được render.

Thông báo được phát ra, cho một mục trong khối locals: của chính một Recipe component. Nó được định vị tại khóa được viết bên trong Recipe, và mọi mục vi phạm đều được báo cáo trong một build; khi có nhiều hơn một mục, các phát hiện được nhóm dưới locals entries that read a sibling they cannot:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<referenced>", resolved at this point "<the locals available here>", reached through the component "<component>"). define "<referenced>" above "<key>" in the locals block (mục locals tham chiếu đến một mục cùng cấp được định nghĩa sau trong cùng khối; hãy định nghĩa khóa được tham chiếu phía trên khóa đang đọc nó trong khối locals)

Một tự tham chiếu là cùng điều kiện — khóa đã được khai báo nhưng chưa được phân giải — và không việc đổi thứ tự nào khắc phục được nó, nên thông báo nói rõ điều đó thay cho chỉ dẫn di chuyển mục:

locals entry references a sibling defined later in the same block ("<expression>", the key it names is "<key>", resolved at this point "<the locals available here>", reached through the component "<component>"). a locals entry cannot read itself; compute the value from .values and .infra directly (mục locals tham chiếu đến một mục cùng cấp được định nghĩa sau trong cùng khối; một mục locals không thể đọc chính nó; hãy tính giá trị trực tiếp từ .values và .infra)

Một Recipe được nhiều component gắn, nên một lỗi trong một khối dùng chung được báo cáo một lần cho mỗi component gắn nó — và reached through the component là thứ phân biệt các phát hiện đó. Chúng có chung một vị trí, vì tất cả đều nói về cùng một mục được viết trong cùng một tài liệu; vị trí là nơi cần sửa, còn tên component cho biết mỗi phát hiện ứng với component nào của bạn. Các phát hiện không được gộp làm một, vì gộp lại sẽ nói rằng có điều gì đó sai mà không nói nó ảnh hưởng tới những component nào, và đó chính là phần bạn phải xử lý.

Cùng lỗi đó trong một khối locals: mà recipe của một Feature khai báo được báo cáo theo cùng cách: định vị tại khóa được viết bên trong recipe đó, được gọi tên theo component mà attachment nằm trên, và được nhóm với mọi mục cùng cấp mang cùng lỗi. Khi recipe được gắn ở nhiều nơi, lỗi được báo cáo một lần cho mỗi nơi — mỗi attachment gắn khối đó một cách độc lập, nên mỗi cái là một lần xảy ra riêng chứ không phải sự lặp lại của một lần.

Khi dạng đó báo cáo một tự tham chiếu, mệnh đề vị trí của nó chỉ ra chính mục tham chiếu thay vì một mục phía sau, vì đó là nơi khóa nằm.

Cách khắc phục: di chuyển mục được tham chiếu lên trên mục đọc nó. Việc đổi thứ tự một khối locals: là một thay đổi về hành vi ở bất cứ đâu một mục đọc mục khác, nên cách sửa chính xác là việc đổi thứ tự mà thông báo chỉ ra. Một tự tham chiếu — một mục gọi tên chính khóa của nó — không thể sửa bằng cách đổi thứ tự; thay vào đó hãy tính giá trị trực tiếp từ .values và .infra, điều mà thông báo nói thay cho chỉ dẫn di chuyển mục.

locals: key does not exist (Khóa locals: không tồn tại)

Một template đọc .locals.<key> cho một khóa mà khối locals: hoàn toàn không khai báo: một lỗi chính tả, hoặc một khóa đã bị đổi tên hay bị xóa. Mọi bề mặt đọc pillar này đều gây ra lần dừng này: một mục locals:, một template provides:, một template source: của Recipe, và việc phân giải một tọa độ source: có cấu trúc, vốn đọc toàn bộ khối để ghim artifact mà tọa độ đó chỉ định. Pillar locals là một map khóa mở, nên một khóa không xác định nằm dưới nó vượt qua được bước kiểm tra gốc và nếu không thì sẽ được phân giải thành một chuỗi rỗng; lần dừng này là thứ ngăn giá trị rỗng đó đi tới một artifact được phát ra.

Thông báo được phát ra, khi tham chiếu vi phạm nằm trong một template provides::

template references a key the locals block does not declare (Recipe <recipe> provides[<key>] references <expression>, the locals block declares no <referenced>, it declares <the keys it does declare>). correct the key name (template tham chiếu một khóa mà khối locals không khai báo (Recipe <recipe> provides[<key>] tham chiếu <expression>, khối locals không khai báo <referenced>, nó khai báo <the keys it does declare>). hãy sửa tên khóa)

Thông báo được phát ra, khi tham chiếu nằm ngay trong một mục locals:. Thông báo mang theo component mà khối được ràng buộc qua đó, vì lý do mà lần dừng về thứ tự ở trên đã nêu: một khối dùng chung được báo cáo một lần cho mỗi component ràng buộc nó, và đây là thứ phân biệt các phát hiện đó:

template references a key the locals block does not declare ("<expression>", the missing key is "<referenced>", the block declares "<the keys it does declare>", reached through the component "<component>"). correct the key name (template tham chiếu một khóa mà khối locals không khai báo ("<expression>", khóa bị thiếu là "<referenced>", khối khai báo "<the keys it does declare>", đi tới qua component "<component>"). hãy sửa tên khóa)

Cách khắc phục: sửa tên khóa thành một khóa mà khối khai báo; thông báo liệt kê các khóa đó. Lần dừng này khác với lần dừng về thứ tự ở trên vì cách khắc phục khác nhau: không cách sắp xếp lại nào khiến một khóa không tồn tại được phân giải.

Bướ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ự được gõ, nên một bí danh của khối cũng được theo dõi: một khóa đi tới qua dấu chấm mà thân with .locals ràng buộc lại, hoặc qua một biến được ràng buộc với .locals, được kiểm tra đúng theo các điều kiện áp cho cách viết trực tiếp và dừng theo cùng cách, và một khóa được đọc từ khối trong ngoặc đơn — {{ (.locals).nope }} hoặc {{ ($.locals).nope }} — cũng vậy, vì cặp ngoặc chỉ trả về chính khối và không gì hơn. Có một cách viết thoát khỏi bước kiểm tra: khóa đi tới qua một lời gọi mà văn bản template không thể chỉ ra kết quả — {{ index .locals "nope" }}, hoặc {{ (default dict .locals).nope }} — vì thứ mà lời gọi như vậy trả về được quyết định khi template chạy chứ không phải bởi những gì được viết. Một khóa vắng mặt được đọc như một trường từ kết quả của lời gọi như vậy — dạng (default dict .locals).nope — không gây dừng, và kết xuất văn bản giữ chỗ của template engine, <no value>. Một khóa vắng mặt đi tới qua index có gây dừng, nhưng dưới dạng “A template indexes a map with a key the map does not hold (Một template đánh chỉ mục một map bằng một khóa mà map đó không chứa)” ở bên dưới chứ không phải bước kiểm tra này: index dừng với bất kỳ khóa nào mà map không chứa. Do đó index vẫn là cách để đi tới một khóa mà chính tên của nó được tính toán, và một tên được tính toán mà khối không khai báo vẫn được báo cáo theo khóa của nó.

Template references a root the render context does not define (Template tham chiếu một root mà render context không định nghĩa)

Một template tham chiếu một root cấp cao nhất — đoạn đường dẫn đầu tiên sau dấu chấm mở đầu — mà render context của nó không định nghĩa: một lỗi chính tả như {{ .valeus.port }}, hoặc một root không tồn tại trên bề mặt đang được soạn. Phép kiểm tra là một allowlist khẳng định trên các tên root, và tập được chấp nhận được suy ra từ chính hình dạng của render context thay vì được giữ như một danh sách riêng bên cạnh nó, nên tập mà bản build từ chối và tập mà context thực sự cung cấp không thể lệch nhau. Chẩn đoán nêu tên tham chiếu vi phạm và liệt kê các root mà context đó có định nghĩa.

Halt này kích hoạt giống hệt nhau dù tham chiếu đứng trần hay được bọc trong một fallback default, if, with hoặc range, và dạng được bọc là dạng quan trọng nhất: một wrapper có thể cung cấp fallback cho một key vắng mặt dưới một root đã định nghĩa, nhưng không bao giờ cho một root vắng mặt, nên nếu không có halt này, dạng được bọc sẽ lặng lẽ phân giải thành một giá trị rỗng và để bản build hoàn tất thành công. Một key vắng mặt dưới một root đã định nghĩa không bị ảnh hưởng và vẫn tuân theo chính sách missingkey=zero cho value template được mô tả trong “Missing template key — asymmetric policy (Thiếu khóa template — chính sách bất đối xứng)” bên dưới, nên các idiom key tùy chọn như {{ .values.optional_field | default "fallback" }} vẫn hoạt động.

Cùng halt này bao quát một key gõ sai ở một cấp sâu hơn, dưới một pillar có hình dạng được khai báo. Một số pillar có một tập key do compiler định nghĩa: .context, .metadata, .inject, .workload và .boundary trên render context của Recipe và FeatureRecipe, và .manifest trên một path template. Một tham chiếu tới key mà một trong các pillar đó không định nghĩa — {{ .context.nmae }}, {{ .metadata.typo }}, {{ .workload.containres }}, {{ .boundary.nmae }} — sẽ halt đúng như một root sai, và chẩn đoán liệt kê các key mà pillar đó định nghĩa. Trên các template riêng của attachment của một Feature, .inject định nghĩa thêm một key cho mỗi cơ chế phân phối mà khối inject: riêng của attachment nêu tên, bên cạnh env, file, arg và all: một attachment ghi cơ chế vault_ref: được đọc tại {{ .inject.vault_ref.VAULT_PATH }}, và chẩn đoán liệt kê .inject.vault_ref trong số các key mà .inject định nghĩa. Một cơ chế mà attachment không nêu tên sẽ halt ngay cả bên trong một if hay một with, vì tham chiếu được kiểm tra trước khi template chạy. Để đọc một cơ chế mà attachment có thể không nêu tên, hãy bảo vệ nó: {{ with .inject }}{{ if hasKey . "vault_ref" }}{{ index . "vault_ref" "VAULT_PATH" }}{{ end }}{{ end }}. Cặp được bảo vệ này build thành công dù attachment có nêu tên cơ chế hay không, và dù nó có ghi khối inject: hay không — khi đó .inject không chứa gì, nên with bỏ qua phần thân của nó, trong khi hasKey áp dụng trực tiếp lên .inject sẽ halt trên một giá trị không phải map. Bên trong phần bảo vệ, index vẫn halt trên một key mà cơ chế được nêu tên không chứa. Các pillar khác là mở, vì thứ chúng chứa là dữ liệu có khóa chứ không phải một tập do compiler khai báo — trong số đó có .values, .infra, .locals, .provides, .features và .steps trên render context, và .parameters và .parent_boundary trên một path template. Một pillar mở chấp nhận mọi key. Một key vắng mặt dưới một pillar mở không phải halt này — nó tuân theo chính sách missing-key của bề mặt được mô tả trong “Missing template key — asymmetric policy (Thiếu khóa template — chính sách bất đối xứng)” bên dưới, nên {{ .values.optional_field | default "fallback" }} và mọi idiom key tùy chọn khác vẫn hoạt động.

Pillar nào được khai báo và pillar nào mở là một thuộc tính của bề mặt, không phải thứ mà template có thể tác động: compiler đọc nó từ hình dạng của render context mà nó sắp cung cấp. Chính điều đó cho phép halt do lỗi chính tả và key tùy chọn cùng render trên một template.

Một bề mặt cũng có thể thu hẹp một key mà pillar của nó vốn định nghĩa, và báo cáo như vậy không phải lỗi chính tả. Khi một key mang một câu trả lời vô nghĩa — hoặc thuộc về một node khác — trên một bề mặt cụ thể, bề mặt đó từ chối tham chiếu thay vì phân giải nó thành thứ sai, và chẩn đoán liệt kê các key mà nó có định nghĩa. Có hai trường hợp cần biết, cả hai đều là {{ .context.rendered_name }}. Trên các template riêng của một Feature attachment, key này mang tên của host component như chính provider của host báo cáo, nên nó bị từ chối trên attachment của một host mà provider không báo cáo tên nào — một host chỉ đặt một tập artifact, hoặc một host render qua một provider không suy ra tên như vậy — và được chấp nhận trên mọi host khác. {{ .context.instance_id }} được chấp nhận trên bề mặt đó và nêu tên host component mà attachment đang phân giải cho, chính là thứ mà các tài nguyên riêng của host được đặt tên theo trên một host như vậy. Trong các mục locals: của một Recipe, key này bị từ chối bất kể provider của node báo cáo gì: một local chia sẻ context với template source: của Recipe, và việc node có cung cấp source hay không là một trong những thứ mà tên phụ thuộc vào, nên tên không được cung cấp ở đó. Chẩn đoán liệt kê .context.instance_id là key duy nhất mà .context định nghĩa ở đó; thay vào đó hãy đọc tên đã render trong một mục provides: hoặc một inline template. Xem ../templates/rendered-resource-names.md để biết mỗi key trong hai key đó nêu tên gì và đọc được ở đâu.

Thông báo được phát ra khi bản thân root không được định nghĩa:

template references a root the render context does not define (template <template-name> references <dotted-path>, the render context defines <the roots that context defines>) (template tham chiếu một root mà render context không định nghĩa (template <template-name> tham chiếu <dotted-path>, render context định nghĩa <the roots that context defines>))

Và khi root đúng nhưng một key dưới một pillar được khai báo thì không:

template references a root the render context does not define (template <template-name> references <dotted-path>, <pillar> defines <the keys that pillar defines>) (template tham chiếu một root mà render context không định nghĩa (template <template-name> tham chiếu <dotted-path>, <pillar> định nghĩa <the keys that pillar defines>))

Cách khắc phục: sửa tham chiếu thành một mục mà chẩn đoán liệt kê — hầu hết các báo cáo là lỗi chính tả của .values, .infra hoặc .context, hoặc của một key dưới .context hay .metadata. Gỡ bỏ fallback wrapper sẽ không xóa halt, và việc thêm một wrapper cũng chưa bao giờ chặn nó; wrapper chỉ che giấu tham chiếu nào sai. Nếu dữ liệu thực sự thuộc về một node khác, nó đến template này qua inject pipe — nối nó bằng một mục uses[].inject trên bên tiêu thụ và đọc nó từ .context.inject — thay vì qua một root riêng.

Phép kiểm tra bao quát mọi bề mặt template mà renderer đánh giá, mỗi bề mặt đối chiếu với tập tham chiếu mà chính bề mặt đó định nghĩa: valuesMapping, injectMapping, workload của Recipe và FeatureRecipe, các thân artifacts:, các mục provides: và locals:, source:, các thân when: và with: của bước pipeline, assertions:, các template self-inject value: cấp component trong một Aggregate, và các path template của boundary trong Release (directory: / subDirectory:). Hai trong số các bề mặt đó gọi tên một số lần từ chối bằng chẩn đoán riêng, vì lỗi mà chúng mô tả cụ thể hơn “tham chiếu này không tồn tại”: một path template với tới một biến không được cấp cho nó được bao quát bởi “Path-template references a variable outside the allowlist (Path-template tham chiếu một biến nằm ngoài allowlist)” bên dưới, và một FeatureRecipe cấp boundary với tới một pillar theo từng component bởi “FeatureRecipe template references a field outside its scope’s allowlist (FeatureRecipe template tham chiếu một trường nằm ngoài allowlist của phạm vi nó)”. Mọi thứ khác mà hai bề mặt đó từ chối — kể cả một key gõ sai dưới một pillar mà chúng có chấp nhận — đều báo cáo halt này, nên không chẩn đoán nào nói với bạn rằng tham chiếu của bạn là thứ mà nó không phải.

An artifacts: template reads a pillar the Recipe does not declare (Một template artifacts: đọc một pillar mà Recipe không khai báo)

Template của một mục artifacts: đọc .workload, hoặc một khóa bên dưới nó, trong một Recipe không khai báo workload:; hoặc đọc .source, hoặc một khóa bên dưới nó, trong một Recipe không khai báo source:. Cả hai pillar luôn có mặt trong render context của artifacts — chúng là các root mà bề mặt này định nghĩa — nên tham chiếu là hợp lệ về hình thức, và lần dừng này là do thiếu khai báo chứ không phải do tham chiếu sai. Một Recipe render một Deployment từ workload được tổng hợp của nó và một Recipe render một chart từ một source là hai dạng khác nhau, và một phần thân artifacts: viết cho dạng này sẽ với tới một pillar mà dạng kia không bao giờ điền.

Việc kiểm tra chạy trước khi mục được đánh giá, và chính thứ tự đó làm cho báo cáo trở nên hữu ích. Một pillar vắng mặt đến template dưới dạng một giá trị rỗng, nên nếu để đến lúc đánh giá, bản build hoặc sẽ chèn rỗng vào tệp được phát ra, hoặc thất bại với bất cứ điều gì template engine nói về việc đọc một khóa từ hư không — không cái nào nêu tên pillar hay khai báo bị thiếu. Từ chối trước cho phép điểm dừng nêu chính xác biểu thức đã với tới pillar, được trích dẫn đúng như bạn đã viết.

Một source: được khai báo nhưng render ra chuỗi rỗng được xem như không có source nào, vì thứ mà phép kiểm tra đọc là source sau khi template của chính nó đã được đánh giá. Đó cũng là giá trị mà provider dùng để render tiếp, nên một Recipe có source: được phân giải thành rỗng cũng không có source nào để cung cấp cho một phần thân artifacts:.

Thông báo được phát ra, có cùng một hình dạng bất kể mục artifacts: được viết ở đâu. Điều thay đổi không phải là câu mà là các chú thích theo sau nó, cho biết tài liệu nào chứa mục đó.

Mọi tham chiếu vi phạm trong template đều được nêu tên, nên một thân với tới hai pillar vắng mặt sẽ báo cho bạn cả hai chứ không chỉ cái xuất hiện trước. Mỗi tham chiếu được báo cáo tại tài liệu khai báo mục đó, được trích dẫn đúng như bạn đã viết và kèm chú thích về output mà nó thuộc về:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>) (template artifact tham chiếu một pillar mà Recipe không khai báo (<expression>, artifact <output-name>))

Biểu thức nêu tên pillar ở đoạn đầu tiên của nó, và đó là điều cho bạn biết khai báo nào bị thiếu: .source.chart với tới source:, .workload.containers với tới workload:.

Một mục do chính Recipe của một component khai báo được báo cáo đối với khối artifacts: của Recipe đó.

Một mục do một FeatureRecipe khai báo — được gắn vào một component dưới dạng một feature, hoặc được khai báo tại một boundary — được kiểm tra đối với các pillar mà chính FeatureRecipe đó khai báo chứ không phải của component chủ, được báo cáo đối với khối artifacts: của FeatureRecipe, và mang thêm một chú thích nêu tên attachment ràng buộc nó:

artifact template references a pillar the Recipe does not declare (<expression>, artifact <output-name>, attachment <attachment-name>) (template artifact tham chiếu một pillar mà Recipe không khai báo (<expression>, artifact <output-name>, attachment <attachment-name>))

Chú thích attachment nói lên điều mà vị trí tự nó không thể nói: một component có thể mang nhiều attachment, và một attachment được khai báo tại một boundary chạm tới mọi component mà boundary đó chứa. Bản thân câu thông báo nêu tên một Recipe trên cả hai đường; vị trí và chú thích attachment cùng nhau mới cho biết cần mở tài liệu nào.

Khi một template nêu nhiều tham chiếu, mỗi tham chiếu nhận một báo cáo riêng bên dưới một dòng nêu tên mục mà chúng cùng chia sẻ, và dòng đó cũng nêu tên tài liệu:

artifact <output-name> references pillars its Recipe does not declare (artifact <output-name> tham chiếu các pillar mà Recipe của nó không khai báo)

artifact <output-name> references pillars the FeatureRecipe attachment <attachment-name> binds does not declare (artifact <output-name> tham chiếu các pillar mà FeatureRecipe được attachment <attachment-name> ràng buộc không khai báo)

Mọi báo cáo trong số này đều mang cùng một điều kiện dừng, bất kể nó nói về tài liệu nào, nên bất cứ thứ gì so khớp theo điều kiện thay vì theo văn bản sẽ không thấy khác biệt nào giữa chúng.

Cách khắc phục: hoặc khai báo pillar mà template đọc, hoặc ngừng đọc nó. Khai báo là cách khắc phục khi phần thân artifacts: thuộc về dạng Recipe đó — thêm workload: mà các tham chiếu container, port hoặc volume của template mong đợi, hoặc source: có đường dẫn chart hoặc module mà template nội suy. Bỏ tham chiếu là cách khắc phục khi phần thân được viết cho một Recipe khác và tái sử dụng một đoạn không áp dụng ở đây; khi giá trị thực sự đến từ nơi khác, hãy công bố nó qua provides: của node tạo ra nó và đọc nó từ inject pipe thay vì với tới một pillar mà Recipe này không điền. Bọc tham chiếu bằng một wrapper dự phòng không gỡ được lần dừng — thứ bị thiếu là pillar, không phải khóa bên dưới nó — và chuyển tham chiếu sang một mục khác trong cùng Recipe cũng vậy, vì mọi mục trong một khối artifacts: đều được đánh giá trên cùng các pillar.

Điểm dừng này khác với “Template references a root the render context does not define (Template tham chiếu một root mà render context không định nghĩa)” ở trên, và đáng phân biệt hai cái vì cách khắc phục khác nhau. Cái đó kích hoạt trên một root mà bề mặt hoàn toàn không định nghĩa, hoặc trên một khóa gõ sai bên dưới một pillar có hình dạng cố định — {{ .workload.containres }} trên một Recipe có khai báo workload. Cái này kích hoạt trên một tham chiếu viết đúng chính tả tới một pillar đơn giản là không có ở đó.

A template reads a rendered name the node’s provider does not report (Một template đọc một tên đã render mà provider của node không báo cáo)

Một template đọc {{ .context.rendered_name }} — tên mà provider được gắn đặt cho đầu ra nó render cho node, từ source do tác giả cung cấp hoặc từ một workload nó tổng hợp — trên một node mà provider của nó không báo cáo tên như vậy. Tham chiếu được viết đúng và khóa là một khóa mà render context định nghĩa; thứ vắng mặt là một câu trả lời cho node này.

Việc từ chối tồn tại vì phương án thay thế còn tệ hơn một lần dừng. Tên đến template dưới dạng một chuỗi thuần, nên một node không có tên sẽ render mất tham chiếu và phát ra một địa chỉ thiếu một đoạn — .svc.cluster.local ở chỗ lẽ ra là một hostname — với mã thoát bằng không, mà không có gì trong bản build để đọc. Artifact đó vẫn triển khai được, và thứ nó trỏ tới không tồn tại. Từ chối trước khi bất cứ thứ gì được đánh giá sẽ báo lỗi vào chính template mà tác giả đã viết.

Việc provider của một node có báo cáo tên như vậy hay không được xác định bởi binding của Recipe, trước mọi lần đánh giá, nên không có gì ở đây là phỏng đoán.

Có hai báo cáo, và bạn nhận báo cáo nào phụ thuộc vào node chứ không phải vào nơi bạn viết tham chiếu. Một node không tự cung cấp source, dưới một provider không báo cáo tên cho nó, có các tài nguyên được đặt tên theo danh tính của node, nên có một giá trị đúng và báo cáo nêu ra giá trị đó. Một node có cung cấp source, dưới một provider không suy ra tên cho nó, thì không có giá trị thay thế — và đưa ra danh tính ở đó sẽ dẫn bạn tới một giá trị không gọi tên tài nguyên nào của node đó, nên báo cáo nói rõ điều này.

Thông báo được phát ra, khi node không tự cung cấp source:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). read {{ .context.instance_id }} instead: this node supplies no source of its own, so its resources are named after the node’s identity (template đọc tên mà target đặt cho các tài nguyên nó render cho node, và provider của node này không báo cáo tên như vậy; một template hợp lệ đọc một giá trị do chính provider của node cung cấp (“.context.rendered_name”, provider “<provider>”). hãy đọc {{ .context.instance_id }} thay thế: node này không tự cung cấp source, nên các tài nguyên của nó được đặt tên theo danh tính của node)

Và khi node có cung cấp source, dưới một provider không suy ra tên như vậy:

template reads the name the target gives the resources it renders for the node, and this node’s provider reports no such name; a conforming template reads a value the node’s own provider supplies (".context.rendered_name", provider "<provider>"). write a value that does not depend on a name this target derives: it reports none for the output it renders from supplied source, so there is nothing of that kind to read here (template đọc tên mà target đặt cho các tài nguyên nó render cho node, và provider của node này không báo cáo tên như vậy; một template hợp lệ đọc một giá trị do chính provider của node cung cấp (“.context.rendered_name”, provider “<provider>”). hãy viết một giá trị không phụ thuộc vào tên mà target này suy ra: nó không báo cáo tên nào cho đầu ra nó render từ source được cung cấp, nên ở đây không có gì thuộc loại đó để đọc)

Khi tham chiếu nằm trong một template không phải là một mục provides:, báo cáo còn nêu thêm trường mà nó được viết trong đó — field "valuesMapping", field "artifacts[probe.tf.json]" — vì khóa của một mục artifacts: là một tên tệp đầu ra và chứa ký tự mà vị trí dùng để phân tách các đoạn của chính nó, nên vị trí dừng lại ở khối chứa mục đó.

Những template được kiểm tra: mọi template mà một Recipe viết trực tiếp — các mục provides:, valuesMapping:, phần thân workload:, từng mục artifacts:, và with: cùng when: của từng bước pipeline. Có một bề mặt template nằm ngoài phạm vi này: một mục valuesMapping:, workload: hoặc artifacts: được cung cấp qua $import: — dù import trỏ tới một tệp cục bộ hay một mục thư viện — không mang văn bản nào trong Recipe cho tới khi quá trình render phân giải nó, nên một tham chiếu bên trong phần thân như vậy được render thành giá trị rỗng thay vì gây dừng.

Cách khắc phục: đọc khóa mà báo cáo nêu ra. Khi đầu ra của node là thứ được dựng cho nó dưới một provider không báo cáo tên — một workload được tổng hợp, một tập artifact được đặt sẵn — {{ .context.instance_id }} là tên mà các tài nguyên đó thực sự mang, và đó là giá trị đúng chứ không phải một giá trị dự phòng. Khi node tự cung cấp một chart hoặc module và báo cáo không đưa ra giá trị thay thế, tên bạn đang tìm không phải là tên mà provider đó suy ra: hãy công bố thứ gì đó không phụ thuộc vào nó, hoặc đặt tên tài nguyên trong source bạn cung cấp và đọc lại tên đó từ một giá trị bạn đặt. ../templates/rendered-resource-names.md trình bày những provider nào báo cáo tên và, với từng provider còn lại, lý do không có tên nào để báo cáo.

A template reads its callers’ render facts without declaring it (Một template đọc render facts của các bên gọi mà không khai báo)

Một template trong một FeatureRecipe được gắn vào một component đọc render_facts bên dưới .context.used_by — những gì các component kết nối tới host của attachment báo cáo về lần render của chính chúng — và FeatureRecipe không đặt readsCallerRenderFacts: true.

Khóa này quyết định khi nào attachment render. Không có nó, attachment render ngay sau component mà nó được gắn vào, và một component kết nối nằm sau trong thứ tự của bản build chưa render vào thời điểm đó, nên những gì nó phát ra không thể có sẵn để đọc. Từ chối template trước khi bất cứ thứ gì render sẽ báo khai báo bị thiếu vào đúng trường bạn đã viết, thay vì tạo ra một bản build có template đọc được những gì một số bên gọi phát ra mà không đọc được của các bên còn lại.

Thông báo được phát ra:

template reads its callers’ render facts, but the FeatureRecipe does not set readsCallerRenderFacts (<reference>, written in <field>) (template đọc render facts của các bên gọi, nhưng FeatureRecipe không đặt readsCallerRenderFacts (<reference>, được viết trong <field>))

Tham chiếu được trích dẫn tương đối với kết nối mà nó được đọc ra — .render_facts, hoặc .render_facts.<name> — vì một template đọc các bên gọi từng kết nối một, bên trong {{ range .context.used_by }} hoặc từ một kết nối mà nó chọn. Trường nêu ra khối mà template được viết trong đó: valuesMapping, workload hoặc artifacts[<output-name>]. with: hoặc when: của một bước pipeline đọc cùng các facts đó sẽ được báo cáo bởi mục tiếp theo, bất kể FeatureRecipe đặt gì, vì đặt khóa này cũng không cho phép một bước đọc chúng. Khi nhiều trường đọc các facts, mỗi trường nhận một báo cáo riêng bên dưới một dòng nêu điểm chung của chúng:

attachment templates reading their callers’ render facts without declaring it (các template của attachment đọc render facts của các bên gọi mà không khai báo)

Cách khắc phục: đặt readsCallerRenderFacts: true trong spec của FeatureRecipe. Điều đó khiến các attachment của nó render sau khi mọi component đã render và không thay đổi gì khác trong những gì chúng render — xem trang thực thể FeatureRecipe. Khóa này là hợp đồng, và lần dừng này chỉ giúp bạn tìm ra một template rõ ràng cần đến nó: việc kiểm tra đọc template như được viết, nên một tham chiếu được dựng trong khi template chạy, hoặc được viết trong nội dung import từ một tệp hay một thư viện, sẽ không gây dừng — dù vậy vẫn hãy đặt khóa trên FeatureRecipe như thế. Một template đọc một trường tên render_facts từ một danh sách khác bên cạnh .context.used_by cũng gây dừng, và một template đọc facts của chính host dưới dạng .render_facts bên trong {{ with .context }} bên cạnh nó cũng vậy — hãy viết facts của chính host đầy đủ là .context.render_facts, cách viết không bao giờ bị hiểu là của các bên gọi; đặt khóa này sẽ gỡ bỏ cả hai trường hợp mà chỉ tốn một lần render muộn hơn.

Một FeatureRecipe render một lần cho một boundary (executionScope: boundary) không được kiểm tra ở đây: các template tạo ra tài nguyên của nó không có .context để đọc, và một tham chiếu tới nó bị từ chối như một trường nằm ngoài danh sách cho phép của phạm vi.

Một bước pipeline đọc render facts của các bên gọi nó

with: hoặc when: của một bước pipeline, trong một FeatureRecipe được gắn vào một component, đọc render_facts bên dưới .context.used_by — những gì các component kết nối tới host của attachment đã báo cáo về các lần render của chính chúng.

Một bước pipeline không bao giờ thấy các kết nối đó. Một bước có thể viết lại các tài liệu của chính component host, và output của chính một component vẫn giữ nguyên bất kể ai kết nối tới nó, nên các template của một bước được đánh giá mà không có .context.used_by — với mọi FeatureRecipe, dù nó có đặt readsCallerRenderFacts: true hay không. Khóa đó quyết định khi nào attachment render, không bao giờ quyết định những gì một bước thấy. Do đó, một bước đọc facts của các bên gọi sẽ không đọc được gì, và build dừng lại trước khi bất cứ thứ gì được render thay vì render lần đọc đó thành một giá trị rỗng.

Thông báo được phát ra:

pipeline step reads its callers’ render facts, but a pipeline step does not read the components connecting to its host; it reads only the host’s own render facts (<reference>, written in <field>) (bước pipeline đọc render facts của các bên gọi nó, nhưng một bước pipeline không đọc các component kết nối tới host của nó; nó chỉ đọc render facts của chính host (<reference>, được viết trong <field>))

Tham chiếu được trích dẫn tương đối so với kết nối mà nó được đọc từ đó — .render_facts, hoặc .render_facts.<name> — như trong mục ở trên, và trường nêu tên bước theo id của nó: pipeline[<step>].with hoặc pipeline[<step>].when. Khi nhiều bước đọc các facts, mỗi bước nhận một báo cáo riêng bên dưới một dòng nêu điểm chung của chúng:

pipeline steps reading their callers’ render facts (các bước pipeline đọc render facts của các bên gọi chúng)

Cách khắc phục: trong một bước, hãy đọc render facts của chính host tại .context.render_facts, viết đầy đủ — chúng đến từ lần render của chính host, nên việc đọc chúng không khiến điều gì phụ thuộc vào ai kết nối tới nó. Thay vào đó, hãy đọc facts của các bên gọi trong các template tạo ra tài nguyên của chính attachment — valuesMapping:, workload: hoặc artifacts: của nó — với readsCallerRenderFacts: true được đặt, như trang thực thể FeatureRecipe mô tả. Chỉ đặt khóa thôi không gỡ được lần dừng này. Phép kiểm tra đọc template như được viết, với các giới hạn mà mục ở trên mô tả: một tham chiếu được dựng trong khi template chạy, hoặc một tham chiếu được viết trong nội dung import từ một tệp hoặc một thư viện, không gây dừng, và một bước đọc một trường tên render_facts từ một danh sách khác bên cạnh .context.used_by, hoặc đọc facts của chính host dưới dạng .render_facts bên trong {{ with .context }} bên cạnh nó, cũng gây dừng.

Một FeatureRecipe render một lần cho một boundary (executionScope: boundary) không được kiểm tra ở đây, vì lý do mà mục ở trên nêu.

Một template đọc render facts của các đích mà không khai báo

Một template trong một FeatureRecipe được gắn vào một component đọc render_facts bên dưới .context.uses — những gì các component mà host của attachment được nối tới đã báo cáo về các lần render của chính chúng — và FeatureRecipe không đặt readsTargetRenderFacts: true.

Khóa này quyết định hai điều. Nó khiến attachment render khi mọi component đã render xong: không có nó, attachment render ngay sau component mà nó được gắn vào, và một đích đứng sau trong thứ tự của build chưa render tại thời điểm đó. Và chính nó đặt facts của từng đích lên các kết nối mà attachment đọc: không có nó, không mục nào của .context.uses mang .render_facts cả. Việc từ chối template trước khi bất cứ thứ gì render sẽ báo cáo khai báo bị thiếu tại trường bạn đã viết, thay vì một build có template không đọc được gì ở nơi nó mong đợi facts của một đích.

Thông báo được phát ra:

template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts (<reference>, written in <field>) (template đọc render facts của một component mà host của nó được nối tới, nhưng FeatureRecipe không đặt readsTargetRenderFacts (<reference>, được viết trong <field>))

Tham chiếu là tham chiếu mà template đã viết: bên dưới alias của một kết nối, viết đầy đủ — .context.uses.<alias>.render_facts, hoặc .context.uses.<alias>.render_facts.<name> — hoặc, khi template đọc từng kết nối một, bên trong {{ range .context.uses }}, {{ with .context.uses.<alias> }} hoặc từ một kết nối mà nó chọn, tương đối so với kết nối đó: .render_facts, hoặc .render_facts.<name>. Trường nêu tên khối mà template được viết trong đó: valuesMapping, workload hoặc artifacts[<output-name>]. with: hoặc when: của một bước pipeline đọc cùng các facts đó thì được báo cáo bởi mục tiếp theo, bất kể FeatureRecipe đặt gì. Khi nhiều trường đọc các facts, mỗi trường nhận một báo cáo riêng bên dưới một dòng nêu điểm chung của chúng:

attachment templates reading the render facts of the components their host is wired to, without declaring it (các template của attachment đọc render facts của các component mà host của chúng được nối tới, mà không khai báo)

Cách khắc phục: đặt readsTargetRenderFacts: true trong spec của FeatureRecipe — readsCallerRenderFacts: true không gỡ được lần dừng này, vì nó đặt facts lên các component kết nối tới host chứ không phải lên các component mà host được nối tới. Điều đó render các attachment của nó sau khi mọi component đã render, đặt facts của từng đích lên kết nối của nó, và không thay đổi gì khác về những gì chúng render — xem trang thực thể FeatureRecipe. Khóa là hợp đồng, và lần dừng này chỉ giúp bạn tìm một template rõ ràng cần nó: phép kiểm tra đọc template như được viết, nên một tham chiếu được dựng trong khi template chạy, hoặc một tham chiếu được viết trong nội dung import từ một tệp hoặc một thư viện, không gây dừng — dù vậy vẫn hãy đặt khóa trên FeatureRecipe như thế. Một template có đọc .context.uses và đồng thời đọc một trường tên render_facts từ một giá trị khác — trong đó có facts của một bên gọi bên trong {{ range .context.used_by }} — cũng gây dừng; hãy đặt khóa, và cả readsCallerRenderFacts nếu template đọc facts của các bên gọi.

Một FeatureRecipe render một lần cho một boundary (executionScope: boundary) không được kiểm tra ở đây, vì lý do mà mục về các bên gọi ở trên nêu.

Một bước pipeline đọc render facts của các đích

with: hoặc when: của một bước pipeline, trong một FeatureRecipe được gắn vào một component, đọc render_facts bên dưới .context.uses — những gì các component mà host của attachment được nối tới đã báo cáo về các lần render của chính chúng.

Một bước đọc các kết nối mà host của nó tạo ra, như Recipe của chính host đọc chúng, và không bao giờ đọc render facts của các đích — với mọi FeatureRecipe, dù nó có đặt readsTargetRenderFacts: true hay không. Một bước có thể viết lại các tài liệu của chính component host, và lần render của chính host đọc những gì các đích của nó công bố, không bao giờ đọc những gì chúng đã phát ra, nên các template của một bước được đánh giá mà không có các facts đó. Do đó, một bước đọc chúng sẽ không đọc được gì, và build dừng lại trước khi bất cứ thứ gì được render thay vì render lần đọc đó thành một giá trị rỗng.

Thông báo được phát ra:

pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host’s own render facts (<reference>, written in <field>) (bước pipeline đọc render facts của một component mà host của nó được nối tới, nhưng một bước pipeline chỉ đọc render facts của chính host (<reference>, được viết trong <field>))

Tham chiếu được trích dẫn như trong mục ở trên, và trường nêu tên bước theo id của nó: pipeline[<step>].with hoặc pipeline[<step>].when. Khi nhiều bước đọc các facts, mỗi bước nhận một báo cáo riêng bên dưới một dòng nêu điểm chung của chúng:

pipeline steps reading the render facts of the components their host is wired to (các bước pipeline đọc render facts của các component mà host của chúng được nối tới)

Cách khắc phục: trong một bước, hãy đọc render facts của chính host tại .context.render_facts, viết đầy đủ. Thay vào đó, hãy đọc facts của các đích trong các template tạo ra tài nguyên của chính attachment — valuesMapping:, workload: hoặc artifacts: của nó — với readsTargetRenderFacts: true được đặt, như trang thực thể FeatureRecipe mô tả. Chỉ đặt khóa thôi không gỡ được lần dừng này. Phép kiểm tra đọc template như được viết, với các giới hạn mà mục ở trên mô tả.

Một FeatureRecipe render một lần cho một boundary (executionScope: boundary) không được kiểm tra ở đây, vì lý do mà mục về các bên gọi ở trên nêu.

Vi phạm an toàn kiểu giữa các node qua selector:

Một lần dừng bao quát hai biểu thức nhãn mà tác giả catalog viết để ràng buộc những gì có thể được nối hoặc gắn, vì cả hai thất bại theo cùng một cách: một tập nhãn không thỏa mãn một biểu thức mà một thực thể catalog đã khai báo.

Một cạnh uses: có đích không thỏa selector: của socket. Một socket usesSchema khai báo một trường selector: loại trừ Component đích được gắn ở đầu kia của cạnh. Selector là cách tác giả catalog nói “socket này chỉ chấp nhận các đích có nhãn khớp với biểu thức này”; một cạnh thỏa mãn phép tra cứu theo tên socket nhưng không thỏa biểu thức selector là một vi phạm an toàn kiểu.

Thông báo được phát ra:

selector violation ("", declared on socket "", not satisfied by the labels of ""). Add the labels the selector requires to the target’s component type, or wire the socket to a component that already carries them. (vi phạm selector: biểu thức khai báo trên socket không được các nhãn của đích thỏa mãn. Hãy thêm các nhãn mà selector yêu cầu vào kiểu component của đích, hoặc nối socket tới một component đã mang sẵn các nhãn đó.)

Một attachment có component không thỏa appliesTo: của Feature. Một Feature khai báo những component mà nó có thể gắn vào, trên appliesTo: và trên appliesToAnyOf:. Các yêu cầu của biểu thức đơn phải cùng đúng, còn các phương án thay thế chỉ cần một trong số chúng đúng là đủ; cả hai bề mặt phải đúng, và một bề mặt mà Feature bỏ qua thì được thỏa mãn bởi bất cứ thứ gì. Một attachment có component mang các nhãn mà khai báo của Feature không chấp nhận là cùng loại vi phạm với trường hợp cạnh ở trên.

Thông báo được phát ra:

selector violation ("", declared by Feature "", not satisfied by the labels of ""). Add the labels the Feature’s appliesTo requires to this component’s type, or attach a Feature whose applicability the component already satisfies. (vi phạm selector: biểu thức do Feature khai báo không được các nhãn của component thỏa mãn. Hãy thêm các nhãn mà appliesTo của Feature yêu cầu vào kiểu của component này, hoặc gắn một Feature có điều kiện áp dụng mà component đã thỏa mãn.)

Mỗi biểu thức cũng có thể được viết ở một dạng mà ngữ pháp nhãn hoàn toàn không đọc được. Trường hợp đó được báo cáo bằng cùng lần dừng này, với giá trị cuối cùng là lý do không đọc được thay vì tập nhãn không thỏa mãn nó — đó là điều phân biệt một biểu thức không thể đánh giá với một biểu thức đã được đánh giá và cho kết quả sai:

selector violation ("", declared by Feature "", which could not be evaluated: ""). Correct the appliesTo selector on the Feature’s catalog entity. (vi phạm selector: biểu thức do Feature khai báo không thể được đánh giá. Hãy sửa selector appliesTo trên thực thể catalog của Feature.)

Một selector của socket mà ngữ pháp không đọc được cũng bị từ chối trước khi có bất cứ thứ gì nối dây vào socket. aggrega validate, trên toàn bộ catalog hoặc trên một Component hay Feature, đọc mọi selector socket mà chính tài liệu của thực thể khai báo, và từ chối, theo cùng điều kiện này, selector mà ngữ pháp không đọc được, dù có cạnh nào được nối qua socket hay không:

selector violation ("", declared on socket "", which could not be evaluated: ""). Correct the selector on the socket’s declaration in the component type’s usesSchema. (vi phạm selector, được khai báo trên một socket, và không thể đánh giá được. Hãy sửa selector trong khai báo của socket ở usesSchema của loại component.)

Trên socket của một Feature, cách khắc phục sẽ nêu usesSchema của Feature thay vào đó. Chưa có gì nối dây vào socket, nên lỗi thuộc về thực thể catalog: nó được xếp vào CATALOG_ERROR và nêu tệp của thực thể.

Lần dừng mang khóa authoring mà nó liên quan — mục socket uses:, hoặc mục features: nêu tên attachment — cùng với tệp khai báo nó, nên vị trí được báo cáo là mục bạn sửa chứ không phải đầu tài liệu. Một Component được viết bên trong một subsystem được định vị tại subsystem mà nó được viết dưới đó, theo từng cấp. Một attachment được định vị tại mục features: đã viết nó, trong tài liệu đã viết nó, và được quy về tác giả của tài liệu đó: khối của chính component hoặc khối của một subsystem trong Aggregate là lỗi của developer; còn với một attachment chỉ Release tạo ra, mục của nó cho component hoặc khối features: của một boundary chứa component là lỗi của operator. Khi cả hai tài liệu đều viết attachment, nó được định vị tại nơi type của nó được nêu tên, điều mà Aggregate luôn làm. Một attachment được viết trên một kết nối được định vị tại khóa của nó dưới features: của kết nối đó, trong tài liệu đã viết nó — mục kết nối của Aggregate, hoặc mục theo từng cạnh của Release với một attachment chỉ Release tạo ra. Một Feature mà chỉ Release gắn vào một component mà khai báo của nó không chấp nhận sẽ có dạng:

[OPS_ERROR E0007] release.yaml at .spec.boundaries.main.components.app.features.metrics
selector violation ("component.aggrega.ai/type in (server, worker)", declared by Feature "core/prometheus-exporter", not satisfied by the labels of "app"). Add the labels the Feature's appliesTo requires to this component's type, or attach a Feature whose applicability the component already satisfies.

và cùng attachment đó khi được viết trên component trong Aggregate sẽ hiển thị [DEVELOPER_ERROR E0007] aggregate.yaml at .spec.components.app.features.metrics. Một attachment do việc mở rộng dựa trên annotation tạo ra không được viết bởi mục features: nào, nên nó được định vị tại khóa features: riêng của component trong tài liệu khai báo component đó, như một lỗi của developer.

Cách khắc phục vi phạm cạnh: hoặc định tuyến cạnh uses: tới một Component có nhãn thỏa mãn selector, hoặc điều chỉnh biểu thức selector trong thực thể catalog để chấp nhận lớp đích mong muốn. Xem lại metadata.labels của Component đích bằng aggrega inspect để xác nhận nó mang những nhãn nào.

Cách khắc phục vi phạm attachment: hoặc gắn Feature vào một component có nhãn mà khai báo của nó chấp nhận, hoặc mở rộng appliesTo: của Feature — thêm một phương án thay thế dưới appliesToAnyOf: khi Feature thực sự phục vụ nhiều hơn một lớp component. Khi component lẽ ra phải đủ điều kiện mà không đủ, phần còn thiếu thường là một nhãn: hãy xem lại bằng aggrega inspect và thêm những gì biểu thức yêu cầu vào metadata.labels của Component.

Unknown provider (Provider không xác định)

Một Recipe khai báo capability: <name> trong đó <name> không nêu tên provider nào mà compiler phục vụ. Compiler không thể điều phối việc render tới một provider mà nó chưa từng biết.

Thông báo được phát ra:

unknown provider: <provider-name> (provider không xác định)

Cách khắc phục: xác nhận tên provider được viết đúng — cloudformation, compose, helm, helm-chart và terraform là các tên mà các plugin provider tích hợp sẵn phục vụ. Nếu bạn muốn dùng một provider doanh nghiệp tùy chỉnh, hãy đảm bảo một Plugin render provider phục vụ tên đó (pluginType: provider với tên trong spec.provider.capabilities của nó) có mặt trong workspace catalog mà build trỏ tới.

A capability is served by more than one provider plugin (Một capability được phục vụ bởi nhiều hơn một plugin provider)

Một build gặp một capability — hoặc một lần pull phân giải một capability — được phục vụ bởi nhiều hơn một Plugin render provider (pluginType: provider, mỗi plugin liệt kê capability đó trong spec.provider.capabilities của nó), và workspace chưa chọn plugin nào sẽ render nó. Thay vì chọn bừa một provider, build dừng lại và nêu tên cả hai ứng viên. Một catalog mang hai plugin cho cùng một capability là hợp lệ — hai nhà phát hành có thể mỗi bên cung cấp một plugin cho helm hoặc compose, và catalog chấp nhận cả hai. Sự mơ hồ chỉ lộ ra tại điểm sử dụng: lần dừng xảy ra khi một build hoặc pull thực sự gặp capability đang tranh chấp, không phải lúc tải.

Thông báo được phát ra. Quy tắc đã dừng build đứng đầu, và các chi tiết — capability nào, các ứng viên nào, và binding cần viết — theo sau:

capability is served by more than one provider plugin; add a plugins.providers entry to select one: capability "<capability-name>" is served by more than one provider plugin (<plugin-1>, <plugin-2>); add a plugins.providers entry for "<capability-name>" selecting one (capability được phục vụ bởi nhiều hơn một provider plugin; hãy thêm một mục plugins.providers để chọn một plugin)

Cách khắc phục: thêm một mục plugins.providers trong cấu hình workspace, có khóa là capability, với giá trị chọn định danh plugin sẽ render nó. Giữ cả hai plugin trong catalog liên kết; binding cho workspace này biết cần điều phối tới plugin nào cho capability đang tranh chấp.

The plugin serving a provider cannot assemble what that provider combines (Plugin phục vụ một provider không thể lắp ráp những gì provider đó kết hợp)

Một provider khai báo điều gì xảy ra với đầu ra theo từng nút của một nhóm điều phối: đầu ra của mỗi nút được ghi thẳng ra tại đường dẫn điều phối, các mảnh được gộp thành một tài liệu, hoặc mỗi nút được đặt tại vị trí riêng của nó bên trong một cấu trúc bao chung. Khi một provider khai báo rằng đầu ra được kết hợp — một tệp compose đã hợp nhất, một umbrella chart — plugin phục vụ nó phải cung cấp export thực hiện việc kết hợp. Điểm dừng này xảy ra khi plugin không cung cấp: plugin quảng bá khả năng render theo từng nút (render_node) nhưng không có assemble_boundary tương ứng, nên các nút của nhóm có thể được render nhưng đầu ra của chúng không thể được hợp nhất.

Cả hai vế của sự bất nhất đó đều thuộc về plugin. Điều gì xảy ra với đầu ra của một nhóm điều phối là một phần của những gì plugin báo cáo về chính nó khi được nạp, và export thực hiện việc kết hợp là một trong các mục dưới spec.exports của một thực thể Plugin, được đối chiếu với chính báo cáo đó — vì vậy điểm dừng chỉ ra một plugin tuyên bố một việc lắp ráp mà bề mặt export của nó không cung cấp.

Bản build dừng lại thay vì bỏ qua việc lắp ráp. Bỏ qua nó sẽ ghi mảnh của từng nút tại đường dẫn nơi lẽ ra chỉ có một artifact và báo cáo thành công, và không bước nào về sau có thể phân biệt các mảnh đó với đầu ra phẳng theo từng nút mà một provider không tuyên bố lắp ráp phát ra theo thiết kế — nên một artifact bị thiếu sẽ chỉ lộ ra ở nơi đầu ra được áp dụng thay vì vào lúc build.

Một nhóm điều phối không có đường dẫn điều phối sẽ được bỏ qua. Đầu ra được ghi mà không có đường dẫn là đầu ra theo từng nút, nên không có gì được lắp ráp ở đó để một tuyên bố về việc kết hợp chi phối.

Thông báo được phát ra — một kết quả cho mỗi nhóm điều phối vi phạm, nêu tên provider và đường dẫn mà nhóm đó lắp ráp tại:

provider expected to assemble its dispatch group provides no boundary assembler ("<provider>", dispatch path "<path>") (provider được kỳ vọng lắp ráp nhóm điều phối của nó không cung cấp bộ lắp ráp boundary)

Khi có nhiều hơn một nhóm điều phối vi phạm, các kết quả được đưa ra cùng nhau dưới báo cáo dispatch groups whose provider offers no boundary assembler (các nhóm điều phối có provider không cung cấp bộ lắp ráp boundary).

Cách khắc phục: phục vụ capability bằng một plugin quảng bá cả render_node lẫn assemble_boundary — xem ../entities/plugin.md để biết bề mặt soạn thảo spec.exports, và ../schema/plugins/wasm-provider.md để biết export lắp ráp nhận được gì. Nếu bạn là tác giả plugin, bạn tự cân chỉnh hai phía: thêm export lắp ráp, hoặc báo cáo không tuyên bố lắp ráp và để đầu ra của từng nút nằm tại đường dẫn điều phối mà không hợp nhất. Nếu bạn dùng một plugin đã phát hành, hãy chọn một phiên bản cung cấp cả hai export, hoặc chọn một plugin có provider không tuyên bố lắp ráp cho capability đó.

A boundary-level Feature’s output reaches no assembled file (Đầu ra của một Feature cấp boundary không đến được tệp đã lắp ráp nào)

Một Feature được gắn dưới features: của một boundary mà FeatureRecipe của nó khai báo executionScope: boundary sẽ render một lần cho toàn bộ boundary, và đầu ra của nó đi tới thư mục mà directory: và subDirectory: riêng của boundary được đánh giá ra cho nó. Một provider gộp đầu ra của mình vào một tài liệu — compose vào một docker-compose.yaml; cloudformation vào một stack — chỉ ghi phần đóng góp của một Feature như vậy như một phần của tệp mà nó lắp ráp tại đó từ các component của boundary. Tệp đó chỉ tồn tại khi đầu ra của ít nhất một component rơi vào cùng thư mục dưới cùng provider.

Tệp đó không tồn tại khi các component của boundary rơi vào nơi khác: khi chúng nằm trong các boundary lồng nhau có subDirectory: gửi chúng đi nơi khác — chẳng hạn "{{ .component_id }}", để mỗi component có tệp riêng — hoặc dưới một thư mục mà đầu ra của Feature không dùng chung. Không có gì được lắp ráp tại thư mục của Feature, nên đầu ra của nó sẽ không được ghi vào đâu cả — đối với compose bridge, đó là một dịch vụ gateway mà không tệp nào chứa — và bản build sẽ báo cáo thành công. Thay vào đó, bản build dừng lại.

Một Feature có provider ghi mỗi phần đóng góp thành các tệp riêng — helm, helm-chart và terraform — không bị ảnh hưởng: các tệp đó được ghi bất kể có gì được lắp ráp bên cạnh chúng hay không.

Thông báo được phát ra — một phát hiện cho mỗi Feature vi phạm, đặt tại mục của nó dưới features: của boundary, nêu tên boundary, Feature, đường dẫn điều phối mà đầu ra của nó được định tuyến tới và provider:

boundary-level Feature’s output is routed to a dispatch path nothing assembles (boundary "<boundary>", feature "<instance>", dispatch path "<path>", provider "<provider>"). attach the Feature at a boundary whose output path also receives its components, or give the boundary’s components the directory the Feature’s output is routed to (đầu ra của Feature cấp boundary được định tuyến tới một đường dẫn điều phối không có gì được lắp ráp; hãy gắn Feature tại một boundary có đường dẫn đầu ra cũng nhận các component của nó, hoặc cấp cho các component của boundary thư mục mà đầu ra của Feature được định tuyến tới)

Một compose bridge được gắn tại boundary cha bridge, có boundary con duy nhất đặt mỗi component dưới subDirectory: "{{ .component_id }}", sẽ in ra:

[OPS_ERROR E0365] release-compose.yaml at .spec.boundaries.bridge.features.gateway
boundary-level Feature's output is routed to a dispatch path nothing assembles (boundary "bridge", feature "gateway", dispatch path "bridge/compose", provider "compose"). attach the Feature at a boundary whose output path also receives its components, or give the boundary's components the directory the Feature's output is routed to

Khi có nhiều hơn một Feature vi phạm, các phát hiện đến cùng nhau dưới báo cáo boundary-level Features whose output is routed to a dispatch path nothing assembles.

Cách khắc phục: làm cho thư mục của Feature là thư mục mà các component của boundary cũng rơi vào. Hoặc gắn Feature tại một boundary có đường dẫn đầu ra riêng nhận các component đó, hoặc cấp cho các component thư mục mà đầu ra của Feature được định tuyến tới — đối với các boundary con, dùng directory: "{{ .parent_boundary.directory }}" mà không có subDirectory: riêng, để chúng dùng chung tệp của boundary cha. Thông báo nêu thư mục mà đầu ra của Feature được định tuyến tới, đó chính là thư mục cần dùng chung.

Path-template references a variable outside the allowlist (Path-template tham chiếu một biến nằm ngoài danh sách cho phép)

Một template directory: hoặc subDirectory: tham chiếu một tên biến mà danh sách cho phép biến của path-template không bao gồm — ví dụ, một lỗi gõ như {{ .parmaeters.region }}, hoặc một trường có trong ngữ cảnh render của Recipe nhưng không được cung cấp cho path template (chẳng hạn .context.inject hoặc .values). Cùng điểm dừng này cũng áp dụng cho {{ .component_id }} trong một template directory:: biến này tồn tại, và các template subDirectory: có thể đọc nó, nhưng directory: của một boundary được đánh giá một lần cho toàn bộ boundary chứ không phải một lần cho mỗi component, nên một biến theo từng component ở đó sẽ khiến đường dẫn được sinh ra phụ thuộc vào component nào tình cờ được đánh giá trước.

Path template được kiểm tra lúc phân tích cú pháp, trước khi bất kỳ công việc render nào bắt đầu, đối chiếu với các biến mà ngữ cảnh path-template định nghĩa trừ đi những biến mà bề mặt cụ thể từ chối. Trình biên dịch cũng đánh giá path template với ngữ nghĩa missingkey=error, nên một tham chiếu có trong danh sách cho phép nhưng chưa được định nghĩa lúc đánh giá sẽ tạo ra một lỗi rõ ràng thay vì âm thầm render một chuỗi rỗng vào đường dẫn thư mục.

Điểm dừng này liên quan đến biến. Một khóa gõ sai bên dưới một biến được cho phép — {{ .manifest.recipe_nmae }} — sẽ báo “Template references a root the render context does not define (Template tham chiếu một gốc mà ngữ cảnh render không định nghĩa)” ở trên thay vào đó, nêu các khóa mà .manifest có định nghĩa, vì bản thân biến đã được chấp nhận và chỉ có khóa là sai.

Thông báo được phát ra:

path template references a field not in the documented allowlist ("<dotted-path>", written in "<directory|subDirectory>", the render context defines "<the variables that field may read>") (path template tham chiếu một trường không có trong danh sách cho phép đã được ghi lại)

Cách khắc phục: sửa tên trường thành một tên có trong danh sách cho phép của path-template, hoặc xóa tham chiếu. Danh sách cho phép cho directory: là {{ .capability }}, {{ .boundary_name }}, {{ .parameters.X }}, {{ .manifest.recipe_name }} và {{ .parent_boundary.* }}; subDirectory: thêm {{ .component_id }}. Các bề mặt khác (valuesMapping của Recipe, injectMapping của FeatureRecipe, v.v.) dùng một dạng ngữ cảnh khác; các tham chiếu tới .context.*, .values, .infra hoặc .locals được chủ ý không cung cấp cho path template vì việc phát đường dẫn là mối quan tâm về cấu trúc, không phải mối quan tâm về render giá trị.

Path collision: two contributors emit at incompatible paths (Xung đột đường dẫn: hai bên đóng góp phát ra tại các đường dẫn không tương thích)

Hai boundary có khai báo đường dẫn được đánh giá ra cùng một đường dẫn lắp ráp lại đi qua các provider khác nhau. Cả hai đều lắp ráp ở đó, và mỗi bên ghi các tệp mà bên kia không hề biết, nên một bên âm thầm thay thế bên kia trên đĩa — và bản build tạo ra đầu ra bị thay thế trông như đã thành công.

subDirectory: mặc định cho mỗi provider một đường dẫn con riêng, nên hai provider chỉ gặp nhau tại một đường dẫn khi các khai báo được viết để cho ra cùng kết quả: chẳng hạn hai boundary dùng chung một directory: và cả hai đều cố định subDirectory: vào cùng một giá trị literal.

Các thông báo được phát ra. Mỗi boundary đóng góp được báo cáo một kết quả, nên mọi boundary có đầu ra đến đường dẫn đều được nêu tên riêng thay vì gộp vào một danh sách trong một thông báo. Lỗi là hai provider gặp nhau tại một đường dẫn, nên luôn có ít nhất hai kết quả, và chúng được đưa ra cùng nhau dưới một báo cáo nêu điểm chung của chúng:

assembly paths reached by more than one provider (các đường dẫn lắp ráp được nhiều hơn một provider đi tới)

Mỗi kết quả nêu đường dẫn, boundary có đầu ra đến đường dẫn đó, và provider mà boundary đó đi qua:

dispatch path produced multiple provider outputs ("<path>", boundary "<boundary>", provider "<provider>") (đường dẫn điều phối tạo ra nhiều đầu ra provider)

Một bản build có các boundary api-net và db-net cùng khai báo directory: ./dist/shared và subDirectory: merged, một đi qua helm và một đi qua compose, sẽ in ra:

[OPS_ERROR E0048]
assembly paths reached by more than one provider
caused by (2):
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "db-net", provider "compose")
---
[OPS_ERROR]
dispatch path produced multiple provider outputs ("dist/shared/merged", boundary "api-net", provider "helm")

Báo cáo mang mã ngắn và mỗi kết quả bên dưới chỉ mang hạng mục của nó, đó là dạng mà mọi báo cáo lỗi thu thập đều dùng — xem error-translation.md để biết ngữ pháp đó.

Cách khắc phục: hoặc cho mỗi boundary một directory: riêng (để chúng lắp ráp tại các đường dẫn tách biệt), hoặc để subDirectory: ở giá trị mặc định để đầu ra của mỗi provider nằm tại một đường dẫn con riêng. Mẫu compose-bridge chủ ý gộp hai boundary con vào một đường dẫn lắp ráp; mẫu đó đòi hỏi cả hai boundary nhắm tới cùng một provider và mang các annotation được phân giải theo tầng tương thích nhau.

A boundary’s output directory is not a directory beneath the output root (Thư mục đầu ra của một boundary không phải là một thư mục nằm dưới thư mục gốc đầu ra)

directory: và subDirectory: của một boundary được đánh giá và ghép lại thành thư mục mà đầu ra của nó được ghi vào, và đường dẫn đó được chuẩn hóa một lần: out/a, out//a, ./out/a và out/a/ là cùng một thư mục. Khi đường dẫn đã chuẩn hóa không phải là một thư mục nằm dưới thư mục gốc đầu ra, bản build dừng lại trước khi bất cứ thứ gì được ghi. Đó là một đường dẫn leo ra khỏi thư mục gốc đầu ra (.., ../escape, a/../..), một đường dẫn tuyệt đối (/srv/out), hoặc một đường dẫn không chỉ tới thư mục nào cả: một giá trị rỗng, hoặc một giá trị sau khi chuẩn hóa chính là thư mục gốc đầu ra, chẳng hạn directory: "." khi thư mục con bị tắt.

Đường dẫn được kiểm tra theo kết quả đánh giá, nên kết quả của template được xét chứ không phải văn bản được viết. Thông báo nêu tên trường gây ra lỗi — directory: khi riêng thư mục đó đã rời khỏi thư mục gốc đầu ra hoặc khi không có thư mục con nào được ghép vào, còn lại là subDirectory: — cùng với giá trị mà trường đó được đánh giá thành và đường dẫn nó tạo ra.

Thông báo được phát ra:

boundary output directory does not name a directory beneath the output root (Release "<release>", boundary "<boundary>", directory: "<value>", output path "<path>"). write a directory beneath the output root, such as “deploy/prod” — no leading ”/”, no ”..” climbing above it, and not the output root itself (thư mục đầu ra của boundary không chỉ tới một thư mục nằm dưới thư mục gốc đầu ra (Release "<release>", boundary "<boundary>", directory: "<value>", đường dẫn đầu ra "<path>"). hãy viết một thư mục nằm dưới thư mục gốc đầu ra, chẳng hạn “deploy/prod” — không có “/” ở đầu, không có “..” leo lên trên nó, và không phải chính thư mục gốc đầu ra)

Khi thư mục con gây ra lỗi, giá trị thứ ba sẽ là subDirectory: "<value>".

Cách khắc phục: viết trường mà thông báo nêu tên thành một thư mục nằm dưới thư mục gốc đầu ra. Một thư mục định đặt cạnh thư mục gốc đầu ra thì nên đặt vào bên trong nó. Để ghi đầu ra của một boundary trực tiếp vào directory: của nó, hãy đặt subDirectory: "." — bản thân thư mục vẫn phải chỉ tới một thư mục riêng.

A boundary-level Feature is named . or .. (Một Feature cấp boundary được đặt tên là . hoặc ..)

Một provider cấp cho mỗi bên đóng góp một thư mục riêng — terraform, dưới modules/, và helm-chart, dưới charts/ — đặt một Feature gắn tại boundary vào một thư mục chỉ mang tên của instance, bên cạnh các component của boundary. Khóa features: của boundary chấp nhận . và .., nhưng không cái nào là tên thư mục: . sẽ đặt các tệp của Feature vào thư mục chứa mọi bên đóng góp, còn .. vào thư mục phía trên nó, nên các tệp sẽ nằm ngoài vị trí mà provider dành cho Feature. Thay vào đó, bản build dừng lại. Mọi tên khác đều không bị ảnh hưởng, kể cả tên có dấu chấm như audit.v2.

Thông báo được phát ra:

boundary-level Feature instance name is not a directory name (Release "<release>", boundary "<boundary>", feature "<instance>"). rename the Feature instance under the boundary’s features to an ordinary name, such as “audit” (tên instance của Feature cấp boundary không phải là tên thư mục (Release "<release>", boundary "<boundary>", feature "<instance>"). hãy đổi tên instance của Feature dưới features của boundary thành một tên thông thường, chẳng hạn “audit”)

Cách khắc phục: đổi tên instance dưới features: của boundary thành một tên thông thường.

Instance-ID collision across boundaries assembling to the same path (Xung đột instance ID giữa các boundary lắp ráp vào cùng một đường dẫn)

Hai boundary lắp ráp vào cùng một bộ (đường dẫn, provider) đóng góp các component có instance ID giống hệt nhau. Bản lắp ráp đã hợp nhất không thể phân biệt hai mảnh component — một Helm chart duy nhất không thể chứa hai Deployment cùng tên web-server, và một tệp docker-compose duy nhất không thể chứa hai service cùng tên api.

Thông báo được phát ra:

multiple contributors share an instance ID at the same dispatch path: dispatch path "<path>" provider "<provider>" already contains node "<instance-id>" (contributing boundaries: [<boundaries>]); component instance IDs must be unique within an assembly group (nhiều bên đóng góp dùng chung một instance ID tại cùng một dispatch path: dispatch path của provider đã chứa node này (các boundary đóng góp được liệt kê); instance ID của component phải là duy nhất trong một nhóm lắp ráp)

Cách khắc phục: đổi tên một trong các component bị xung đột trong Aggregate, hoặc tách hai boundary sang các đường dẫn directory: riêng để mỗi instance component nằm trong bản lắp ráp riêng của nó.

Two contributors write the same output path (Hai bên đóng góp ghi vào cùng một đường dẫn đầu ra)

Hai bên đóng góp vào một bản lắp ráp tạo ra một tệp tại cùng một đường dẫn đầu ra. Điều này khác với xung đột instance ID ở trên: các component được đặt tên khác nhau và bản lắp ráp có thể phân biệt chúng — chính các tệp mà chúng phát ra mới rơi vào một đường dẫn. Điều này thường xảy ra nhất khi một provider ghi đầu ra của từng bên đóng góp cạnh nhau thay vì dưới một vị trí riêng cho từng component, nên hai component có Recipes phát ra cùng một tên tệp (chẳng hạn hai mục artifacts: cùng tên main.tf) gặp nhau tại một đường dẫn. Đầu ra riêng của bộ lắp ráp cũng có thể xung đột với tệp của một bên đóng góp theo cách tương tự.

Việc hai bên đóng góp phát ra cùng một tên tệp có xung đột hay không phụ thuộc vào nơi provider của chúng đặt chúng. Một provider lồng từng bên đóng góp dưới vị trí riêng trong bản lắp ráp sẽ giữ hai tệp cùng tên tách biệt; một provider ghi các bên đóng góp cạnh nhau thì không. Việc so sánh dựa trên đường dẫn cuối cùng mà tệp sẽ được ghi vào, chứ không dựa trên tên mà bên đóng góp phát ra, nên trường hợp lồng nhau không bị báo cáo.

Bản build dừng lại thay vì ghi một trong hai tệp và bỏ tệp còn lại. Không có cách giải quyết ngầm nào là đúng: đổi tên hoặc thêm hậu tố cho một tệp sẽ tạo ra một tên không ai viết, còn hợp nhất nội dung của chúng sẽ tạo ra một tài liệu không ai viết. Mọi đường dẫn xung đột đều được báo cáo, và mọi bên đóng góp ghi vào nó đều được nêu tên, nên một lần build cho bạn thấy toàn cảnh thay vì từng xung đột một.

Các thông báo được phát ra. Mỗi đường dẫn xung đột được báo cáo một phát hiện — một lần, bất kể có bao nhiêu boundary đã đưa vào bản lắp ráp nơi xung đột xảy ra — nên một bản build có các bên đóng góp gặp nhau trên hai đường dẫn sẽ báo cho bạn cả hai và không xung đột nào bị báo cáo hai lần:

assembled output collision: two contributors write the same output path (output path "<output-path>", written by "<contributor-1> and <contributor-2>", assembled within "<boundary-1> and <boundary-2>") (xung đột đầu ra đã lắp ráp: hai bên đóng góp ghi vào cùng một đường dẫn đầu ra (đường dẫn đầu ra, được ghi bởi hai bên đóng góp, được lắp ráp trong hai boundary))

Mỗi bên đóng góp được nêu tên theo đúng bản chất của nó, điều này cho biết tên của nó được viết ở đâu: component <name> cho một instance component, feature <name> cho một feature gắn vào boundary, và the <provider> assembly cho đầu ra hợp nhất riêng của bản lắp ráp. Các bên đóng góp được liệt kê theo thứ tự tên, nên câu thông báo giống nhau ở mọi lần build với cùng đầu vào.

Một tệp mà Recipe đóng góp vào đầu ra chung của boundary cũng tuân theo quy tắc này. Khối boundary: của một Recipe ghi các tệp của nó bên cạnh đầu ra đã lắp ráp riêng của provider, mỗi tên tệp một lần. Nhiều component khai báo cùng một tên với các byte giống hệt nhau là một tệp và không bao giờ xung đột; khai báo với các byte khác nhau sẽ xung đột ở đây, nêu tên tệp và mọi component đã khai báo nó, và một tên mà chính bản lắp ráp của provider ghi cũng vậy — chẳng hạn aggrega.modules.tf đối với terraform, khi đó the terraform assembly được nêu trong số các bên đóng góp. Một tệp mà nhiều component khai báo giống hệt nhau gặp tệp riêng của bản lắp ráp sẽ được nêu cùng tất cả các component đó, dưới dạng component <name-1> and component <name-2>.

Các boundary đã đưa vào bản lắp ráp cũng được nêu tên, và chúng được liệt kê thay vì chỉ ra một cái riêng. Các boundary có khai báo directory: được đánh giá giống nhau sẽ lắp ráp thành một, và không có gì trong một xung đột cho biết các bên đóng góp gặp nhau được khai báo trong boundary nào — nên phát hiện cho bạn mọi boundary mà khai báo của nó có thể tách chúng ra và không khẳng định boundary nào là nơi gây lỗi. Vì cùng lý do đó, phát hiện được báo cáo đối với toàn bộ tài liệu Release: nêu tên một boundary bên trong sẽ dẫn bạn tới một tài liệu có thể không đóng góp gì vào đường dẫn.

Khi có nhiều hơn một đường dẫn xung đột, các phát hiện được gửi cùng nhau dưới một báo cáo nêu điểm chung của chúng:

assembled output paths written by more than one contributor (các đường dẫn đầu ra đã lắp ráp được ghi bởi nhiều hơn một bên đóng góp)

Cách khắc phục: đổi tên tệp được phát ra trong Recipe mà bạn kiểm soát — một khóa artifacts:, một khóa của khối boundary:, hoặc tên tệp mà một bản dịch Workload suy ra — để hai tệp không còn gặp nhau. Khi hai Recipes khai báo một tệp chung và có cùng ý nghĩa cấu hình, hãy làm cho các khai báo của chúng giống hệt nhau từng byte. Khi hai bên đóng góp thực sự thuộc về các đầu ra riêng biệt, hãy cấp cho các boundary của chúng các đường dẫn directory: khác nhau để mỗi cái lắp ráp riêng.

The same name is derived more than once inside the output (Cùng một tên được suy ra nhiều lần bên trong đầu ra)

Một bản lắp ráp cuối cùng có cùng một tên được dùng hai lần cho một thứ bên trong các tệp mà nó phát ra, ở chỗ chỉ có chỗ cho một. Điều này xảy ra theo hai cách: hai bên đóng góp suy ra cùng một tên, hoặc đầu ra riêng của một bên đóng góp duy nhất chứa tên đó hai lần. Điều này khác với hai loại xung đột ở trên: khi có hai bên đóng góp, các component được đặt tên khác nhau và các tệp của chúng nằm ở các đường dẫn khác nhau, nên không có gì sai về hình dạng của bản lắp ráp — đó là một tên trong nội dung, chẳng hạn định danh mà một target dùng để tham chiếu một tài nguyên, hoặc tên mà một đầu ra được công bố dưới đó để một bên khác tham chiếu.

Những tên nào được so sánh phụ thuộc vào việc provider làm gì với đầu ra của một bản lắp ráp. Khi provider hợp nhất đầu ra đó thành một tài liệu duy nhất — một stack template, một tệp compose — các tên bên trong tài liệu đó được so sánh với nhau, và một bên đóng góp có đầu ra được ghi thành các tệp riêng thì nằm ngoài tài liệu đó. Các tên của nó không gặp tên của ai khác, nên không có gì dừng lại giữa chúng, và không có gì bạn đổi tên có thể thay đổi điều đó. Khi provider thay vào đó ghi đầu ra của từng bên đóng góp thành các tệp riêng — một bản render chart, một tập manifest — mọi bên đóng góp vào bản lắp ráp được so sánh với mọi bên khác, vì một tên trong đầu ra như vậy là duy nhất trên toàn bộ những gì đọc các tệp đó như một tập, chứ không phải trong một tệp riêng lẻ.

Các tài nguyên riêng của một FeatureRecipe đi theo cùng đường với các tài nguyên của component chủ của nó, vì một attachment đóng góp vào bản lắp ráp mà component chủ thuộc về. Vì vậy, khi provider hợp nhất, các tên của một attachment được so sánh với các tên của component chủ và với các tên của mọi attachment khác, đúng như tên của hai component: tất cả đều nằm trong cùng một tài liệu, và một trong hai tên bằng nhau sẽ thay thế tên kia ở đó. Khi provider không hợp nhất, các tài nguyên của attachment được ghi dưới một thư mục mang tên component mà nó được gắn vào, và các tên của nó vẫn được so sánh với mọi bên đóng góp vào bản lắp ráp — đó là nơi một định danh tài nguyên phải là duy nhất trên toàn cluster được phát hiện. Do đó việc so sánh là như nhau ở cả hai trường hợp, và điều khác biệt chỉ là nơi mà tên lẽ ra bị thay thế sẽ nằm.

Một nửa của điểm dừng này không bị ảnh hưởng bởi tất cả những điều trên: đầu ra riêng của một bên đóng góp duy nhất chứa một tên hai lần. Đó là một tên được dùng hai lần bên trong đầu ra mà một bên đóng góp đã ghi, nên nó dừng build ở bất cứ nơi nào đầu ra đó được ghi, và hai thứ cần tách ra luôn nằm bên trong nó.

Hầu hết các tên như vậy là của riêng provider, được suy ra từ instance component và tài nguyên, nên hai component có thể đi tới cùng một tên bất cứ khi nào các thành phần dùng để suy ra chúng trùng nhau — và một component có thể đi tới một tên hai lần theo cùng cách, khi hai tài nguyên riêng của nó được tạo từ các thành phần trùng nhau. Vì tên nằm trong chính các byte của tệp, bản lắp ráp không thể thấy nó: provider báo cáo các tên mà nó suy ra, và bản build so sánh chúng.

Có một loại tên là của riêng bản build chứ không phải của provider, và nó được báo cáo theo cùng cách: định danh mà mọi tài nguyên do một FeatureRecipe phát ra được gắn nhãn, xuất hiện trong đầu ra của bạn dưới dạng nhãn aggrega.ai/component-id. Nó được báo cáo dưới loại tên component-id, để bạn có thể tìm cùng chuỗi đó trong đầu ra đã phát ra của mình. Khi một FeatureRecipe tổng hợp các tài nguyên của nó, định danh đó cũng là thứ mà chúng được đặt tên theo; khi nó render một chart hoặc một fragment do tác giả cung cấp, các tên bên trong bản render đó vẫn là của component chủ và chỉ các nhãn mang định danh.

Đối với một feature gắn vào một component, định danh được ghép từ component mà feature được gắn vào và khóa bạn viết dưới features:, sau một phần mở đầu cố định. Component chủ là một phần của giá trị vì một tên feature gắn vào nhiều component sẽ phát ra một tập tài nguyên riêng trên mỗi component, và mỗi tập cần một định danh riêng.

Đối với một feature gắn vào một boundary, định danh được ghép từ tên của feature và từng đoạn của đường dẫn boundary, sau một phần mở đầu riêng. Cả hai nơi đều ghép chứ không thay thế: một ký tự mà bảng chữ cái của nhãn từ chối được viết ra thay vì bị thay thế, và các phần được nối bằng một chuỗi mà không phần được viết nào có thể chứa, nên hai attachment mà bạn phân biệt được luôn đi tới hai định danh. Phần dư duy nhất là độ dài: một định danh đã ghép quá dài cho giá trị nhãn sẽ được rút gọn quanh một digest của toàn bộ nó, và về nguyên tắc hai định danh đã rút gọn có thể trùng nhau. Điểm dừng này báo cáo sự trùng nhau như vậy giữa hai bên đóng góp có tên được so sánh, và hai attachment trên một component là hai bên đóng góp như vậy ở bất cứ nơi nào provider của component chủ lắp ráp chúng cùng nhau. Xem ../providers/well-known-annotations.md để biết cách mỗi định danh được tạo.

Một bản render Kubernetes báo cáo một loại tên riêng: tên mà mỗi tài nguyên do chính bản render đó tạo ra mang trong metadata.name. Một tên như vậy phải là duy nhất trong kind của nó — và, đối với một kind mà cluster giữ trong namespace, trong namespace của nó — chứ không phải trên toàn bộ đầu ra, nên loại tên cho biết nó được giới hạn trong phạm vi nào. Nó mở đầu bằng resource-names rồi mang kind của tài nguyên và namespace mà tài nguyên rơi vào, tức là namespace mà tài nguyên tự nêu hoặc, khi nó không nêu, namespace mà boundary được chú thích. Vì vậy resource-names:Service--default là các tên của các Service rơi vào default. Một kind mà Kubernetes API giữ ngoài mọi namespace — một ClusterRole, một StorageClass, một CustomResourceDefinition — và một kind tùy chỉnh mà một CustomResourceDefinition trong cùng bản render khai báo với phạm vi Cluster, chỉ mang kind của nó, bất kể tài liệu của nó ghi namespace nào: resource-names:ClusterRole là các tên của mọi ClusterRole mà đầu ra chứa. Mọi thứ ngoài chữ cái và chữ số được viết ra thay vì bị thay thế và hai phần được nối bằng một chuỗi mà không phần được viết nào có thể chứa, nên hai cặp khác nhau không bao giờ đi tới cùng một loại tên, và một kind riêng lẻ không bao giờ đi tới loại tên của một kind và một namespace. Một Service và một Deployment có thể dùng chung một tên, và hai namespace giữ một tên của kind có namespace một cách độc lập, nên không trường hợp nào trong đó dừng build. Bản thân tên được báo cáo đúng như chart của bạn đã viết, nên đó là chuỗi để tìm trong các template của bạn.

Vì vậy hai bên đóng góp vào một đầu ra mà mỗi bên ghi một đối tượng toàn cluster dưới cùng một tên sẽ dừng build ngay cả khi Release đặt chúng vào hai namespace, vì áp dụng cả hai sẽ ghi đối tượng đó hai lần; và một chart ghi một đối tượng như vậy dưới hai namespace khác nhau, mà bản render phát ra thành hai tệp, sẽ dừng build như một bên đóng góp duy nhất chứa tên đó hai lần. Một kind mà không gì trong bản render phân loại — một kind tùy chỉnh có CustomResourceDefinition không được bản render phát ra, hoặc một tài liệu không nêu apiVersion — được so sánh trong namespace của nó, như một kind có namespace, vì không gì trong bản render cho biết cluster giữ nó ngoài namespace; do đó hai bên đóng góp ghi một đối tượng như vậy trong hai namespace không gặp nhau.

Các tên được so sánh giữa các bên đóng góp vào một đầu ra, và không bao giờ giữa hai đầu ra. Hai boundary là hai đầu ra khi mỗi boundary có một thư mục riêng — thư mục nó nêu, hoặc thư mục được cấp cho mỗi boundary không nêu directory: — và không gì trong một bản build cho biết hai đầu ra được áp dụng cho một cluster hay hai: CustomResourceDefinition của một operator được gửi tới mỗi cluster trong hai cluster là cùng một tên trong hai đầu ra, và điều đó là đúng. Vì vậy hai boundary mà mỗi cái ghi một đối tượng toàn cluster dưới cùng một tên vẫn build được ngay cả khi cả hai được áp dụng cho một cluster; khi đúng như vậy, hãy chỉ phát ra đối tượng đó từ một trong hai.

Cách sắp xếp thường dẫn đến lần dừng này nhất là hai Features được gắn vào một component, mỗi Feature cung cấp một chart do tác giả của nó cung cấp. Cả hai chart đều render theo cùng một tên release — tên của component chủ, để việc gắn một chart không đổi tên các tài nguyên mà tác giả của nó đã khai báo và triển khai — và đặt tên một tài nguyên theo tên release là một trong những việc phổ biến nhất mà một chart làm. Hình dạng của đầu ra không có gì sai: hai tài nguyên chỉ đơn giản mang cùng một tên. Khi provider của component ghi các tài liệu riêng biệt, mỗi attachment ghi vào một thư mục riêng và việc áp dụng cả hai chỉ để lại cái nào được áp dụng sau cùng; khi nó gộp nhóm của mình vào một tài liệu, cả hai attachment đều đóng góp vào tài liệu đó và một trong hai tên thay thế tên còn lại bên trong nó. Hãy đổi tên tài nguyên trong chart mà bạn kiểm soát, hoặc đặt cho nó một tên mang thông tin phân biệt hai attachment — và chính attachment phải đến được template, vì cả hai chart đều render theo tên release của component chủ, nên chỉ đổi tên attachment thì không thay đổi gì. Truyền .attachment_name vào chart thông qua valuesMapping: của FeatureRecipe, và đặt nó vào bất kỳ giá trị nào của chính chart mà tên tài nguyên được xây dựng từ đó.

Cách sắp xếp thứ hai dẫn đến cùng lần dừng này với một Feature thay vì hai: một chart có template ghi tên tài nguyên dưới dạng một giá trị cố định, được gắn vào hai component. Mỗi component chủ render nó dưới một tên release riêng, nên giá trị cố định là lý do duy nhất khiến hai bản sao mang cùng một tên — hãy đặt tên tài nguyên theo .Release.Name và component chủ lại có mặt trong tên, đó là điều mà một chart xây dựng tên tài nguyên từ danh tính release của nó vốn đã làm.

Cách sắp xếp thứ ba có cùng hình dạng nhưng ở sâu hơn một bề mặt soạn thảo: một FeatureRecipe cung cấp tài nguyên của nó qua artifacts: thay vì qua một chart, được gắn dưới một tên vào hai component, và phần thân của nó ghi tên tài nguyên dưới dạng một giá trị cố định. Đầu ra của mỗi attachment nằm trong một thư mục mang tên component chủ của nó, nên các đường dẫn được phát ra khác nhau và hình dạng của đầu ra không có gì sai — nhưng cả hai phần thân đều mang cùng một tên, và việc áp dụng cả hai chỉ để lại cái nào được áp dụng sau cùng. Một tên trong phần thân artifacts được so sánh đúng như một tên mà chart đã render: cả hai mô tả cùng một tài nguyên trong cùng một cluster, nên tên đến từ đâu không tạo ra khác biệt nào cho điều xảy ra khi cả hai được áp dụng. Cách hiểu đó dựa trên việc hai tên được đọc cùng nhau, điều xảy ra khi một provider ghi đầu ra của mỗi bên đóng góp thành các tệp mà một đích đọc như một tập hợp. Khi provider thay vào đó gộp đầu ra của một assembly vào một tài liệu duy nhất, các tệp của mỗi attachment nằm ngoài tài liệu đó và một tên bên trong một tệp chỉ có phạm vi trong tệp ấy, nên hai attachment như vậy không bao giờ gặp nhau và bản build tiếp tục.

Không phải mọi tên đều được báo cáo, nên một bản build không dừng chưa xác lập rằng mọi tên mà đầu ra của nó rốt cuộc sẽ mang đã được so sánh. Một tài nguyên để cluster đặt tên — tài nguyên khai báo generateName thay vì name — chưa mang tên nào, nên không có tên để báo cáo. Và một tên được ghi vào một trường khác để một controller đọc sau thì không phải là tên tài nguyên, nên không có gì so sánh nó. Cả hai giới hạn đều là đặc tính của việc đọc tài liệu được phát ra, nên cả hai áp dụng cho phần thân artifacts đúng như chúng áp dụng cho một template chart được render.

Phần thân artifacts: là một template, nên một tên trong đó cần khác biệt theo từng component chủ được ghép lại thay vì ghi dưới dạng giá trị cố định. .context.rendered_name là tên mà chính provider của component chủ đặt cho nó — với helm, là tên release của nó, được viết bằng các ký tự mà một tên Kubernetes cho phép — và .attachment_name là khóa mà bạn đã gắn nó dưới đó, nên {{ .context.rendered_name }}-{{ .attachment_name }} cho một tài nguyên một tên riêng trên mọi component chủ và dưới mọi attachment. Trên một component chủ mà provider không báo cáo tên như vậy, hãy ghép tên từ .context.instance_id, danh tính của component chủ, thay thế. Một phần thân được soạn đến mỗi component chủ mà nó được gắn vào mang theo bất kỳ tên nào có trong nó, và một giá trị cố định thì giống nhau trên tất cả — vì vậy hãy đặt cho tên cần là duy nhất trong cluster hình dạng đó.

Ý nghĩa của một tên không hề được diễn giải — hai tên được báo cáo hoặc là cùng một văn bản hoặc không — đó là lý do cùng một báo cáo bao quát mọi loại tên, bất kể ai đã suy ra nó.

Một tên có thể xuất hiện trong nhiều báo cáo cho một component, vì mỗi phần của một component được báo cáo khi nó được render. Đó là một tài nguyên được nêu tên trong mỗi báo cáo mà nó thuộc về, không phải một tên được dùng hai lần, và nó không dừng. Điều gây dừng là một báo cáo duy nhất mang một tên hai lần, vì báo cáo đó mô tả đầu ra nơi tên thực sự được dùng hai lần.

Cách hiểu đó phụ thuộc vào điều gì được tính là một bên đóng góp, và với loại component-id câu trả lời là attachment chứ không phải component hay boundary mà nó nằm trên. Một attachment được xác định bởi cả hai tọa độ bạn đã viết cho nó — component mà nó được gắn vào cùng với khóa dưới features:, hoặc đường dẫn boundary cùng với tên tại boundary đó — nên hai attachment trên một component là hai bên đóng góp, đúng như hai attachment trên các component khác nhau, và một tên feature được viết tại hai boundary là hai bên đóng góp dù tên ở mỗi nơi là như nhau. Việc là hai bên đóng góp là điều khiến danh tính của chúng có thể so sánh được trong mỗi cách sắp xếp đó; còn việc hai bên có được so sánh hay không thì tuân theo cùng quy tắc như mọi tên khác ở đây, nên khi provider gộp, một attachment có đầu ra được ghi thành các tệp riêng nằm ngoài tài liệu được gộp và chỉ được so sánh với chính nó. Do đó hai attachment đạt cùng một danh tính sẽ dừng ở bất cứ nơi nào đầu ra của chúng có thể gặp nhau, và mỗi phát hiện nêu cả hai tọa độ của nó để bạn biết hai thứ nào cần tách ra. Vì cả hai tọa độ đều là một phần của giá trị được ghép, hai attachment mà bạn phân biệt được sẽ đạt hai danh tính ở bất kỳ độ dài nào vừa vặn — nên cách sắp xếp dẫn đến lần dừng này là khi một giá trị quá dài so với đích của nó bị rút ngắn và hai giá trị bị rút ngắn gặp nhau. Khi hai danh tính bị rút ngắn gặp nhau mà đầu ra của chúng không thể gặp nhau — hai attachment trên một component, dưới một provider có gộp, mỗi cái được ghi thành các tệp riêng — thì không có gì so sánh chúng, và hai tập tài nguyên mang chung một aggrega.ai/component-id.

Có một cách sắp xếp đáng nói rõ vì nó trông như phải dừng nhưng lại không: gắn một feature dưới cùng một tên trên hai component được hỗ trợ hoàn toàn, và không cần đổi tên. Component là một phần của giá trị được ghép, nên metrics trên api và metrics trên web đạt hai danh tính và tài nguyên của mỗi component có danh tính riêng — điều này quan trọng vì một cascade tạo một tên attachment trên nhiều component theo thiết kế sẽ không để lại cho tác giả tên nào khác để viết. Mọi cách mà một FeatureRecipe cung cấp tài nguyên đều đặt danh tính của nó lên những gì nó phát ra, kể cả cách chỉ vendor một nguồn và render nguyên trạng, nên mọi cách đều được so sánh; một feature có FeatureRecipe không phát ra gì thì không có gì để so sánh.

Bản build dừng thay vì giữ một cái và bỏ cái kia. Không có cách giải quyết ngầm nào là đúng: giữ cái đầu tiên sẽ loại hoàn toàn một tài nguyên bạn đã khai báo khỏi đầu ra và để bản build báo thành công, và bất cứ thứ gì tham chiếu đến cái bị loại sẽ lặng lẽ phân giải sang cái còn lại. Mọi tên xung đột đều được báo cáo, mỗi tên kèm loại tên của nó và nêu tên mọi bên đóng góp đã suy ra nó — nên một bản build cho bạn biết toàn bộ bức tranh thay vì từng xung đột một. Một bên đóng góp có đầu ra của chính nó mang tên hai lần được nêu là đã suy ra tên nhiều hơn một lần, điều này cho bạn biết hai thứ cần tách ra nằm bên trong một component đó chứ không phải giữa hai component.

Thông báo được phát ra. Mỗi contributor ứng với mỗi tên xung đột được báo cáo bằng một phát hiện, nên mỗi contributor đã suy ra tên đó được nêu riêng thay vì gộp vào một danh sách trong một thông báo. Khi hai contributor cùng suy ra tên đó thì có ít nhất hai phát hiện, và chúng đến cùng nhau dưới một báo cáo nêu điểm chung của chúng:

dispatch groups whose contributors derive one name more than once in one key space (các nhóm phân phối có contributor suy ra một tên nhiều hơn một lần trong một không gian khóa)

Mỗi phát hiện nêu tên đó, loại tên, contributor đã suy ra nó, cùng provider và đường dẫn của bản lắp ráp mà đầu ra của chúng được hợp nhất vào:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<contributor>", provider "<provider>", dispatch path "<path>") (xung đột tên được suy ra: một tên được suy ra nhiều hơn một lần trong một không gian khóa)

Contributor được nêu theo đúng loại của nó, và chính điều đó cho biết tên của nó được viết ở đâu: derived by component cho một instance của component, và derived by feature cho một feature gắn vào một boundary.

Khi tên riêng của contributor không tự nhận diện được nó, một tọa độ thứ hai sẽ theo sau, và đó là tọa độ nào tùy thuộc vào loại. Một feature gắn vào một boundary mang đường dẫn của boundary, vì một tên feature có thể được viết ở nhiều boundary:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by feature "<feature-name>", attached at boundary "<boundary-path>", provider "<provider>", dispatch path "<path>") (xung đột tên được suy ra: một tên được suy ra nhiều hơn một lần trong một không gian khóa)

Một component mang khóa của attachment mà quá trình render của nó đã suy ra tên đó, vì một component mang một attachment cho mỗi khóa bạn đã viết:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived by component "<component>", carrying attachment "<attachment-key>", provider "<provider>", dispatch path "<path>") (xung đột tên được suy ra: một tên được suy ra nhiều hơn một lần trong một không gian khóa)

Phần render riêng của một component — một tên mà provider của nó suy ra cho chính component đó chứ không cho một trong các attachment của nó — không mang tọa độ thứ hai, nên phát hiện kết thúc ở tên của component.

Khi đầu ra riêng của một contributor duy nhất mang tên đó hai lần, contributor đó là phát hiện duy nhất, nên nó đến riêng lẻ mà không có báo cáo nào phía trên — và nó được nêu là đã suy ra tên đó nhiều hơn một lần, chứ không phải là đã gặp một contributor khác:

derived name collision: one name is derived more than once in one key space ("<name>", key space "<kind-of-name>", derived more than once by component "<contributor>", provider "<provider>", dispatch path "<path>") (xung đột tên được suy ra: một tên được suy ra nhiều hơn một lần trong một không gian khóa)

Ở đây tọa độ thứ hai theo sau contributor theo cùng điều kiện như trên, nên một lần lặp bên trong đầu ra riêng của một attachment sẽ nêu attachment đó chứ không chỉ nêu component mang nó.

Cách khắc phục: khi hai contributor được nêu, hãy đổi tên một trong hai trong Aggregate, để các tên suy ra từ nó không còn trùng với tên của cái kia. Khi loại tên là component-id, mỗi phát hiện đã nêu sẵn thứ cần đổi tên: carrying attachment "…" là khóa trong khối features: của component đó, còn một feature "…" attached at boundary "…" là tên trong khối features: của boundary đó. Khi hai phát hiện chỉ khác nhau ở boundary mà chúng nêu, hai attachment mang cùng một tên tại hai boundary — hãy đổi tên một trong hai, hoặc cho hai boundary các đường dẫn directory: khác nhau để đầu ra của chúng không còn hợp nhất. Khi hai tên là những tên do bản build ghép thành, chúng chỉ có thể gặp nhau sau khi bị rút ngắn cho vừa đích, nên hãy tự rút ngắn các phần ghép thành chúng thay vì để bản build làm việc đó. Khi cả hai tên đều được suy ra từ thứ bạn đặt tường minh — một giá trị mà Recipe truyền cho provider, hoặc một annotation mà provider đọc — hãy thay đổi thứ đó ở cái nào trong hai cái mà bạn kiểm soát. Khi hai contributor thực sự thuộc về các đầu ra riêng biệt, hãy cho các boundary của chúng các đường dẫn directory: khác nhau để mỗi cái được lắp ráp riêng và hai tên không bao giờ gặp nhau. Khi một contributor duy nhất được nêu là đã suy ra tên đó nhiều hơn một lần, hai thứ xung đột đều nằm bên trong component đó: hãy tìm hai resource mà Recipe của nó tạo ra có tên trùng nhau, và thay đổi thứ mà một trong hai được đặt tên theo — khóa mà nó được khai báo dưới đó, hoặc một giá trị mà nó được dựng từ đó — để provider suy ra một tên riêng cho mỗi cái. Khi loại tên là một kind có phạm vi cluster tự thân, chẳng hạn resource-names:ClusterRole, các tài liệu được nêu mô tả cùng một đối tượng trong cluster dù chúng được đặt vào namespace nào: hãy chỉ phát ra nó từ một contributor — thông qua một giá trị mà chart của nó cung cấp, chẳng hạn một công tắc cài đặt các định nghĩa của nó — hoặc, khi hai cái được dự định là hai đối tượng, hãy cho một trong hai một tên riêng trong chart hoặc body mà bạn kiểm soát; một contributor duy nhất được nêu hai lần cho nó thì viết nó dưới hai namespace, và một trong hai tài liệu là cái cần bỏ đi.

An authored export name is one the build derives for a cross-stack reference (Tên export do bạn viết trùng với tên mà bản build suy ra cho một tham chiếu liên stack)

Khối Outputs: của một Recipe cloudformation là CloudFormation do bạn viết, và một mục trong đó có thể mang Export: riêng với một Name:; tên đó đến stack đã lắp ráp đúng như đã viết. Riêng biệt với điều đó, khi một cạnh uses đi từ một boundary sang boundary khác, provider công bố giá trị được tiêu thụ dưới dạng một Output của stack với một Export dưới một tên mà nó suy ra từ release, boundary, component và khóa được cung cấp. Lỗi dừng này xảy ra khi hai thứ đó gặp nhau: tên bạn viết chính là tên mà phép suy ra tạo ra cho cùng bản build, nên stack sẽ khai báo một tên export hai lần từ hai nơi, trong khi tên export phải là duy nhất.

Chỉ sự trùng hợp mới gây dừng. Việc khai báo tên export trên một mục Outputs được hỗ trợ, và một tên không trùng với tên suy ra nào sẽ được công bố cùng với các tên suy ra mà không có cảnh báo — trên mọi mục, trừ output của stack mà một tham chiếu liên stack dùng để công bố export của chính nó, cho một khóa mà nó tiêu thụ. Một Export: ở đó sẽ gây dừng trừ khi nó mang đúng tên suy ra; trường hợp đó là The output a cross-stack reference publishes on already carries an Export (Output mà một tham chiếu liên stack công bố lên đã mang một Export).

Lỗi dừng đưa ra tên export suy ra cùng với bốn phần dùng để tạo nó, để bạn thấy tham chiếu liên boundary nào đã tạo ra nó, và nêu tên output của stack mà khai báo của bạn nằm dưới — được đánh dấu là một tên do provider lắp ráp chứ không phải tên do một Recipe viết, vì provider tạo tên đó bằng cách mã hóa component và mục thành các chữ cái và chữ số mà một logical ID cho phép, nên nó không phải chuỗi mà component hay mục được viết. Tên export là phần cần tìm kiếm. Mục của bạn viết nó đúng như lỗi dừng viết, đó là điều khiến hai thứ xung đột, nên nó là chuỗi duy nhất xuất hiện cả trong thông báo lẫn trong các tệp của bạn.

Việc so sánh được giới hạn trong một stack: các tên export mà stack đó khai báo, so với các tên được suy ra cho những tham chiếu liên boundary công bố vào nó. Hai stack không được so sánh với nhau, và một tên export được viết dưới dạng intrinsic của CloudFormation sẽ được phân giải lúc triển khai, nên không có tên nào để so sánh. Việc một tên gặp gì trong số các export đã được triển khai vào một account và region là thuộc tính của việc triển khai, điều mà bản build không quan sát được.

Thông báo được phát ra. Điều kiện nêu loại lỗi và câu của chính provider cho biết điều gì đã xảy ra; báo cáo bao quanh cũng nêu cạnh uses đang được nối:

two things a plugin produced occupy one name in its output (hai thứ do một plugin tạo ra chiếm cùng một tên trong output của nó) cloudformation-provider: an export name a cross-boundary link derives is already declared by another Outputs entry in the same stack: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and another Outputs entry of the same stack already declares that same export name — that declaration sits under the stack output <stack-output>, a name this provider assembles rather than one a Recipe wrote; each shadowing Outputs entry spells its export name exactly as the halt does, so searching your Recipes for that name reaches the entry — rename the export name the entry declares, or remove that entry’s Export block and let the link publish the export (tên export mà một liên kết liên boundary suy ra đã được một mục Outputs khác trong cùng stack khai báo: liên kết suy ra tên export cho khóa provides của component trong boundary của Release, và một mục Outputs khác của cùng stack đã khai báo cùng tên export đó — khai báo đó nằm dưới output của stack, một tên do provider này lắp ráp chứ không phải do một Recipe viết; mỗi mục Outputs che khuất viết tên export của nó đúng như lỗi dừng viết, nên tìm tên đó trong các Recipes của bạn sẽ dẫn đến mục đó — hãy đổi tên export mà mục khai báo, hoặc xóa khối Export của mục đó và để liên kết công bố export)

Cách khắc phục: tìm trong các Recipes của bạn tên export mà lỗi dừng nêu — mục Outputs khai báo nó viết y hệt — rồi hoặc đổi tên export đó để nó không còn trùng, hoặc xóa khối Export: của mục đó và để phần nối liên stack tự công bố export. Xóa thường là cách đúng khi mục đó tồn tại để export chính giá trị mà cạnh tiêu thụ: provider vẫn công bố một Export cho giá trị đó, nên cái do bạn viết không thêm gì. Hãy giữ Export: do bạn viết và đổi tên nó khi mục đó export giá trị cho một bên tiêu thụ khác import nó dưới một tên bạn chọn.

The output a cross-stack reference publishes on already carries an Export (Output mà một tham chiếu liên stack công bố lên đã mang một Export)

Khi một cạnh uses đi từ một boundary sang boundary khác, provider công bố Export của giá trị được tiêu thụ trên output của stack mà nó lắp ráp cho component cung cấp và khóa được cung cấp — chính output mà một Recipe cloudformation đạt tới khi khối Outputs: của nó viết một mục dưới khóa đó. Một Export: đã có ở output đó chỉ được giữ khi Name: của nó đúng là tên provider suy ra: đó là export mà một tham chiếu liên stack trước đó vào cùng giá trị đã công bố, nên mọi bên tiêu thụ import cùng một tên. Bất kỳ Export: nào khác ở đó đều gây dừng, vì ghi export của provider sẽ ghi đè lên những gì bạn viết, còn giữ cái của bạn sẽ khiến mọi bên tiêu thụ import một tên mà tham chiếu chưa bao giờ công bố.

Lỗi dừng xảy ra với bốn dạng Export: tại output đó:

  • một Name: là một chuỗi khác;
  • một Name: được viết dưới dạng intrinsic của CloudFormation, được phân giải lúc triển khai, nên provider không thể đọc nội dung của nó;
  • một khối Export: không nêu tên nào;
  • một Export: được viết dưới dạng giá trị đơn thay vì một khối.

Một tên export bạn khai báo trên bất kỳ mục Outputs nào khác được so sánh riêng, trong An authored export name is one the build derives for a cross-stack reference (Tên export do bạn viết trùng với tên mà bản build suy ra cho một tham chiếu liên stack).

Thông báo được phát ra. Điều kiện nêu loại lỗi và câu của chính provider cho biết điều gì đã xảy ra; báo cáo bao quanh cũng nêu cạnh uses đang được nối:

two things a plugin produced occupy one name in its output (hai thứ do một plugin tạo ra chiếm cùng một tên trong output của nó) cloudformation-provider: the stack output a cross-boundary link publishes its export on already carries an Export the link did not write: the link derives the export name <export-name> for provides key <provides-key> of component <component> in boundary <boundary> of Release <release>, and the stack output this provider assembles for that key and component <what-it-found>; remove that entry’s Export block and let the link publish the export every consumer imports (output của stack mà một liên kết liên boundary công bố export lên đã mang một Export mà liên kết không viết: liên kết suy ra tên export cho khóa provides của component trong boundary của Release, và output của stack mà provider này lắp ráp cho khóa và component đó; hãy xóa khối Export của mục đó và để liên kết công bố export mà mọi bên tiêu thụ import)

<what-it-found> là một trong các nội dung sau, theo thứ tự các dạng ở trên:

already declares the export name <name> (đã khai báo tên export) already declares an export name that is not a string — one given as an intrinsic, which resolves at deploy time, so this provider cannot read what it spells (đã khai báo một tên export không phải chuỗi — một tên được cho dưới dạng intrinsic, được phân giải lúc triển khai, nên provider này không thể đọc nội dung của nó) already carries an Export block declaring no export name (đã mang một khối Export không khai báo tên export nào) already carries an Export that is not a block, where CloudFormation expects one carrying a Name (đã mang một Export không phải khối, trong khi CloudFormation yêu cầu một khối mang Name)

Cách khắc phục: trong Recipe của component mà lỗi dừng nêu, tìm mục Outputs được viết dưới khóa được cung cấp mà nó nêu, và xóa khối Export: của mục đó — khi đó phần nối liên stack sẽ công bố export mà mọi bên tiêu thụ import. Nếu bạn cũng cần export giá trị dưới một tên của riêng mình, cho một bên tiêu thụ bên ngoài bản build này, hãy viết Export: đó trên một mục Outputs dưới một khóa khác: tên export ở đó được hỗ trợ, miễn là nó không phải tên mà bản build suy ra.

Chart-name mismatch on a merged helm-chart umbrella (Tên chart không khớp trên một umbrella helm-chart được hợp nhất)

Hai hoặc nhiều boundary cùng đóng góp vào một đường dẫn lắp ráp của provider helm-chart nhưng các annotation aggrega.ai/chart-name có hiệu lực của chúng (được phân giải qua cơ chế cascade annotation của boundary) không thống nhất. Một umbrella chart của Helm có đúng một tên chart; bộ render không thể chọn một trong các ứng viên xung đột.

Các thông báo được phát ra. Mỗi boundary đóng góp được báo cáo bằng một phát hiện, mỗi phát hiện mang giá trị mà boundary đó phân giải ra, nên các tên không thống nhất xuất hiện mỗi tên trong một phát hiện thay vì trong một tập hợp được in ra. Báo cáo chứa chúng nêu điểm chung của chúng:

merged dispatch groups whose boundaries disagree on the assembly name (các nhóm dispatch được hợp nhất có các boundary không thống nhất về tên lắp ráp)

Mỗi phát hiện nêu giá trị mà boundary đó phân giải ra, annotation mà giá trị được đọc từ đó, boundary, provider và đường dẫn mà chúng hợp nhất vào:

merged-path assembly has conflicting assembly-name annotation values ("<value>", annotation "<annotation>", boundary "<boundary>", provider "<provider>", dispatch path "<path>") (việc lắp ráp trên đường dẫn hợp nhất có các giá trị annotation tên lắp ráp xung đột)

Cách khắc phục: khai báo một annotation aggrega.ai/chart-name khớp nhau trên mọi boundary đóng góp (cơ chế cascade giúp tránh lặp lại khi các boundary đóng góp có chung một boundary cha — chỉ cần khai báo một lần trên boundary cha), hoặc tách các boundary sang các đường dẫn directory: riêng để mỗi boundary có umbrella chart riêng.

FeatureRecipe template references a field outside its scope’s allowlist (Template của FeatureRecipe tham chiếu một trường nằm ngoài danh sách cho phép của phạm vi)

Một FeatureRecipe có executionScope: boundary tham chiếu một trường chỉ dành cho từng component như .context.instance_id, .context.inject hoặc .context.uses — những trường không có giá trị ý nghĩa ở phạm vi boundary — trong một template chạy một lần cho boundary: locals:, provides:, valuesMapping:, artifacts: của nó, hoặc with: hay when: của một bước pipeline. Điều kiện ngược lại cũng đúng: một FeatureRecipe phạm vi component (mặc định) tham chiếu các trường .boundary.* cũng bị cùng trình kiểm tra từ chối. Việc kiểm tra chạy lúc phân tích cú pháp, dựa trên danh sách trường cho phép của phạm vi tương ứng, trước khi bắt đầu bất kỳ công việc render nào. injectMapping của một FeatureRecipe phạm vi boundary không được kiểm tra ở đây: nó chạy một lần cho mỗi component mà attachment đến được, trong ngữ cảnh của component đó, nên nó đọc .context.*, và một tham chiếu tới .boundary trong đó được báo cáo bởi “Template references a root the render context does not define (Template tham chiếu một root mà render context không định nghĩa)” ở trên.

Thông báo được phát ra:

FeatureRecipe template references a per-component-only field with executionScope: boundary ("<dotted-path>", written in "<field>", the render context defines "<the roots the boundary-scope context defines>") (Template của FeatureRecipe tham chiếu một trường chỉ dành cho từng component với executionScope: boundary)

Một FeatureRecipe phạm vi boundary có valuesMapping đọc .context.instance_id sẽ in ra:

[CATALOG_ERROR E0039] scope-probe-fr at .spec.valuesMapping
FeatureRecipe template references a per-component-only field with executionScope: boundary (".context.instance_id", written in "valuesMapping", the render context defines ".values, .infra, .locals, .provides, .features, .metadata, .steps, .source, .boundary")

Cách khắc phục: viết lại template theo các trường có sẵn của phạm vi, hoặc thay đổi executionScope của FeatureRecipe. Các FeatureRecipes phạm vi boundary tham chiếu .boundary.path, .boundary.boundary_name, .boundary.components, các tập hợp .boundary.*_uses_edges, .boundary.labels, .boundary.annotations và .boundary.feature_attachments. Các FeatureRecipes phạm vi Component tham chiếu .context.instance_id, .context.inject, .context.uses, .context.labels, .context.annotations. Cả hai phạm vi đều dùng chung .values, .infra, .locals, .provides, .steps và .metadata. Một tham số của Release không phải là một trụ cột riêng trên bề mặt này — nó đến được template của FeatureRecipe thông qua một mục values hoặc infra tham chiếu đến nó.

Self-inject value template references cross-node data (Template giá trị self-inject tham chiếu dữ liệu xuyên node)

Một template value: của inject: cấp component lấy dữ liệu từ .context.inject hoặc .context.uses. Đường ống inject chính là thứ mà lượt này đang xây dựng — một template bên trong giá trị self-inject của chính component không thể đọc từ nó.

Nguyên nhân nằm ở .context của bề mặt này: nó chứa instance_id, labels và annotations, và không có gì khác. Vì vậy .context.inject và .context.uses là những khóa mà context của bề mặt này không định nghĩa, và tham chiếu dừng lại như “Template references a root the render context does not define” ở trên, lúc phân tích cú pháp, trước khi bất kỳ thứ gì được render. Chẩn đoán nêu cơ chế và khóa phân phối mà template thuộc về, đồng thời liệt kê các khóa mà .context định nghĩa ở đây — nên cùng một báo cáo bao quát cả việc thực sự cố truy cập dữ liệu xuyên node lẫn một lỗi chính tả đơn thuần như {{ .context.nmae }}, vốn là lỗi phổ biến hơn và nếu không sẽ được render thành rỗng.

Thông báo được phát ra — chi tiết ở cấp tham chiếu; báo cáo bao quanh cũng nêu node, cơ chế và khóa phân phối:

template references a root the render context does not define (template self-inject.<mechanism>[<key>] references .context.inject, .context defines .context.instance_id, .context.labels, .context.annotations) (template tham chiếu một root mà render context không định nghĩa)

Mọi khung của báo cáo đều thuộc miền developer, vì một khối inject: cấp component được viết trong Aggregate.

Cách khắc phục: chuyển phần kết nối giữa các component vào một mục uses[].inject — đó là nơi có context xuyên node. Giữ các template value: self-inject cấp component chỉ dùng values và infra của chính component, .context.instance_id / .context.labels / .context.annotations của nó, và .metadata.

Thiếu khóa template — chính sách bất đối xứng

Cách xử lý khóa bị thiếu phụ thuộc vào bề mặt template. Ở nơi một kết quả render rỗng rơi vào chỗ có giới hạn — một trường manifest mà tác giả có thể đọc lại — việc thiếu được chấp nhận và phép đọc render ra rỗng. Ở nơi một kết quả render rỗng sẽ tạo ra một cấu trúc sai hoặc một phán quyết sai, bề mặt đó từ chối tham chiếu thay vì phân giải nó thành rỗng.

  • Nội suy tham số trong một Aggregate — các tham chiếu {{ .parameters.<key> }} mà chính văn bản của Aggregate chứa — là bề mặt sớm nhất trong số này: nó chạy trên tài liệu thô trước khi catalog được phân giải, nên chính sách của nó áp dụng cho văn bản mà chưa bề mặt nào khác thấy. Một tham chiếu đến tham số mà Release không bao giờ điền render ra rỗng, và một pipe default hoặc một điều kiện if trên phép đọc như vậy hoạt động đúng như trên tham số chưa được điền. Một tham chiếu mà template lặp qua vẫn tiếp tục lặp như rỗng, đó là điều mà việc duyệt qua một danh sách tùy chọn cần — trừ khi văn bản cũng in nó ra, khi đó nó sẽ dừng như mô tả trong “A template reads and iterates a path that holds nothing (Một template vừa đọc vừa lặp qua một đường dẫn không chứa gì)” bên dưới. Một tham chiếu có cha vắng mặt — .parameters.db.host khi không có tham số db nào được điền — vẫn dừng, vì không có gì để đi xuống, và việc cung cấp một cha sẽ đổi việc dừng lấy một artifact sai một cách âm thầm. Có một giới hạn đáng nêu như một giới hạn thay vì một chính sách: một tham chiếu neo tại một gốc mà bề mặt không định nghĩa sẽ được để nguyên thay vì render thành rỗng, nên nó tồn tại trong tài liệu đã nội suy dưới dạng văn bản giữ chỗ của chính template engine, <no value>. Không có gì trên bề mặt này dừng vì nó, vì vậy hãy neo mọi tham chiếu tham số tại .parameters, và hiểu một <no value> lạc lõng là một gốc bị viết sai chính tả.
  • Path template (directory: / subDirectory: của boundary trong Release) được đánh giá với missingkey=error. Một tham chiếu đến biến mà bề mặt không cung cấp sẽ dừng tại thời điểm phân tích cú pháp — xem “Path-template references a variable outside the allowlist (Path template tham chiếu một biến nằm ngoài danh sách cho phép)” ở trên — và một khóa gõ sai dưới .manifest, nơi các khóa đã được khai báo, cũng vậy. Một tham chiếu được cho phép nhưng chưa được định nghĩa tại thời điểm đánh giá, chẳng hạn một khóa .parameters mà Release không cung cấp, tạo ra một lỗi tường minh thay vì âm thầm render một chuỗi rỗng vào đường dẫn thư mục.
  • assertions (trên một Component, Feature, Recipe hoặc FeatureRecipe) được đánh giá với missingkey=error. Một tham chiếu đến khóa chưa được định nghĩa sẽ dừng với một chẩn đoán không-có-khóa nêu tên thực thể, instance và assertion. Chính sự nghiêm ngặt khiến một assertion đáng tin cậy: một vị từ mà tham chiếu của nó render thành giá trị rỗng sẽ so sánh với rỗng và vượt qua, nên chỉ một lỗi gõ cũng âm thầm vô hiệu hóa quy tắc mà assertion được viết ra để thực thi. Vì tham chiếu trần dừng trước khi bất kỳ giá trị dự phòng nào kịp chạy, một default đơn thuần không cung cấp giá trị dự phòng cho trường tùy chọn trên bề mặt này — hãy bảo vệ tham chiếu bằng hasKey, hoặc dùng helper optional, vốn thực hiện trực tiếp việc kiểm tra sự hiện diện. Đọc khóa qua index cũng không cung cấp được: index dừng trên một khóa map mà map không chứa, nêu tên khóa.
  • Value template (valuesMapping của Recipe, các mục locals: và provides:, phần thân artifacts:, phần thân Workload, injectMapping và pipeline.with của FeatureRecipe, và các template value: self-inject cấp component) được đánh giá với missingkey=zero, nên một tham chiếu đến khóa chưa được định nghĩa không dừng bản build — phép đọc render ra rỗng, và rỗng là thứ đến được artifact. Điều vẫn dừng trên bề mặt này là một tham chiếu đi xuống xuyên qua một container mà tác giả chưa bao giờ cung cấp — .values.tls.ca khi không có tls nào được viết — vì không có gì để đi xuống. Chỉ khóa cuối cùng của một tham chiếu có tất cả container đều hiện diện mới render ra rỗng. Một trường cấp cao nhất mà ngữ cảnh định nghĩa nhưng không chứa gì — .workload trên một Recipe không tổng hợp gì, .features trên một component không có attachment nào — cũng render ra rỗng theo cùng cách khi được đọc nguyên khối. Một tham chiếu vẫn là một tham chiếu dù được viết thế nào: .values.list, $.values.list và (.values).list chỉ cùng một khóa, nên duyệt nó theo một cách viết cũng là duyệt nó theo mọi cách viết, và một khóa được đọc từ một trụ cột trong ngoặc đơn sẽ render, hoặc dừng, đúng như cách viết trực tiếp. Một khóa mà template duyệt qua vẫn tiếp tục lặp như rỗng khi chưa được đặt, và một khóa mà template vừa in ra vừa duyệt qua sẽ dừng khi chưa được đặt — xem “A template reads and iterates a path that holds nothing (Một template vừa đọc vừa lặp qua một đường dẫn không chứa gì)” bên dưới. Việc bảo vệ hoạt động như mong đợi: {{ .values.optional_field | default "fallback" }} thực sự cung cấp giá trị dự phòng, vì một giá trị chưa đặt được tính là rỗng đối với default và là falsy đối với if. Tác giả cần phân biệt vắng-mặt với giá-trị-không — phân biệt “khóa vắng mặt” với “khóa hiện diện và rỗng” — dùng helper optional được mô tả tại templates/sprig-functions.md, và đọc một khóa nhất định theo một cách duy nhất trong mỗi template: một khóa mà cùng template đó cũng đọc dưới dạng .values.<key> được tính là hiện diện, nên optional báo giá trị rỗng của nó thay vì giá trị dự phòng. Điều chính sách này không bao gồm là phép đọc qua index: đánh chỉ mục một map bằng khóa mà nó không chứa sẽ dừng và nêu tên khóa ở đây cũng như trên mọi bề mặt — xem “A template indexes a map with a key the map does not hold (Một template đánh chỉ mục một map bằng khóa mà map không chứa)” bên dưới.
  • Một tọa độ source: — các trường dạng template của một khối source: có cấu trúc trên một Recipe hoặc FeatureRecipe (version, ref, chart, module_subdir) — được đánh giá với missingkey=error. Một tham chiếu đến khóa mà không gì cung cấp sẽ dừng và nêu tên trường source, thay vì phân giải thành rỗng: một version hoặc ref rỗng sẽ ghim một artifact khác với artifact mà tác giả đã nêu, và bản ghim là thứ mà mọi bản build sau này tái tạo. Bề mặt này cũng là nơi tập hàm khả dụng khác biệt, và là nơi một tham chiếu locals: mà thứ tự do chính tác giả của khối đặt ra từ chối sẽ dừng trước khi bất cứ thứ gì được đánh giá — xem bên dưới.
  • Hợp đồng tham số có kiểu bắt các trường hợp thiếu tham số bắt buộc và vi phạm hợp đồng tại tầng hợp đồng tham số, trước khi nội suy chạy — xem “Parameter type mismatch / contract violation (Sai kiểu tham số / vi phạm hợp đồng)” ở trên.

Tập helper giống nhau trên value template, path template và assertion: các hàm của Sprig cộng với các hàm riêng của Aggrega (optional và capitalizedWords). fail của Sprig nằm trong số đó, nên một value template có thể dừng bản build bằng một thông báo của riêng nó, như “A value template failed while it ran (Một value template thất bại khi đang chạy)” bên dưới mô tả; assertion là bề mặt được viết cho mục đích đó, vì dừng bản build là toàn bộ mục đích của nó. Giữa ba bề mặt đó, điều khác biệt là chính sách khóa bị thiếu — optional cũng khả dụng trong path template, nơi nó đọc một khóa từ .parameters mà chính sách nghiêm ngặt không kích hoạt trước. Việc phân giải một tọa độ source: khác biệt ở chính tập hàm, và có tiểu mục riêng bên dưới. Nội suy tham số trong một Aggregate chỉ cung cấp các hàm của Sprig, nên không helper nào của Aggrega khả dụng ở đó. Có một hàm đọc giống nhau trên mọi bề mặt này, kể cả tọa độ và nội suy: index, hàm dừng và nêu tên khóa khi map mà nó đọc không chứa khóa đó.

Thông báo mà một lần thiếu trong path template in ra được trích dẫn dưới mục mô tả điều kiện đó, “Path-template references a variable outside the allowlist (Path template tham chiếu một biến nằm ngoài danh sách cho phép)” ở trên, nên nó được viết một lần thay vì nhắc lại ở đây.

Cách khắc phục: với lỗi thiếu trong path template, sửa tên trường thành một tên trong danh sách cho phép được mô tả tại path-template-variables.md. Với lỗi thiếu trong assertion, sửa tham chiếu — phần lớn các báo cáo là do khóa viết sai chính tả — hoặc, khi trường thực sự là tùy chọn, bảo vệ nó bằng hasKey hoặc dùng helper optional; bọc tham chiếu trần trong một default sẽ không gỡ được việc dừng, vì tham chiếu được phân giải trước khi giá trị dự phòng chạy, và đọc nó qua index cũng không, vì index dừng trên một khóa mà map không chứa. Với lỗi thiếu trong value template khi không mong muốn render rỗng, hãy dùng helper optional hoặc cung cấp khóa bị thiếu dưới dạng một khai báo parameters.* có kiểu trên Aggregate với một giá trị từ Release, dưới dạng một mục provides: của một Component phía thượng nguồn được nối qua uses[].inject, hoặc dưới dạng một mục locals: trên cùng thực thể.

Việc phân giải một tọa độ source: đăng ký một tập hàm hẹp hơn

Một khối source: có cấu trúc được phân giải để artifact mà nó chỉ định có thể được ghim, và quá trình phân giải đó đăng ký các helper riêng của Aggrega và không gì khác — optional và capitalizedWords khả dụng, và index dừng lại khi gặp một khóa map mà map không chứa, đúng như khi Recipe được kết xuất; các hàm của Sprig thì không khả dụng. Trong các bề mặt mà một Recipe hoặc FeatureRecipe viết template, đây là bề mặt duy nhất có tập hàm khác biệt, nên một biểu thức kết xuất đúng ở chỗ khác trong cùng Recipe có thể bị từ chối ở đây. Tập hàm hẹp hơn là có chủ ý: những gì được ghim được quyết định bởi values và infra mà tác giả cung cấp, và các hàm của Sprig bao gồm những hàm đọc đồng hồ, môi trường, một nguồn ngẫu nhiên hoặc mạng.

Việc gọi một hàm Sprig trong một trường source:, hoặc trong một mục locals: mà trường đó đọc, sẽ dừng ở thời điểm phân tích cú pháp. Chẩn đoán có tiêu đề E0111 và nêu tên mục, trường source: đọc nó, hàm không thể phân giải, và các helper mà bề mặt này có đăng ký:

resolve: parse template at <name>:<version>.spec.locals.<key>, read by <name>:<version>.spec.source.<field>: resolve: source-template parse error (cause: template: <name>:<version>.spec.locals.<key>:1: function "<function>" not defined); a source field, and every locals entry it reads, is evaluated when the source is resolved with Aggrega’s own helpers only (optional, capitalizedWords and index), not the Sprig functions a render adds; write the value without that function, or move the value into a locals entry no source field reads (resolve: phân tích template tại .spec.locals., được đọc bởi .spec.source.: resolve: lỗi phân tích source-template (nguyên nhân: template: .spec.locals.:1: hàm không được định nghĩa); một trường source, và mọi mục locals mà nó đọc, được đánh giá khi source được phân giải chỉ với các helper riêng của Aggrega (optional, capitalizedWords và index), không phải các hàm Sprig mà một lần kết xuất bổ sung; hãy viết giá trị mà không dùng hàm đó, hoặc chuyển giá trị vào một mục locals mà không trường source nào đọc)

Một trường source: tự gọi hàm đó cũng được báo cáo theo cùng cách, chỉ nêu tên trường.

Phạm vi là các mục mà tọa độ đọc. Việc phân giải một tọa độ đánh giá từng mục locals: mà một trường source: đọc, và từng mục mà một mục như vậy lần lượt đọc — và không mục nào khác. Một mục mà không trường source: nào chạm tới sẽ không được đánh giá, phân tích hay kiểm tra trong khi source được phân giải, nên một local mà lần kết xuất cần — một local làm phép tính bằng các hàm của Sprig, hoặc đặt tên tài nguyên theo .context.instance_id — không ảnh hưởng gì đến việc ghim artifact; nó được đánh giá, và mọi lỗi trong nó được báo cáo, khi Recipe được kết xuất. Việc một trường đọc những mục nào được quyết định từ văn bản của nó, nên một trường đọc .locals theo cách không nêu tên một mục cụ thể nào — {{ index .locals "version" }}, toàn bộ khối được truyền cho optional hoặc gán vào một biến — sẽ khiến mọi mục được đánh giá, và chẩn đoán cho một mục mà nó chạm tới theo cách đó sẽ nói rõ điều này: thay cho read by <field>, nó ghi evaluated for <field>, which reads the locals block as a whole rather than by entry, so every entry is evaluated.

Hai dạng nằm ngoài bề mặt này, và việc biết một Recipe thuộc dạng nào giải thích vì sao cùng một biểu thức được chấp nhận trong Recipe này và bị từ chối trong Recipe khác:

  • Một source: được viết dưới dạng chuỗi thuần — một URI hoặc một đường dẫn cục bộ thay vì một mapping — được lấy nguyên văn, nên nó không có trường nào để đánh giá và khối locals: hoàn toàn không được phân giải ở đây.
  • Một thực thể không khai báo source: không phân giải tọa độ nào, nên khối locals: của nó chỉ được phân giải cho lần kết xuất của chính thực thể đó, nơi áp dụng toàn bộ tập hàm.

Hợp đồng về thứ tự tham chiếu ở đây là như nhau cho mọi mục mà tọa độ đọc. Việc phân giải một tọa độ từ chối cùng những tham chiếu mà một lần kết xuất từ chối trong mỗi mục nó đánh giá: một mục đọc một mục anh em mà khối khai báo bên dưới nó, và bất kỳ template nào đọc một khóa mà khối không khai báo. Cả hai đều báo cáo các điều kiện được mô tả ở trên trong “locals: entry references a sibling defined later in the same block (Mục locals tham chiếu đến một mục anh em được định nghĩa sau trong cùng khối)” và “locals: key does not exist (Khóa locals không tồn tại)” — cùng điều kiện, cùng cách khắc phục, bất kể lần phân giải nào chạm tới nó trước — và báo cáo nêu tên trường source: mà mục được đánh giá cho. Một lỗi trong một mục mà không trường source: nào đọc sẽ bị từ chối khi Recipe được kết xuất, theo cùng điều kiện.

Điều mà bề mặt này bỏ qua là một mục mà tọa độ thực sự không thể phân giải: một mục đọc dữ liệu chỉ tồn tại trong khi một artifact được kết xuất, với .context.instance_id là trường hợp nó dành cho. Một mục như vậy bị bỏ qua, nên một Recipe có tọa độ chạm tới một mục như thế trên một nhánh mà nó không đi vào vẫn được ghim. Khi chính tọa độ cần mục đó, việc phân giải dừng lại và nêu tên trường source: — báo cáo thiếu khóa được mô tả cho bề mặt này ở trên, có tiêu đề E0110 — và trích dẫn, bên cạnh khóa không đọc được, lý do vì sao mục đó không có giá trị ở đây:

resolve: evaluate template at <name>:<version>.spec.source.<field>: resolve: source-template evaluation failure at lock time (cause: template: … map has no entry for key "<key>"); it reads <name>:<version>.spec.locals.<key>, which could not be evaluated here (cause: template: … map has no entry for key "context") (resolve: đánh giá template tại .spec.source.: resolve: lỗi đánh giá source-template tại thời điểm khóa (nguyên nhân: template: … map không có mục cho khóa); nó đọc .spec.locals., mục này không thể được đánh giá ở đây (nguyên nhân: template: … map không có mục cho khóa))

Cả một trường source: lẫn một mục locals: mà nó đọc đều không được đọc .provides. Một khối locals: cung cấp cho một khối provides: và không bao giờ theo chiều ngược lại, nên một template trên bề mặt này đọc .provides bị từ chối như chính tham chiếu ngược mà nó là, thay vì được phân giải thành rỗng. Sự từ chối này không phải là sự vắng mặt tại thời điểm khóa mà một giai đoạn sau sẽ đáp ứng — không thứ tự nào làm cho tham chiếu hợp lệ — nên nó được báo cáo theo cùng cách ở bất cứ đâu tọa độ được phân giải. Chẩn đoán có tiêu đề E0112; nó nêu tên trường, hoặc mục và trường đọc nó, nói điều gì sai với tham chiếu, và chỉ ra bề mặt mà biểu thức có thể đọc thay thế:

source-version template at <name>:<version>.spec.source.<field> references .provides, which is an invalid reverse reference (locals feed provides, never the reverse) — refactor to read only .values and .infra (and .locals over the same): resolve: source-template references .provides (invalid reverse reference) (template source-version tại .spec.source. tham chiếu đến provides, đây là một tham chiếu ngược không hợp lệ (locals cung cấp cho provides, không bao giờ ngược lại) — hãy tái cấu trúc để chỉ đọc values và infra (và locals trên cùng các giá trị đó): resolve: source-template tham chiếu đến provides (tham chiếu ngược không hợp lệ))

Nơi xảy ra việc dừng: trong khi lockfile đang được điền hoặc làm mới — aggrega pull, hoặc một lần build điền nó (--auto-pull, --upgrade, hoặc thiết lập auto_pull của workspace). Mỗi lỗi được báo cáo thành một chẩn đoán, có tiêu đề là mã của điều đã sai — E0111 cho một template không phân tích được, E0112 cho một tham chiếu .provides, E0110 cho một template đã phân tích được nhưng không thể đánh giá — trong terminal cũng như trong một trình soạn thảo kết nối với aggrega serve. Một khóa bị thiếu trên một trường source:, khác với một hàm không khả dụng, được báo cáo ở thời điểm thực thi chứ không phải thời điểm phân tích, nêu tên trường và khóa không đọc được.

Cách khắc phục: optional được đăng ký trên bề mặt này và trên mọi value template, path template và assertion, điều này khiến nó trở thành lựa chọn có tính di động — {{ optional .values "chart_version" "25.0.8" }} thay cho {{ default "25.0.8" .values.chart_version }}. Hãy đọc sự khác biệt về ngữ nghĩa trước khi thay thế: optional kích hoạt khi khóa vắng mặt, còn default kích hoạt khi giá trị rỗng, nên một khóa được viết là chuỗi rỗng hoặc số không sẽ giữ giá trị đã viết dưới optional và bị thay thế dưới default. Khi biểu thức thực sự cần một hàm Sprig — định dạng lại một chuỗi thay vì cung cấp giá trị dự phòng — hãy giữ nó ngoài những gì tọa độ đọc: trong một mục locals: mà không trường source: nào đọc, hoặc trên bề mặt tiêu thụ nó (valuesMapping, phần thân của một Workload, một mục artifacts:).

Một template truy cập một map bằng một khóa mà map đó không chứa

Một template đọc một map thông qua index — {{ index .values "replicas" }}, hoặc {{ index .context.inject.env $apiKeyVar }} với tên khóa do template tính ra — và map không chứa khóa được yêu cầu. index dừng tại đó và nêu tên khóa, trên mọi bề mặt đánh giá template: value template, các mục locals: và provides:, path template, assertion, một tọa độ source: có cấu trúc, phép nội suy tham số trong một Aggregate và các vị từ validate: của các tham số của nó, cùng các vị từ x-aggrega-when: và x-aggrega-validate: của một schema.

Đây là thuộc tính của riêng index, và chính sách khóa thiếu của không bề mặt nào thay đổi nó. Một phép đọc bằng dấu chấm đối với một khóa chưa được đặt dưới một pillar mở vẫn không hiển thị gì trên một value template, như “Missing template key — asymmetric policy (Thiếu khóa template — chính sách bất đối xứng)” ở trên mô tả, và một template kiểm tra xem tác giả có cung cấp khóa như vậy hay không không bị ảnh hưởng. Thứ dừng lại là việc yêu cầu index lấy một khóa mà map không chứa. index là cách một template truy cập một khóa có tên do nó tính ra — chẳng hạn một thông tin xác thực được đọc theo tên biến mà Recipe sử dụng đã chọn — và nếu không dừng, phép đọc đó sẽ đưa văn bản giữ chỗ <no value> của template engine vào artifact trong khi bản build vẫn thành công: một máy chủ khởi động với văn bản đó làm khóa. Mọi câu trả lời khác mà index đưa ra đều là của chính template engine: một vị trí trong danh sách hoặc chuỗi, một vị trí ngoài phạm vi, một khóa mà map chứa — kể cả một khóa có giá trị null, khi đó in ra <no value>.

Thông báo được phát ra, ở dòng cuối của báo cáo — các frame phía trên nêu tên node và trường chứa template, và trên một value template của Recipe hoặc FeatureRecipe, phần đầu mang mã của điều kiện này:

template: <template>:<line>:<column>: executing "<template>" at <index <map> <key>>: error calling index: template indexes a map with a key the map does not hold (key "<key>"). read a key that may be absent through a function that tests for it first, such as optional, get or hasKey (template truy cập một map bằng một khóa mà map đó không chứa (khóa). hãy đọc khóa có thể vắng mặt thông qua một hàm kiểm tra nó trước, chẳng hạn optional, get hoặc hasKey)

Trên một bề mặt báo cáo lỗi template theo điều kiện riêng của nó — một mục provides: (“A provides: template could not be evaluated (Không thể đánh giá một template provides)”), phép nội suy tham số (“A {{ .parameters.* }} reference cannot be interpolated (Không thể nội suy một tham chiếu)”), một vị từ schema (“An x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Không thể đánh giá một vị từ)”), một tọa độ source: (“Resolving a source: coordinate registers a narrower function set (Việc phân giải một tọa độ source đăng ký một tập hàm hẹp hơn)”) — phần đầu mang mã của điều kiện đó và dòng ở trên là lý do nó mang theo, bao gồm cả khóa.

Cách khắc phục: xác định xem khóa có thể vắng mặt một cách hợp lệ hay không.

  • Có thể. Hãy đọc nó thông qua một hàm kiểm tra nó trước: {{ optional .values "replicas" 1 }} trả về giá trị dự phòng khi khóa vắng mặt và trả về giá trị, bất kể là gì, khi khóa có mặt; get của Sprig trả về chuỗi rỗng cho khóa vắng mặt; hasKey kiểm tra mà không đọc. optional được đăng ký trên mọi bề mặt trừ phép nội suy tham số và các vị từ của một tham số hoặc một schema, vốn cung cấp get và hasKey của Sprig; một tọa độ source: đăng ký optional chứ không đăng ký Sprig.
  • Không được. Hãy cung cấp nó. Khóa mà thông báo nêu tên là khóa template đã yêu cầu, nên các nguyên nhân thường gặp là một khóa được công bố dưới tên khác — một thông tin xác thực có key không phải tên biến mà Recipe đọc — một khóa viết sai chính tả trong template hoặc trong các giá trị đã viết, và một kết nối lẽ ra cung cấp khóa nhưng chưa được nối.

A template reads and iterates a path that holds nothing (Một template đọc và lặp qua một đường dẫn không chứa gì)

Một template in ra một đường dẫn đúng như hiện trạng và đồng thời lặp qua chính đường dẫn đó — chẳng hạn "user": "{{ .values.user }}" và "users": "{{ range .values.user }}…{{ end }}" trong cùng một valuesMapping — trong khi dữ liệu không chứa gì ở đó: khóa chưa được đặt, chứa null, hoặc là một trường cấp cao nhất mà ngữ cảnh định nghĩa nhưng không chứa gì, chẳng hạn .workload trên một Recipe không tổng hợp workload nào. Bản build dừng trước khi template chạy và nêu tên đường dẫn, trên mọi bề mặt render một giá trị chưa đặt thành rỗng: các template giá trị mà “Missing template key — asymmetric policy (Thiếu khóa template — chính sách bất đối xứng)” ở trên liệt kê, và phép nội suy tham số trong một Aggregate.

Mỗi cách đọc riêng lẻ đều có câu trả lời. Một giá trị chưa đặt được in ra sẽ render thành rỗng, và một giá trị chưa đặt được lặp qua sẽ không lặp gì cả. Một đường dẫn được đọc theo cả hai cách thì không thể có câu trả lời nào: render nó thành rỗng sẽ khiến range thất bại trên văn bản, còn để nó chưa đặt sẽ in văn bản giữ chỗ của template engine là <no value> vào artifact trong khi bản build vẫn thành công. Vì vậy không câu trả lời nào được đưa ra và thay vào đó bản build dừng lại.

Những gì được tính là in ra đường dẫn được giới hạn hẹp, và ranh giới được vạch ở nơi template chắc chắn in nó ra:

  • Đường dẫn được in ra khi một action chỉ gồm đường dẫn đó và không có gì khác — {{ .values.user }}, {{ $.values.user }}, {{ (.values).user }}, hoặc một biến được gắn với đường dẫn, {{ $u }} sau {{ $u := .values.user }} — tại một điểm mà template đạt tới mỗi lần chạy.
  • Đường dẫn không được in ra khi phép đọc nằm bên trong thân if, with hoặc range hoặc trong một nhánh else, vì việc phép đọc đó có chạy hay không phụ thuộc vào một điều kiện, và điều kiện đó có thể chính là phép kiểm tra ngăn nó gặp phải giá trị rỗng — vì vậy {{ if .values.user }}{{ .values.user }}{{ end }} bên cạnh một range .values.user vẫn render như trước nay. Nó cũng không được in ra khi đó là phép kiểm tra của chính một guard, phép gán của một biến, hoặc một đối số cho một hàm — {{ .values.user | quote }}, {{ toYaml .values.user }} — mà đầu ra là câu trả lời của hàm thay vì văn bản giữ chỗ.

Một lệnh in đường dẫn không chứa gì bên trong một thân thực sự chạy vẫn ghi ra <no value>, điều mà phép kiểm tra này không chạm tới. Một cách viết của đường dẫn là cùng một đường dẫn với mọi cách viết khác, nên một lệnh in theo một cách viết và một range theo cách viết khác được xét cùng nhau, và thông báo trích dẫn cách viết mà template viết trước. Một đường dẫn chứa giá trị được in và lặp như trước nay, còn một đường dẫn có cha không chứa gì thì được để cho lần dừng mà việc đi xuống qua giá trị rỗng vốn đã gây ra.

Thông báo được phát ra, ở dòng cuối cùng của báo cáo — các khung phía trên nêu tên node và template, và phần đầu mang mã của điều kiện này:

template reads a path as a value and iterates it, and the data holds nothing at that path (path <path>). supply a value at the path, guard the printed read with an if or with over the path, or read it one way only (Template đọc một đường dẫn như một giá trị và lặp qua nó, và dữ liệu không chứa gì tại đường dẫn đó. Hãy cung cấp một giá trị tại đường dẫn, bảo vệ phép đọc được in bằng if hoặc with trên đường dẫn, hoặc chỉ đọc nó theo một cách)

Phép nội suy tham số trong một Aggregate cũng báo cáo cùng dòng đó dưới mã của điều kiện này. Một mục provides: báo cáo lỗi template dưới “A provides: template could not be evaluated (Không thể đánh giá template)”, nên ở đó phần đầu mang mã của điều kiện đó và dòng ở trên là lý do mà nó mang, bao gồm cả đường dẫn.

Cách khắc phục: xác định template muốn nói đến cách đọc nào trong hai cách.

  • Đường dẫn phải có mặt. Hãy cung cấp nó — trong values: của Aggregate, infra: của Release hoặc tham số mà Release điền — hoặc khai báo nó là bắt buộc trong schema chi phối nó, để việc thiếu nó được báo cáo tại nơi nó được viết.
  • Đường dẫn có thể vắng mặt. Hãy bảo vệ phép đọc được in: {{ with .values.user }}{{ . }}{{ end }} hoặc {{ if .values.user }}{{ .values.user }}{{ end }} không in gì khi đường dẫn chưa được đặt, và range bên cạnh vẫn tiếp tục lặp như qua rỗng.
  • Một cách đọc là đủ. Hãy đọc đường dẫn theo một cách — một range cũng ghi ra những gì nó cần, hoặc in thông qua một hàm như toYaml hoặc join tự đưa ra câu trả lời cho một giá trị chưa đặt.

A value template failed while it ran (Một value template thất bại khi đang chạy)

Một value template của Recipe hoặc FeatureRecipe — một trong các template mà “Missing template key — asymmetric policy (Thiếu khóa template — chính sách bất đối xứng)” ở trên liệt kê, trong đó có thân Workload, thân artifacts: hoặc một mục locals: — đã được phân tích, bắt đầu chạy, và dừng lại trước khi tạo ra văn bản của nó. Thứ làm nó dừng là lý do riêng của template engine, mà halt mang theo bên dưới: một tham chiếu đi xuyên qua một container mà không gì cung cấp, chẳng hạn {{ .values.tls.ca }} khi không có tls nào được viết; một phép so sánh giữa các giá trị thuộc hai kiểu, chẳng hạn {{ if eq .context.instance_id 1 }}, vốn so sánh văn bản với một số và dừng với cannot compare text with a number; hoặc một lời gọi fail của Sprig, mà một value template có thể thực hiện để từ chối một đầu vào bằng thông báo của riêng nó.

Bốn lỗi trên các template này được báo cáo dưới các điều kiện riêng của chúng. Một mục provides: được báo cáo dưới “A provides: template could not be evaluated (Không thể đánh giá template)” bên dưới, với câu này và lý do của engine bên trong thông báo của nó. Một phép đọc index đối với một khóa mà map không chứa được báo cáo dưới “A template indexes a map with a key the map does not hold (Một template đánh chỉ mục một map bằng một khóa mà map không chứa)” ở trên. Một template in ra và lặp qua một đường dẫn không chứa gì bị từ chối trước khi chạy, dưới “A template reads and iterates a path that holds nothing (Một template đọc và lặp qua một đường dẫn không chứa gì)” ở trên. Và một template không phân tích được sẽ dừng trước khi chạy, nên đó không phải điều kiện này.

Thông báo được phát ra — các khung phía trên nêu instance của component và template, chẳng hạn recipe "<recipe>" workload template hoặc Recipe "<recipe>" locals["<key>"], và dòng riêng của template engine theo sau bên dưới:

a value template failed while it ran (một value template thất bại khi đang chạy)

Dòng của engine có dạng template: <template>:<line>:<column>: executing "<template>" at <<expression>>: <reason> — với một lời gọi fail là error calling fail: <the message the template wrote>. Bản build báo cáo halt với thẻ CATALOG_ERROR, vì template do tác giả của Recipe hoặc FeatureRecipe viết. aggrega pull gặp cùng lỗi đó khi nó render Release để khám phá các đầu vào bên ngoài mà Release đọc: nó báo cáo lỗi, vẫn ghi các ghim phụ thuộc của lockfile, và cho biết các ghim đầu vào bên ngoài có thể chưa đầy đủ; bản build thì dừng lại vì lỗi đó.

Cách khắc phục: đọc lý do của engine ở cuối báo cáo — nó nêu template, dòng và cột, và biểu thức nơi nó dừng. Với một container mà không gì cung cấp, hãy cung cấp nó, hoặc bảo vệ phép đọc để nó không bao giờ đi xuống thứ vắng mặt: {{ with .values.tls }}{{ .ca }}{{ end }}, hoặc helper optional. Với hai kiểu được so sánh, hãy so sánh cùng loại với nhau — một số với một số viết không có dấu ngoặc kép, văn bản với văn bản viết trong dấu ngoặc kép — hoặc chuyển một bên thành văn bản bằng toString. Với một lời gọi fail, thông báo là của tác giả template, và nó cho biết Recipe cần gì: hãy cung cấp điều đó, hoặc ánh xạ component tới một Recipe chấp nhận những gì bạn đã viết.

Một governance plugin đã từ chối bản build

Người vận hành có thể gắn một governance plugin ở vai trò phán quyết, trên đồ thị mà trình biên dịch đã xây dựng hoặc trên các artifact mà nó đã kết xuất. Plugin như vậy đọc và trả về một phán quyết. Host không có đường nào để áp dụng một thay đổi trả về từ nó, nên một vai trò phán quyết có thể từ chối một bản build và không thể viết lại bản build để tuân thủ — việc từ chối là toàn bộ những gì nó có thể làm, còn việc thay đổi gì thì để cho người đọc nó quyết định.

Chỉ phán quyết halt mới dừng bản build. Các phán quyết warn và info được báo cáo và bản build tiếp tục. Mọi phán quyết halt mà một plugin trả về đều được báo cáo, theo thứ tự plugin phát ra chúng, nên một lần chạy cho bạn biết tất cả.

Thông báo mà bản build in ra là của chính plugin, được hiển thị đúng như khi được trả về và chỉ được bao bởi tên plugin đã trả về nó — vì vậy mức độ cụ thể và khả năng hành động của nó do plugin quyết định chứ không phải trình biên dịch. Bất kỳ chi tiết tùy chọn nào mà phán quyết mang theo sẽ theo sau trong ngoặc vuông, mỗi phần đều được đặt tên: một mã, một định danh quy tắc, một phân loại, một tham chiếu nguồn, một vị trí, một gợi ý. Điều kiện mà nó được ghi nhận là policy violation, đó cũng là thứ mà một mã ngắn ở phần đầu chẩn đoán phân giải tới.

Việc từ chối được quy cho governance attachment chứ không phải cho một tài liệu của bạn, nên nó không mang vị trí tệp: không có khóa nào tạo ra nó, và cách giải quyết là hoặc đáp ứng chính sách, hoặc xem xét lại attachment.

Thông báo được phát ra:

policy plugin "<plugin>" rejected the build: <the plugin's own message> [code=<code>; rule_id=<rule>; classification=<class>; source_ref=<reference>; location=<where>; suggest=<suggestion>] (policy plugin đã từ chối bản build)

Phần trong ngoặc vuông chỉ có mặt khi phán quyết mang chi tiết, và mỗi phần bên trong chỉ có khi plugin đã đặt nó.

Cách khắc phục: đọc thông báo của plugin và gợi ý nếu nó có cung cấp. Nếu phát hiện là đúng, hãy thay đổi điều mà nó phản đối. Nếu chính sách không nên áp dụng cho Release này, đó là câu hỏi về attachment: các governance attachment được cấu hình dưới plugins.governance trong cấu hình workspace, và plugin nào chạy ở vai trò nào là quyết định của người vận hành chứ không phải điều một tài liệu có thể ghi đè.

Thiết lập của một governance attachment không khớp với schema mà plugin khai báo

Một governance plugin có thể khai báo một schema cho các thiết lập mà attachment của nó truyền vào. Các thiết lập được viết dưới with.settings của attachment được kiểm tra theo schema đó trước khi plugin được gọi, nên một attachment cấu hình sai được báo cáo đúng là lỗi cấu hình, thay vì đến plugin dưới dạng đầu vào sai hình dạng và quay lại thành bất cứ điều gì plugin hiểu từ nó.

Thứ tự đó chính là mục đích của phép kiểm tra. Nó cũng giúp phân biệt rõ điều này với một sự từ chối: plugin chưa chạy, không có phán quyết nào được đưa ra, và không có gì về bản build bị đánh giá. Một plugin không khai báo schema thiết lập sẽ chấp nhận mọi thiết lập, nên một attachment đối với plugin như vậy không bao giờ gặp điều này.

Phép kiểm tra bao gồm mọi vai trò governance. Một attachment được viết ở ir-verdict, render-verdict, label-transform hoặc annotation-transform có thiết lập được kiểm tra theo schema trước khi plugin được gọi — with.settings là cùng một khóa trên mọi vai trò, và mọi vai trò đều đọc nó theo schema trước. Một vai trò transform chạy tại nơi bản build áp dụng nó, mà với một bản build pull trước thì là trong lần pull đó, nên thông báo ở đó mở đầu bằng bước đã gọi nó, như trong auto-pull: label-transform:.

Thông báo được phát ra — vai trò mà attachment được viết và plugin mà nó nêu tên, sau đó là câu cố định, rồi đến kết quả của phép kiểm tra schema:

ir-verdict: plugin "<the attachment's uri>": with.settings does not satisfy the plugin’s declared settings schema: <what the schema check found>: policy attachment settings do not satisfy the plugin’s declared settings schema (with.settings không thỏa mãn schema thiết lập mà plugin khai báo: thiết lập của policy attachment không thỏa mãn schema thiết lập mà plugin khai báo)

Mệnh đề đầu là render-verdict đối với một attachment được viết ở vai trò đó. Kết quả của phép kiểm tra schema là báo cáo riêng của trình xác thực schema và dài hơn một dòng.

Cách khắc phục: sửa các thiết lập dưới with.settings của attachment đó trong plugins.governance. Chi tiết ở giữa thông báo nêu tên khóa bị lỗi và điều schema mong đợi ở đó; tài liệu tham khảo riêng của plugin mô tả các thiết lập mà nó khai báo.

Một bước pipeline bị lỗi

Một FeatureRecipe có thể khai báo một pipeline: một chuỗi các bước, mỗi bước gọi một export của plugin trên các tài liệu mà node đã phát ra, để một Feature có thể định hình đầu ra mà Recipe của chính component đó tạo ra. Đây là điều kiện mà một bước báo cáo khi nó thất bại vì bất kỳ lý do nào ngoài việc một patch trỏ tới thứ mà tập tài liệu không chứa — trường hợp đó có báo cáo riêng ở bên dưới.

Thứ bị lỗi được nêu theo id và chỉ số của bước, và mệnh đề theo sau cho biết phần nào bị hỏng: việc render đầu vào with của bước, chính lời gọi, đầu ra mà host không đọc được, một lỗi mà plugin trả về, một diagnostic mức lỗi mà plugin phát ra, một patch bị engine patch từ chối, hoặc một patch nêu tên một scope mà quá trình duyệt không có.

Một bước bị lỗi được hoàn tác toàn bộ. Các tài liệu được khôi phục về trạng thái trước khi bước chạy, và các đầu ra riêng của bước bị loại bỏ cùng với chúng, nên when hoặc with của một bước sau không thể đọc một kết quả dở dang. Khi đó, một bước được khai báo optional: true báo cáo dưới dạng cảnh báo và quá trình duyệt tiếp tục; một bước không phải optional sẽ dừng bản build. Điều mà optional: không dung thứ là một contract đã khai báo bị vi phạm — xem mục bên dưới.

Các thông báo được phát ra:

pipeline step failed: step "<id>" (index <n>) with: <what the render could not do> (bước pipeline bị lỗi: bước (chỉ số): điều mà việc render không làm được) pipeline step failed: step "<id>" (index <n>) invoke: <what the call could not do> (bước pipeline bị lỗi: bước (chỉ số) gọi: điều mà lời gọi không làm được) pipeline step failed: step "<id>" (index <n>) error diagnostic: <the plugin's message> (bước pipeline bị lỗi: bước (chỉ số) diagnostic lỗi: thông báo của plugin) pipeline step failed: scope "<scope>" key "<key>": <what the patch engine refused> (bước pipeline bị lỗi: scope, key: điều mà engine patch từ chối) pipeline step failed: unknown patch scope "<scope>" (bước pipeline bị lỗi: scope patch không xác định)

Cách khắc phục: đọc id của bước, rồi mệnh đề sau chỉ số — nó cho biết cần xem nửa nào của bước. Một lỗi with là một template trong khối with: của chính bước, và bạn là người sửa. Một diagnostic lỗi là lời của chính plugin về đầu vào của bạn. Một patch bị từ chối và một scope không xác định là đầu ra của plugin so với những gì node đã phát ra, và thuộc về tác giả plugin. Khi một bước thực sự được phép thất bại — một bước làm giàu tùy chọn chứ không phải một phép biến đổi bắt buộc — hãy khai báo nó optional: true, và nhớ rằng điều này dung thứ một lỗi chứ không dung thứ một contract bị phá vỡ.

Đầu vào hoặc đầu ra có kiểu của một bước pipeline không thỏa mãn contract đã khai báo

Một export của plugin có thể khai báo một schema cho đầu vào nó nhận và cho các đầu ra nó trả về. Cả hai đều được kiểm tra: giá trị with đã render trước lời gọi, và các đầu ra được trả về sau lời gọi. Một diagnostic có mức độ nghiêm trọng mà contract chung không khai báo cũng bị từ chối theo cùng cách.

Điều này dừng build ngay cả với một bước được khai báo optional: true, và sự phân biệt này chính là toàn bộ lý do điều kiện này tách biệt với lỗi bước. Optional dung thứ một bước không thể làm xong việc của nó — một lời gọi thất bại, một plugin phản đối. Nó không dung thứ đầu ra mà host không thể định tuyến, hay đầu vào chưa bao giờ có hình dạng mà export nói nó nhận: một contract đã khai báo là một cam kết, và một bản build lặng lẽ bỏ qua một bước có contract bị phá vỡ sẽ báo thành công cho một Feature chẳng làm gì cả.

Các thông báo được phát ra:

pipeline step "<id>" with input does not satisfy the declared input contract: <what the schema check found>: pipeline step typed-I/O contract violation (đầu vào của bước pipeline không thỏa mãn contract đầu vào đã khai báo: điều mà việc kiểm tra schema phát hiện: vi phạm contract I/O có kiểu của bước pipeline) pipeline step "<id>" returned outputs that do not satisfy the declared output contract: <what the schema check found>: pipeline step typed-I/O contract violation (bước pipeline trả về các đầu ra không thỏa mãn contract đầu ra đã khai báo: điều mà việc kiểm tra schema phát hiện: vi phạm contract I/O có kiểu của bước pipeline)

và đối với một mức độ nghiêm trọng của diagnostic mà contract không khai báo, thông báo xuất hiện bên trong khung lỗi bước:

pipeline step failed: step "<id>" (index <n>): <the severity the host could not route>: pipeline step typed-I/O contract violation (bước pipeline bị lỗi: bước (chỉ số): mức độ nghiêm trọng mà host không thể định tuyến: vi phạm contract I/O có kiểu của bước pipeline)

Khi template with của bước đọc một giá trị được khai báo là nhạy cảm, một vi phạm đầu vào không nêu giá trị nào. Điều mà việc kiểm tra schema phát hiện được thay bằng từng vị trí không hợp lệ và từ khóa đã từ chối nó, kết thúc bằng một thông báo nêu lý do — at '/origin': pattern (the value is withheld because the template that rendered this input reads a value declared sensitive) — nên trường cần sửa vẫn được nêu tên. Xem vocabulary/compact-form-authoring.md “Một lời từ chối nói gì về một giá trị đã khai báo”.

Cách khắc phục: với một vi phạm đầu vào, hãy sửa khối with: của bước theo schema mà export của nó khai báo — chi tiết nêu tên trường và điều được mong đợi. Một vi phạm đầu ra và một mức độ nghiêm trọng không được khai báo là phần của plugin phải sửa; khai báo của bước không phải là chỗ sai, nên đánh dấu nó optional sẽ không xóa được lỗi nào trong hai lỗi đó.

Một patch pipeline trỏ tới một tài liệu mà tập không chứa, hoặc một tài liệu không có cây để trỏ vào

Một bước pipeline trỏ tới một tài liệu bằng một scope và một key, và hai dạng địa chỉ bị từ chối.

Tập không chứa nó. Bước đã patch một cặp scope và key không nằm trong các tài liệu được giao cho nó. Sẽ không có gì được chỉnh sửa, nên thay vì áp dụng một patch vào hư không và báo thành công, quá trình duyệt dừng lại:

pipeline patch targets a document not present in the set: scope "<scope>" key "<key>" (patch pipeline trỏ tới một tài liệu không có trong tập: scope, key)

Nó không có cây để trỏ vào. Một số đơn vị không có cấu trúc mà một patch có thể trỏ vào — một nội dung nhị phân, văn bản tự do, một vùng mà provider không thể duyệt an toàn. Một đơn vị như vậy vẫn được giao cho bước, gắn kèm media type và các byte của nó, để có thể được chọn và phát ra nguyên vẹn; điều nó không thể là bị patch, vì không có gì để một đường dẫn phân giải theo. Một patch nhắm vào nó sẽ dừng lại thay vì bị lặng lẽ bỏ qua:

pipeline patch targets an opaque (non-structured) unit: scope "<scope>" key "<key>" (patch pipeline trỏ tới một đơn vị mờ (không có cấu trúc): scope, key)

Điều gì được coi là có cấu trúc là cách đọc đơn vị của chính provider chứ không phải một phép kiểm tra cố định, nên cùng một nội dung có thể trỏ vào được dưới một provider và mờ dưới một provider khác.

Cả hai đều là lời từ chối của chính quá trình duyệt, và một bản build báo cáo chúng đối với node có pipeline đã tạo patch, nên thông báo trên xuất hiện bên dưới một lần dừng nêu tên node đó. Lần dừng đó là dạng dừng build của cùng hai lỗi định địa chỉ, được mô tả trong “A pipeline step addresses documents the node does not have (Một bước pipeline trỏ tới các tài liệu mà node không có)” bên dưới — mục này cũng bao gồm địa chỉ thứ ba mà một bước có thể không trỏ tới được gì, là yêu cầu các tài liệu của một component host tại một vị trí không gắn với component nào.

Cách khắc phục: cả hai đều thuộc về tác giả plugin chứ không phải bạn. Một bước nhận tập tài liệu mà nó đang chạy trên đó và có thể đọc những key nào có trong đó, nên một đích vắng mặt là một bước trỏ tới một tài liệu mà node này không phát ra — hãy patch một tài liệu có ở đó, hoặc trước tiên phát ra tài liệu bạn muốn rồi patch nó ở một bước sau. Với một đơn vị mờ, hãy thay patch bằng một lần phát ra toàn bộ đơn vị: một nội dung mờ được thay thế chứ không được chỉnh sửa.

A patch’s test operation did not match the document (Thao tác của một bản vá không khớp với tài liệu)

Một bản vá có thể mang một thao tác test, thao tác này khẳng định giá trị tại một đường dẫn trước khi các thao tác sau nó được áp dụng. Engine từ chối toàn bộ bản vá khi khẳng định không đúng, và chính điều đó khiến một bản vá có điều kiện thực sự có điều kiện thay vì lạc quan: một plugin kiểm tra trước khi chỉnh sửa là đang nói rằng nó sẽ không động vào một tài liệu mà nó không nhận ra.

Có hai dạng được báo cáo dưới điều kiện này. Hoặc hoàn toàn không có gì tại đường dẫn, và thông báo nói rõ điều đó. Hoặc có một giá trị nhưng không phải giá trị được khẳng định, và trường hợp này được báo cáo dưới dạng lời từ chối trần — không trích dẫn giá trị được khẳng định lẫn giá trị tìm thấy.

Các thông báo được phát ra:

jsonpatch: test operation failed: no value at path (jsonpatch: thao tác test thất bại: không có giá trị tại đường dẫn) jsonpatch: test operation failed (jsonpatch: thao tác test thất bại)

Khi đầu ra của một bước pipeline mang bản vá, lời từ chối xuất hiện bên dưới lỗi của bước đó, kèm tên bước. Khi bản vá của một plugin biến đổi nhãn mang nó, lời từ chối xuất hiện bên dưới lời từ chối vá nhãn.

Cách khắc phục: lỗi thuộc về plugin chứ không phải tài liệu của bạn. Một kiểm tra mong đợi một giá trị mà tài liệu không có thường có nghĩa là plugin đang chạy trên một dạng mà nó không được viết cho — đầu ra của một provider khác, hoặc một tài liệu mà một bước trước đó trong cùng pipeline đã thay đổi. Khi bản vá là của bạn để sửa, hãy nới lỏng kiểm tra theo đúng những gì tài liệu thực sự mang, hoặc để điều kiện when của bước bỏ qua trường hợp đó thay vì kiểm tra nó bên trong bản vá.

A workload: form and the fields beside it do not agree (Dạng của workload và các trường bên cạnh nó không khớp nhau)

Một workload: khai báo một form: — hình dạng của thứ được chạy, được nêu bằng những thuật ngữ mà mọi đích đều hiểu thay vì bằng từ vựng của riêng một đích nào. Một số trường chỉ có nghĩa trên một dạng, và một dạng được khai báo mà thiếu trường nó cần thì không có gì nhất quán để render. Cả hai chiều đều được kiểm tra, trước khi bất kỳ đích nào dịch workload, nên sự không khớp được báo cáo một lần dựa trên những gì bạn đã viết thay vì mỗi đích một lần bằng cách diễn đạt riêng của từng đích.

Năm cặp ràng buộc được thực thi, và mỗi cặp báo cáo bằng câu riêng nêu tên cả hai vế và điều cần viết:

workload declares a persistentTemplate volume but is not form: stateful; declare form: stateful (workload khai báo volume persistentTemplate nhưng không có dạng stateful; hãy khai báo dạng stateful) workload is form: reference but declares no endpoint; set endpoint to the external host or URL the reference points at (workload có dạng reference nhưng không khai báo endpoint; hãy đặt endpoint là host hoặc URL bên ngoài mà tham chiếu trỏ tới) workload declares an endpoint but is not form: reference; declare form: reference or remove the endpoint (workload khai báo endpoint nhưng không có dạng reference; hãy khai báo dạng reference hoặc xóa endpoint) workload is form: scheduled but declares no schedule; set schedule to a 5-field cron expression or an @-macro (e.g. @daily) (workload có dạng scheduled nhưng không khai báo schedule; hãy đặt schedule là một biểu thức cron 5 trường hoặc một macro @, ví dụ @daily) workload declares a schedule but is not form: scheduled; declare form: scheduled or remove the schedule (workload khai báo schedule nhưng không có dạng scheduled; hãy khai báo dạng scheduled hoặc xóa schedule)

Mỗi lỗi được định vị tại thực thể component có workload đang được đọc, và được báo cáo là lỗi dịch, vì sự không khớp nằm giữa hai trường của cùng một khối do người dùng viết.

Các điều kiện mà chúng được ghi nhận, cũng là thứ mà mã ngắn của chúng phân giải tới, là persistentTemplate volume requires form: stateful, form: reference requires an endpoint, endpoint requires form: reference, form: scheduled requires a schedule và schedule requires form: scheduled.

Một cặp chỉ áp dụng một chiều. Một workload form: stateful không có claim template theo từng replica là bình thường và không gây lỗi gì — quy tắc là một claim template cần danh tính ổn định theo từng replica mà chỉ dạng đó cung cấp, chứ không phải dạng đó cần một claim template. Hai cặp còn lại áp dụng cả hai chiều, vì endpoint và schedule mỗi thứ chỉ có đúng một dạng mà chúng có ý nghĩa.

Hai cặp endpoint cũng nằm trong schema của Workload, nên một workload vi phạm một trong hai bị từ chối ở giai đoạn schema, dưới E0214, trước khi đến câu tương ứng ở trên. Một endpoint: trên bất kỳ form nào khác reference — kể cả form: bị bỏ qua, vì nó được đọc là stateless — bị từ chối dưới dạng

workload validation failed (Workload in Recipe <name>:<version>, at <path>, schema stage): .endpoint: value matches a shape that is not allowed here (xác thực workload thất bại ở giai đoạn schema: giá trị endpoint khớp với một hình dạng không được phép ở đây)

và form: reference không có endpoint: thì kết thúc bằng .endpoint: missing required property: endpoint. Cách khắc phục là cách mà câu của cặp đó đưa ra.

Cách khắc phục: mỗi câu nêu tên hai trường và đưa ra cả hai cách giải. Thêm trường mà dạng cần, hoặc đổi dạng sang dạng mà trường thuộc về, hoặc xóa trường nếu nó bị sót lại sau một lần chỉnh sửa — xóa giá trị schedule: nhưng để lại khóa là dạng gây ra lỗi này thường gặp nhất.

A workload schedule: is not an expression the check accepts (Lịch của workload không phải là biểu thức mà bước kiểm tra chấp nhận)

Một workload form: scheduled mang một schedule: cho biết khi nào nó chạy, và giá trị được kiểm tra cấu trúc trước khi bất kỳ đích nào đọc nó. Có hai cách viết được chấp nhận: một trong năm macro @hourly, @daily, @weekly, @monthly và @yearly, hoặc một biểu thức crontab năm trường mà các trường chỉ dùng chữ số và các ký tự *, ,, - và /.

Những gì bước kiểm tra đọc và không đọc. Nó đếm số trường và xem các ký tự trong đó. Nó không đánh giá phạm vi, phép tính bước hay tên ngày trong tuần, nên một biểu thức năm trường có số nằm ngoài phạm vi vẫn qua được ở đây và việc từ chối thuộc về đích. Một biểu thức sáu trường có trường giây ở đầu bị từ chối: năm trường là thứ bề mặt này chấp nhận, và một đích muốn dùng giây sẽ nhận chúng theo cách khác.

Thông báo được phát ra:

workload schedule is not a valid cron expression; use a 5-field crontab expression (e.g. “0 0 * * *”) or one of @hourly, @daily, @weekly, @monthly, @yearly (schedule của workload không phải là biểu thức cron hợp lệ; hãy dùng biểu thức crontab 5 trường, ví dụ “0 0 * * *”, hoặc một trong @hourly, @daily, @weekly, @monthly, @yearly)

Điều kiện mà lỗi này được ghi nhận là schedule is not a valid cron expression, cũng là thứ mà mã ngắn của nó phân giải tới.

Cách khắc phục: trước tiên hãy đếm số trường — một schedule có bốn hoặc sáu trường là nguyên nhân phổ biến nhất, và một dấu cách lạc bên trong một trường sẽ tách nó thành hai. Thay tên ngày hoặc tháng bằng số tương ứng, và dùng macro khi có macro diễn đạt đúng ý bạn.

A workload suspend: is set on a form other than scheduled (Trường tạm dừng của workload được đặt trên một form không phải lập lịch)

suspend: true giữ lại lịch định kỳ của một workload form: scheduled: tài nguyên được lập lịch vẫn được render, và không lần chạy nào bắt đầu từ lịch của nó cho đến khi nó được tiếp tục. Không form nào khác mang lịch, nên trên bất kỳ form nào khác, trường này không có gì để giữ lại, và bản build dừng lại thay vì render một workload âm thầm bỏ qua nó. Phép kiểm tra chạy cùng các cặp form khác, trước khi bất kỳ đích nào dịch workload, và form: bị bỏ qua ở đây cũng được đọc là stateless.

Thông báo được phát ra:

workload declares suspend but is not form: scheduled; declare form: scheduled with a schedule or remove suspend (workload khai báo suspend nhưng không phải form: scheduled; hãy khai báo form: scheduled với một lịch hoặc xóa suspend)

Nó được đặt tại instance của component có workload đang được đọc, và được báo cáo như một lỗi dịch. Điều kiện mà nó được ghi nhận là suspend requires form: scheduled, cũng là thứ mà mã ngắn của nó phân giải tới.

Quy tắc chỉ áp dụng một chiều, và chỉ với true. Một workload form: scheduled không có suspend: là bình thường và chạy theo lịch của nó, còn suspend: false, giá trị mặc định, không gây ra gì trên bất kỳ form nào.

Cách khắc phục: khi workload chỉ nhằm chạy khi có người khởi động nó, hãy đặt nó là form: scheduled với một schedule: và giữ suspend: true; nếu không, giữ form như đã viết và xóa suspend:, vốn không form nào khác đọc.

A library $import: is not written in the bare-name form (Một lệnh import thư viện không được viết ở dạng tên trần)

Ba trường trên một Recipe và một FeatureRecipe có thể lấy phần thân từ một thư viện thay vì viết tại chỗ: một mục artifacts.<name>:, một valuesMapping: và một workload:. Mỗi trường viết $import: với tên trần của thư viện, sau đó là #, rồi đến đường dẫn của mục trên bề mặt mà trường đó đọc — lần lượt là #/artifacts/, #/mappings/ và #/workloads/. Một giá trị không theo dạng đó không chỉ đến thứ gì mà bản build có thể phân giải, và bị từ chối khi trường được phân giải.

Ba trường này được thiết kế có chủ ý để phản chiếu nhau, nên lỗi được báo giống nhau ở cả ba và chỉ có bề mặt thay đổi:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): "<the value as written>" (artifacts $import: không phải là tham chiếu artifact-library dạng tên trần) valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/): "<the value as written>" (valuesMapping $import: không phải là tham chiếu mapping-library dạng tên trần) workload $import: is not a bare-name workload-library reference (#/workloads/): "<the value as written>" (workload $import: không phải là tham chiếu workload-library dạng tên trần)

Một phiên bản viết bằng @ được báo kèm cách viết nên dùng thay thế, thay vì rơi xuống lời phàn nàn rằng không tìm thấy thư viện, vì đây là lỗi mà dạng này hay gặp nhất:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): version separator is ’:’, not ’@’ — use "<the corrected value>" (artifacts $import: không phải là tham chiếu artifact-library dạng tên trần: dấu phân cách phiên bản là ’:’, không phải ’@’ — hãy dùng giá trị đã sửa)

Còn một dạng nữa được báo ở đây, và đó không phải lỗi chính tả. Phần thân tệp riêng của một bundle ArtifactLibrary không được tự nó là một $import: của bundle khác: một vị trí tệp không thể mở rộng thành nhiều tệp, nên lệnh import lồng nhau bị từ chối thay vì được phân giải thành thứ mà tác giả không viết. Thay vào đó, hãy kết hợp các bundle tại nơi chúng được sử dụng.

Một mục artifacts: do chính Recipe của một component viết được quyết định trước khi bất cứ thứ gì được render, nên báo cáo được định vị tại khối artifacts: trong Recipe đó và nêu tên tham chiếu, bundle, tệp có phần thân chứa lệnh import lồng nhau, và mục nơi lệnh import được viết. Mọi tệp của bundle có dạng đó đều được báo trong một lần build; khi có nhiều hơn một, các phát hiện được nhóm dưới artifacts entries whose library import the compiler cannot resolve:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/) ("<the value as written>", bundle "<bundle>", bundle file "<filename>", artifacts entry "<key>"). a bundle file body cannot import another bundle — compose the two at the artifacts entry that consumes them (artifacts $import: không phải là tham chiếu artifact-library dạng tên trần. Phần thân tệp bundle không thể import bundle khác — hãy kết hợp hai bundle tại mục artifacts sử dụng chúng)

Một mục artifacts: do một FeatureRecipe viết báo cùng điều kiện đó khi bundle được phân giải, nêu tên tệp đầu tiên có dạng đó:

artifacts $import: is not a bare-name artifact-library reference (#/artifacts/): bundle "<bundle>" file "<filename>" body is a field-root $import: (nested library import inside a bundle file is not supported; compose at the consumption site) (artifacts $import: không phải là tham chiếu artifact-library dạng tên trần: phần thân tệp của bundle là một $import: ở gốc trường (không hỗ trợ import thư viện lồng nhau bên trong tệp bundle; hãy kết hợp tại nơi sử dụng))

Một valuesMapping: do chính Recipe của một component viết được quyết định trước khi bất cứ thứ gì được render, nên báo cáo được định vị tại khóa valuesMapping: trong Recipe đó và kèm cách viết nên dùng:

valuesMapping $import: is not a bare-name mapping-library reference (#/mappings/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/mappings/ (valuesMapping $import: không phải là tham chiếu mapping-library dạng tên trần. Hãy nêu tên thư viện và mục ở hai bên fragment)

Một valuesMapping: do một FeatureRecipe viết được báo khi tham chiếu được phân giải, theo dạng mà danh sách ở trên ghi.

Một workload: do chính Recipe của một component viết được quyết định trước khi bất cứ thứ gì được render, nên báo cáo được định vị tại khóa workload: trong Recipe đó và kèm cách viết nên dùng:

workload $import: is not a bare-name workload-library reference (#/workloads/) ("<the value as written>"). name the library and the entry either side of the fragment — write #/workloads/ (workload $import: không phải là tham chiếu workload-library dạng tên trần. Hãy nêu tên thư viện và mục ở hai bên fragment)

Một workload: do một FeatureRecipe viết được báo khi tham chiếu được phân giải, theo dạng mà danh sách ở trên ghi.

Cách khắc phục: viết lại giá trị thành <Library>#<entry-path>, chỉ thêm :<version> sau tên thư viện khi bạn cần một mức sàn cho phiên bản có thể được chọn. Kiểm tra fragment khớp với trường — một đường dẫn mục #/mappings/… trên một workload: chỉ đến một bề mặt mà trường đó không đọc, và được báo ở đây thay vì như một mục bị thiếu. Cùng dạng định danh này chi phối $ref: của một schema, mà các trường hợp từ chối được mô tả trong “A $ref: is not written in a form the compiler can resolve” ở trên.

Một $import: thư viện nêu tên một thư viện hoặc một mục mà catalog không có

Một $import: được viết đúng nhưng thứ nó trỏ tới không có ở đó. Sáu điều kiện bao quát hai nửa của một tham chiếu trên ba loại thư viện, và điều kiện bạn gặp cho biết cần xem nửa nào: bản thân thư viện vắng mặt trong những gì bản build nhìn thấy được, hoặc thư viện có ở đó nhưng không công bố mục đó.

Tập hợp mà một tham chiếu được phân giải dựa vào là catalog riêng của workspace cộng với các thư viện mà lockfile đã ghim và đưa vào khi bản build tải. Vì vậy, một thư viện mà không thứ gì trong bao đóng phụ thuộc của Release khai báo phụ thuộc vào thì không nằm trong tập hợp đó, dù tham chiếu tới nó có được viết đúng đến đâu.

Thư viện không có ở đó:

artifact-library import references an ArtifactLibrary not present in the catalog: ArtifactLibrary "<library>" (bundle "<entry>") (lệnh import artifact-library tham chiếu tới một ArtifactLibrary không có trong catalog: ArtifactLibrary (bundle)) mapping-library import references a MappingLibrary not present in the catalog: MappingLibrary "<library>" (entry "<entry>") (lệnh import mapping-library tham chiếu tới một MappingLibrary không có trong catalog: MappingLibrary (mục)) workload-library import references a WorkloadLibrary not present in the catalog: WorkloadLibrary "<library>" (entry "<entry>") (lệnh import workload-library tham chiếu tới một WorkloadLibrary không có trong catalog: WorkloadLibrary (mục))

Mục không có ở đó:

artifact-library import references a bundle not present in the ArtifactLibrary: bundle "<entry>" in ArtifactLibrary "<library>" (lệnh import artifact-library tham chiếu tới một bundle không có trong ArtifactLibrary: bundle trong ArtifactLibrary) mapping-library import references an entry not present in the MappingLibrary: entry "<entry>" in MappingLibrary "<library>" (lệnh import mapping-library tham chiếu tới một mục không có trong MappingLibrary: mục trong MappingLibrary) workload-library import references an entry not present in the WorkloadLibrary: entry "<entry>" in WorkloadLibrary "<library>" (lệnh import workload-library tham chiếu tới một mục không có trong WorkloadLibrary: mục trong WorkloadLibrary)

Một mục artifacts: do chính Recipe của một component viết báo cáo bundle bị thiếu theo một dạng riêng. Mục đó được quyết định trước khi bất cứ thứ gì được render, nên báo cáo được định vị tại khối artifacts: trong Recipe đó và nêu tên mục nơi lệnh import được viết cùng với cả hai nửa của tham chiếu:

artifact-library import references a bundle not present in the ArtifactLibrary ("<entry>", ArtifactLibrary "<library>", artifacts entry "<key>") (lệnh import artifact-library tham chiếu tới một bundle không có trong ArtifactLibrary)

Một valuesMapping: do chính Recipe của một component viết báo cáo mục bị thiếu theo một dạng riêng, với cùng lý do: nó cũng được quyết định trước khi bất cứ thứ gì được render, nên báo cáo được định vị tại khóa valuesMapping: trong Recipe đó và nêu tên cả hai nửa của tham chiếu:

mapping-library import references an entry not present in the MappingLibrary ("<entry>", MappingLibrary "<library>") (lệnh import mapping-library tham chiếu tới một mục không có trong MappingLibrary)

Một workload: do chính Recipe của một component viết báo cáo mục bị thiếu theo một dạng riêng, với cùng lý do: nó cũng được quyết định trước khi bất cứ thứ gì được render, nên báo cáo được định vị tại khóa workload: trong Recipe đó và nêu tên cả hai nửa của tham chiếu:

workload-library import references an entry not present in the WorkloadLibrary ("<entry>", WorkloadLibrary "<library>") (lệnh import workload-library tham chiếu tới một mục không có trong WorkloadLibrary)

Một mục artifacts: do một FeatureRecipe viết, một valuesMapping: hoặc một workload: do một FeatureRecipe viết, và mọi tham chiếu tới một thư viện mà bản build không nhìn thấy, đều báo cáo khi tham chiếu được phân giải, theo các dạng mà hai danh sách ở trên đưa ra.

Mỗi báo cáo đều nêu tên cả thư viện lẫn mục, bất kể nửa nào thất bại, nên chỉ một báo cáo là đủ để phân biệt thư viện bị thiếu với mục bị thiếu mà không cần mở thứ gì.

Cách khắc phục: với mục bị thiếu, hãy đối chiếu tên với những gì thư viện công bố — tên mục là một khóa trong map riêng của thư viện đó và phân biệt chữ hoa chữ thường. Với thư viện bị thiếu, tham chiếu thường đúng và chính bao đóng mới là thứ còn thiếu: hãy khai báo phụ thuộc vào thư viện đó để nó được tải, và làm mới lockfile để nó được ghim. Một thư viện truy cập được trong workspace này mà không được trong workspace khác là cùng một lỗi nhìn từ phía bên kia.

Một $import: thư viện chỉ định thư viện của nó theo vị trí registry

Một $import: thư viện nêu tên thư viện của nó theo định danh, không bao giờ theo registry mà nó tình cờ được công bố lên. Một tên được phân giải qua registry nào là cấu hình của workspace, còn phiên bản nào được dùng là câu trả lời của lockfile, nên một tham chiếu mang theo host sẽ cố định trong một tài liệu catalog hai điều mà bản build lẽ ra phải quyết định — và tài liệu khi đó ngừng hoạt động trong bất kỳ workspace nào được cấu hình khác đi.

Những chỗ một tham chiếu như vậy vẫn có thể gặp điểm dừng này hẹp hơn vẻ ngoài. Các trường $import: riêng của một Recipe và một FeatureRecipe bị từ chối sớm hơn, bởi schema của chúng, vốn không chấp nhận tiền tố registry ở bất kỳ vị trí nào trong ba vị trí. Thứ còn lại là tham chiếu mà không schema nào mô tả: một tham chiếu đọc ra từ chính phần thân của một mục thư viện, mà thực thể sử dụng nó không viết và không thể thấy cho đến khi phần thân được phân giải.

Thông báo được phát ra, từ các bề mặt valuesMapping: và workload:, nơi bộ phân giải chỉ báo cáo giá trị:

library $import: carries a registry host; reference the library by bare-name identity: "<the value as written>" ($import: thư viện mang theo một host registry; hãy tham chiếu thư viện bằng định danh tên trần)

Một mục artifacts: không gặp điểm dừng này, và lý do đáng biết nếu bạn đang tìm nó ở đó. Tham chiếu riêng của nó bị từ chối cùng với phần còn lại của tài liệu, như mọi vị trí khác; và khác với hai bề mặt còn lại, một tệp bundle có phần thân tự nó là một lệnh import sẽ bị từ chối thay vì được đi theo — nên không có phần thân nào mà một tham chiếu mang host có thể đến từ đó.

Cách khắc phục: bỏ host và mọi thứ đứng trước tên thư viện, chỉ để lại <Library>#<entry-path>. Khi giá trị gây lỗi nằm trong một thư viện bạn sử dụng chứ không phải thư viện bạn công bố, việc sửa thuộc về tác giả của thư viện đó; cho đến khi bản sửa được đưa vào, việc import một mục khác hoặc viết phần thân tại chỗ sẽ giúp bản build chạy được.

Hai đầu ra artifact của một Recipe mang cùng một tên tệp

Khối artifacts: của một Recipe đặt tên một đầu ra cho mỗi khóa, và một bundle được import tại một khóa sẽ đóng góp các tệp của nó bên dưới khóa đó. Hai đầu ra đến cùng một tên tệp đồng nghĩa với việc cái này ghi đè cái kia, nên bản build dừng lại thay vì chọn cái nào được giữ lại.

Đây là một cơ chế bảo vệ phần còn sót, và việc nói rõ điều đó là một phần bản chất của nó. Một đầu ra được đặt tên theo khóa mà nó được viết dưới, các khóa mapping là duy nhất trong một tài liệu, và bề mặt viết giới hạn một khóa ở một tên tệp duy nhất — nên hai mục được viết không thể va chạm, và một khóa cũng không thể viết ra tên lồng nhau mà bundle của khóa khác tạo ra. Điều cơ chế bảo vệ vẫn bao quát là nội dung đã đến phép chiếu mà không đi qua bước từ chối khóa trùng lặp của một tài liệu được viết: trạng thái được lắp ráp trong khi bản build chạy thay vì đọc từ một tệp. Do đó, một va chạm được báo cáo ở đây chỉ ra cách bản build được lắp ráp chứ không phải một dòng bạn có thể nhìn thấy.

Nó được nêu ra theo từng Recipe trên các đầu ra riêng của Recipe đó, và đó là điều phân biệt nó với việc hai bên đóng góp khác nhau đáp xuống cùng một đường dẫn trong một lần lắp ráp — trường hợp đó là “Two contributors write the same output path (Hai bên đóng góp ghi cùng một đường dẫn đầu ra)” ở trên, với một cách khắc phục khác.

Thông báo được phát ra:

artifacts output filename collision: two artifact outputs carry the same filename (Recipe "<recipe>", artifact output "<filename>" emitted more than once) (va chạm tên tệp đầu ra artifacts: hai đầu ra artifact mang cùng một tên tệp (Recipe, đầu ra artifact được phát ra nhiều hơn một lần))

Cách khắc phục: mở Recipe mà thông báo nêu tên và đối chiếu các khóa artifacts: của nó với các tệp mà bất kỳ bundle nào nó import đóng góp. Khi các khóa thực sự khác nhau mà va chạm vẫn còn, không có gì trong tài liệu bị lỗi và báo cáo này đáng được nêu với người duy trì bản build.

An ArtifactLibrary bundle file names no file of its own under the key it was imported at (Một tệp trong bundle của ArtifactLibrary không đặt tên cho tệp riêng nào dưới khóa mà nó được nhập vào)

Một mục artifacts: nhập một bundle sẽ mở rộng thành một đầu ra cho mỗi tệp trong bundle đó, mỗi đầu ra lồng dưới khóa mà lệnh nhập được viết tại đó. Vì vậy khóa đặt tên cho một thư mục và mọi tệp mà bundle đóng góp đều nằm bên dưới nó, dưới một tên riêng. Một tên tệp leo ra khỏi thư mục đó, chỉ đến một vị trí tuyệt đối, hoặc không chỉ đến gì cả thì không như vậy, và bản build dừng lại thay vì đặt tệp vào một nơi mà Recipe sử dụng nó chưa bao giờ chọn.

Không chỉ đến gì bao gồm mọi tên không phải là cách viết duy nhất của một tệp bên dưới khóa. . và ./, cùng một tên thu gọn trở lại chính khóa như x/.., đều chỉ đến chính khóa, nên tệp sẽ được ghi vào chỗ của thư mục khóa. Một tên có / ở cuối hoặc lặp đôi, hoặc có một phần . hay .. — x/, a//b, ./a, a/./b, a/../b — là cách viết thứ hai của một tệp mà một tên khác có thể mang: a//b bên cạnh a/b là hai tên cho một tệp, và tệp này sẽ bị ghi đè lên tệp kia mà không có xung đột nào được báo. Tên rỗng cũng bị từ chối.

Điều nó ngăn chặn là một sự sắp xếp lại âm thầm chứ không phải một lần ghi ra ngoài thư mục đầu ra. Nơi các tệp được ghi được bảo vệ thêm một lần nữa, nên một tên leo đủ xa dù sao cũng bị từ chối ở đó. Tên vượt qua được lớp bảo vệ đó là tên leo đúng một cấp: nó rơi trở lại bên trong thư mục đầu ra, tại một vị trí không ai chọn. Điều đó tệ hơn một lần ghi bị từ chối, vì mọi lớp bảo vệ xung đột trên đường đi này đọc một tên theo cách nó được ghép chứ không theo cách nó được phân giải — nên hai tệp như vậy có thể phân giải về cùng một đầu ra mà không có gì báo xung đột, và tệp nào còn lại được quyết định bởi thứ không ai viết ra.

Một bố cục lồng nhau được viết đơn giản bên trong khóa thì không bị ảnh hưởng. Một bundle có thể tự do mang các thư mục con riêng, như rbac/role.yaml, và lồng chúng dưới khóa sử dụng chính là mục đích của khóa. Một tên chỉ chứa dấu chấm bên trong một phần, như ..config hay role.v1.yaml, là một tên bình thường.

Recipe sử dụng và bundle được phát hành thường do những tác giả khác nhau viết, nên thông báo nêu cả hai nửa cùng với cách khắc phục.

Một mục artifacts: do chính Recipe của một component viết được quyết định trước khi bất cứ thứ gì được render, nên báo cáo được định vị tại khối artifacts: trong Recipe đó và nêu tệp trước, sau đó là thư viện mà nó đến từ và mục mà nó được sử dụng tại đó. Mọi tệp của bundle có tên bị từ chối đều được báo trong một bản build; khi có nhiều hơn một, các phát hiện được nhóm dưới artifacts entries whose library import the compiler cannot resolve:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under ("<filename>", ArtifactLibrary "<library>", artifacts entry "<key>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (tên tệp trong bundle của artifact-library không đặt tên cho tệp riêng bên dưới khóa artifacts mà đầu ra của nó lồng dưới đó. Hãy đổi tên tệp trong bundle của ArtifactLibrary thành một tên tệp bình thường bên dưới khóa artifacts mà nó được sử dụng tại đó, như “config.yaml” hoặc “rbac/role.yaml” — không có phần “.” hay “..”, và không có “/” ở đầu, ở cuối hoặc lặp đôi)

Một mục artifacts: do một FeatureRecipe viết báo cùng điều kiện đó khi bundle được phân giải, nêu recipe mà nó được viết trong đó và tệp đầu tiên như vậy:

artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under (Recipe "<recipe>", artifact "<key>", bundle file "<filename>"). rename the file inside the ArtifactLibrary bundle to an ordinary file name beneath the artifacts key it is consumed at, such as “config.yaml” or “rbac/role.yaml” — no ”.” or ”..” part, and no leading, trailing or doubled ”/” (tên tệp trong bundle của artifact-library không đặt tên cho tệp riêng bên dưới khóa artifacts mà đầu ra của nó lồng dưới đó. Hãy đổi tên tệp trong bundle của ArtifactLibrary thành một tên tệp bình thường bên dưới khóa artifacts mà nó được sử dụng tại đó, như “config.yaml” hoặc “rbac/role.yaml” — không có phần “.” hay “..”, và không có “/” ở đầu, ở cuối hoặc lặp đôi)

Cách khắc phục: đổi tên tệp bên trong ArtifactLibrary thành một tên tệp bình thường bên dưới khóa. Khi thư viện không phải của bạn, việc nhập một bundle khác hoặc viết trực tiếp mục đó tại chỗ sẽ giúp bản build chạy được trong khi bản sửa được thực hiện ở upstream. Một tệp cần nằm ở một nơi hoàn toàn khác là một mục artifacts: thứ hai tại khóa mà nó thuộc về, chứ không phải một tên đi đến đó.

An imported artifact no longer matches the digest recorded beside its Recipe (Một artifact được nhập không còn khớp với digest được ghi bên cạnh Recipe của nó)

Một mục artifacts: nhập một tệp cục bộ có nội dung được ghim khi Recipe được ghim — bằng aggrega pin, hoặc bằng một lần pull hay push được yêu cầu chạy cùng bước đó: digest của các byte trong tệp được ghi vào entity.lock bên cạnh Recipe. Một mục trong boundary.artifacts: của Recipe được ghim và so sánh theo cùng cách, được ghi dưới boundary/<key>, là tên mà thông báo dùng cho nó. Mọi bản build đọc lại tệp, tính digest lại, và từ chối sự không khớp — nên một tệp bị sửa sau khi đã ghim không bao giờ được render như thể nó đã được kiểm tra. aggrega pull --verify thực hiện cùng phép so sánh và báo sự không khớp bằng cùng thông báo.

Thứ được so sánh là nội dung của mục, không phải thứ mà việc render nó tạo ra. Phần thân của một artifact là một template, và việc đánh giá nó thay thế các giá trị khác nhau theo từng instance của component, nên một digest trên đầu ra sẽ không khớp với mọi instance có giá trị khác nhau. Nội dung được ghi lại là cùng một văn bản cho mọi instance gắn với Recipe, và đó là điều khiến một digest được ghi lại là thứ đúng để so sánh.

Một Recipe chưa ai ghim thì không có pin bên cạnh, và bản build không so sánh nó. Đối với bản build, việc không có pin không phải là sự không khớp; nó có nghĩa là không có gì để so sánh. Thay vào đó, một lần pull trên Recipe như vậy sẽ dừng lại, như An entity reads an input the lock beside it records no pin for (Một entity đọc một đầu vào mà lock bên cạnh không ghi pin nào) mô tả. Một lockfile được ghi trước khi tệp bị sửa sẽ báo trước, vì hàng của entity cũng bao gồm tệp được nhập, như A local source no longer matches the pins recorded beside its Recipe (Một nguồn cục bộ không còn khớp với các pin được ghi bên cạnh Recipe của nó) trình bày, nơi cùng mục đó cho biết khi nào phép so sánh này là phép mà bản build gặp phải.

Ba bề mặt thực hiện cùng phép kiểm tra trên các tài liệu khác nhau — Recipe riêng của một component, một Feature gắn vào một component, và một Feature gắn vào một boundary — nên nội dung của FeatureRecipe được đối chiếu với digest được ghi bên cạnh FeatureRecipe chứ không phải bên cạnh Recipe của component chủ. Trên hai bề mặt gắn kết, thông báo cũng nêu attachment, và đó là điều cho biết cần mở tài liệu nào.

Các thông báo được phát ra:

imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (nội dung artifact được nhập không khớp với digest được ghi cho nó trong entity.lock. Nếu tệp được thay đổi có chủ đích, hãy chạy lệnh trên entity nhập nó để ghi digest mới; nếu không, hãy khôi phục tệp) imported artifact content does not match the digest recorded for it in entity.lock ("<artifact>", imported file "<path>", its content digests to "<digest>", the recorded pin is "<digest>", attachment "<attachment>"). If the file was changed on purpose, run aggrega pin on the entity that imports it to record its new digest; otherwise restore the file (nội dung artifact được nhập không khớp với digest được ghi cho nó trong entity.lock. Nếu tệp được thay đổi có chủ đích, hãy chạy lệnh trên entity nhập nó để ghi digest mới; nếu không, hãy khôi phục tệp)

Cách khắc phục: có hai câu trả lời, và câu nào đúng tùy thuộc vào việc chỉnh sửa có chủ đích hay không. Nếu có, hãy chạy aggrega pin trên Recipe để pin được lấy lại từ các byte hiện tại của tệp, và commit entity.lock mà nó ghi lại. Nếu không, hãy khôi phục tệp — digest được ghi là bản ghi của các byte đã được ghim, và một bản build render tệp đã thay đổi sẽ phát hành nội dung mà không gì đã xác minh.

A local source no longer matches the pins recorded beside its Recipe (Nguồn cục bộ không còn khớp với các pin được ghi bên cạnh Recipe của nó)

Một Recipe hoặc FeatureRecipe có source: chỉ tới một thư mục hoặc một tệp nằm bên cạnh nó sẽ được pin nguồn đó khi thực thể được pin — bằng aggrega pin, hoặc bằng một lệnh pull hay push được yêu cầu chạy cùng bước đó. Tệp entity.lock bên cạnh thực thể ghi một digest cho mỗi tệp mà nguồn đóng góp vào nội dung một bản phát hành của thực thể mang theo, với khóa là đường dẫn của tệp. Khi lock đã ghi chúng, mỗi lần build sẽ so sánh nguồn ở trạng thái hiện tại với các pin đó trước khi provider đọc nó, và từ chối nếu có sự khác biệt — nhờ vậy một chart hay một module bị sửa sau khi được pin không bao giờ được render như thể nó đã được kiểm tra. aggrega pull --verify thực hiện cùng phép so sánh và báo cáo sự khác biệt bằng cùng thông báo. Một lần build nêu tên thể hiện component mà nó đang phân giải nguồn, cùng tài liệu Recipe bên dưới nó.

Nguồn được so sánh như một tập hợp tệp. Một tệp có nội dung thay đổi, một tệp được thêm vào nguồn và một tệp bị xóa khỏi nguồn đều làm thay đổi thứ mà thực thể render từ đó, nên mỗi trường hợp đều được báo cáo, kèm digest hiện tại của tệp và digest được ghi cho nó. Một tệp bên cạnh thực thể mà nguồn không đóng góp — một ghi chú hay một README cạnh Recipe — không được so sánh. Một nguồn được viết dưới dạng template, chẳng hạn ./charts/{{ .values.flavour }}, đóng góp mọi tệp trong thư mục của thực thể, vì thư mục mà nó chỉ tới do từng Release quyết định; với dạng này, một chỉnh sửa ở bất kỳ tệp nào trong thư mục đều được báo cáo.

Một Recipe có lock không ghi pin nào cho nguồn của nó thì không có gì để một lần build so sánh. Lần build không từ chối nó; một lệnh pull hoặc push không pin thì từ chối, như An entity reads an input the lock beside it records no pin for (Một thực thể đọc một đầu vào mà lock bên cạnh không ghi pin nào) mô tả. Các pin mà lock vẫn ghi cho một nguồn cục bộ mà Recipe không còn khai báo không pin thứ gì nó đọc, nên chúng không được so sánh với gì cả. Một Recipe được lệnh pull phân giải từ registry thì thay vào đó được bảo đảm bởi digest mà lockfile ghi cho những gì bản phát hành của nó mang theo.

Một lockfile được ghi trước thay đổi sẽ báo cáo trước. Lockfile ghi thực thể theo những gì nó mang theo, và các tệp của nguồn là một phần trong đó, nên một lần build hoặc aggrega pull --verify giữ lockfile được ghi trước khi một tệp thay đổi sẽ dừng trước khi phép so sánh này chạy, với The lockfile no longer matches what the release resolves to (Lockfile không còn khớp với kết quả phân giải của release) nêu tên thực thể và cả hai digest. Một lệnh aggrega pull thông thường nêu tên tệp đã thay đổi, với An entity reads an input the lock beside it records no pin for (Một thực thể đọc một đầu vào mà lock bên cạnh không ghi pin nào). Điều tương tự áp dụng cho một tệp được import. Khi lockfile không có mục riêng của thực thể, phép so sánh này là thứ mà một lần build và một lệnh pull có kiểm tra gặp phải: một Recipe hoặc FeatureRecipe mà Manifest gọi bằng một tham chiếu cũng là tên của một Component hoặc Feature mà Release tiếp cận sẽ được ghi dưới tham chiếu đó như là Component hoặc Feature, nên không có gì trong lockfile thay đổi khi các tệp của Recipe thay đổi.

Các thông báo được phát ra:

the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (các tệp của nguồn cục bộ của thực thể không khớp với các pin được ghi cho chúng trong entity.lock (digest của tệp khác với pin đã ghi). Nếu nguồn được thay đổi có chủ đích, hãy chạy aggrega pin trên thực thể để ghi lại các tệp của nó; nếu không, hãy khôi phục các tệp) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> digests to <digest> and no pin is recorded for it). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (các tệp của nguồn cục bộ của thực thể không khớp với các pin được ghi cho chúng trong entity.lock (tệp có digest nhưng không có pin nào được ghi cho nó). Nếu nguồn được thay đổi có chủ đích, hãy chạy aggrega pin trên thực thể để ghi lại các tệp của nó; nếu không, hãy khôi phục các tệp) the files of the entity’s local source do not match the pins recorded for them in entity.lock (file <path> is no longer in the source and its recorded pin is <digest>). If the source was changed on purpose, run aggrega pin on the entity to record its files again; otherwise restore the files (các tệp của nguồn cục bộ của thực thể không khớp với các pin được ghi cho chúng trong entity.lock (tệp không còn trong nguồn nhưng vẫn có pin được ghi). Nếu nguồn được thay đổi có chủ đích, hãy chạy aggrega pin trên thực thể để ghi lại các tệp của nó; nếu không, hãy khôi phục các tệp)

Cách khắc phục: cũng như với tệp được import, có hai cách, và cách nào đúng phụ thuộc vào việc thay đổi có chủ đích hay không. Nếu có, hãy chạy aggrega pin trên Recipe để các tệp nguồn của nó được pin lại, rồi commit tệp entity.lock mà lệnh ghi lại. Nếu không, hãy khôi phục các tệp mà thông báo nêu tên.

Mọi tệp mà một bản phát hành của thực thể mang theo đều được đọc từ thư mục riêng của thực thể, và một liên kết tượng trưng ở đó bị từ chối thay vì được đi theo. Đi theo nó sẽ phát hành các byte mà nó trỏ tới dưới tên của chính liên kết — từ bất cứ nơi nào nó trỏ tới, kể cả bên ngoài thư mục của thực thể — vào một artifact mà sau đó được tính digest và, khi có áp dụng ký, được ký. Bỏ qua nó thì lại phát hành một artifact có nội dung âm thầm khác với thư mục của bạn. Vì vậy mọi dạng liên kết đều bị từ chối như nhau: liên kết tới một tệp, liên kết tới một thư mục, liên kết không trỏ tới đâu, liên kết trỏ tới chính nó, và hai liên kết trỏ lẫn nhau.

Việc từ chối được thực hiện ở bất cứ nơi nào các tệp của thực thể được đọc: bởi aggrega pin, bởi một lần phát hành trước khi đóng gói bất cứ thứ gì (kể cả chạy thử), bởi một lệnh pull và một lệnh pull có kiểm tra khi đối chiếu entity.lock với các tệp của thực thể, bởi một lần build khi so sánh một nguồn cục bộ với các pin của nó, và bởi một lần render khi đọc một thư mục nguồn cục bộ trước khi giao bất kỳ phần nào cho provider. Thông báo nêu tên liên kết theo đường dẫn của nó bên cạnh tài liệu thực thể, và chẩn đoán được đặt tại chính liên kết đó.

Một liên kết bị các quy tắc bỏ qua của bạn loại ra thì không phải là tệp mà thực thể mang theo, nên nó được bỏ qua như mọi tệp khác bị các quy tắc đó loại ra, và không bao giờ được đi theo. Các quy tắc đó là những quy tắc được ghi trong entity.lock khi thực thể được pin, nên một dòng bạn thêm vào .aggregaignore chỉ có hiệu lực khi bạn pin lại thực thể.

Thông báo được phát ra:

a symbolic link sits among the files an entity carries (<path>). remediation: replace the link with a copy of what it points to, placed inside the entity’s own directory. A link met inside a source directory can instead be left out with a line in the .aggregaignore beside the entity, which takes effect when the entity is pinned again. A link is refused rather than followed because the bytes it points to would travel under the link’s name, from wherever it points (một liên kết tượng trưng nằm giữa các tệp mà thực thể mang theo. cách khắc phục: thay liên kết bằng một bản sao của thứ nó trỏ tới, đặt bên trong thư mục riêng của thực thể. Một liên kết gặp trong thư mục nguồn có thể được loại ra bằng một dòng trong .aggregaignore bên cạnh thực thể, có hiệu lực khi thực thể được pin lại. Liên kết bị từ chối thay vì được đi theo vì các byte nó trỏ tới sẽ đi kèm dưới tên của liên kết, từ bất cứ nơi nào nó trỏ tới)

Cách khắc phục: nếu thực thể cần thứ mà liên kết trỏ tới, hãy thay liên kết bằng một bản sao của nó bên trong thư mục của thực thể, rồi pin lại thực thể. Nếu liên kết ở đó chỉ để thuận tiện cho bạn và thực thể không đọc nó, hãy thêm đường dẫn của nó vào .aggregaignore bên cạnh tài liệu thực thể rồi pin lại. Các tệp được phát hành cùng một thực thể mô tả các quy tắc quyết định những gì một thực thể mang theo.

An entity reads an input the lock beside it records no pin for (Một thực thể đọc một đầu vào mà tệp khóa bên cạnh nó không ghi lại pin nào)

Một Recipe hoặc FeatureRecipe có thể phụ thuộc vào các byte nằm ngoài tài liệu của chính nó: một source: từ xa có tọa độ được viết đầy đủ, một tệp mà một mục artifacts nhập bằng $import, và các tệp của một source: chỉ đến một thư mục hoặc một tệp bên cạnh nó. Pin cho mỗi đầu vào được ghi trong entity.lock bên cạnh thực thể, và việc ghi nó là bước của tác giả thực thể, aggrega pin. Vì vậy một lần pull không tự ghi các pin đó: với một thực thể trong một thư mục catalog của bạn mà Release xây dựng, nó so sánh những gì bước đó sẽ ghi với những gì tệp khóa đang giữ, và dừng lại khi tệp khóa thiếu một pin — hoặc giữ một pin mà đầu vào không còn khớp — thay vì ghi vào thư mục của tác giả khi không được yêu cầu. Một lần build tự điền lockfile của nó là một lần pull và dừng lại theo cùng cách.

Một lần push dừng lại trên cùng phép so sánh, với một thực thể duy nhất mà nó sắp xuất bản. Trước khi bundle được dựng, và trước khi liên hệ với bất kỳ registry nào, nó so sánh những gì bước đó sẽ ghi cho thực thể với tệp khóa bên cạnh nó, và từ chối theo cùng cách — kể cả khi chạy thử — trừ khi lần push được yêu cầu tự chạy bước đó. Phần gợi ý ở cuối thông báo khác nhau giữa hai lệnh, vì mỗi lệnh có cách riêng để ghi các pin; nội dung được báo cáo thì không khác.

Một nguồn cục bộ được đối chiếu với các pin của nó như một tập tệp duy nhất. Khi tệp khóa không ghi pin nào trong số đó, mỗi tệp mà nguồn đóng góp được báo cáo ở đây là bị thiếu. Khi tệp khóa có ghi, một tệp được thêm sau khi pin được báo cáo là bị thiếu, còn một tệp bị thay đổi hoặc bị xóa được báo cáo là một pin mà đầu vào không còn khớp, và một lần build báo cáo cùng thay đổi đó như A local source no longer matches the pins recorded beside its Recipe (Một nguồn cục bộ không còn khớp với các pin được ghi bên cạnh Recipe của nó). Các pin mà tệp khóa vẫn ghi cho một nguồn cục bộ mà Recipe không còn khai báo — source: của nó đã bị xóa, hoặc giờ chỉ đến một artifact từ xa — không ghim gì mà Recipe đọc, nên chúng không làm dừng pull, push, pull xác minh hay build; lần aggrega pin kế tiếp sẽ loại bỏ chúng.

Thông báo nêu tên mọi đầu vào bị thiếu, theo loại. Mỗi đầu vào là một remote source, được nêu bằng url và phiên bản mà nó được phân giải đến, một imported file, được nêu bằng khóa artifacts sử dụng nó, hoặc một local source file, được nêu bằng đường dẫn của nó bên cạnh thực thể — để bạn biết cần pin một nguồn hay một tệp. Mọi thực thể như vậy trong Release đều được báo cáo trong một lần chạy.

Một thực thể được phân giải từ một registry không bao giờ bị một lần pull đối chiếu theo cách này, vì lần xuất bản của nó đã bị đối chiếu rồi. Nó nằm trong bộ nhớ đệm nội dung thay vì trong một thư mục do bạn soạn, nên một lần pull không đọc cũng không ghi tệp khóa bên cạnh nó, và các nguồn của nó được đối chiếu với lockfile của Release. Một thực thể được xuất bản bằng aggrega push đã bị từ chối khi xuất bản trừ khi tệp khóa của nó ghi mọi pin mà bước đó sẽ ghi cho nó lúc ấy, và tệp khóa đó đi kèm bên trong bundle được xuất bản.

Các thông báo được phát ra, từ một lần pull và từ một lần push:

an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded, imported file <key>: the recorded pin no longer matches it). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have every pull in this workspace record the pins itself instead, set pin_sources_at_pull: true in the workspace configuration (một đầu vào mà thực thể đọc không có pin nào được ghi cho nó trong entity.lock bên cạnh nó (Recipe, nguồn từ xa: không có pin nào được ghi, tệp được nhập: pin đã ghi không còn khớp). khắc phục: chạy aggrega pin và commit entity.lock mà nó ghi bên cạnh thực thể; để mọi lần pull trong workspace này tự ghi các pin, hãy đặt tùy chọn tương ứng trong cấu hình workspace) an input the entity reads has no pin recorded for it in the entity.lock beside it (Recipe "<name>", remote source <url>@<version>: no pin recorded). remediation: run aggrega pin <entity-path> and commit the entity.lock it writes beside the entity; to have this publication record the pins itself instead, re-run it with --pin-sources; to have every publication in this workspace record them, set pin_sources_at_push: true in the workspace configuration (một đầu vào mà thực thể đọc không có pin nào được ghi cho nó trong entity.lock bên cạnh nó (Recipe, nguồn từ xa: không có pin nào được ghi). khắc phục: chạy aggrega pin và commit entity.lock mà nó ghi bên cạnh thực thể; để lần xuất bản này tự ghi các pin, hãy chạy lại với tùy chọn tương ứng; để mọi lần xuất bản trong workspace này ghi chúng, hãy đặt tùy chọn tương ứng trong cấu hình workspace)

Mệnh đề giữa trong thông báo của lần xuất bản nêu những gì giao diện mà bạn xuất bản từ đó chấp nhận: --pin-sources tại terminal, trường pinSources trên daemon, và đối số pin_sources cho công cụ trợ lý.

Cách khắc phục: nếu thực thể là của bạn, hãy chạy aggrega pin trên nó và commit entity.lock mà lệnh ghi ra, rồi pull hoặc push lại — hoặc push với --pin-sources, tùy chọn này chạy bước đó trước khi bundle được dựng. Nếu nó là của người khác — một catalog bạn sử dụng từ một thư mục riêng của nó — thì người xuất bản chưa pin nó; hãy đặt pin_sources_at_pull: true trong cấu hình workspace của bạn để mọi lần pull tự ghi các pin, hoặc truyền --pin-sources cho một lần pull. aggrega pin mô tả đầy đủ bước này.

A provides: template could not be evaluated (Không thể đánh giá một template provides)

Một mục provides: là một template tạo ra giá trị mà một component khác đọc qua một kết nối phụ thuộc. Điều kiện này là những gì một mục không thể đánh giá báo cáo: một template không phân tích cú pháp được, một hàm mà nó gọi nhưng giao diện này không đăng ký, một tham chiếu đi xuống qua thứ mà ngữ cảnh render không cung cấp, hoặc một lần đọc index với một khóa mà map không chứa.

Nó khác với hai lần từ chối chạy trước khi đánh giá trên cùng khối — một tham chiếu đến một gốc nằm ngoài tập tự chứa, và một tham chiếu mà thứ tự soạn của chính khối từ chối — cả hai đều được mô tả ở trên. Những lần từ chối đó nêu biểu thức cần thay đổi; điều kiện này mang theo bất cứ điều gì mà chính quá trình đánh giá báo cáo, đó là lý do mục được nêu tên bên cạnh.

Thông báo được phát ra, nêu tên instance của component, mục bên trong khối, và những gì quá trình đánh giá báo cáo:

provides template evaluation failed (node "<instance>", provides["<key>"], <what the evaluation reported>) (đánh giá template provides thất bại (node, provides[], những gì quá trình đánh giá báo cáo))

Phần đầu mang mã của điều kiện này, E0056, bất kể quá trình đánh giá đã báo cáo gì. Khi quá trình đánh giá dừng ở một điều kiện dừng của chính nó — thường gặp nhất là một lần đọc index với khóa mà map không chứa — điều kiện đó được báo cáo bên dưới điều kiện này chứ không thay thế nó: dưới caused by (2):, câu của điều kiện này đứng trước và báo cáo riêng của quá trình đánh giá đứng sau, kèm theo câu của nó. Vì vậy, người đọc đối chiếu theo mã sẽ gắn mọi mục provides: thất bại với E0056, và đọc nguyên nhân khiến quá trình đánh giá thất bại từ điều kiện bên dưới, mà câu của nó ứng với mã riêng của nó trong bảng mọi điều kiện — E0327 cho khóa vắng mặt.

Cách khắc phục: mở khối provides: của Recipe tại khóa mà thông báo nêu và đọc lý do được báo cáo — nó thường nêu một vị trí phân tích cú pháp hoặc một hàm. Cách xử lý khóa bị thiếu trên giao diện này render một khóa cuối vắng mặt thành rỗng thay vì thất bại, nên một lỗi ở đây là lỗi cấu trúc: một template không phân tích cú pháp được, một tham chiếu đi xuống qua một container chưa từng được cung cấp, hoặc một lần đọc index với một khóa mà map không chứa, như lý do được báo cáo nêu. Khi giá trị thực sự là tùy chọn, hãy đọc nó qua helper optional thay vì đi xuống vào thứ có thể không tồn tại.

A Recipe or FeatureRecipe does not publish a provides key its contract declares (Một Recipe hoặc FeatureRecipe không công bố một khóa mà hợp đồng của nó khai báo)

Một Component và một Feature đều khai báo, dưới schema.provides, các khóa mà bất cứ thứ gì gắn kết với chúng sẽ công bố — hợp đồng đầu ra mà bên tiêu thụ dựa vào để viết các kết nối của mình. Recipe gắn với một Component và FeatureRecipe gắn với một Feature phải tạo ra mọi khóa mà hợp đồng đó nêu. Recipe nào không làm vậy sẽ bị từ chối, vì nếu không, khóa bị thiếu sẽ không cung cấp gì cả: tham chiếu của bên tiêu thụ sẽ đến dưới dạng một biến chưa được đặt, một đối số rỗng, hoặc một tệp không tồn tại, mà không có lời giải thích nào.

Hợp đồng chỉ là sự hiện diện của khóa, không hơn. Mọi khóa được khai báo phải xuất hiện; các khóa thừa được cho phép. Bản thân các giá trị không bao giờ được kiểm tra — chúng là các con trỏ mờ được truyền dưới dạng chuỗi, nên các kiểu mà một hợp đồng khai báo vẫn chỉ là lời tuyên bố với bên tiêu thụ chứ không phải một phép kiểm tra mà bản dựng thực hiện.

Mọi chỗ thiếu đều được báo cáo. Một Recipe thiếu ba khóa sẽ tạo ra ba phát hiện, mỗi phát hiện được định vị tại mục riêng của nó trong khối provides: của Recipe đó, nên cả ba được sửa chỉ sau một lần dựng. Thông báo nêu khóa bị thiếu, kiểu có hợp đồng khai báo khóa đó, và instance mà Recipe được gắn vào — điều cuối cùng giúp phân biệt hai phát hiện khi một Recipe phục vụ nhiều instance của cùng một kiểu.

Thông báo được phát ra:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares ("<key>", declared by component type "<type>", bound to component instance "<instance>") (Recipe hoặc FeatureRecipe không công bố một khóa provides mà hợp đồng schema.provides của thực thể trừu tượng của nó khai báo; được khai báo bởi kiểu component, gắn với instance component)

Cặp Feature và FeatureRecipe báo cáo cùng điều kiện này thông qua quá trình phân giải riêng của attachment, nêu tên cặp và khóa:

Recipe or FeatureRecipe does not publish a provides key its abstract entity’s schema.provides contract declares (<attachment context>, <the FeatureRecipe> does not publish provides key "<key>" declared by <the Feature>’s schema.provides contract) (Recipe hoặc FeatureRecipe không công bố một khóa provides mà hợp đồng schema.provides của thực thể trừu tượng của nó khai báo; FeatureRecipe không công bố khóa provides được khai báo bởi hợp đồng schema.provides của Feature)

Ở đó, nó báo cáo khóa bị thiếu đầu tiên theo thứ tự đã sắp xếp rồi dừng, nên cặp đó nêu một khóa mỗi lần dựng, trong khi cặp Component nêu tất cả. Dù theo cách nào, các khóa đều được duyệt theo thứ tự đã sắp xếp, điều này khiến cả hai giống nhau giữa các lần chạy.

Cách khắc phục: thêm khóa còn thiếu vào khối provides: của Recipe hoặc FeatureRecipe, hoặc xóa nó khỏi schema.provides của Component hoặc Feature nếu không có gì được kỳ vọng sẽ công bố nó. Một khóa có template kết xuất ra rỗng vẫn được công bố, với chuỗi rỗng làm giá trị, nên một mục có mặt nhưng rỗng vẫn thỏa mãn hợp đồng và không báo lỗi ở đây. Nếu một giá trị rỗng phải dừng bản dựng, hãy từ chối nó trong một assertion: các assertion của một Recipe đọc các giá trị provides: đã được phân giải của nó.

Một assertion đã dừng bản dựng

Một Component, Feature, Recipe hoặc FeatureRecipe có thể mang assertions: — các template có tên với mục đích từ chối một đầu vào thay vì tạo ra văn bản. Một assertion gọi fail, và việc gọi nó là điều làm dừng bản dựng; đối số là thông báo mà tác giả viết cho bất kỳ ai gặp phải nó.

Các assertion được đánh giá tại hai thời điểm, để một quy tắc đọc đúng trạng thái mà nó liên quan: các assertion trên một Component hoặc Feature chạy khi catalog đã được phân giải và trước khi bất cứ thứ gì được kết xuất, còn các assertion trên một Recipe hoặc FeatureRecipe chạy khi việc gắn kết đã được xác lập và trước khi việc gắn kết đó được kết xuất.

Một tham chiếu tới một khóa không có gì cung cấp cũng báo cáo ở đây. Bề mặt này đánh giá với cách xử lý khóa thiếu nghiêm ngặt, chính là để một vị từ có tham chiếu kết xuất thành rỗng không thể so sánh với hư không rồi lặng lẽ vượt qua — nếu không, một lỗi gõ duy nhất sẽ vô hiệu hóa quy tắc mà assertion được viết ra để thực thi. Đây là lý do một default đơn thuần không cung cấp giá trị dự phòng trên bề mặt này: tham chiếu trần dừng việc đánh giá trước khi giá trị dự phòng kịp chạy. Hãy chặn tham chiếu bằng hasKey, hoặc dùng helper optional; đọc nó qua index cũng dừng, nêu tên khóa, như “A template indexes a map with a key the map does not hold” mô tả.

Thông báo được phát ra, nêu loại và kiểu thực thể, instance và assertion, rồi mang theo thông báo mà chính assertion đã viết:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <fail …>: error calling fail: assertion failed: <the message the assertion wrote> (lỗi khi gọi fail: assertion thất bại)

và đối với một khóa mà không gì cung cấp, câu của template engine theo sau câu riêng của điều kiện:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>": assertion failed: template: <kind>/<type>/<instance>/<name>:<line>:<column>: executing "<kind>/<type>/<instance>/<name>" at <.reference>: map has no entry for key "<key>" (assertion thất bại: khi chạy template, map không có mục nào cho khóa đó)

và khi việc đánh giá thất bại chứ không phải vị từ:

<entity-kind> "<type>" instance "<instance>" assertion "<name>": assertion "<kind>/<type>/<instance>/<name>" parse: <what the parse reported> (lỗi phân tích cú pháp)

Một giá trị được khai báo là nhạy cảm không xuất hiện trong thông báo. Khi assertion đọc một giá trị như vậy và gọi fail với câu của nó được viết trọn thành một chuỗi duy nhất trong dấu ngoặc kép — fail "…", không có gì được truyền qua pipe vào nó và không có gì được ghép lại — thông báo mang câu đó đúng như được viết, bất kể giá trị chứa gì, vì câu đó không trích dẫn bất cứ thứ gì assertion đã đọc. Khi thông báo của nó trích dẫn giá trị, thông báo sẽ hiển thị <redacted> ở vị trí của giá trị. Khi thông báo được ghép theo bất kỳ cách nào khác và điều assertion làm phụ thuộc vào nội dung của giá trị, phần thông báo sau biểu thức thất bại được thay bằng failure text withheld: this template reads a value declared sensitive, and the failure depends on what that value holds; việc dừng và mã của nó không thay đổi. Điều gì được tính là đã khai báo, và những sự từ chối nào nằm ngoài điều này, có tại vocabulary/compact-form-authoring.md “What a refusal says about a declared value”.

Khi được kiểm tra riêng lẻ, một thực thể báo cáo một assertion thất bại dưới dạng cảnh báo. aggrega validate khi nhận tệp của một Recipe, phép kiểm tra tệp đó của trình soạn thảo qua aggrega serve, và công cụ validate của aggrega mcp khi nhận một entity đều dựng Recipe quanh các giá trị giữ chỗ và giá trị mặc định của schema thay vì các giá trị mà một Release đặt, nên chúng không thể phân biệt một assertion đang chờ một Release với một assertion bị hỏng. Ở đó, một assertion gọi fail — của chính Recipe, hoặc một assertion mà Component nó triển khai khai báo — được báo cáo dưới dạng cảnh báo mang thông báo ở trên, kết thúc bằng câu A Release must satisfy this assertion before a build of it can pass., và phép kiểm tra vượt qua. Một tham chiếu tới một khóa không có gì cung cấp và một assertion không phân tích được không phải là assertion thất bại: mỗi trường hợp là một lỗi trong chính văn bản của assertion, và phép kiểm tra đó đánh giá nó như mọi lỗi khác. Một bản dựng luôn có một Release, và dừng khi gặp assertion như được mô tả ở đây; xem một assertion thất bại là một cảnh báo.

Cách khắc phục: thông báo sau dấu hai chấm cuối cùng là của tác giả assertion, và chính nó cho biết cần thay đổi gì — một assertion được viết sao cho khi gặp nó, bạn biết câu trả lời. Khi báo cáo là một khóa bị thiếu thay vì câu của tác giả, thì chính assertion có lỗi: hãy sửa tham chiếu, hoặc bảo vệ nó như mô tả ở trên. Khi quy tắc không nên áp dụng cho Release này, đó là vấn đề về thực thể mang assertion chứ không phải về tệp của riêng bạn.

A pipeline step addresses documents the node does not have (Một bước pipeline trỏ tới các tài liệu mà node không có)

Một bước pipeline trỏ tới một tài liệu bằng một phạm vi và một khóa. Ba điều kiện bao quát các cách một địa chỉ không trỏ tới gì, và mỗi điều kiện dừng bản build thay vì để một bước báo thành công cho một chỉnh sửa chưa bao giờ xảy ra.

Node không phát ra tài liệu đó. Một patch nêu một cặp phạm vi và khóa không nằm trong số các tài liệu mà node này tạo ra:

node "<instance>": pipeline PATCH targets a document the node did not emit (PATCH của pipeline nhắm tới một tài liệu mà node không phát ra)

Không có host để trỏ tới. Một bước tìm tới các tài liệu của một component host tại một vị trí không đứng đối diện component nào — pipeline riêng của một component, có phạm vi duy nhất là đầu ra của chính nó, hoặc một Feature được gắn vào một boundary thay vì vào một component. Phạm vi host rỗng ở bất cứ đâu một pipeline như vậy chạy, nên một địa chỉ trỏ vào đó không phân giải được tới gì:

node "<instance>": pipeline /host operation from a step with no host component (thao tác /host của pipeline từ một bước không có component host)

Tài liệu không có cây để trỏ tới. Một số đơn vị không có cấu trúc mà một đường dẫn có thể trỏ vào — một phần thân nhị phân, văn bản tự do, một vùng mà đích không thể duyệt an toàn. Một đơn vị như vậy vẫn được giao cho bước để có thể được chọn và phát ra nguyên vẹn; điều không thể làm với nó là patch:

node "<instance>": pipeline PATCH target is not parseable structured YAML/JSON (đích PATCH của pipeline không phải YAML/JSON có cấu trúc phân tích được) pipeline PATCH target is not parseable structured YAML/JSON (node "<instance>", document "<key>") (đích PATCH của pipeline không phải YAML/JSON có cấu trúc phân tích được)

Mỗi điều kiện đi kèm mô tả của chính quá trình duyệt về địa chỉ bên dưới nó, và mỗi điều kiện được định vị tại instance component có pipeline tạo ra nó.

Hai trong ba điều kiện còn được báo trước bất kỳ lần duyệt nào. Việc một vị trí có tài liệu host hay không được suy ra từ nơi pipeline được viết, nên một bước khai báo rằng nó thao tác trên tài liệu host tại một vị trí không có tài liệu nào như vậy sẽ được nêu ra ngay khi bản build biết mọi plugin khai báo gì, không cần chờ một node render — và một Feature gắn vào một boundary được nêu cùng với bước đó:

pipeline /host operation from a step with no host component (thao tác /host của pipeline từ một bước không có component host) pipeline /host operation from a step with no host component ("<attachment>") (thao tác /host của pipeline từ một bước không có component host)

Hai cách đọc này là sự phân chia của một điều kiện chứ không phải cùng một phát hiện hai lần: điều mà một khai báo có thể xác định thì được xác định từ khai báo, và điều mà chỉ lần chạy mới thấy được thì để cho lần chạy — một bước khai báo phạm vi riêng của nó vẫn có thể trả về một thao tác nhắm vào phạm vi khác.

Ba điều kiện này là dạng dừng build của các từ chối về địa chỉ mà chính quá trình duyệt pipeline báo cáo, được mô tả ở mục “A pipeline patch addresses a document the set does not hold, or one with no tree to address (Một patch pipeline trỏ tới một tài liệu mà tập không có, hoặc một tài liệu không có cây để trỏ tới)” ở trên.

Cách khắc phục: cả ba đều thuộc về tác giả của bước chứ không phải của bạn. Với một đích không tồn tại, hãy patch một tài liệu mà node thực sự phát ra, hoặc phát ra tài liệu bạn muốn ở một bước trước và patch nó ở một bước sau — một bước có thể đọc những khóa nào nó được giao. Với host bị thiếu, hãy chuyển bước tới một vị trí đứng đối diện một component host, thay vào đó trỏ tới các tài liệu của chính vị trí đó, hoặc bỏ bước đi. Với một đơn vị không có cây, hãy thay patch bằng một lệnh emit toàn bộ đơn vị: một phần thân không trong suốt được thay thế chứ không được chỉnh sửa.

A pipeline patch addresses output that has not been assembled yet (Một patch pipeline trỏ tới đầu ra chưa được lắp ráp)

Một số provider gộp đầu ra theo từng node của một nhóm dispatch thành một tài liệu — một tệp compose đã hợp nhất, một umbrella chart. Cho tới khi việc hợp nhất đó xảy ra, không có tài liệu riêng rẽ nào, chỉ có các mảnh, nên một patch trỏ tới một tài liệu không có gì để trỏ vào. Vì vậy, một pipeline nhắm vào component như thế được hoãn toàn bộ và chạy lại khi việc hợp nhất đã tạo ra các tài liệu; đây là đường đi thông thường và không đòi hỏi gì từ tác giả.

Điều kiện này là thứ tới được bản build khi một patch vẫn đến một mảnh. Trường hợp nó nêu là đầu ra riêng của một Feature được gắn. Khi provider của component gộp nhóm của nó, toàn bộ pipeline của attachment bị giữ lại cho tới khi việc hợp nhất đã tạo ra các tài liệu — và thứ mà lần chạy lại đó được giao chỉ là các tài liệu của component. Một bước nhắm vào đầu ra riêng của Feature chỉ được đưa ra khi component đang render, tức là trước khi bất kỳ việc hợp nhất nào xảy ra, nên nó không có gì để trỏ tới. Điều đó đúng bất kể đầu ra riêng của Feature đi theo đường nào: dù nó tham gia việc hợp nhất hay được ghi thành các tài liệu riêng, phạm vi riêng của nó không bao giờ là phạm vi mà lần chạy lại mang theo.

Việc emit không bao giờ bị ảnh hưởng. Một emit thêm một tài liệu chứ không chỉnh sửa tài liệu nào, và chạy theo từng node với mọi provider, nên nó hoàn toàn nằm ngoài điều này.

Điều kiện được báo trước bất kỳ lần duyệt nào, từ những gì các plugin và provider khai báo, và lại được báo như một lớp chặn cuối khi một node render. Các thông báo được phát ra:

pipeline PATCH targets an assembler provider’s pre-assembly fragments ("<attachment>") (PATCH của pipeline nhắm tới các mảnh trước lắp ráp của một provider lắp ráp) pipeline PATCH targets an assembler provider’s pre-assembly fragments (node "<instance>", <scope>-scope document "<key>" is rendered by an assembler provider). the post-assembly phase re-runs this PATCH once the documents are discrete (PATCH của pipeline nhắm tới các mảnh trước lắp ráp của một provider lắp ráp; tài liệu được render bởi một provider lắp ráp. giai đoạn sau lắp ráp chạy lại PATCH này khi các tài liệu đã riêng rẽ)

Cách khắc phục: trỏ tới các tài liệu của component thay vì của chính Feature, đó là dạng được chạy lại sau khi hợp nhất; hoặc đặt component trên một provider không gộp nhóm dispatch của nó; hoặc bỏ bước đi. Lựa chọn nào trong ba là đúng phụ thuộc vào việc bước được viết để thay đổi điều gì, và thông báo nêu phạm vi mà nó đã trỏ tới để bạn có thể biết. Thay đổi capability: riêng của FeatureRecipe không nằm trong số đó: nó không thay đổi phạm vi nào được giao cho lần chạy lại sau khi hợp nhất, và đó chính là điều mà điều kiện này nói tới.

A pipeline step’s plugin does not claim the provider rendering what it addresses (Plugin của một bước pipeline không khai nhận provider đang render thứ mà bước đó trỏ tới)

Một plugin được một bước pipeline sử dụng có thể khai báo các provider mà nó đã được kiểm thử. Danh sách đó là một khai nhận tường minh chứ không phải một ngầm định “bất cứ thứ gì tương tự”: chạy một plugin với một provider mà nó không nêu tên có nguy cơ áp một patch viết cho một dạng đầu ra khác, nên bản build dừng thay vì thử.

Provider mà một bước được đối chiếu là provider đang render các tài liệu mà bước đó trỏ tới — provider riêng của component với một bước nhắm vào tài liệu của component, và provider riêng của Feature với một bước nhắm vào tài liệu của Feature. Tại một Feature gắn vào một component, cả hai đều xuất hiện, và chúng là hai giá trị khác nhau từ hai tài liệu khác nhau.

Một danh sách khai nhận rỗng hoặc vắng mặt không khớp với gì cả, nên mọi bước dùng một plugin như vậy đều báo ở đây. Một plugin mà bản build không thể hỏi là một trường hợp khác và không báo ở đây: một bản tự báo cáo không lấy được là sự vắng mặt của khai nhận chứ không phải một khai nhận rỗng, và bước như vậy dừng với chính lỗi phân giải, tải hoặc tự báo cáo, đó là thứ cần sửa.

Điều kiện này được báo cáo khi bản build đã biết mọi plugin khai báo gì về chính nó, trước lần chạy sẽ gọi bước đó, và một lần cho mỗi bước được viết ra thay vì một lần cho mỗi bản build — nhờ vậy tác giả thấy được mọi bước vi phạm của một pipeline chỉ từ một bản build. Tên Provider được so khớp chính xác.

Các thông báo được phát ra, thông báo đầu từ pipeline riêng của một component và thông báo thứ hai từ pipeline của một Feature, có nêu cả attachment:

pipeline plugin is not compatible with the rendering provider ("<provider>") (plugin của pipeline không tương thích với provider đang render) pipeline plugin is not compatible with the rendering provider ("<attachment>", "<provider>") (plugin của pipeline không tương thích với provider đang render)

Cách khắc phục: phát hiện được định vị tại bước được viết, và provider mà nó nêu là thứ khai báo cần được đối chiếu cho khớp. Nếu plugin là của bạn, hãy thêm provider vào phần tương thích mà nó khai báo sau khi bạn đã kiểm thử với provider đó. Nếu không, hãy chọn một phiên bản plugin có khai nhận provider đó, render phạm vi đó qua một provider mà plugin có khai nhận, hoặc bỏ bước đi.

A provider refused a node’s input (Provider đã từ chối đầu vào của một node)

Một provider có thể kiểm tra đầu vào được giao cho một component trước khi kết xuất nó, và báo cáo những gì nó phát hiện. Các phát hiện ở mức nghiêm trọng halt sẽ dừng bản dựng; các phát hiện ở mức cảnh báo và thông tin được hiển thị cùng với đầu ra của bản dựng và không thay đổi gì đối với các byte được phát ra.

Đây là cách chính provider đọc đầu vào của bạn chứ không phải của trình biên dịch, vì vậy việc nó phản đối điều gì và nói điều đó cụ thể đến mức nào là do provider quyết định. Trình biên dịch nêu tên component và provider, và chuyển tải các thông báo của provider đúng như chúng được trả về; khi một provider báo cáo nhiều thông báo, chúng đến cùng nhau, ngăn cách bằng dấu chấm phẩy, để một bản dựng cho bạn biết về tất cả.

Cùng một cách định tuyến được dùng dù đầu vào thuộc về Recipe của chính một component hay thuộc về một Feature được gắn vào, vì vậy việc kiểm tra của một provider đọc giống hệt nhau ở cả hai trường hợp.

Thông báo được phát ra:

provider rejected node input: node "<instance>", provider "<provider>": <the provider's messages> (provider đã từ chối đầu vào của node)

Cách khắc phục: đọc các thông báo của provider — chúng nêu những gì trong đầu vào đã được phân giải mà nó không thể chấp nhận. Đầu vào được tập hợp từ các giá trị của Recipe và cấu hình riêng của component, nên chỗ cần sửa thường nằm ở một trong hai nơi đó; trang tham chiếu riêng của provider cho biết nó yêu cầu gì. Khi provider phản đối điều gì đó mà bạn không thể thay đổi từ một tài liệu, đó là câu hỏi dành cho người đã tạo ra Recipe hoặc plugin.

A provider rendered the same input twice and produced different output (Provider đã kết xuất cùng một đầu vào hai lần và tạo ra đầu ra khác nhau)

Với đầu vào giống hệt nhau, một bản dựng tạo ra đầu ra giống hệt nhau — đó là hợp đồng mà các công cụ review và công cụ triển khai dựa vào khi đọc kết quả của một bản dựng. Một chế độ dựng tùy chọn kiểm tra trực tiếp điều này: mỗi component được kết xuất hai lần từ cùng một đầu vào và các byte được phát ra được so sánh với nhau. Một provider có hai lần kết xuất không khớp nhau là provider mang trạng thái qua hai lần đó, hoặc vì lý do khác không phải là một hàm của đầu vào, và bản dựng dừng lại.

Bản dựng thông thường kết xuất mỗi component một lần, vì vậy điều kiện này chỉ gặp phải trong chế độ kiểm tra. Việc chế độ này có sẵn không làm thay đổi gì ở một bản dựng bình thường.

Thứ được so sánh là đầu ra thô mà provider phát ra — chính những byte mà các artifact được kết xuất được tách ra từ đó — vì vậy một khác biệt ở bất kỳ đâu trong những gì nó tạo ra đều bị phát hiện, chứ không chỉ khác biệt còn sót lại trong một tệp cuối cùng.

Thông báo được phát ra:

rendering node "<instance>": node "<instance>" (provider "<provider>"): two renders of identical input produced different output: provider render is not deterministic (đang kết xuất node: hai lần kết xuất cùng một đầu vào đã tạo ra đầu ra khác nhau: việc kết xuất của provider không tất định)

Cách khắc phục: trước tiên hãy tìm điểm khác nhau giữa hai bản dựng của component mà thông báo nêu tên — dựng nó hai lần và so sánh các đầu ra. Khi khác biệt là một giá trị mà chart bạn lấy nguồn tạo mới ở mỗi lần kết xuất — một mật khẩu ngẫu nhiên, một khóa được sinh ra, một dấu thời gian trong một Secret hoặc một ConfigMap — lỗi nằm ở đầu ra của chart đó chứ không phải ở provider, và bạn có thể tự xử lý theo một trong hai cách. Cung cấp giá trị đó, thông qua bất kỳ thiết lập nào mà chart cung cấp cho nó, từ valuesMapping: của Recipe, để chart ngừng sinh ra nó. Hoặc, khi tài liệu được sinh ra là thứ mà Release không được phép phát hành — chẳng hạn một Secret do người vận hành cung cấp riêng — hãy loại nó khỏi bản dựng bằng một mục omits: trên Recipe; xem Recipe → Trường omits:. Ngoài ra, lỗi thuộc về provider chứ không phải tài liệu của bạn, và không có gì bạn viết có thể xử lý nó. Hãy báo cáo cho người phát hành plugin phục vụ provider đó, nêu tên component mà thông báo xác định — nguyên nhân thường gặp là một dấu thời gian, một giá trị ngẫu nhiên, hoặc một thứ tự đi theo thứ tự lặp của một map thay vì thứ tự tác giả đã viết. Cho đến khi lỗi được sửa, chế độ dựng thông thường không bị ảnh hưởng, và ghim plugin vào một phiên bản đã vượt qua kiểm tra là giải pháp thực tế.

An omits entry left out nothing the source rendered (Một mục omits không loại bỏ được gì mà nguồn đã kết xuất)

Mỗi mục trong danh sách omits: của một Recipe hoặc một FeatureRecipe áp dụng cho một bản dựng — có when: vắng mặt, rỗng hoặc true — phải loại khỏi đầu ra ít nhất một thứ mà nguồn đã kết xuất: một tài liệu mà chart kết xuất, một service, một volume hoặc một config mà tệp compose khai báo, hoặc một resource mà template CloudFormation khai báo. Provider kết xuất nguồn sẽ đối chiếu mỗi mục với những gì nó đã kết xuất và báo cáo mỗi mục đã loại bỏ bao nhiêu đơn vị; một mục không loại bỏ được gì sẽ dừng bản dựng.

Một mục không khớp với gì là một khẳng định về nguồn không còn đúng nữa. Nguyên nhân thường gặp là một lần nâng cấp nguồn đã đổi tên hoặc gỡ bỏ thứ mà mục đó nêu tên — và khi đó một tài liệu hoặc service đã đổi tên nằm trong đầu ra dưới tên mới, đó chính là thứ mà mục được viết ra để loại bỏ — và nguyên nhân còn lại là một sai sót trong chính mục đó. Bỏ qua nó sẽ phát hành thứ mà mục đó nhằm loại bỏ, vì vậy bản dựng dừng lại và nêu tên mục đó.

Thông báo nêu tên node, provider, tài liệu khai báo mục đó và vị trí của mục trong danh sách omits: của tài liệu đó, đếm từ 0, cùng với kind, name và namespace mà mục được phân giải thành, namespace chỉ có khi mục nêu tên một namespace. Với một FeatureRecipe được gắn vào một component, node chính là component đó; với một FeatureRecipe được gắn vào một boundary, dòng phía trên thông báo nêu tên attachment và boundary của nó. Khi nhiều mục không khớp với gì, mục đầu tiên theo thứ tự bạn viết là mục được nêu tên, nên cùng một mục được nêu tên ở mỗi lần chạy. Một trường có template đọc một giá trị được khai báo là nhạy cảm sẽ được hiển thị là <redacted> thay vì giá trị mà nó được phân giải thành. Một mục bị when: của nó loại bỏ thì không bao giờ được giao cho provider và không bao giờ được kiểm tra.

Thông báo được phát ra. Danh mục đến với bạn trong phần đầu nằm trong ngoặc vuông:

an omits entry left out nothing the source rendered (node "<node-id>", provider "<provider>", "<document>" omits[<position>], kind "<kind>", name "<name>", namespace "<namespace>"). correct the entry so it names something the source renders, or remove it; a source upgrade that renamed or removed it is the usual cause (một mục omits không loại bỏ được gì mà nguồn đã kết xuất. hãy sửa mục để nó nêu tên thứ mà nguồn kết xuất, hoặc gỡ bỏ nó; nguyên nhân thường gặp là một lần nâng cấp nguồn đã đổi tên hoặc gỡ bỏ thứ đó)

Phần đầu mang mã ngắn của điều kiện này, E0334.

Cách khắc phục: so sánh mục với những gì nguồn hiện kết xuất — dựng với mục đã gỡ bỏ và đọc những gì component kết xuất — rồi sửa kind, name hoặc namespace của mục, hoặc gỡ bỏ mục khi thứ nó nêu tên không còn nữa. Với một chart, một mục nêu tên một tài liệu bằng kind, metadata.name của chính tài liệu đó và, khi mục nêu tên một namespace, namespace mà tài liệu nằm trong; với một tệp compose, nó nêu tên một service, một volume hoặc một config theo khóa của nó; với một template CloudFormation, nó nêu tên một resource bằng Type và logical ID của resource, trong bất kỳ template nào của nguồn. Xem Recipe → Trường omits:.

A provider’s omitted counts do not match the omits entries it was handed (Số lượng bị lược bỏ của một provider không khớp với các mục omits mà nó được giao)

Một provider khai báo rằng nó lược bỏ các đơn vị đã kết xuất sẽ báo cáo, cho mỗi mục omits: mà nó được giao, số đơn vị mà mục đó khớp — mỗi mục một số đếm, theo thứ tự các mục được giao. Một báo cáo bị thiếu, chứa quá ít hoặc quá nhiều số đếm, hoặc chứa một số đếm nhỏ hơn không thì không còn cách nào để biết một mục có lược bỏ được gì hay không, nên bản dựng dừng lại. Không có gì bạn viết gây ra điều này: nó báo cáo một provider có đầu ra trả về không giữ đúng hợp đồng mà nó khai báo.

Thông báo được phát ra. Thông báo nêu tên node và provider, sau đó là số mục đã được giao và những gì được trả về — hoặc là bao nhiêu số đếm, hoặc là số đếm nhỏ hơn không cùng mục mà nó được đưa ra cho:

a provider’s omitted counts do not match the omits entries it was handed (node "<node-id>", provider "<provider>", handed <n> omits entries, returned <m> omitted counts) (số lượng bị lược bỏ của một provider không khớp với các mục omits mà nó được giao (node, provider, đã giao các mục omits, đã trả về các số lượng bị lược bỏ))

Phần đầu mang mã ngắn của điều kiện này, E0336.

Cách khắc phục: báo cáo cho bên phát hành plugin phục vụ provider đó, nêu tên component mà thông báo xác định. Những gì một provider phải đáp ứng được trình bày trong hợp đồng plugin tại Lược bỏ các đơn vị đã kết xuất.

Assembled output still carries a cross-boundary placeholder (Đầu ra đã lắp ráp vẫn chứa một placeholder liên ranh giới)

Khi một kết nối phụ thuộc đi qua giữa hai đầu ra đã lắp ráp, giá trị mà nó mang không thể biết được trong lúc phía tiêu thụ được kết xuất — giá trị đó do phía bên kia công bố và được phân giải sau khi cả hai đã được lắp ráp. Vì vậy bản dựng ghi một placeholder vào đầu vào của component phía tiêu thụ, và provider thay thế nó bằng dạng tham chiếu chéo của riêng mình khi bản lắp ráp đã tồn tại.

Điều kiện này là những gì một placeholder sống sót qua bước thay thế đó báo cáo. Sống sót nghĩa là việc phân giải không bao giờ chạm tới nó: giá trị rơi vào chỗ mà provider không thể định địa chỉ — thường gặp nhất là bị ghép vào một chuỗi lớn hơn thay vì đứng như một giá trị trọn vẹn — hoặc một điểm giao cắt được đánh dấu mà không có gì ở phía bên kia để phân giải nó. Một placeholder không bao giờ là đầu ra hợp lệ, nên bản dựng dừng lại thay vì xuất ra một tệp chứa nó.

Thông báo nêu tên provider đã ghi tệp và đường dẫn của tệp: một đường dẫn chỉ là duy nhất trong một bản lắp ráp, nên cả hai cùng nhau mới xác định được một tệp. Mọi tệp vi phạm đều được báo cáo chứ không chỉ tệp đầu tiên, và mỗi tệp được báo cáo một lần bất kể bao nhiêu boundary đã đóng góp vào bản lắp ráp chứa nó. Lỗi được báo cáo trên toàn bộ tài liệu Release thay vì trên một boundary bên trong nó — lỗi nằm ở cách một giá trị đi đến tệp chứ không ở một khai báo boundary, nên không có khai báo boundary nào cần thay đổi.

Thông báo được phát ra:

assembled output retains an unresolved cross-boundary link placeholder ("<provider>", "<output-path>") (đầu ra đã lắp ráp vẫn giữ một placeholder liên kết liên ranh giới chưa được phân giải)

Cách khắc phục: nguyên nhân phổ biến nhất là một giá trị mà phía tiêu thụ đã nội suy vào một chuỗi dài hơn. Một tham chiếu chéo phải đứng như toàn bộ giá trị mà nó được chèn vào, vì vậy hãy thay đổi ánh xạ của Recipe để chuyển giao nó nguyên vẹn và thay vào đó ghép nối xung quanh nó bằng từ vựng riêng của đích. Khi giá trị đã đứng nguyên vẹn mà placeholder vẫn sống sót, lỗi nằm ở phía provider trong việc phân giải và thuộc về bên phát hành plugin đó.

Một template có thể đọc trực tiếp các giá trị của bên sản xuất từ một connection, tại .context.uses.<alias>.provides — hoặc, trong một FeatureRecipe có phạm vi boundary, từ các connection của boundary dưới .boundary. Khi connection nối hai component được render vào các đầu ra khác nhau và provider nối nó bằng một tham chiếu của riêng mình, mỗi giá trị đó đến template dưới dạng một placeholder mà provider thay thế khi cả hai đầu ra đã được lắp ráp: bằng một tham chiếu xuyên stack, hoặc bằng chính giá trị đó. Vì vậy một template chỉ có thể sao chép một giá trị như vậy — viết nó nguyên vẹn, bên trong một chuỗi dài hơn, hoặc qua một hàm giữ nguyên nó, chẳng hạn quote.

Một phép so sánh, một nhánh, một độ dài, hoặc một hàm thay đổi giá trị — eq, if, len, upper, trimPrefix — sẽ được quyết định dựa trên placeholder thay vì giá trị, một cách âm thầm. Bản build kiểm tra điều đó bằng cách đánh giá template hai lần, một lần trên các placeholder và một lần trên các giá trị thật, và dừng lại khi hai kết quả khác nhau sau khi mỗi placeholder được ghi trở lại. Điều này áp dụng cho mọi template đọc một connection như vậy: các template riêng của một Recipe, injectMapping: của một FeatureRecipe được gắn, và các template của một FeatureRecipe có phạm vi boundary.

Thông báo nêu template — trường và Recipe mà nó thuộc về — và, với mỗi giá trị provides mà sự khác biệt phụ thuộc vào, nêu component tiêu thụ, alias và socket của connection, và component sản xuất. Một giá trị mà template chỉ sao chép thì không được nêu.

Thông báo được phát ra:

a template does more than copy a value it reads off a cross-boundary link (template "<template>", provides key "<key>" that component "<consumer>" reads off its connection "<alias>" on socket "<socket>" to component "<producer>"). Copy the value as it stands, whole or inside a larger string, because the provider writes in its place what the value becomes in the other output, and branch on a value of the component’s own instead (một template làm nhiều hơn việc sao chép một giá trị nó đọc từ một liên kết xuyên boundary: thông báo nêu template, khóa provides, component tiêu thụ đọc nó từ connection của mình trên socket, và component sản xuất. Hãy sao chép giá trị như hiện có, nguyên vẹn hoặc bên trong một chuỗi dài hơn, vì provider ghi vào vị trí của nó thứ mà giá trị trở thành trong đầu ra kia, và thay vào đó hãy rẽ nhánh dựa trên một giá trị của chính component)

Cách khắc phục: sao chép giá trị mà thông báo nêu thay vì kiểm tra hay biến đổi nó, và dựa quyết định vào một giá trị mà component tiêu thụ tự soạn — một trong các khóa values hoặc infra của chính nó — thay vì vào thứ mà connection của nó đọc. Provider CloudFormation mô tả một giá trị được sao chép trở thành gì trong stack kia.

A provider named a directory for a contributor that is not one directory (Một provider đặt tên thư mục cho một contributor không phải là một thư mục duy nhất)

Một provider đặt mỗi contributor dưới vị trí riêng của nó bên trong một đầu ra bao quanh sẽ khai báo thư mục mà các vị trí đó nằm dưới, và bản dựng ghép danh tính của mỗi component vào đó. Giá trị phải đặt tên đúng một thư mục: một giá trị chứa dấu phân cách đường dẫn, hoặc chỉ thư mục hiện tại hay thư mục cha, sẽ đặt các tệp của một component ở nơi khác ngoài vị trí riêng của nó — hoặc hoàn toàn bên ngoài bản lắp ráp, hoặc bị sắp xếp lại một cách âm thầm bên trong nó.

Bản dựng dừng lại thay vì ghép một đường dẫn như vậy. Thông báo nêu tên provider đã khai báo giá trị và chính giá trị đó, để thấy rõ cần thay đổi provider nào và nó đã khai báo gì.

Một provider không khai báo thư mục như vậy thì không bị ảnh hưởng. Khi đó mỗi contributor nằm trực tiếp tại thư mục triển khai dưới tên riêng của nó, nên việc không đặt tên thư mục bao quanh là một lựa chọn hợp lệ chứ không phải một thiếu sót.

Thông báo được phát ra:

provider named a directory for each contributor’s own sub-directory that is not a single directory name: provider "<provider>" declared nest_segment "<value>"; the value must name one directory, carrying no path separator and naming neither the current nor the parent directory (provider đặt tên thư mục cho thư mục con riêng của mỗi contributor mà không phải là một tên thư mục duy nhất: provider đã khai báo nest_segment; giá trị phải đặt tên một thư mục, không chứa dấu phân cách đường dẫn và không chỉ thư mục hiện tại hay thư mục cha)

Cách khắc phục: không có tài liệu catalog nào tạo ra giá trị này, nên không có gì trong các tệp của bạn cần sửa — nó đến từ plugin phục vụ provider. Hãy báo cáo cho bên phát hành plugin đó, trích dẫn giá trị mà thông báo nêu. Nếu plugin là của bạn, hãy khai báo một tên thư mục duy nhất, hoặc không khai báo và để mỗi contributor nằm tại thư mục triển khai.

A boundary-scope Feature is attached only to a component (Một Feature phạm vi boundary chỉ được gắn vào một component)

Một FeatureRecipe có thể khai báo rằng nó sinh một lần cho một boundary thay vì một lần cho mỗi component — một tài nguyên dùng chung cho mọi thứ boundary chứa, thay vì mỗi component một tài nguyên. Do đó boundary là nơi phải viết phần gắn như vậy: một phần gắn có tên đó chỉ được viết trên một component thì không chỉ ra phạm vi nào để recipe sinh cho, nên không có gì quyết định nó sẽ chạy tại boundary nào, đọc giá trị nào, hay ghi đầu ra ở đâu.

Viết nó trên cả một component là bình thường và không bị báo cáo. Một phần gắn được khai báo tại một boundary sẽ đến mọi component mà boundary đó chứa, kể cả những component trong các phạm vi lồng bên trong nó, nên việc mang nó là dạng bình thường. Điều được kiểm tra là phạm vi riêng của component hoặc một phạm vi bao quanh nó có khai báo tên đó hay không — việc tìm kiếm đi ra ngoài từ nơi component nằm và dừng ở phạm vi đầu tiên có khai báo. Một component khai báo lại tại chính nó một phần gắn mà phạm vi bao quanh đã khai báo sẽ kết xuất giống hệt dạng chỉ khai báo ở phạm vi, và được chấp nhận vì cùng lý do.

Một component không nằm trong phạm vi nào thì không có gì để đi qua, nên một phần gắn phạm vi boundary trên nó bị báo cáo ở đây — đó là cách hiểu đúng đắn, vì không có phạm vi nào mà một recipe như vậy có thể sinh cho.

Thông báo được phát ra, nêu tên phần gắn và phạm vi mà component nằm trong:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>", on a component in boundary "<boundary>") (phần gắn liên kết một FeatureRecipe có executionScope: boundary nhưng không boundary nào chứa component khai báo nó (trên một component trong boundary))

và đối với một component không nằm trong phạm vi nào, vốn không đóng góp giá trị như vậy:

attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it ("<attachment>") (phần gắn liên kết một FeatureRecipe có executionScope: boundary nhưng không boundary nào chứa component khai báo nó)

Cách khắc phục: khai báo phần gắn dưới features: trên boundary mà nó cần sinh cho — phạm vi mà component nằm trong, hoặc một phạm vi bao quanh nó — thay vì chỉ trên component. Nếu điều bạn muốn là sinh theo từng component, hãy thay vào đó gắn một Feature có FeatureRecipe không khai báo phạm vi boundary.

The sandbox refused a plugin (Sandbox đã từ chối một plugin)

Mọi plugin đều báo cáo nó là gì và nó cần gì trước khi được phép thực hiện bất kỳ công việc nào, và sandbox đối chiếu báo cáo đó với những gì nó sẵn sàng cấp. Điều kiện này bao trùm toàn bộ loại báo cáo mà sandbox sẽ không chấp nhận, và câu thông báo cho biết phần nào của báo cáo bị từ chối: một phiên bản giao diện plugin mà host không hỗ trợ, một loại plugin mà host không có từ vựng cho nó, một plugin yêu cầu quyền truy cập mạng ra ngoài hoặc quyền truy cập hệ thống tệp, một plugin nêu tên một lời gọi host nằm ngoài tập mà host cung cấp hoặc import từ một namespace nằm ngoài tập mà host chấp nhận, một export bị thiếu hoặc sai định dạng, một trường mang giá trị nằm ngoài tập đóng của nó, hoặc một bản tự báo cáo hoàn toàn không đọc được.

Việc từ chối xảy ra trước khi plugin chạy, và một plugin bị từ chối sẽ bị tắt trước khi lỗi được truyền đi, nên không điều gì nó yêu cầu được cấp, dù chỉ trong chốc lát.

Một số thứ mà plugin không thể có không được kiểm tra ở đây vì chúng không bao giờ được cấp. Host cung cấp cho guest một đồng hồ bị đóng băng, không có hệ thống tệp, không có môi trường, và không có nơi nào cho đầu ra của chính nó, nên một guest cố truy cập bất kỳ thứ nào trong số đó sẽ thất bại ngay tại lần thử thay vì bị từ chối từ trước. Điều kiện này bao trùm bản báo cáo mà plugin đưa ra về chính nó, được kiểm tra trước khi nó khởi động.

Các thông báo được phát ra. Câu của điều kiện kết thúc mỗi thông báo, và phần đứng trước nêu tên plugin cùng phần báo cáo của nó đã bị từ chối. Một phiên bản giao diện mà host không hỗ trợ:

plugin "<plugin>" declares abi_version "<declared>"; host speaks "<supported>": wasm: plugin rejected by the sandbox (plugin khai báo abi_version; host hỗ trợ: wasm: plugin bị sandbox từ chối)

một loại plugin mà host không có từ vựng cho nó:

plugin "<plugin>" declares unknown plugin_type "<declared>": wasm: plugin rejected by the sandbox (plugin khai báo plugin_type không xác định: wasm: plugin bị sandbox từ chối)

một bản tự báo cáo không đọc được:

wasm: plugin "<plugin>" describe() output is not valid JSON: <what the read reported>: wasm: plugin rejected by the sandbox (wasm: đầu ra describe() của plugin không phải JSON hợp lệ: wasm: plugin bị sandbox từ chối)

một plugin thiếu export mà loại của nó yêu cầu, được nêu tên từ cùng registry mà chính loại đó được đọc từ:

<kind> plugin "<plugin>" declares no "<export>" export: wasm: plugin rejected by the sandbox (plugin không khai báo export: wasm: plugin bị sandbox từ chối)

một trường đóng với một tập cố định nhưng mang giá trị khác — cùng dạng này áp dụng cho chế độ assembly, và các trường operates và scope của từng export:

plugin "<plugin>" export "<export>" declares unknown scope "<declared>" (want "own", "host", or empty): wasm: plugin rejected by the sandbox (export của plugin khai báo scope không xác định (cần own, host hoặc rỗng): wasm: plugin bị sandbox từ chối)

một capability theo cặp được khai báo mà không có đủ cả hai export, hoặc có các export mà không có khai báo capability:

plugin "<plugin>" declares the cross-boundary linking capability but does not export both "link_publish" and "link_resolve": wasm: plugin rejected by the sandbox (plugin khai báo capability liên kết xuyên ranh giới nhưng không export cả link_publish và link_resolve: wasm: plugin bị sandbox từ chối)

một tên capability mà một Recipe không bao giờ có thể chọn — một provider phục vụ một tên chứa dấu hai chấm, hoặc một bước pipeline tương thích với một tên như vậy — vì capability: của một Recipe được đọc là tên cho đến dấu hai chấm cuối cùng và một ghim phiên bản sau đó. parse:<format> của một parser và import:<format> của một importer không bị từ chối: dấu hai chấm là một phần của các tên đó, và chúng được tra cứu theo định dạng thay vì thông qua một Recipe. Cùng sự từ chối này cũng ngăn entity của một plugin như vậy được tạo ra để xuất bản:

plugin "<plugin>" (plugin_type "provider") serves the capability "<name>", which contains a colon; a Recipe’s capability reference is read as the capability up to its last colon and a version pin after it, so no Recipe can name "<name>": report the capability name without a colon: wasm: plugin rejected by the sandbox (plugin phục vụ capability có chứa dấu hai chấm; tham chiếu capability của một Recipe được đọc là capability cho đến dấu hai chấm cuối cùng và một ghim phiên bản sau đó, nên không Recipe nào có thể nêu tên nó: hãy báo cáo tên capability không có dấu hai chấm: wasm: plugin bị sandbox từ chối)

và các lời gọi host mà một plugin khai báo được đối chiếu với những lời gọi mà binary của nó thực sự dùng, việc này được kiểm tra theo cả hai chiều để một plugin không thể quảng bá một bề mặt nó không dùng cũng không thể che giấu một bề mặt nó có dùng:

plugin "<plugin>" declares host function "<name>" in describe() that its wasm does not import: wasm: plugin rejected by the sandbox (plugin khai báo trong describe() một hàm host mà wasm của nó không import: wasm: plugin bị sandbox từ chối) plugin "<plugin>" imports host function "<name>" that its describe() does not declare: wasm: plugin rejected by the sandbox (plugin import một hàm host mà describe() của nó không khai báo: wasm: plugin bị sandbox từ chối)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra điều này và không thay đổi soạn thảo nào xóa được nó — bản báo cáo bị từ chối là của chính plugin. Nếu bạn dùng một plugin đã xuất bản, hãy báo cáo thông báo cho người xuất bản nó và trong lúc chờ đợi, chọn một phiên bản mà host chấp nhận. Nếu plugin là của bạn, thông báo nêu tên trường và cả hai giá trị, nên cách sửa là điều mà câu thông báo chỉ ra: dùng phiên bản giao diện mà host hỗ trợ, khai báo một loại mà host biết, giữ mọi trường trong tập đóng của nó, khai báo export mà loại của bạn yêu cầu, và khai báo chính xác các lời gọi host mà binary của bạn dùng — không nhiều hơn, không ít hơn.

A plugin is not the kind of plugin the socket expects (Plugin không thuộc loại plugin mà socket mong đợi)

Mỗi điểm gắn nêu rõ loại plugin mà nó điều phối tới, và mọi plugin đều báo cáo loại của chính nó. Điều kiện này là thứ mà sự bất đồng giữa hai bên báo cáo: một plugin phục vụ một provider được gắn ở nơi mong đợi một linter, một parser được gắn ở nơi mong đợi một importer, một plugin không phải lệnh terminal lại được chạy như một lệnh terminal. Việc kiểm tra diễn ra khi plugin được nạp, nên một plugin sai loại không bao giờ chạm tới công việc mà nó lẽ ra sẽ được yêu cầu làm.

Lý do build dừng lại thay vì vẫn cố thử là các loại không dùng chung một giao diện. Một plugin thuộc loại khác sẽ được gọi qua những export mà nó không có, và những gì trả về sẽ được đọc theo một dạng mà nó chưa bao giờ tạo ra.

Việc đọc bản tự báo cáo của một plugin mà không khẳng định loại thì không bị ảnh hưởng. Một bề mặt chỉ muốn biết plugin nói gì về chính nó — liệt kê những gì đã được cấu hình, tạo một entity cho một plugin — không nêu kỳ vọng nào, và việc kiểm tra này được bỏ qua ở đó.

Thông báo được phát ra, nêu tên plugin và cả hai loại, trong đó loại được mong đợi được nêu bằng lời cũng như bằng giá trị đã khai báo của nó:

wasm: plugin "<plugin>": expected a <kind in words> plugin (plugin type "<expected>") but its describe() reports plugin type "<reported>": wasm: declared plugin type does not match plugin describe() (wasm: mong đợi một plugin thuộc loại đã nêu nhưng describe() của nó báo cáo một loại plugin khác: wasm: loại plugin đã khai báo không khớp với describe() của plugin)

Cách khắc phục: gắn một plugin thuộc loại mà điểm gắn nhận — thông báo nêu tên loại được mong đợi. Nếu plugin đúng là plugin bạn định dùng, thì việc gắn đang ở sai chỗ: hãy chuyển nó tới bề mặt mà loại của nó thuộc về. Nếu bạn là tác giả plugin và nó lẽ ra phải thuộc loại được mong đợi, thì nó đang báo cáo sai loại về chính mình, và đó là việc sửa trong plugin chứ không phải trong cấu hình gắn nó.

A plugin failed while it was running (Một plugin bị lỗi khi đang chạy)

Một plugin được yêu cầu làm một việc nhưng không trả về kết quả. Ba điều kiện bao quát trường hợp này, và điều phân biệt chúng chỉ là cách lỗi được truyền đi — một plugin bị sập, một plugin tự dừng việc thực thi của chính nó, và một plugin chạy đến cuối rồi báo rằng nó không thể làm điều được yêu cầu. Chúng được gộp thành một hệ phân loại một cách có chủ ý, để một bản build xử lý mọi cách một plugin có thể thất bại như nhau.

Một plugin bị sập. Hầu hết các lỗi bên trong một plugin — một lệnh không thể tới được, một phép chia cho không, một lần đọc ngoài bộ nhớ của nó — được chuyển thành lỗi thông thường trên đường ra và không bao giờ tới điều kiện này. Điều kiện này là tấm lưới phía sau con đường đó, dành cho một lần sập thoát ra khỏi nó.

Một plugin tự dừng việc thực thi của chính nó. Một plugin yêu cầu thoát là đang làm một việc mà mô hình plugin không có công dụng: một plugin trả kết quả qua chính lời gọi đã gọi nó, chứ không phải bằng cách thoát. Việc thực thi của chính nó dừng lại; tiến trình build không bị ảnh hưởng.

Một plugin báo cáo một lỗi. Phong bì kết quả mà một plugin trả về có chỗ để nó nói rằng nó không thể hoàn thành, và một thông điệp nói như vậy được truyền đi như một lỗi thay vì được đọc như một kết quả.

Các thông báo được phát ra, mỗi thông báo nêu tên plugin hoặc export và mang theo bất cứ thứ gì lỗi cung cấp. Một lần sập mang theo giá trị được khôi phục:

wasm: guest plugin "<plugin>" panicked in <export>: <the recovered value>: wasm: guest plugin panicked during call (wasm: plugin khách bị panic trong export: wasm: plugin khách bị panic trong khi gọi)

một plugin tự dừng mang theo mã mà nó dừng với:

wasm: plugin "<plugin>" call to <export> invoked proc_exit(<code>): wasm: plugin invoked proc_exit (wasm: lời gọi tới export của plugin đã gọi proc_exit: wasm: plugin đã gọi proc_exit)

và một lỗi được báo cáo mang theo thông điệp của chính plugin:

call "<export>": wasm: guest plugin reported an error: <the plugin's message> (gọi export: wasm: plugin khách đã báo cáo một lỗi)

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra bất kỳ điều nào trong ba trường hợp, và không thay đổi soạn thảo nào xóa được chúng — mỗi trường hợp là một lỗi bên trong plugin. Hãy báo thông báo cho bên phát hành plugin, nêu tên export mà nó xác định, và ghim plugin vào một phiên bản đã hoạt động trong khi lỗi được sửa. Nếu plugin là của bạn: hãy trả về một lỗi trên phong bì kết quả thay vì sập hoặc thoát, để bản build nhận được một thông điệp nó có thể hiển thị; và nếu lỗi được báo cáo là câu trả lời có cân nhắc của chính plugin, thông điệp của nó là thứ người đọc sẽ thấy, nên đáng để nói rõ điều gì trong đầu vào mà nó không thể chấp nhận.

A plugin returned something that is not the shape the socket reads (Một plugin trả về thứ không có dạng mà socket đọc)

Mọi điểm gắn đều đọc kết quả nhận về theo dạng mà nó mong đợi, và từ chối mọi thứ khác — một trường mà dạng đó không khai báo, một trường có giá trị không thuộc kiểu được khai báo cho nó, hoặc các byte hoàn toàn không phải một kết quả hợp lệ.

Nó từ chối thay vì đọc những gì có thể đọc, và lý do là việc đọc những gì có thể đọc sẽ diễn ra âm thầm. Export mà một điểm gắn gọi có thể được chọn theo từng điểm gắn, nên một điểm gắn có thể nêu tên một export có kết quả thuộc một dạng hoàn toàn khác. Bỏ qua các phần không khớp sẽ cho ra một kết quả rỗng — và bản thân một kết quả rỗng là một câu trả lời hợp lệ: không có phán quyết nào được trả về, không có phát hiện nào được nêu ra. Khi đó hai trường hợp sẽ không thể phân biệt, và một bản build sẽ tiếp tục y như thể plugin đã chấp thuận nó.

Thông báo được phát ra, nêu tên export mà kết quả được trả về từ đó và mang theo lý do việc đọc thất bại — cùng nhau chúng xác định export mà điểm gắn lẽ ra phải nêu tên:

call "<export>": wasm: guest plugin returned an output that is not the shape the socket reads: <what could not be read> (gọi export: wasm: plugin khách đã trả về một đầu ra không có dạng mà socket đọc)

Cách khắc phục: hãy đối chiếu hàm đầu vào mà điểm gắn nêu tên với các export mà plugin khai báo — một điểm gắn trỏ tới sai export là nguyên nhân phổ biến, và lý do trong thông báo nêu tên trường không thuộc về dạng đó. Nếu export là đúng, plugin đang trả về một dạng mà điểm gắn không đọc, và đó là một chỉnh sửa trong plugin; hãy báo cho bên phát hành plugin, trích dẫn cả export lẫn lý do.

A plugin returned a diagnostic at a severity that is not declared (Một plugin trả về một chẩn đoán ở mức độ nghiêm trọng không được khai báo)

Một plugin có thể trả về các quan sát kèm theo kết quả của nó, và mỗi quan sát mang một mức độ nghiêm trọng từ một tập đóng: một mức dừng bản build và nêu điều cần sửa, một mức được hiển thị bên cạnh một bản build vẫn hoàn tất, và một mức ghi lại quan sát mà không thay đổi gì. Một mức độ nghiêm trọng nằm ngoài tập đó là mức mà host không có lộ trình xử lý, và bản build dừng lại.

Nó từ chối thay vì chọn một lộ trình, và cả hai lựa chọn thay thế đều tệ hơn. Bỏ qua một quan sát mà nó không thể định tuyến sẽ coi quan sát đó là không có gì phải làm — điều mà, khi plugin đang quyết định có chấp nhận bản build hay không, sẽ được hiểu là chấp thuận: một phản đối mà plugin nêu ra sẽ để bản build đi qua mà không bao giờ được hiển thị. Coi nó là mức dừng sẽ từ chối một bản build dựa trên một giá trị mà không ai chọn. Cả hai đều diễn ra âm thầm, nên host báo rằng giá trị là sai và plugin được sửa thay vào đó.

Việc kiểm tra chạy một lần, tại nơi kết quả được đọc, thay vì tại mỗi nơi một quan sát được hiển thị sau đó — đây cũng là điểm duy nhất mà danh tính của plugin vẫn còn trong tầm tay, vì một quan sát đã được gộp vào một báo cáo không còn biết plugin nào đã nêu ra nó.

Thông báo được phát ra, nêu tên plugin, export, quan sát nào bị lỗi, giá trị của nó, và các giá trị được khai báo:

plugin "<plugin>" call "<export>": wasm: guest plugin returned a diagnostic whose severity the contract does not declare: diagnostic <index> has severity "<value>"; the declared severities are "halt", "warn" and "info" (plugin gọi export: wasm: plugin khách đã trả về một chẩn đoán có mức độ nghiêm trọng mà hợp đồng không khai báo: chẩn đoán có mức độ nghiêm trọng không hợp lệ; các mức độ nghiêm trọng được khai báo là halt, warn và info)

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra điều này — giá trị đến từ plugin. Hãy báo cho bên phát hành plugin, trích dẫn giá trị mà thông báo nêu ra. Nếu plugin là của bạn, hãy phát ra một trong ba mức độ nghiêm trọng được khai báo; thông báo nêu tên chúng, và chỉ số cho bạn biết cần xem quan sát nào.

A provider returned two output files under one path (Một provider trả về hai tệp đầu ra dưới cùng một đường dẫn)

Một provider trả về đầu ra của nó dưới dạng một danh sách tệp, mỗi tệp nêu đường dẫn nơi nó được ghi. Host thu thập chúng theo khóa là đường dẫn và ghi nguyên văn các byte của mỗi tệp, không chạy bộ tuần tự hóa nào của riêng nó. Hai tệp cùng nêu một đường dẫn khiến tập hợp đó có hai giá trị cho một khóa.

Nó từ chối thay vì chọn một tệp, vì sau đó không thể phân biệt lựa chọn này với lựa chọn kia. Giữ tệp sau sẽ loại bỏ một tệp mà provider đã yêu cầu ghi; giữ tệp đầu sẽ loại bỏ một tệp sau. Dù theo cách nào, đầu ra trên đĩa vẫn hợp lệ và thiếu một tệp, không có gì ghi lại rằng một tệp đã bị bỏ — và đường dẫn còn lại là đường dẫn vốn sẽ còn lại, nên không có gì trong kết quả cho thấy đã xảy ra xung đột. Tệp nào trong hai tệp là tệp được dự định là câu hỏi chỉ provider mới trả lời được.

Điều kiện này được nêu ra ở bất cứ nơi nào một provider trả về tệp: khi render một nút, và khi lắp ráp đầu ra của một nhóm dispatch thành một artifact. Điều kiện và cách khắc phục giống nhau ở cả hai, nên cả hai đều báo cáo nó.

Thông báo được phát ra, nêu tên đường dẫn được trả về hai lần và nút hoặc đường dẫn dispatch mà nó được trả về cho:

provider guest returned two output files under one path; a conforming guest returns each output path at most once (path "<path>", node "<node>") (provider khách đã trả về hai tệp đầu ra dưới cùng một đường dẫn; một guest tuân thủ trả về mỗi đường dẫn đầu ra nhiều nhất một lần)

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra điều này — các đường dẫn đến từ provider. Hãy báo cho bên phát hành nó, trích dẫn đường dẫn mà thông báo nêu ra. Nếu provider là của bạn, hãy trả về mỗi đường dẫn đầu ra nhiều nhất một lần: xây dựng danh sách đường dẫn dựa trên một tập hợp để tệp thứ hai tại cùng một đường dẫn bị phát hiện ngay nơi nó được tạo ra, và đặt cho tệp thứ hai một đường dẫn riêng nếu cần cả hai.

A provider reported a render fact whose value is not a list (Một provider đã báo cáo một render fact có giá trị không phải là danh sách)

Một provider có thể báo cáo các fact về đầu ra mà nó đã render bên cạnh các tệp của nó — mỗi fact gồm một tên và một giá trị, theo bộ từ vựng được tài liệu hóa riêng của provider đó — và các Features được gắn vào một component đọc chúng từ các template của mình. Giá trị của mọi fact là một danh sách, kể cả khi nó chỉ chứa một phần tử: một tên có thể được báo cáo bởi nhiều lần render của một component, gồm các lần gọi provider của chính nó và các lần render của các Features được gắn vào nó, và các danh sách được nối thành một dưới tên đó cho các template đọc nó. Khi render, một provider không thể biết liệu báo cáo của nó có phải là báo cáo duy nhất dưới một tên hay không, nên một giá trị là object, chuỗi, số, boolean hoặc null sẽ bị từ chối ngay tại chỗ provider giao nó, với mọi lần render, bất kể có template nào đọc fact đó hay không.

Thông báo được phát ra, nêu tên fact, node mà fact được báo cáo cho, provider đã báo cáo nó, và giá trị đó là gì:

provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact’s value as a JSON array, even with one entry (fact "<fact>", node "<node>", provider "<provider>", its value is <kind>) (guest provider đã báo cáo một render fact có giá trị không phải là danh sách; một guest tuân thủ báo cáo giá trị của mọi render fact dưới dạng mảng JSON, kể cả khi chỉ có một phần tử)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra lỗi này — giá trị đến từ provider. Hãy báo cáo cho bên phát hành nó, trích dẫn fact mà thông báo nêu tên. Nếu provider là của bạn, hãy báo cáo giá trị của fact đó dưới dạng mảng JSON — một object đơn lẻ trở thành một danh sách chứa object đó — và tài liệu hóa nó là một danh sách trong các fact mà provider của bạn báo cáo; xem Báo cáo fact về những gì một guest đã phát ra.

Khi một kết nối đi qua giữa hai dispatch group, provider ở mỗi bên được yêu cầu nối nó: đầu được tiêu thụ công bố một định danh, đầu tiêu thụ phân giải dựa trên định danh đó, và mỗi bên có thể trả về phần nối cấu trúc để áp dụng lên đầu ra của group của chính nó. Mỗi phần nối nêu tên tệp đầu ra mà nó áp dụng vào. Một lượt xử lý sau đó cắt tệp đó, áp dụng các thao tác, và ráp lại nó trung thực đến từng byte.

Một tên không khớp với tệp nào đã phát ra khiến lượt xử lý đó không có gì để cắt, và nó từ chối thay vì bỏ qua phần nối. Các thao tác mà phần nối mang theo chính là thứ phân giải kết nối, nên bỏ chúng đi sẽ khiến đầu ra đã ráp tham chiếu đến một endpoint mà không gì nối cả — điều này thất bại lúc triển khai, cách xa provider đã gây ra nó, và trông giống một lỗi trong kết nối thay vì trong phần nối.

Các tệp mà một phần nối có thể nêu tên là các tệp mà lần render của chính group đó đã trả về. Chúng được giao cho provider trong cùng lần gọi, nên provider không bao giờ phải đoán tên: nó chọn một tên từ tập hợp được giao.

Thông báo được phát ra, nêu tên tệp mà phần nối yêu cầu và endpoint mà nó được trả về cho:

link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group’s own render returned (file "<file>", node "<node>") (link patch nêu tên một tệp đầu ra mà dispatch group không phát ra; một link patch tuân thủ nêu tên một tệp mà lần render của chính group đó đã trả về)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra lỗi này — tên đến từ provider. Hãy báo cáo cho bên phát hành nó, trích dẫn tệp mà thông báo nêu tên. Nếu provider là của bạn, hãy lấy tên tệp từ các tệp đã ráp mà lần gọi giao cho bạn thay vì từ một tên được dựng độc lập — một đường dẫn ghép thủ công sẽ lỗi thời ngay khi lần render tạo ra nó thay đổi, và đây chính là biểu hiện của điều đó.

A pipeline step’s file emission carries no file (Lần phát tệp của một bước pipeline không mang theo tệp nào)

Một bước pipeline có thể phát ra một tài liệu mới bên cạnh những tài liệu nó patch. Mỗi lần phát khai báo loại của nó, và một lần phát thuộc loại tệp mang theo tệp mà nó ghi: đường dẫn và nội dung.

Ở đây loại thì đúng nhưng tệp lại vắng mặt, nên bước đó đã khai báo một ý định mà phản hồi của nó không thực hiện. Đó là khác biệt giữa lỗi này và lỗi dừng do loại chưa được định nghĩa bên dưới: host biết chính xác phải làm gì với một lần phát emit_file nhưng không có gì để làm.

Nó từ chối thay vì không phát ra gì, vì một lần phát lặng lẽ không đóng góp tệp nào sẽ là vô hình. Một bước phát ra tài liệu thường là toàn bộ lý do nó có mặt trong pipeline, và đầu ra của nó là một tệp trước đó chưa có — nên một bản build bỏ qua nó sẽ tạo ra đầu ra thiếu một tài liệu, trong khi bước đó báo rằng nó đã chạy.

Thông báo được phát ra, nêu tên node và lần phát nào của bước đó bị lỗi:

emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content (node "<node>", side effect <index>) (side effect emit_file không mang theo tệp nào; một side effect emit_file tuân thủ mang theo một tệp với đường dẫn và nội dung của nó)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra lỗi này — phản hồi đến từ plugin. Hãy báo cáo cho bên phát hành nó, trích dẫn chỉ số mà thông báo nêu ra. Nếu plugin là của bạn, hãy điền thành phần file trên mọi lần phát emit_file, với cả đường dẫn và nội dung; chỉ số cho biết cần xem lần phát nào trong phản hồi của bước đó.

A pipeline step declares an emission kind the contract does not define (Một bước pipeline khai báo một loại phát ra mà hợp đồng không định nghĩa)

Mỗi lần phát mà một bước pipeline trả về khai báo loại của nó, và hợp đồng định nghĩa hai loại: một loại ghi tệp, một loại đóng góp tài liệu custom-resource. Loại là một chuỗi mở trên đường truyền, điều cho phép thêm một loại mới sau này mà không làm hỏng các plugin hiện có.

Chính sự mở đó là lý do một loại chưa được định nghĩa bị từ chối thay vì bị bỏ qua. Chỉ dựa vào hình dạng, một giá trị mà host không định nghĩa không thể phân biệt với một giá trị mà phiên bản sau sẽ định nghĩa — nên một host bỏ qua nó sẽ lặng lẽ đánh rơi bất cứ điều gì bước đó muốn nói, trên mọi bản build, trong khi bước đó báo thành công. Việc từ chối giữ điểm mở rộng luôn mở mà không biến nó thành một lỗ hổng: một loại mà bản build này không định nghĩa được báo là chưa định nghĩa, kèm trích dẫn giá trị bước đó đã gửi, thay vì được chấp nhận rồi bị bỏ qua.

Thông báo được phát ra, nêu tên node, lần phát nào bị lỗi, và loại mà nó đã khai báo:

side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd (node "<node>", side effect <index>, kind "<value>") (side effect khai báo một loại mà hợp đồng plugin không định nghĩa; một side effect tuân thủ khai báo emit_file hoặc emit_crd)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra lỗi này — giá trị đến từ plugin. Hãy báo cáo cho bên phát hành nó, trích dẫn loại mà thông báo nêu tên. Nếu plugin là của bạn, hãy khai báo một trong các loại mà thông báo liệt kê; viết sai chính tả một loại đã định nghĩa là nguyên nhân thường gặp, và giá trị được trích dẫn lại chính là thứ bạn đã gửi.

Bước ghép lại của một provider nhận một đơn vị mà chính bước cắt của nó chưa từng tạo ra

Một provider có dạng đầu ra không thể định địa chỉ trực tiếp có thể tự cắt nó: provider tách một tệp đầu ra thành các đơn vị có thể định địa chỉ, mỗi đơn vị dưới một token, rồi trả chúng lại. Sau đó một bước pipeline định địa chỉ một đơn vị bằng token đó, và bước ghép lại nối các đơn vị đã chỉnh sửa trở vào tệp, trung thực đến từng byte. Hai nửa này là một hợp đồng — các token mà một tệp được cắt theo chính là các token mà bước ghép lại của nó phân giải.

Khi bước ghép lại nhận một token mà bước cắt của chính tệp đó không tạo ra, sẽ không có dải byte nào để nội dung đã chỉnh sửa quay vào. Nó từ chối thay vì bỏ đơn vị đó, vì một đơn vị bị bỏ sẽ tạo ra một tệp hợp lệ về cấu trúc nhưng thiếu một chỉnh sửa mà một bước đã được yêu cầu thực hiện: không có gì thất bại, không có gì sai định dạng, và chỉnh sửa đó đơn giản là không có.

Hai nửa chỉ có thể không khớp nhau khi chúng bị tách rời — một codec tự cắt và mượn bước ghép lại cấu trúc tiêu chuẩn cho phần còn lại. Khi đó, cắt theo một tập token và ghép lại theo một tập khác sẽ gây ra đúng lỗi này. Một codec sở hữu cả hai nửa không thể gặp lỗi này: bước ghép lại của chính nó chịu trách nhiệm cho các token của chính nó.

Thông báo được phát ra, nêu token không phân giải được và tệp mà token đó được gắn với:

reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens (token "<token>", file "<file>") (reassemble nêu một token đơn vị đã vá mà bước cắt không tạo ra; một codec tuân thủ cắt và ghép lại một tệp theo cùng các token (token, tệp))

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra lỗi này. Nếu provider là của bạn, hãy làm cho các token mà một nửa tạo ra chính là các token mà nửa kia phân giải: suy ra chúng một lần rồi mang theo, thay vì suy ra độc lập ở mỗi bên, và khi bước cắt viết lại một tệp trước khi tách, hãy ghép lại theo đúng dạng đã viết lại đó. Nếu provider không phải của bạn, hãy báo cho bên phát hành nó, trích dẫn token mà thông báo nêu.

Một workload khai báo một dạng mà compose không thể biểu diễn

Provider compose kết xuất các dịch vụ chạy lâu dài. Một workload khai báo rằng nó chạy một bản trên mỗi máy, chạy theo lịch, hoặc chạy một lần rồi kết thúc không có tương đương gọn gàng trên một máy duy nhất, nên quá trình kết xuất dừng lại thay vì phát ra một dịch vụ thông thường — thứ sẽ khởi động nó, giữ nó chạy và thể hiện sai điều đã được yêu cầu.

Thông báo được phát ra. Điều kiện nêu loại lỗi — một provider không có cách biểu diễn cho điều mà bản build khai báo — và câu của chính provider nêu dạng mà nó đã nhận:

a plugin has no expression for a construct this build declares (một plugin không có cách biểu diễn cho một cấu trúc mà bản build này khai báo) compose: workload form "<form>" has no compose mapping; compose supports stateless and stateful only: compose cannot express this workload form (compose: dạng workload không có ánh xạ compose; compose chỉ hỗ trợ stateless và stateful: compose không thể biểu diễn dạng workload này)

Cách khắc phục: nếu đích thực sự là một môi trường compose trên một máy duy nhất, hãy biểu diễn công việc dưới dạng một dịch vụ chạy lâu dài — các dạng stateless và stateful là hai dạng mà nó kết xuất. Nếu dạng đó đúng là điều bạn muốn, hãy kết xuất boundary đó qua một provider có đích có dạng tương đương: một bản trên mỗi máy, một lần chạy theo lịch và một job chạy đến khi hoàn tất đều có cách biểu diễn trực tiếp ở nơi khác, và việc chọn provider thuộc về boundary chứ không thuộc về workload.

Một container khai báo một trường mà compose không có primitive tương ứng

Hai trường của container không có tương đương trong compose, và cả hai đều dừng quá trình kết xuất thay vì bị bỏ qua.

Các hook chạy khi một container khởi động hoặc sắp dừng. compose không có gì để chạy chúng, và một hook lặng lẽ không được chạy là một bất ngờ về tính đúng đắn, chỉ lộ ra lúc chạy thay vì lúc build.

Môi trường hàng loạt lấy từ một đối tượng có tên. compose có thể đọc biến từ một tệp, nhưng một tham chiếu đến đối tượng không phải là một tệp — diễn giải cái này thành cái kia sẽ thay đổi những gì container nhận được mà không báo ra.

Cả hai đều được kiểm tra với các container thông thường và với các container chạy trước container chính, nên cùng một trường sẽ dừng ở bất cứ nơi nào nó được khai báo và thông báo nêu container mà nó thuộc về.

Các thông báo được phát ra. Cả hai đều báo cùng một điều kiện — một provider không có cách biểu diễn cho điều mà bản build khai báo — và câu của chính provider cho biết đó là trường nào:

a plugin has no expression for a construct this build declares (một plugin không có cách biểu diễn cho một cấu trúc mà bản build này khai báo) compose: node "<node>" container "<container>": compose: node "<node>" declares container lifecycle hooks; compose has no lifecycle-hook primitive: compose has no lifecycle-hook primitive; container declares lifecycle hooks (compose: node, container: compose: node khai báo các lifecycle hook của container; compose không có primitive lifecycle-hook: compose không có primitive lifecycle-hook; container khai báo các lifecycle hook)

a plugin has no expression for a construct this build declares (một plugin không có cách biểu diễn cho một cấu trúc mà bản build này khai báo) compose: node "<node>" container "<container>": compose: node "<node>" declares container envFrom; compose has no env-from-object primitive: compose has no env-from-object primitive; container declares envFrom (compose: node, container: compose: node khai báo envFrom của container; compose không có primitive env-from-object: compose không có primitive env-from-object; container khai báo envFrom)

Cách khắc phục: với đích compose, hãy bỏ trường đó và thực hiện công việc của nó theo cách khác — công việc khởi động thuộc về một container chạy trước container chính, còn công việc tắt thuộc về việc xử lý tín hiệu của chính container; môi trường hàng loạt có thể được viết ra thành các biến tường minh, hoặc cung cấp từ một tệp mà đích compose có thể đọc. Nếu trường đó đúng là điều bạn muốn, hãy kết xuất boundary đó qua một provider có đích có primitive tương ứng.

Một mục omits nêu một kind hoặc một namespace mà tệp compose không có

Một mục omits: trên một Recipe hoặc một FeatureRecipe lấy nguồn từ một tệp compose sẽ loại bỏ một đơn vị cấp cao nhất của tệp đó, và một tệp compose có đúng ba kind mà một mục có thể nêu — một service, một volume và một config, mỗi cái được đặt khóa dưới services:, volumes: hoặc configs: — và không có namespace. Một mục nêu bất kỳ kind nào khác, trong đó có Secret của một tài liệu chart hay network của compose, hoặc mang một namespace, không nêu được gì mà tệp có thể loại bỏ, nên quá trình kết xuất dừng lại thay vì coi mục đó là một mục không khớp gì. Các kind được so sánh chính xác, nên Service bị từ chối khi ý định là service. Mọi mục đều được kiểm tra trước khi loại bỏ bất cứ thứ gì, và mục lỗi đầu tiên, theo thứ tự các mục được viết, là mục được nêu.

Các thông báo được phát ra. Cả hai đều báo điều kiện cho một cấu trúc mà provider không có cách biểu diễn, và câu của chính provider nêu mục đó cùng các kind mà nó chấp nhận. Một trường có template đọc một giá trị được khai báo là nhạy cảm sẽ hiển thị là <redacted>:

a plugin has no expression for a construct this build declares (một plugin không có cách biểu diễn cho một cấu trúc mà bản build này khai báo) compose: an omits entry (name "<name>") names kind "<kind>": compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind (compose: một mục omits (tên) nêu kind: compose loại bỏ một service, một volume hoặc một config, mỗi cái được nêu bằng khóa của nó dưới services:, volumes: hoặc configs:, và không kind nào khác)

a plugin has no expression for a construct this build declares (một plugin không có cách biểu diễn cho một cấu trúc mà bản build này khai báo) compose: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a compose file has no namespaces: compose leaves out a service, a volume or a config, each named by its key under services:, volumes: or configs:, and no other kind; remove the namespace from the entry (compose: một mục omits (kind, tên) nêu namespace, trong khi tệp compose không có namespace: compose loại bỏ một service, một volume hoặc một config, mỗi cái được nêu bằng khóa của nó dưới services:, volumes: hoặc configs:, và không kind nào khác; hãy bỏ namespace khỏi mục)

Cách khắc phục: nêu đơn vị theo cách tệp compose nêu — kind: service, volume hoặc config, và name: là khóa của nó dưới mục đó — và bỏ namespace:. Xem compose → Chế độ lấy nguồn.

An omits entry names a namespace a CloudFormation template does not have (Một mục omits nêu tên một namespace mà template CloudFormation không có)

Một mục omits: trên một Recipe hoặc một FeatureRecipe lấy nguồn từ một template CloudFormation sẽ loại bỏ một tài nguyên, được nêu tên bằng Type của nó làm kind của mục và logical ID của nó làm name của mục. Template không có namespace, nên một mục mang namespace không nêu tên thứ gì mà template có thể loại bỏ, và quá trình render dừng lại thay vì coi mục đó là một mục không khớp với gì. Mọi mục đều được kiểm tra trước khi bất cứ thứ gì bị loại bỏ, và mục đầu tiên mang namespace, theo thứ tự các mục được viết, là mục được nêu tên.

Thông báo được phát ra. Thông báo báo cáo điều kiện cho một cấu trúc mà provider không có cách biểu đạt, và câu riêng của provider nêu tên mục đó cùng những gì provider này loại bỏ. Một trường có template đọc một giá trị được khai báo là nhạy cảm sẽ hiển thị là <redacted>:

a plugin has no expression for a construct this build declares (một plugin không có cách biểu đạt cho một cấu trúc mà bản dựng này khai báo) cloudformation-provider: an omits entry (kind "<kind>", name "<name>") names namespace "<namespace>", and a CloudFormation template has no namespaces: cloudformation leaves out a resource, named by its Type as the entry’s kind and its logical ID under Resources as the entry’s name; remove the namespace from the entry (cloudformation-provider: một mục omits nêu tên một namespace, và template CloudFormation không có namespace: cloudformation loại bỏ một tài nguyên, được nêu tên bằng Type của nó làm kind của mục và logical ID của nó dưới Resources làm name của mục; hãy xóa namespace khỏi mục)

Cách khắc phục: bỏ namespace: khỏi mục, vốn chỉ nêu tên tài nguyên bằng Type và logical ID của nó. Xem cloudformation → Loại bỏ tài nguyên khỏi một template có nguồn.

A published port declares a transport compose cannot spell (Một cổng được công bố khai báo giao thức truyền tải mà compose không thể viết ra)

Một cổng compose được công bố mang giao thức truyền tải của nó dưới dạng hậu tố trên mục, và hậu tố đó có hai cách viết. Một cổng khai báo bất kỳ giao thức truyền tải nào khác hoàn toàn không có cách viết trong compose.

Quá trình dừng lại thay vì bỏ hậu tố, vì một cổng được công bố âm thầm quay về giao thức truyền tải mặc định sẽ khởi chạy với lưu lượng mà các client của nó không thể tiếp cận — đúng là lỗi mà việc khai báo giao thức truyền tải tồn tại để ngăn chặn, bị đưa trở lại ngay lúc chuyển đổi.

Một cổng không khai báo giao thức truyền tải không bị ảnh hưởng. Cổng đó được công bố không có hậu tố, đúng như một cổng chưa từng mang giao thức truyền tải.

Thông báo được phát ra. Điều kiện nêu loại lỗi — một giá trị không có cách biểu diễn trong những gì provider phát ra — và câu riêng của provider theo sau:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được truyền cho nó) compose: node "<node>" apply service ports: compose publishes a port’s transport as a tcp or udp suffix; this port declares a transport compose cannot express (compose: node, áp dụng cổng service: compose công bố giao thức truyền tải của cổng dưới dạng hậu tố tcp hoặc udp; cổng này khai báo một giao thức truyền tải mà compose không thể biểu đạt)

Cách khắc phục: với target compose, hãy khai báo giao thức truyền tải của cổng là một trong hai giao thức compose có thể viết ra, hoặc để trống và để mục được công bố không có hậu tố. Nếu giao thức truyền tải đó đúng là điều bạn muốn, hãy render boundary đó qua một provider có target biểu đạt được nó.

A resources quantity cannot be converted to a compose value (Một lượng tài nguyên không thể chuyển thành giá trị compose)

Các lượng bộ xử lý và bộ nhớ của một container, cùng số lượng nvidia.com/gpu của nó, được viết theo ký pháp Kubernetes dùng cho tài nguyên, còn compose mang chúng theo đơn vị riêng — số GPU trở thành số lượng của một yêu cầu đặt trước thiết bị NVIDIA — nên mỗi giá trị được đọc như một lượng và được chuyển đổi từ giá trị của nó. Có hai điều ngăn việc này, và thông báo cho biết đã gặp điều nào: một giá trị hoàn toàn không phải là một lượng, và một lượng mà compose không có dạng chính xác — một lượng âm, một lượng bộ nhớ không phải là số nguyên byte, một lượng bộ xử lý mịn hơn chín chữ số thập phân của một lõi, một số GPU không phải là số nguyên thiết bị, hoặc một lượng vượt quá giá trị lớn nhất compose có thể chứa. Một container có request và limit nvidia.com/gpu yêu cầu các số lượng khác nhau cũng dừng lại, vì compose chỉ đặt trước một số lượng cho một service. Quá trình dừng lại thay vì làm tròn giá trị hay phát ra một giá trị xấp xỉ, vì một limit âm thầm không phải là limit đã được yêu cầu là loại khác biệt không ai tìm kiếm cho đến khi có thứ bị dừng vì vượt quá nó.

Các thông báo được phát ra. Mỗi thông báo mở đầu bằng điều kiện — một giá trị không có cách biểu diễn trong những gì provider phát ra — rồi nêu tên tài nguyên, giá trị là request hay limit, đường dẫn của nó trong Workload và giá trị đó. Một giá trị không phải là lượng được theo sau bởi lý do khiến nó không phải là lượng và dạng mà một lượng có:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được truyền cho nó) compose: node "<node>" container "<container>": compose: the <cpu|memory|nvidia.com/gpu> <request|limit> at <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): resources quantity cannot be converted to a compose deploy.resources value (compose: node, container: compose: giá trị tại đường dẫn không phải là một lượng; một lượng là một số như 2, 0.5 hoặc 1.5, có dấu tùy chọn và tối đa một trong hai: số mũ nguyên (1e3, 5E-2) hoặc hậu tố đơn vị (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei): lượng tài nguyên không thể chuyển thành giá trị deploy.resources của compose)

Một lượng mà compose không thể biểu diễn được theo sau bởi phạm vi compose chứa được cho tài nguyên đó:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được truyền cho nó) compose: node "<node>" container "<container>": compose: the memory <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose memory value is a whole number of bytes from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: node, container: compose: giá trị bộ nhớ tại đường dẫn là một lượng compose không thể biểu diễn chính xác; giá trị bộ nhớ của compose là số nguyên byte từ 0 đến 9223372036854775807: lượng tài nguyên không thể chuyển thành giá trị deploy.resources của compose)

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được truyền cho nó) compose: node "<node>" container "<container>": compose: the cpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose cpus value is a core count from 0 to 9223372036.854775807 with at most nine decimal places: resources quantity cannot be converted to a compose deploy.resources value (compose: node, container: compose: giá trị cpu tại đường dẫn là một lượng compose không thể biểu diễn chính xác; giá trị cpus của compose là số lõi từ 0 đến 9223372036.854775807 với tối đa chín chữ số thập phân: lượng tài nguyên không thể chuyển thành giá trị deploy.resources của compose)

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được truyền cho nó) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu <request|limit> at <path> is "<value>", a quantity compose cannot represent exactly; a compose device count is a whole number of devices from 0 to 9223372036854775807: resources quantity cannot be converted to a compose deploy.resources value (compose: node, container: compose: giá trị nvidia.com/gpu tại đường dẫn là một lượng compose không thể biểu diễn chính xác; số thiết bị của compose là số nguyên thiết bị từ 0 đến 9223372036854775807: lượng tài nguyên không thể chuyển thành giá trị deploy.resources của compose)

Một request và limit GPU yêu cầu các số lượng khác nhau sẽ nêu cả hai đường dẫn và cả hai số lượng:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được truyền cho nó) compose: node "<node>" container "<container>": compose: the nvidia.com/gpu request at <path> and the limit at <path> ask for different counts (<request> and <limit>); compose reserves one device count for a service, so write the same count in both or only the limit: resources quantity cannot be converted to a compose deploy.resources value (compose: node, container: compose: request nvidia.com/gpu và limit tại các đường dẫn yêu cầu các số lượng khác nhau; compose chỉ đặt trước một số thiết bị cho một service, vì vậy hãy viết cùng một số lượng ở cả hai hoặc chỉ viết limit: lượng tài nguyên không thể chuyển thành giá trị deploy.resources của compose)

Khi template của Workload đọc một giá trị mà tác giả đã khai báo là nhạy cảm, không thông báo nào trích dẫn giá trị bị từ chối, và hai số lượng cũng được lược bỏ theo cùng cách.

Cách khắc phục: khi giá trị không phải là một lượng, hãy viết nó theo dạng được mô tả trong Workload → Lượng tài nguyên; một hậu tố trơn như m là thứ template để lại khi giá trị nó nội suy bị rỗng, nên đầu vào cần sửa là đầu vào mà template đã đọc. Khi đó là một lượng compose không thể biểu diễn, hãy viết một lượng nằm trong phạm vi thông báo nêu — bộ nhớ là số nguyên byte theo đơn vị bất kỳ (1536Mi thay vì 1.5001Gi), thời gian bộ xử lý tối đa chín chữ số thập phân của một lõi, và số GPU là số nguyên thiết bị (1, không phải 0.5 hay 500m). Khi request và limit GPU không khớp, hãy viết cùng một số lượng ở cả hai, hoặc chỉ viết limit, vốn là số lượng Kubernetes lập lịch cho cùng Workload đó.

Một lượng tài nguyên mà helm provider phát ra không phải là một lượng

Helm provider sao chép nguyên văn mọi lượng tài nguyên vào các manifest mà nó phát ra — các giá trị resources.requests và resources.limits của mỗi container và mỗi init container, kể cả các tài nguyên mở rộng, cùng ephemeral.sizeLimit, persistent.size và persistentTemplate.size của mỗi volume — và trước hết kiểm tra từng giá trị theo dạng của một lượng, trên Workload như các template của Recipe đã đánh giá nó. Một giá trị nằm ngoài dạng đó sẽ dừng bản build tại đây, nơi mà nếu không thì nó sẽ build thành công rồi bị cluster từ chối khi chart được cài đặt.

Thông báo được phát ra. Thông báo mở đầu bằng điều kiện, sau đó nêu tên node, đường dẫn của trường trong Workload, giá trị và lý do khiến nó không phải là một lượng, rồi nêu dạng của một lượng:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được trao cho nó) helm: node "<node>": <path>: "<value>" is not a quantity: <reason>; a quantity is a number such as 2, 0.5 or 1.5, with an optional sign and at most one of an integer exponent (1e3, 5E-2) or a unit suffix (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei) (helm: node: giá trị không phải là một lượng; một lượng là một số như 2, 0.5 hoặc 1.5, có dấu tùy chọn và tối đa một trong hai: số mũ nguyên (1e3, 5E-2) hoặc hậu tố đơn vị (n, u, m, k, M, G, T, P, E, Ki, Mi, Gi, Ti, Pi, Ei))

Cách khắc phục: viết giá trị theo dạng được nêu trong Workload → Lượng tài nguyên. Khi trường được tạo từ template, giá trị cần sửa là giá trị mà template đã đọc: một hậu tố trơn như m hoặc Mi là thứ template để lại khi giá trị mà nó nội suy bị rỗng, và một tham số của Release đến trường đúng như nó đã được viết.

Một kiểu service mà helm provider không thể render

Helm provider render mỗi mục services của Workload thành một Kubernetes Service có kiểu là type của mục đó. Một mục Loopback yêu cầu các cổng của nó chỉ có thể truy cập từ địa chỉ loopback của chính máy chủ và không từ đâu khác, và Kubernetes Service không có kiểu nào làm được điều đó: một Service NodePort lắng nghe trên những địa chỉ node nào là thiết lập của toàn bộ cluster, không phải của một Service. Vì vậy bản build dừng ở mục Loopback đầu tiên, theo thứ tự các service được khai báo, trước khi bất kỳ tài nguyên nào được ghi.

Nó dừng thay vì render mục đó thành một kiểu khác, vì mỗi kiểu mà Service có đều thay đổi phạm vi mà cổng vươn tới: một Service ClusterIP bỏ mất phạm vi công bố mà mục đó yêu cầu, còn một Service NodePort công bố cổng trên mọi địa chỉ node mà cluster cho phép — chính mức phơi bày rộng hơn mà mục đó tồn tại để tránh.

Thông báo được phát ra. Thông báo mở đầu bằng điều kiện, sau đó nêu tên node, đường dẫn của service trong Workload và kiểu:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được trao cho nó) helm: node "<node>": services.<service>: type “Loopback” publishes the service’s ports on the host’s loopback address only, and a Kubernetes Service has no type that does; declare ClusterIP to keep the ports inside the cluster, or NodePort or LoadBalancer to publish them outside it (helm: node: services: kiểu “Loopback” chỉ công bố các cổng của service trên địa chỉ loopback của máy chủ, và Kubernetes Service không có kiểu nào làm vậy; hãy khai báo ClusterIP để giữ các cổng bên trong cluster, hoặc NodePort hay LoadBalancer để công bố chúng ra bên ngoài)

Cách khắc phục: với target helm, hãy khai báo kiểu nói rõ cổng cần vươn xa đến đâu trong cluster — ClusterIP để giữ nó bên trong, NodePort hoặc LoadBalancer để công bố nó. Mục Loopback dành cho target compose, vốn công bố cổng trên 127.0.0.1; xem Workload → services.

Một phiên bản Kubernetes mà helm provider không thể render chart cho nó

Helm provider render một chart từ mã nguồn cho phiên bản Kubernetes mà annotation aggrega.ai/kubernetes-version nêu trên một component hoặc trên boundary của nó, và đọc giá trị đó theo cách helm template --kube-version đọc flag của nó. Một giá trị mà flag đó sẽ từ chối — "one.two", "latest", một số đơn lẻ như "1", một số viết với số 0 đứng đầu như "01.20" — không có phiên bản nào để chart đọc làm .Capabilities.KubeVersion, nên bản build dừng trước khi chart được render.

Nó dừng thay vì render chart cho phiên bản mặc định, vì chart đọc phiên bản để chọn một phiên bản API, một trường hoặc cả một cơ chế, và một chart được render cho phiên bản khác với phiên bản bạn đã nêu sẽ phát ra hình dạng cho phiên bản khác đó — một hình dạng mà cluster nó được triển khai tới có thể không chạy được.

Giá trị rỗng không bị từ chối. Nó được coi là chưa đặt, và chart được render cho phiên bản mặc định: phiên bản mà helm template gốc của cùng bản phát hành helm render cho.

Thông báo được phát ra. Thông báo mở đầu bằng điều kiện, sau đó nêu tên node và boundary chứa nó, annotation, giá trị và lý do khiến nó không phải là một phiên bản, rồi nêu dạng cần viết:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị được trao cho nó) helm: node "<node>" in boundary "<boundary>": annotation aggrega.ai/kubernetes-version: "<value>" is not a Kubernetes version a chart can be rendered for: <reason>; write the version of the cluster the chart deploys to, such as “1.31” or “v1.31.2”, on the component or on its boundary (helm: node trong boundary: annotation aggrega.ai/kubernetes-version: giá trị không phải là một phiên bản Kubernetes mà chart có thể được render cho; hãy viết phiên bản của cluster mà chart được triển khai tới, chẳng hạn “1.31” hoặc “v1.31.2”, trên component hoặc trên boundary của nó)

Thông báo nêu cả node lẫn boundary của nó vì provider đọc các annotation của một component cùng với các annotation của boundary của nó, trong đó giá trị của chính component được ưu tiên, nên giá trị có thể đã được viết ở một trong hai nơi.

Cách khắc phục: viết phiên bản của cluster mà chart được triển khai tới — một phiên bản major và minor như "1.31", hoặc một phiên bản đầy đủ như "v1.31.2" — trên component hoặc trên boundary của nó, hoặc xóa annotation để render cho phiên bản mặc định. Xem helm → Phiên bản Kubernetes mà chart được render cho.

Một health probe không thể chuyển thành healthcheck của compose

Một health probe được khai báo sẽ trở thành một healthcheck của compose, và có hai điều có thể ngăn việc đó.

Một probe kiểm tra một đường dẫn qua HTTP, trên một container không công bố cổng nào. Việc kiểm tra được xây dựng như một request tới một cổng trên container, nên khi không có cổng nào được khai báo thì không có địa chỉ nào để xây dựng nó.

Một probe hoàn toàn không khai báo cách kiểm tra nào — không có đường dẫn, không có cổng để kết nối, cũng không có lệnh để chạy. Không có gì để chuyển thành một lần kiểm tra. Trường hợp này là một lớp bảo vệ phía sau schema chứ không phải một hình dạng bạn có khả năng viết ra: một probe đã được kiểm tra xem có một trong ba cách đó hay không trước khi đến đây.

Các thông báo được phát ra. Cả hai đều báo cùng một điều kiện — một thứ provider cần mà nó không thể phân giải thành đúng một giá trị — và câu riêng của provider cho biết trường hợp nào:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị) compose: node "<node>" container "<container>": probe http: requires at least one container port; container declares none (compose: node, container: probe http: cần ít nhất một cổng container; container không khai báo cổng nào)

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị) compose: node "<node>" container "<container>": probe declares no shape (http/tcp/exec) (compose: node, container: probe không khai báo hình dạng nào (http/tcp/exec))

Cách khắc phục: khai báo cổng mà việc kiểm tra cần thực hiện trên đó, trong cùng container với probe — một probe qua HTTP đọc cổng container đầu tiên, nên cổng phải tồn tại để việc kiểm tra được xây dựng. Khi container thực sự không công bố gì, hãy kiểm tra nó theo cách khác: một probe chạy lệnh không cần cổng. Với một probe không khai báo cách kiểm tra nào, hãy cho nó một trong ba cách.

A configmap volume has no file behind it (Một volume configmap không có tệp nào phía sau)

Một volume gắn cấu hình được cung cấp qua cơ chế riêng của compose dành cho nó, được tham chiếu theo tên, và mục chứa nội dung đến từ một tệp mà Recipe phát ra. Điều kiện này là thứ mà một tham chiếu không có mục tương ứng báo cáo: tệp không có ở đó, nên điểm gắn sẽ tồn tại mà không có gì phía sau và container sẽ khởi động với việc đọc một đường dẫn rỗng.

Việc kiểm tra chạy trên toàn bộ đầu ra đã được lắp ráp thay vì theo từng component, và điều đó là có chủ ý: tham chiếu và mục chứa nội dung đến theo những con đường khác nhau và có thể đến từ các component khác nhau của cùng một nhóm, nên đầu ra đã lắp ráp là điểm đầu tiên mà cả hai đều có mặt. Một phép kiểm tra theo từng component sẽ từ chối một tham chiếu có nội dung do một component khác trong cùng nhóm cung cấp.

Mọi tham chiếu chưa được phân giải đều được báo cáo chứ không chỉ tham chiếu đầu tiên, theo một thứ tự ổn định, nên một lần build nêu tên tất cả chúng.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là từng service, tham chiếu mà nó tạo ra và nơi nó được gắn:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị) compose AssembleBoundary: service "<service>" references config "<name>" mounted at "<path>"; declare each one as a top-level configs: entry from the Recipe’s artifacts: input: configmap volume requires a file emitted via the Recipe’s artifacts: input; none found (compose AssembleBoundary: service tham chiếu config được gắn tại; hãy khai báo mỗi config là một mục configs: cấp cao nhất từ đầu vào artifacts: của Recipe: volume configmap cần một tệp được phát ra qua đầu vào artifacts: của Recipe; không tìm thấy tệp nào)

Cách khắc phục: phát ra tệp từ đầu vào artifacts: của Recipe dưới tên mà volume tham chiếu — hai thứ được khớp theo tên đó, nên sự không khớp giữa thứ volume yêu cầu và thứ Recipe phát ra là nguyên nhân thường gặp. Khi nội dung vốn định đến từ nơi khác, volume là cơ chế sai cho nó: một giá trị thuộc về môi trường thì đặt vào đó.

What an omits entry left out is still named by the compose file (Thứ mà một mục omits đã loại bỏ vẫn được tệp compose nêu tên)

Một mục omits: loại bỏ một service, một volume hoặc một config khỏi một tệp compose có nguồn, và compose từ chối một tệp nêu tên một thứ mà nó không khai báo. Vì vậy, khi các đơn vị của các mục đã bị loại bỏ, mọi tham chiếu mà phần còn lại của tệp vẫn tạo tới một trong số chúng đều dừng quá trình render: một service được nêu tên bởi depends_on, links, volumes_from, extends, một giá trị build.additional_contexts hoặc một chế độ network, IPC, PID hay UTS dạng service:; một volume được nêu tên làm nguồn của một mục volumes:; một config được nêu tên bởi một mục configs: — được đọc trong từng service, các hook pre_start của từng service và từng job. Danh sách đầy đủ, cùng các giá trị chỉ trông giống tham chiếu, có trong compose → Chế độ có nguồn.

Phép kiểm tra đọc chính tệp của Recipe hoặc FeatureRecipe khai báo, nên nó dừng quá trình render ngay cả khi một bên đóng góp khác vào cùng tệp đã lắp ráp khai báo một đơn vị trùng tên với đơn vị bị loại bỏ. Mọi tham chiếu đều được báo cáo chứ không chỉ tham chiếu đầu tiên — các service theo thứ tự khóa, rồi đến các job, các hook của mỗi service đứng sau nó — nên một lần build nêu tên tất cả chúng.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là từng mục tham chiếu, đơn vị mà nó nêu tên và trường chứa tham chiếu:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị) compose: what an omits entry left out is still named by the file: service "<service>" names <kind> "<name>" at <field>; compose refuses a file naming a service, a volume or a config it does not declare: leave out what names it as well, change the reference through valuesMapping, or remove the entry (compose: thứ mà một mục omits đã loại bỏ vẫn được tệp nêu tên: service nêu tên tại; compose từ chối một tệp nêu tên một service, một volume hoặc một config mà nó không khai báo: hãy loại bỏ cả thứ nêu tên nó, thay đổi tham chiếu qua valuesMapping, hoặc xóa mục đó)

Một đơn vị có tên mục được tạo từ một giá trị được khai báo là nhạy cảm sẽ được hiển thị là <redacted>.

Cách khắc phục: quyết định bạn muốn điều nào trong hai điều. Khi service tham chiếu vẫn cần đơn vị đó, hãy giữ nó: xóa mục. Khi không cần, hãy thay đổi tham chiếu qua valuesMapping: của Recipe — một danh sách ở đó thay thế danh sách của tệp gốc, nên depends_on: [] xóa một danh sách — hoặc loại bỏ service tham chiếu bằng một mục riêng của nó.

What an omits entry left out is still named by a CloudFormation template (Thứ mà một mục omits đã loại bỏ vẫn được một template CloudFormation nêu tên)

Một mục omits: loại bỏ một resource khỏi một template CloudFormation có nguồn, và CloudFormation từ chối một template nêu tên một resource mà nó không khai báo. Vì vậy, khi các resource của các mục đã bị loại bỏ, mọi tham chiếu mà các template còn lại vẫn tạo tới một trong số chúng đều dừng quá trình render: một Ref, một Fn::GetAtt ở dạng danh sách hoặc dạng chuỗi có dấu chấm, DependsOn của một resource, hoặc một biến của Fn::Sub — được đọc ở bất kỳ đâu trong phần thân của từng resource và từng output. Danh sách đầy đủ, cùng các giá trị chỉ trông giống tham chiếu, có trong cloudformation → Loại bỏ resource khỏi một template có nguồn.

Phép kiểm tra đọc cùng lúc chính các template của Recipe hoặc FeatureRecipe khai báo: một tham chiếu tới một logical ID mà một template khác trong số đó vẫn khai báo thì không bị dừng, còn một tham chiếu tới resource đã bị loại bỏ sẽ dừng quá trình render ngay cả khi một component khác khai báo một resource có logical ID đó. Mọi tham chiếu đều được báo cáo chứ không chỉ tham chiếu đầu tiên — từng template theo thứ tự nguồn chứa chúng, các resource của mỗi template rồi đến các output của nó theo thứ tự khóa — nên một lần build nêu tên tất cả chúng.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là từng tham chiếu: template chứa nó, resource mà nó nêu tên, cách nó nêu tên, và vị trí của nó dưới dạng đường dẫn từ gốc của template:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị) cloudformation-provider: what an omits entry left out is still named by the source’s templates: template "<template>" names resource "<logical-id>" (type "<type>") by <Ref|Fn::GetAtt|DependsOn|Fn::Sub> at <path>; CloudFormation refuses a template naming a resource it does not declare: leave out what names it as well, or remove the entry (cloudformation-provider: thứ mà một mục omits đã loại bỏ vẫn được các template của nguồn nêu tên: template nêu tên resource (kiểu) bằng tại; CloudFormation từ chối một template nêu tên một resource mà nó không khai báo: hãy loại bỏ cả thứ nêu tên nó, hoặc xóa mục đó)

Khi các trường của một mục được tạo từ một giá trị được khai báo là nhạy cảm, logical ID và kiểu của resource đó được hiển thị là <redacted>, và mọi bước của đường dẫn viết ra logical ID đó cũng vậy.

Cách khắc phục: quyết định bạn muốn điều nào trong hai điều. Khi resource tham chiếu vẫn cần resource đã bị loại bỏ, hãy giữ nó: xóa mục. Khi không cần, hãy loại bỏ cả resource tham chiếu bằng một mục riêng của nó — một giá trị gắn với một parameter chỉ thay thế tham chiếu tới parameter đó, nên không thể dùng nó để thay đổi tham chiếu tới một resource. Một output nêu tên resource không thể bị loại bỏ, nên resource mà một output nêu tên sẽ được giữ lại.

A valuesMapping key names no parameter of a sourced CloudFormation template (Một khóa valuesMapping không nêu tên parameter nào của một template CloudFormation có nguồn)

Một template CloudFormation có nguồn nhận giá trị qua các Parameters mà nó khai báo, và valuesMapping của Recipe hoặc FeatureRecipe lấy nguồn từ nó ghi một khóa cho mỗi parameter mà nó điền. Một khóa không nêu tên parameter nào mà bất kỳ template nào của nguồn khai báo thì không có chỗ để đi, nên quá trình render dừng lại thay vì bỏ nó đi — chính lỗi mà CloudFormation sẽ báo cho một parameter không xác định, được báo khi bạn vẫn còn có thể sửa. Chỉ một valuesMapping mới điền parameter: các giá trị không được ánh xạ sẽ không bao giờ được đọc theo cách này, nên các giá trị riêng của một component hoặc một attachment được viết cho các đầu vào khác của nó sẽ không bao giờ gặp lỗi này.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là mọi khóa không nêu tên gì và những gì mỗi template của nguồn khai báo:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị) cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping writes the key "<key>", and no template of the source declares a parameter of that name: template "<template>" declares "<parameter>", …; a sourced template takes values only through the parameters it declares, so rename the key to the parameter it is meant for, or remove it from the valuesMapping (cloudformation-provider: valuesMapping của Recipe hoặc FeatureRecipe ghi khóa, và không template nào của nguồn khai báo một parameter có tên đó: template khai báo, …; một template có nguồn chỉ nhận giá trị qua các parameter mà nó khai báo, nên hãy đổi tên khóa thành parameter mà nó dành cho, hoặc xóa nó khỏi valuesMapping)

Cách khắc phục: so sánh khóa với các parameter mà thông báo liệt kê — một khóa viết sai chính tả là nguyên nhân thường gặp — và đổi tên nó, hoặc xóa nó khỏi valuesMapping. Xem cloudformation → Giá trị cho các parameter của một template có nguồn.

Một component khác tham chiếu đến một tham số CloudFormation mà ràng buộc của một template có nguồn đã điền

Việc điền một tham số của template có nguồn thông qua valuesMapping của Recipe hoặc của FeatureRecipe thuộc Feature được gắn đã lấy nguồn template đó sẽ thay thế mọi tham chiếu đến tham số trong mọi template của nguồn đó và xóa khai báo của nó. Nội dung từ nơi khác trong cùng stack đã lắp ráp — fragment hoặc template có nguồn của một component khác, hoặc fragment của component mà một Feature được gắn vào — nếu vẫn gọi tên tham số qua Ref, một biến Fn::Sub hoặc Fn::ValueOf của một rule thì khi đó sẽ gọi tên một thứ mà stack không còn khai báo, điều mà CloudFormation từ chối khi stack được triển khai, vì vậy quá trình lắp ráp dừng lại. Một tên mà một component nào đó của stack vẫn khai báo, dưới dạng tham số của riêng nó hoặc logical ID của một resource, là một tham chiếu mà stack phân giải được và không bị dừng.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là mọi tham chiếu: component và template chứa nó, tham số, và component có valuesMapping của Recipe hoặc FeatureRecipe được gắn đã điền tham số đó — một Feature được gắn vào một component được gọi tên theo component đó, còn một Feature được gắn vào một boundary được gọi theo danh tính mà các resource của nó mang dưới dạng aggrega.ai/component-id, ghép từ đường dẫn của boundary và tên của attachment, chẳng hạn bfr--stack--aux:

a plugin could not resolve something it requires to exactly one value cloudformation-provider: a parameter a sourced template’s binding filled is still referenced from elsewhere in the assembled stack: component "<component>"’s template "<template>" references parameter "<parameter>", which the valuesMapping of a Recipe or FeatureRecipe rendering for component "<component>" binds; …; binding a parameter removes its declaration from the source that declares it, and no template in the stack declares it any more, so the reference names nothing CloudFormation can resolve: reference what the binding component publishes instead, declare the parameter in the template that references it, or remove the key from the valuesMapping (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị: cloudformation-provider: một tham số mà ràng buộc của template có nguồn đã điền vẫn được tham chiếu từ nơi khác trong stack đã lắp ráp: template của component tham chiếu đến tham số, mà valuesMapping của một Recipe hoặc FeatureRecipe render cho component ràng buộc; …; ràng buộc một tham số sẽ xóa khai báo của nó khỏi nguồn khai báo nó, và không còn template nào trong stack khai báo nó, nên tham chiếu không gọi tên thứ gì CloudFormation có thể phân giải: hãy tham chiếu thứ mà component ràng buộc công bố, khai báo tham số trong template tham chiếu đến nó, hoặc xóa khóa khỏi valuesMapping)

Cách khắc phục: khi component tham chiếu cần giá trị đó, hãy để component điền nó công bố giá trị qua provides và tham chiếu đến đó; hoặc khai báo tham số trong template tham chiếu để nó nhận giá trị riêng; hoặc xóa khóa khỏi valuesMapping, để tham số vẫn được khai báo và mọi component đọc giá trị được truyền khi stack triển khai. Xem cloudformation → Giá trị cho các tham số của template có nguồn.

A value bound to a CloudFormation parameter cannot take the parameter’s type (Một giá trị ràng buộc với một tham số CloudFormation không thể nhận kiểu của tham số)

Một literal được ràng buộc với một tham số sẽ được chuyển đổi theo cách CloudFormation chuyển đổi cùng giá trị đó khi được truyền cho Type của tham số lúc stack triển khai. Khi không tồn tại phép chuyển đổi như vậy, quá trình render dừng lại: một giá trị không phải số được ràng buộc với Number hoặc List<Number>, một danh sách hoặc một mapping được ràng buộc với tham số chỉ nhận một giá trị, và bất kỳ literal nào được ràng buộc với tham số AWS::SSM::Parameter::Value<…>, vốn có giá trị được CloudFormation đọc từ Parameter Store thay vì từ template. Một danh sách được ràng buộc với một tham số mà template gọi tên như một biến Fn::Sub cũng làm dừng render, vì một biến chỉ thay thế một chuỗi.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là tham số, template và kiểu của nó, và lý do giá trị không phù hợp; không giá trị nào được trích dẫn:

a plugin has no representation for a value it was given cloudformation-provider: parameter "<parameter>" of template "<template>" is of type <type>, and <why the value does not fit> (một plugin không có cách biểu diễn cho một giá trị nó được cung cấp: cloudformation-provider: tham số của template có kiểu, và)

Cách khắc phục: ràng buộc một giá trị đúng kiểu của tham số — hoặc, với kiểu Parameter Store, một dynamic reference {{resolve:ssm:…}} hay một intrinsic function — hoặc để tham số không ràng buộc để nhận giá trị được truyền khi stack triển khai.

A value bound to a CloudFormation parameter is one its constraints refuse (Một giá trị ràng buộc với một tham số CloudFormation bị các ràng buộc của nó từ chối)

Một literal được ràng buộc với một tham số được kiểm tra theo các ràng buộc mà template khai báo cho nó — AllowedValues, AllowedPattern, MinLength, MaxLength, MinValue và MaxValue — tức phép kiểm tra CloudFormation thực hiện trên giá trị được truyền khi stack triển khai, được chuyển sang thời điểm build để việc điền một tham số không làm mất phép kiểm tra nào mà template đã khai báo. Một intrinsic function và một dynamic reference được để CloudFormation kiểm tra, vì giá trị của chúng chưa tồn tại cho đến khi stack triển khai.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là tham số, template của nó và ràng buộc; không giá trị nào được trích dẫn:

a plugin has no representation for a value it was given cloudformation-provider: the value bound to parameter "<parameter>" of template "<template>" does not satisfy its <constraint>, which CloudFormation would refuse when the stack deploys; bind a value the parameter admits (một plugin không có cách biểu diễn cho một giá trị nó được cung cấp: cloudformation-provider: giá trị được ràng buộc với tham số của template không thỏa mãn ràng buộc của nó, điều mà CloudFormation sẽ từ chối khi stack triển khai; hãy ràng buộc một giá trị mà tham số chấp nhận)

Cách khắc phục: ràng buộc một giá trị mà ràng buộc chấp nhận; chính khai báo tham số trong template liệt kê những gì nó cho phép.

A secret bound to a CloudFormation parameter would be written into the template (Một bí mật ràng buộc với một tham số CloudFormation sẽ bị ghi vào template)

Một giá trị được ràng buộc với một tham số sẽ được ghi vào template, nơi bất kỳ ai đọc được template của stack đều đọc được nó. Quá trình render dừng lại với một literal được ràng buộc với tham số mà template khai báo NoEcho, và, khi valuesMapping của Recipe hoặc FeatureRecipe đọc một giá trị mà tác giả đã khai báo là nhạy cảm, với mọi literal mà mapping đó ràng buộc, vì không đầu ra nào của nó có thể truy ngược về giá trị nguồn. Một dynamic reference và một intrinsic function được ghi đúng như đã cho — kể cả phần văn bản bên trong intrinsic — nên một giá trị nhạy cảm mà mapping ghép vào chuỗi Fn::Sub sẽ đến template dưới dạng văn bản đó, và chỉ dynamic reference mới giữ chính bí mật nằm ngoài template.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là các tham số và thứ nên ràng buộc thay thế; không giá trị nào được trích dẫn. Một trong:

a plugin has no representation for a value it was given cloudformation-provider: parameter "<parameter>" of template "<template>" is declared NoEcho, and the value bound to it would be written into the template as it stands; bind a dynamic reference ({{resolve:secretsmanager:…}} or {{resolve:ssm-secure:…}}) or an intrinsic function instead, or leave the parameter unbound for a deploy-time value (một plugin không có cách biểu diễn cho một giá trị nó được cung cấp: cloudformation-provider: tham số của template được khai báo NoEcho, và giá trị ràng buộc với nó sẽ bị ghi nguyên vào template; hãy ràng buộc một dynamic reference hoặc một intrinsic function thay thế, hoặc để tham số không ràng buộc để nhận giá trị lúc triển khai)

cloudformation-provider: the Recipe’s or FeatureRecipe’s valuesMapping reads a value declared sensitive, so a literal it produces is refused, and binding parameter(s) "<parameter>", … would write a literal into the template as it stands; … (cloudformation-provider: valuesMapping của Recipe hoặc FeatureRecipe đọc một giá trị được khai báo là nhạy cảm, nên literal nó tạo ra bị từ chối, và việc ràng buộc các tham số … sẽ ghi nguyên một literal vào template; …)

Cách khắc phục: lưu bí mật trong Secrets Manager hoặc dưới dạng secure string của Parameter Store và ràng buộc một dynamic reference đến nó — {{resolve:secretsmanager:<secret>}} hoặc {{resolve:ssm-secure:<name>}} — thay vì ghép nó vào văn bản của một intrinsic, hoặc để tham số không ràng buộc để nhận giá trị được truyền khi stack triển khai. Xem cloudformation → Giá trị cho các tham số của template có nguồn.

A dynamic reference is bound where CloudFormation does not resolve it (Một tham chiếu động được gắn ở nơi CloudFormation không phân giải nó)

CloudFormation phân giải một tham chiếu động trong các thuộc tính của một tài nguyên, nhưng không phân giải trong user data của EC2 và trong metadata AWS::CloudFormation::Init, và nó hiển thị Outputs của một template cho bất kỳ ai đọc stack. Vì vậy, một tham chiếu động được gắn vào một tham số mà bất kỳ template nào của nguồn tham chiếu trong một thuộc tính UserData, trong metadata đó hoặc trong Outputs của nó sẽ dừng quá trình render thay vì đi tới một nơi mà nó hoặc không thể triển khai hoặc bị lộ.

Thông báo được phát ra. Điều kiện đứng đầu, tiếp theo là tham số, template và nơi template đó tham chiếu nó; không giá trị nào được trích dẫn:

a plugin has no representation for a value it was given (một plugin không có cách biểu diễn cho một giá trị nó được trao) cloudformation-provider: the value bound to parameter "<parameter>" is a dynamic reference, and template "<template>" references the parameter in <where>, where CloudFormation does not resolve a dynamic reference or shows it to whoever reads the stack; bind an intrinsic function instead, or leave the parameter unbound for a deploy-time value (giá trị được gắn vào tham số là một tham chiếu động, và template tham chiếu tham số ở nơi CloudFormation không phân giải tham chiếu động hoặc hiển thị nó cho bất kỳ ai đọc stack; hãy gắn một hàm intrinsic thay thế, hoặc để tham số không được gắn để nhận giá trị lúc triển khai)

Cách khắc phục: để tham số không được gắn và truyền giá trị của nó khi stack được triển khai, hoặc gắn một hàm intrinsic cho ra thứ mà template cần ở đó.

A rule reads a bound CloudFormation parameter by name (Một rule đọc một tham số CloudFormation đã được gắn theo tên)

Fn::ValueOf trong Rules của một template gọi tên một tham số bằng logical ID của nó thay vì qua Ref, và đọc giá trị được truyền cho nó khi stack được triển khai. Việc gắn tham số sẽ xóa khai báo của nó khỏi mọi template của nguồn, điều này sẽ khiến rule — trong bất kỳ template nào trong số đó — không gọi tên gì cả, vì vậy quá trình render dừng lại.

Thông báo được phát ra. Điều kiện đứng đầu, tiếp theo là rule, template của nó và tham số:

a plugin has no expression for a construct this build declares (một plugin không có cách diễn đạt cho một cấu trúc mà bản build này khai báo) cloudformation-provider: rule "<rule>" of template "<template>" reads parameter "<parameter>" through Fn::ValueOf, which names a declared parameter by its logical ID, and binding the parameter removes its declaration from the source; leave the parameter unbound so the rule can read it at deploy (rule của template đọc tham số qua Fn::ValueOf, vốn gọi tên một tham số đã khai báo bằng logical ID của nó, và việc gắn tham số sẽ xóa khai báo của nó khỏi nguồn; hãy để tham số không được gắn để rule có thể đọc nó khi triển khai)

Cách khắc phục: xóa khóa của tham số khỏi valuesMapping, để tham số vẫn được khai báo và rule đọc giá trị được truyền khi stack được triển khai.

The assembled CloudFormation stack cannot carry a transform (Stack CloudFormation đã lắp ráp không thể mang một transform)

Transform của stack đã lắp ráp được xây dựng từ phần tương ứng của mọi component, và một transform xử lý toàn bộ template, nên một transform có tác động không giới hạn trong nội dung được viết cho nó sẽ bị từ chối thay vì được phép thay đổi cách nội dung của một component khác được triển khai: AWS::CodeDeployBlueGreen và AWS::Include luôn luôn bị từ chối, một macro do tài khoản của bạn định nghĩa và AWS::ServiceCatalog khi đứng cạnh bất kỳ component nào khác, AWS::LanguageExtensions khi đứng cạnh nội dung serverless của một component khác, và AWS::Serverless-2016-10-31 khi Globals của nó sẽ chạm tới các tài nguyên serverless của một component khác hoặc khi một trong các nguồn sự kiện của nó nêu tên một tài nguyên mà một component khác khai báo. Bảng đầy đủ nằm ở cloudformation → Các phần cấp cao nhất trong stack đã lắp ráp.

Thông báo được phát ra. Điều kiện đứng đầu, tiếp theo là mọi component trong stack, transform và các component khai báo nó, và lý do nó không thể được mang:

a plugin has no expression for a construct this build declares (một plugin không có cách diễn đạt cho một cấu trúc mà bản build này khai báo) cloudformation-provider: the assembled stack of component "<component>", … cannot carry the transform "<transform>", declared by component "<component>": <why> (stack đã lắp ráp của component, … không thể mang transform do component khai báo)

Cách khắc phục: đặt component khai báo transform vào một boundary riêng, để stack của nó không chứa gì mà transform có thể thay đổi; hoặc, khi thông báo gọi tên nội dung mà một component khác khai báo, hãy chuyển nội dung đó vào component khai báo transform.

Two components order one pair of transforms oppositely (Hai component sắp xếp một cặp transform theo thứ tự ngược nhau)

Stack đã lắp ráp chạy các transform của nó theo một thứ tự duy nhất, được xây dựng từ thứ tự riêng của từng component và từ thứ tự mà CloudFormation ghi trong tài liệu. Khi hai thứ tự không thể cùng đúng — hai component liệt kê một cặp transform theo chiều ngược nhau, hoặc một component liệt kê AWS::Serverless-2016-10-31 trước AWS::LanguageExtensions, trong khi tài liệu của CloudFormation ghi theo chiều ngược lại — thì không có một thứ tự duy nhất nào để viết, vì vậy quá trình render dừng lại.

Thông báo được phát ra. Điều kiện đứng đầu, tiếp theo là cặp transform và ai đã sắp xếp nó theo mỗi chiều:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải một thứ nó cần thành đúng một giá trị) cloudformation-provider: the transforms "<first>" and "<second>" are ordered both ways — "<first>" before "<second>" by <who>, and "<second>" before "<first>" by <who> — and the assembled stack’s Transform runs them in one order; declare them in one order (các transform được sắp xếp theo cả hai chiều, và Transform của stack đã lắp ráp chạy chúng theo một thứ tự; hãy khai báo chúng theo một thứ tự)

Cách khắc phục: khai báo cặp transform theo một thứ tự trong mọi component liệt kê cả hai, theo thứ tự riêng của CloudFormation khi tài liệu của nó có ghi.

Two entries reach one stack output name (Hai mục dẫn tới cùng một tên output của stack)

Một tên output của stack chỉ chấp nhận chữ cái và chữ số, vì vậy tên được xây dựng từ những gì bạn viết bằng cách mã hóa các ký tự mà bảng chữ cái đó không chấp nhận thay vì loại bỏ chúng. Do đó, hai mục bạn viết khác nhau vẫn tách biệt, và lỗi dừng này là thứ báo cáo trường hợp hai mục trong số đó vẫn dẫn tới cùng một tên. Quá trình render dừng lại thay vì phát ra một output ở chỗ đã viết hai mục, điều sẽ âm thầm loại bỏ một trong hai.

Mọi tên mà hai mục trở lên trùng nhau đều được báo cáo, và mọi mục đứng sau mỗi tên đều được nêu, theo một thứ tự ổn định — để một lần build cho bạn thấy toàn bộ xung đột thay vì chỉ một phía của nó.

Thông báo được phát ra, mở đầu bằng điều kiện và tiếp tục với chi tiết riêng của provider:

two things a plugin produced occupy one name in its output (hai thứ một plugin tạo ra chiếm cùng một tên trong output của nó) cloudformation-provider: two entries an author wrote reach one stack Output name: <the entries that met> reach the Output name "<name>"; an Output name is built by encoding the component and the entry into the letters and digits a logical id admits, rather than by dropping what it does not, so two entries an author wrote apart stay apart — renaming either end clears the build (hai mục tác giả viết dẫn tới cùng một tên Output của stack; tên Output được xây dựng bằng cách mã hóa component và mục thành các chữ cái và chữ số mà logical id chấp nhận, thay vì loại bỏ những gì nó không chấp nhận, nên hai mục viết khác nhau vẫn tách biệt — đổi tên một trong hai đầu sẽ giúp build thành công)

Cách khắc phục: đổi tên một trong các mục, hoặc một trong các component, để hai mục không còn dẫn tới cùng một tên — thông báo nêu cả hai phía. Tên mang dấu câu và kiểu chữ hoa thường mà bạn đã viết, được mã hóa chứ không bị loại bỏ, nên khác biệt ở một trong hai điều đó vẫn được giữ trong tên và hai mục viết khác nhau sẽ có tên khác nhau.

A CloudFormation fragment writes one key twice (Một fragment CloudFormation viết một khóa hai lần)

Một mapping giữ một giá trị cho mỗi khóa, vì vậy một fragment viết cùng một khóa hai lần sẽ giữ lại phần thân nào đến sau cùng và loại bỏ phần còn lại. Khi mapping là khối chứa các tài nguyên hoặc output, phần thân bị loại bỏ là một tài nguyên hoặc một output đã được viết ra và sẽ không có trong kết quả. Thay vào đó, quá trình render dừng lại.

Cả hai nơi khóa được viết đều được báo cáo, vì một khóa được viết hai lần thường là hai lần chỉnh sửa vốn định là hai khóa khác nhau — và tác giả cần cả hai để biết nên thay đổi cái nào.

Thông báo được phát ra, mở đầu bằng điều kiện và tiếp tục với chi tiết riêng của provider:

two things a plugin produced occupy one name in its output (hai thứ một plugin tạo ra chiếm cùng một tên trong output của nó) cloudformation-provider: one mapping key is written more than once: the key "<key>" is written at line <first> and again at line <second>; a mapping holds one value per key, so one of the two bodies would be dropped — remove one, or rename one so each key is written once (một khóa mapping được viết nhiều hơn một lần; một mapping giữ một giá trị cho mỗi khóa, nên một trong hai phần thân sẽ bị loại bỏ — hãy xóa một, hoặc đổi tên một để mỗi khóa chỉ được viết một lần)

Cách khắc phục: mở fragment tại hai dòng mà thông báo nêu. Khi hai phần thân vốn định là một thứ, hãy xóa phần giờ đã thừa; khi chúng vốn định là hai thứ, hãy đổi tên một phần để mỗi phần có khóa riêng. Fragment là một template, vì vậy hãy kiểm tra văn bản đã render chứ không chỉ nguồn, ở những chỗ khóa được ghép lại thay vì được viết trực tiếp.

A cross-boundary reference has no consuming stack to be written into (Một tham chiếu xuyên ranh giới không có stack tiêu thụ nào để được ghi vào)

Khi một kết nối phụ thuộc đi qua giữa hai đầu ra được lắp ráp riêng biệt, phía tiêu thụ được render với một placeholder và tham chiếu được ghi vào khi cả hai phía đều tồn tại. Điều kiện này là điều xảy ra khi đầu ra đã lắp ráp của phía tiêu thụ hoàn toàn không chứa template stack nào: không có tài liệu nào để ghi tham chiếu vào, nên placeholder không thể được thay thế.

Thông báo được phát ra. Điều kiện nêu loại lỗi, và câu riêng của provider cho biết đầu vào nào:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải thứ nó cần thành đúng một giá trị) cloudformation-provider: cross-boundary link resolve received no consumer stack template (việc phân giải liên kết xuyên ranh giới không nhận được template stack tiêu thụ nào)

Cách khắc phục: không có gì bạn viết bên trong component tiêu thụ gây ra lỗi này — đó là hình dạng của những gì ranh giới của nó đã lắp ráp. Hãy kiểm tra xem phía tiêu thụ có thực sự được render bởi provider CloudFormation hay không: một kết nối đi vào một ranh giới lắp ráp thứ khác thì không có stack nào để tham chiếu đặt vào, và kết nối đó nên nằm giữa hai ranh giới do cùng một provider lắp ráp. Khi cả hai phía đều nên là CloudFormation, ranh giới tiêu thụ đã không tạo ra template stack nào, và đó là câu hỏi dành cho người đã viết các Recipes đóng góp vào nó.

A cross-boundary reference was spliced into a longer string (Một tham chiếu xuyên ranh giới đã bị ghép vào một chuỗi dài hơn)

Một tham chiếu chéo CloudFormation là một đối tượng chứ không phải văn bản, nên nó chỉ có thể thay thế toàn bộ một giá trị. Điều kiện này là điều mà một placeholder được tìm thấy bên trong một chuỗi lớn hơn báo cáo — một giá trị được ghép quanh nó, thay vì được chuyển giao như toàn bộ những gì được inject. Không có gì để hoán đổi đối tượng vào, nên quá trình render dừng lại thay vì phát ra một tham chiếu ở hình dạng mà đích không thể đọc.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là giá trị và kết nối mà nó đến qua:

a plugin has no representation for a value it was given (một plugin không có biểu diễn cho một giá trị nó được cung cấp) cloudformation-provider: cross-boundary link value is interpolated into a larger string; only a whole-scalar injection can carry a cross-stack reference: output key "<key>" on socket "<socket>" (giá trị liên kết xuyên ranh giới bị nội suy vào một chuỗi lớn hơn; chỉ việc inject nguyên một scalar mới có thể mang một tham chiếu xuyên stack: khóa đầu ra trên socket)

Cách khắc phục: chuyển giao nguyên giá trị thay vì ghép quanh nó. Khi phía tiêu thụ cần giá trị bên trong một chuỗi dài hơn — một chuỗi kết nối, một URL — hãy xây dựng phép ghép đó bằng từ vựng riêng của đích từ tham chiếu, thay vì trong template của Recipe trước khi tham chiếu tồn tại. Mapping inject giá trị là nơi việc ghép xảy ra, nên đó là dòng cần thay đổi.

Two rendered resources land at one output file (Hai tài nguyên đã render rơi vào cùng một tệp đầu ra)

Mỗi tài nguyên đã render được ghi vào một tệp có tên xuất phát từ việc tài nguyên đó là gì và được gọi là gì. Hai tài nguyên trùng các thông tin đó sẽ mang cùng một tên tệp, nên một tài nguyên sẽ chiếm chỗ của tài nguyên kia và quá trình render dừng lại thay vì phát ra một tệp khi hai tài nguyên đã được render.

Hai tài nguyên render giống hệt nhau không phải là xung đột. Khi nội dung khớp từng byte, giữ lại một cái không mất gì và quá trình render tiếp tục — nên một template được include hai lần với cùng kết quả sẽ không bị báo cáo.

Thông báo được phát ra. Điều kiện đứng đầu, sau đó là cả hai template đã tạo ra chúng và tệp mà chúng gặp nhau:

two things a plugin produced occupy one name in its output (hai thứ một plugin tạo ra chiếm cùng một tên trong đầu ra của nó) helm: node "<node>": rendered resources "<one template>" and "<the other>" both derive output "<file>" with differing content: two rendered resources derive the same output filename with differing content (node: các tài nguyên đã render và cả hai đều suy ra đầu ra với nội dung khác nhau: hai tài nguyên đã render suy ra cùng một tên tệp đầu ra với nội dung khác nhau)

Cách khắc phục: cho hai tài nguyên các định danh riêng biệt — tên thường là thứ khác nhau, và tên tệp theo sau từ đó. Thông báo nêu tên cả hai template, nên hãy mở chúng và kiểm tra mỗi cái đang tạo ra gì: hai template render cùng một tài nguyên dưới một tên thường là do một trong số chúng là bản sao cũ hơn. Khi cả hai đều cần thiết, chúng là hai tài nguyên và mỗi cái cần tên riêng.

A synthesized StatefulSet has no single service to govern it (Một StatefulSet được tổng hợp không có một service duy nhất để quản lý nó)

Một workload khai báo lưu trữ theo từng instance được render thành một StatefulSet, và một StatefulSet nêu tên một service quản lý nó — service cấp cho mỗi instance địa chỉ ổn định. Service đó là service được khai báo không có địa chỉ cluster riêng. Hai trường hợp làm dừng quá trình render: không có service nào được khai báo, nên không có gì để nêu tên; và có nhiều hơn một, nên không có câu trả lời cho việc cái nào quản lý. Cả hai đều sẽ tạo ra một StatefulSet mà đích từ chối, nên quá trình render dừng lại thay vì phát ra nó.

Các thông báo được phát ra. Cả hai đều báo cáo cùng một điều kiện — thứ mà provider cần nhưng không thể phân giải thành đúng một giá trị — và câu riêng của provider cho biết đã gặp trường hợp nào trong hai. Mỗi thông báo được in bên dưới một khung nêu tên node:

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải thứ nó cần thành đúng một giá trị) synthesized StatefulSet requires a headless governing Service (declare a service with type: Headless); none found: synthesized StatefulSet has no headless governing Service (StatefulSet được tổng hợp cần một Service quản lý headless (hãy khai báo một service với type: Headless); không tìm thấy: StatefulSet được tổng hợp không có Service quản lý headless)

a plugin could not resolve something it requires to exactly one value (một plugin không thể phân giải thứ nó cần thành đúng một giá trị) synthesized StatefulSet declares more than one headless Service; the governing Service is ambiguous (declare exactly one type: Headless service): synthesized StatefulSet has more than one headless Service (StatefulSet được tổng hợp khai báo nhiều hơn một Service headless; Service quản lý không rõ ràng (hãy khai báo đúng một service type: Headless): StatefulSet được tổng hợp có nhiều hơn một Service headless)

Cách khắc phục: khai báo đúng một service loại headless trên workload. Khi chưa có service nào được khai báo, hãy thêm nó — một workload có lưu trữ theo từng instance cần một service như vậy, và đó là thứ cấp cho mỗi instance một địa chỉ gắn liền với nó. Khi có nhiều hơn một service được khai báo, hãy giữ service cần quản lý và đặt cho các service khác một loại thông thường, hoặc xóa chúng; một service headless thứ hai thường là service không cần phải là headless.

A plugin reported a failure it did not classify (Một plugin đã báo cáo một lỗi mà nó không phân loại)

Một plugin dừng một bản build sẽ báo cáo hai điều: một câu riêng của nó nói điều gì đã xảy ra, và câu đó nêu loại lỗi nào. Các loại lỗi là một tập nhỏ do compiler khai báo — một cấu trúc không có biểu thức, một đầu vào không thể phân giải thành một giá trị, hai thứ được tạo ra cùng muốn một tên, một giá trị không có biểu diễn — và điều kiện này là điều kiện mà một plugin chọn khi lỗi của nó không khớp với loại nào trong số đó.

Đây là phương án dự phòng chứ không phải đích đến. Một plugin dùng nó khi một trong các loại khác phù hợp là đang cho bạn biết ít hơn những gì nó biết, và cách diễn đạt nói rõ rằng plugin đã từ chối phân loại chứ không phải chỉ đơn thuần là có gì đó sai — nên một phương án dự phòng bị lạm dụng vẫn dễ nhận ra thay vì không thể phân biệt với một báo cáo đúng.

Thông báo được phát ra. Điều kiện đứng đầu và câu riêng của plugin theo sau:

a plugin reported a failure that none of the declared kinds names (một plugin đã báo cáo một lỗi mà không loại nào đã khai báo nêu tên) <the plugin's own sentence>

Cách khắc phục: đọc câu riêng của plugin, đó là nơi chứa mọi thứ cụ thể cho bản build của bạn. Bản thân điều kiện chỉ cho bạn biết rằng plugin không có loại nào cho lỗi đó. Khi plugin là của bạn, hãy chọn loại đúng với lỗi thực sự; khi không phải, câu đó là thứ cần trích dẫn cho người phát hành plugin.

A plugin named a condition the socket does not declare (Một plugin đã nêu một điều kiện mà socket không khai báo)

Một plugin báo cáo một điều kiện mà trình biên dịch này khai báo thay vì tự đặt ra một số hiệu riêng, nên mã định danh đến tay bạn luôn là mã mà aggrega explain có thể giải thích. Lần dừng này là kết quả của một báo cáo nêu bất kỳ thứ gì khác: một số hiệu không có gì được đăng ký dưới nó, một số hiệu đã bị loại bỏ, một mã ngắn được viết khác với bản đăng ký mà nó phân giải tới, hoặc một cặp mã định danh nêu hai điều kiện khác nhau.

Nó dừng lại thay vì lặng lẽ gạt bỏ báo cáo. Nếu bỏ các mã định danh và để điều kiện lỗi plugin chung đứng thay, bản build sẽ trông giống hệt một bản build từ plugin không nêu điều kiện nào cả, nên người phải sửa sẽ không bao giờ biết có điều gì cần sửa. Còn nếu báo cáo số hiệu được đưa ra thì bạn sẽ nhận một mã định danh không phân giải tới đâu cả.

Bản build của bạn vẫn nhận được điều đã làm nó dừng. Lần dừng trích dẫn số hiệu gây lỗi, cho biết vì sao nó không phân giải tới điều kiện nào, nêu các điều kiện chung mà một plugin dùng khi không có định danh nào tốt hơn, và chuyển nguyên vẹn câu riêng của plugin.

Thông báo được phát ra:

wasm: guest plugin named a condition the socket does not declare: the guest named "<offered>", and <why it resolves to no condition>; a plugin names a condition this compiler declares, and reaches for one of <the generic conditions and their codes> when it has none better: <the plugin's own sentence> (wasm: plugin khách đã nêu một điều kiện mà socket không khai báo: plugin khách đã nêu, và; một plugin nêu một điều kiện mà trình biên dịch này khai báo, và dùng một trong các điều kiện chung khi không có điều kiện nào tốt hơn)

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra điều này — chính báo cáo của plugin là sai, còn lỗi mà nó báo cáo là có thật. Hãy xử lý theo câu riêng của plugin, là phần cuối của thông báo. Nếu plugin là của bạn, hãy báo cáo một điều kiện mà trình biên dịch này khai báo — một trong các loại chung mà thông báo liệt kê, khi lỗi không khớp với điều kiện cụ thể hơn nào; nếu plugin không phải của bạn, hãy trích dẫn số hiệu gây lỗi cho người phát hành nó.

A source artifact is cached without a workspace root to anchor it (Một artifact nguồn được lưu cache mà không có gốc workspace để neo nó)

Một artifact nguồn đã thu nhận được lưu trong một ô bên dưới cache artifact của workspace, và đường dẫn tới ô đó được xây dựng từ gốc workspace trở ra. Điều kiện này báo cáo gốc đến với giá trị rỗng, khiến đường dẫn ô trở thành tương đối — được phân giải theo bất kỳ thư mục nào mà tiến trình tình cờ đang ở khi các byte được ghi, và đặt cache vào một nơi không ai chọn.

Nó bị từ chối thay vì được phân giải, vì một ô được ghi vào sai chỗ còn tệ hơn không có ô: các lần đọc sau tìm ở đúng chỗ, không thấy gì, và thu nhận lại, nên điều bạn thấy là một cache dường như không bao giờ giữ được gì, và không có gì khác chỉ ra lý do.

Thông báo được phát ra. Câu riêng của điều kiện mở đầu, tiếp theo là những gì nhận diện artifact:

cacheslot: empty workspaceRoot (kind=<kind> url=<url> chart=<chart> version=<version>) (cacheslot: workspaceRoot rỗng)

Cách khắc phục: không có gì trong các tệp thực thể của bạn gây ra điều này và không thay đổi nào khi soạn thảo xóa được nó — gốc workspace được cung cấp bởi thứ đang điều khiển bản build, không được viết trong catalog. Hãy chạy bản build từ bên trong workspace, để gốc được phát hiện thay vì được truyền vào là rỗng. Nếu bạn điều khiển trình biên dịch từ phần mềm của riêng mình, hãy truyền gốc workspace một cách tường minh; một bên gọi thực sự muốn cache tương đối với thư mục hiện tại thì truyền một dấu chấm, giá trị này được chấp nhận và thể hiện rõ ý định đó.

A value would place a cached file outside the cache (Một giá trị sẽ đặt một tệp đã lưu cache ra ngoài cache)

Một thực thể đã lưu cache và một artifact nguồn đã lưu cache mỗi thứ nằm trong một ô mà cache đặt tên cho nó, và ô đó được ghép từ các giá trị: tham chiếu của thực thể và phiên bản mà nó phân giải tới, hoặc loại, url, chart, module_subdir, phiên bản và digest của một nguồn. Mỗi giá trị nêu một vị trí trong bố cục. Điều kiện này báo cáo một giá trị sẽ đưa những gì được ghi cho nó tới nơi khác với vị trí mà nó nêu — cạnh một ô khác, hoặc ra hẳn ngoài cache — và từ chối nó trước khi bất cứ thứ gì được ghi hoặc đọc ở đó.

Phần lớn các giá trị đó đến từ nơi mà cache không kiểm soát: nội dung một registry phục vụ, một bản ghi đọc lại từ đĩa, một tọa độ mà tác giả Recipe hoặc FeatureRecipe đã viết. Một phiên bản là đường dẫn chứ không phải phiên bản, một đường dẫn url hoặc một module_subdir leo lên trên vị trí của nó, và một tham chiếu phân giải tới một thư mục dấu chấm đều bị từ chối tại đây. Một giá trị nêu một thư mục — và một đường dẫn url hoặc module_subdir ở tại hoặc bên dưới vị trí của nó — thì không bị ảnh hưởng.

Một module_subdir leo lên bị từ chối trước khi bất cứ thứ gì được tải về. Với một nguồn git-repository, cùng giá trị đó còn nêu thư mục của kho mà lần pull lưu trữ, và một giá trị leo lên trên kho sẽ khiến lần pull đọc các tệp nằm cạnh bản checkout của nó. Vì vậy lần pull xét module_subdir trước khi tải kho về, và từ chối giá trị leo lên bằng điều kiện này, trích dẫn nó dưới khóa của nó: không có gì được tải về, và không có gì cạnh bản checkout bị đọc. Một dấu gạch chéo ngược trong đó được đọc là dấu phân tách, như một đường dẫn Windows đọc nó, nên ..\shared bị từ chối trên mọi máy thay vì được đọc từ cạnh bản checkout trên một máy; dấu phân tách ở đầu hoặc cuối giá trị bị bỏ, nên /charts/app nêu charts/app.

Thông báo được phát ra. Câu riêng của điều kiện mở đầu, tiếp theo là giá trị như được viết dưới khóa mà nó được viết, và cách khắc phục:

a value a cache location is built from would place cached files outside the place it names in the cache (version "../../../etc" for entity "demo/app/web"). a version, a name, a kind or a host names one directory of the cache, so it carries no / or \ and is neither . nor ..; a URL path or a module subdirectory may name directories beneath its place but may not climb above it. Correct the value where it was written, or, where a registry served it, ask its publisher to publish a version that carries a well-formed one (một giá trị dùng để xây dựng vị trí cache sẽ đặt các tệp đã lưu cache ra ngoài vị trí mà nó nêu trong cache (phiên bản cho thực thể). một phiên bản, một tên, một loại hoặc một host nêu một thư mục của cache, nên nó không chứa dấu phân tách và không phải thư mục dấu chấm; một đường dẫn URL hoặc một thư mục con của module có thể nêu các thư mục bên dưới vị trí của nó nhưng không được leo lên trên nó. Hãy sửa giá trị tại nơi nó được viết, hoặc, nếu một registry phục vụ nó, hãy yêu cầu người phát hành công bố một phiên bản mang giá trị hợp lệ)

Cách khắc phục: nếu giá trị là do bạn viết — source.version, url hoặc module_subdir của một Recipe hoặc FeatureRecipe — hãy sửa nó để nêu một thư mục, hoặc một đường dẫn ở trong vị trí của nó; thông báo trích dẫn giá trị và khóa mà nó được đọc từ đó. Nếu một registry phục vụ nó, thực thể đã công bố mang một phiên bản hoặc một tọa độ không hợp lệ, điều mà không thay đổi nào của bạn sửa được: thông báo nêu những gì đã được tải về, và việc khắc phục thuộc về người phát hành nó.

Một số thao tác ghi hoặc xóa các tệp của riêng chúng, tại những nơi chúng tự xác định chứ không phải nơi bạn đã nêu: thư mục đầu ra của một bản build và mọi tệp nó ghi ở đó, và thư mục .trace mà một bản build có theo dõi thay thế; lockfile của một Release, và bản ghi tin cậy plugin bên cạnh nó, mà một lần pull ghi; entity.lock bên cạnh một thực thể, mà aggrega pin ghi, và một lần pull ghim nguồn ghi bên cạnh mỗi thực thể nó ghim; .aggrega-config.yaml của workspace, khi một lệnh ghi cấu hình của workspace; cache artifact và từng cây con của nó, mà một lần pull lấp đầy còn aggrega cache clear và aggrega cache prune làm trống; các gói chữ ký mà một lần pull giữ trong cache đó cho mỗi artifact có chữ ký đã được nó xác minh; các bản nháp mà aggrega import ghi; các thực thể Plugin mà aggrega plugin gen-catalog ghi bên dưới thư mục đầu ra của nó; và dấu đánh dấu .aggrega/active-release mà language server của trình soạn thảo ghi khi một Release mặc định được ghi nhận, cùng thư mục .aggrega chứa nó. Điều này cũng đúng bất kể giao diện nào đã khởi động thao tác — dòng lệnh, language server của trình soạn thảo, hay các công cụ của một trợ lý. Ranh giới workspace nêu quy tắc mà điều này áp dụng, và các đường dẫn cố ý vươn ra ngoài workspace.

Mỗi nơi đó có một thư mục mà nó phải ở bên trong, và thư mục nào thì tùy vào thư mục mà thao tác ghép nó bên dưới:

  • Workspace, cho mọi thứ được ghép bên trong nó. Đây là trường hợp thông thường, và nó cũng áp dụng cho một thư mục bạn đã nêu nằm bên trong workspace. dist và .trace của một bản build luôn được ghép ở đây, bên dưới gốc workspace, bất kể bản build được chạy từ thư mục nào, và các bản nháp của một lần import không nêu thư mục đầu ra cũng vậy.
  • Một thư mục bạn đã nêu nằm ngoài workspace, cho mọi thứ được ghép bên dưới nó: thư mục đầu ra bạn truyền cho aggrega plugin gen-catalog hoặc aggrega import; thư mục của một Release bạn nêu, hoặc một thư mục mà cấu hình workspace nêu, nằm ngoài workspace, cho lockfile và bản ghi tin cậy bên cạnh nó; và thư mục của một thực thể bạn nêu cho aggrega pin, hoặc một thư mục catalog bạn nêu bằng --catalog hoặc cấu hình liệt kê dưới catalog_dirs, cho entity.lock bên cạnh mỗi thực thể ở đó. Bản thân thư mục được dùng đúng như bạn đã nêu — một thư mục là liên kết thì được ghi xuyên qua, tới nơi nó trỏ tới — và những gì được ghi bên dưới nó ở lại bên trong nó.
  • Bản thân thư mục cache artifact, cho mọi thứ được ghi vào cache bên dưới nó và mọi thứ mà aggrega cache clear và aggrega cache prune xóa ở đó — thư mục mặc định .aggrega/cache cũng như một artifact_cache_dir mà cấu hình viết leo ra khỏi gốc workspace (../shared-cache). Một thư mục riêng của cache, hoặc một tệp trong đó, là liên kết dẫn ra ngoài thư mục cache thì bị từ chối ngay cả khi nó dẫn tới nơi khác bên trong workspace, nên không có gì được ghi vào cache, và không có gì mà một lần clear hoặc prune xóa, rơi vào một tệp bên ngoài nó. Vị trí của bản thân thư mục cache được xét trước: một thư mục được viết bên trong gốc workspace thì được đi theo tới bất cứ đâu nó dẫn bên trong workspace và bị từ chối, giới hạn trong workspace, khi nó dẫn ra ngoài; một thư mục được viết leo ra khỏi gốc workspace thì được dùng đúng như bạn đã nêu, được ghi xuyên qua tới nơi nó trỏ tới nếu nó là một liên kết.

Mỗi nơi đó được kiểm tra trước khi bất cứ thứ gì được ghi hoặc xóa ở đó. Phần sâu nhất đang tồn tại của đường dẫn, với mọi liên kết tượng trưng trên đường đi được đi theo, phải là thư mục mà nó phải ở bên trong hoặc nằm bên dưới thư mục đó. Một liên kết ở bất kỳ đâu trên đường đi dẫn ra ngoài thư mục đó — một dist liên kết tới một thư mục ở nơi khác, một lockfile liên kết tới một tệp trong dự án khác, một .aggrega/cache liên kết tới một thư mục dùng chung với công việc khác, một thư mục bên dưới thư mục đầu ra của gen-catalog liên kết tới nơi khác — sẽ khiến việc ghi hoặc xóa rơi ra ngoài, nên thao tác dừng lại, và đường dẫn đó được giữ nguyên như cũ. Điều này quan trọng nhất với một bản build: việc xóa và ghi lại một thư mục đầu ra là liên kết nếu không sẽ xóa và ghi lại một thư mục ở nơi khác trên máy.

Một liên kết không dẫn tới đâu được xem đúng như bản chất của nó — không phải thứ tồn tại — nên thư mục chứa nó là thứ được kiểm tra. Khi một liên kết như vậy nằm ở chính cuối một đường dẫn mà thao tác sắp tạo, tệp sẽ được tạo tại nơi liên kết trỏ tới, nên nơi nó trỏ tới cũng được kiểm tra. Một liên kết trỏ tới một nơi bên trong thư mục mà đường dẫn phải ở bên trong thì được đi theo như thường lệ.

Thông báo được phát ra. Câu riêng của điều kiện mở đầu, tiếp theo là đường dẫn mà thao tác sắp ghi hoặc xóa — writing hoặc removing cho biết là việc nào — thư mục mà nó phải ở bên trong, liên kết mà nó gặp trên đường đi và nơi liên kết đó dẫn tới, rồi cách khắc phục. Một bản build có dist là liên kết dẫn ra ngoài workspace bị dừng ở thứ đầu tiên nó chạm tới, việc xóa đầu ra trước đó:

a path this operation writes or deletes leads through a link out of the directory it must stay inside (removing <workspace>/dist/boundaries, which must stay inside <workspace>, the link <workspace>/dist leads to <elsewhere>/dist-target). nothing was written to or removed from that path. Remove the link, or make it lead to a place inside <workspace>, and run the operation again (một đường dẫn mà thao tác này ghi hoặc xóa đi qua một liên kết ra ngoài thư mục mà nó phải ở bên trong (đang xóa đường dẫn, vốn phải ở bên trong workspace, liên kết dẫn tới nơi khác). không có gì được ghi vào hoặc xóa khỏi đường dẫn đó. Hãy xóa liên kết, hoặc làm nó dẫn tới một nơi bên trong workspace, và chạy lại thao tác)

Chẩn đoán này không mang danh mục nào: thứ có lỗi là cách bố trí trên đĩa chứ không phải bất kỳ tài liệu nào bạn đã viết.

Cách khắc phục: xóa liên kết mà thông báo nêu và chạy lại thao tác, để nó tạo một thư mục hoặc tệp thật ở nơi đó; hoặc làm liên kết dẫn tới một nơi bên trong thư mục mà thông báo nêu, nơi nó được đi theo. Không có gì trong các tệp thực thể của bạn gây ra điều này và không thay đổi nào khi soạn thảo xóa được nó.

A name the operation writes holds a part Windows cannot hold (Một tên mà thao tác ghi chứa một phần mà Windows không thể chứa)

Trên Windows, một số tên không đến được tệp như cách chúng được viết. Một tên mà Windows dành riêng cho thiết bị — CON, PRN, AUX, NUL, CONIN$, CONOUT$, COM0 đến COM9 và LPT0 đến LPT9, cùng các tên COM và LPT được viết với chữ số một, hai hoặc ba dạng chỉ số trên — chỉ đến thiết bị chứ không phải tệp, với bất kỳ kiểu chữ hoa thường nào và bất kể phần mở rộng nào theo sau, nên nul, Aux.yaml và com1.txt đều là thiết bị. Và một phần của đường dẫn kết thúc bằng dấu chấm hoặc dấu cách là phần mà Windows có thể cắt bỏ thay vì giữ nguyên như đã viết. Ghi một tên như vậy sẽ đặt các byte của nó vào nơi khác với tệp mà nó đặt tên.

Vì vậy, khi một thao tác sắp ghi một tên mà nó không tự chọn bên dưới một thư mục trên máy Windows, tên chứa phần như vậy sẽ bị từ chối trước khi bất cứ thứ gì được ghi: một mục của kho lưu trữ mà một source artifact hoặc một entity của catalog mang theo, khi bộ nhớ đệm giải nén kho lưu trữ để đọc; một tệp mà bản build kết xuất vào thư mục đầu ra của nó; một bản nháp mà importer trả về cho aggrega import, khi chạy thử cũng như khi ghi thật; và tài liệu mà aggrega edit-document ghi lại, bất kể giao diện nào yêu cầu chỉnh sửa. Mọi phần của tên đều được xét, với dấu gạch chéo ngược được đọc là dấu phân tách, đúng như Windows đọc — nên aux/x.yaml bị từ chối vì thư mục aux của nó, report. vì dấu chấm cuối, và .. \evil.yaml vì phần đầu tiên của nó, gồm hai dấu chấm và một dấu cách. Một tập hợp bị từ chối vì một tên sẽ không ghi bất kỳ tên nào khác: kho lưu trữ không được giải nén, đầu ra của bản build không bị xóa hay ghi, và không bản nháp nào được ghi xuống đĩa.

Trên Linux và macOS, các tên đó được ghi đúng như được đặt, và điều kiện này không bao giờ xảy ra. Một tên leo ra ngoài thư mục mà nó được ghi bên dưới là một lỗi khác, bị từ chối trên mọi nền tảng với thông báo riêng của thao tác đó trước khi điều kiện này được xét.

Thông báo được phát ra. Câu riêng của điều kiện mở đầu thông báo, sau đó là tên, phần mà Windows không thể chứa và thư mục mà tên sẽ được ghi bên dưới, rồi đến cách khắc phục:

a name this operation writes holds a path segment Windows cannot hold as written (the name "aux/x.yaml", its segment "aux", beneath <directory>). It was not written. Windows reserves device names such as CON, PRN, AUX, NUL, COM1 and LPT1, in any letter case and whatever extension follows, and does not hold a segment ending in a full stop or a space as written; rename that segment where the name is produced (một tên mà thao tác này ghi chứa một đoạn đường dẫn mà Windows không thể giữ nguyên như đã viết (tên, đoạn của nó, bên dưới thư mục). Nó đã không được ghi. Windows dành riêng các tên thiết bị như CON, PRN, AUX, NUL, COM1 và LPT1, với bất kỳ kiểu chữ hoa thường nào và bất kể phần mở rộng nào theo sau, và không giữ nguyên một đoạn kết thúc bằng dấu chấm hoặc dấu cách như đã viết; hãy đổi tên đoạn đó tại nơi tên được tạo ra)

Chẩn đoán này không mang danh mục nào: tên đến từ bất cứ thứ gì đã tạo ra nó — nhà phát hành của kho lưu trữ, một Recipe hoặc một thư viện, một importer, đường dẫn mà một lần chỉnh sửa nêu ra — chứ không phải từ một tài liệu mà trình biên dịch quy lỗi cho.

Cách khắc phục: đổi tên phần mà thông báo nêu ra tại nơi tên đó xuất phát. Với một mục của kho lưu trữ, đó là source artifact hoặc entity đã phát hành, thứ chỉ nhà phát hành của nó mới thay đổi được. Với một tệp được kết xuất, đó là tên đầu ra mà một Recipe hoặc một ArtifactLibrary đặt cho nó; với một bản nháp, là importer đã đặt tên cho nó; với một lần chỉnh sửa, là đường dẫn của tài liệu. Không có gì về máy Windows khiến tên đó dùng được như đã viết.

Các điều kiện không dừng bản dựng

Mọi điều kiện ở trên đều dừng bản dựng. Một số điều kiện mang mã ngắn và thông báo riêng mà không bao giờ dừng bản dựng, và chúng được liệt kê ở đây để một mã bạn đang có luôn tra ra được một mục nào đó, dù bạn đến từ trang nào.

Chúng chia thành bốn loại, và nên biết sự khác biệt trước khi bạn đi tìm cách khắc phục.

  • Một cảnh báo tư vấn. Bản dựng báo cáo nó rồi tiếp tục, và đầu ra được kết xuất vẫn như nhau dù bạn có xử lý nó hay không. Mỗi cảnh báo được trình bày đầy đủ trên warnings.md — điều gì khiến nó xuất hiện, nó được đọc ở đâu trong quá trình biên dịch, nó in ra gì, và cần làm gì với nó — và các mục bên dưới cho biết phần nào, thay vì lặp lại ở đây.
  • Một điều kiện mà trình soạn thảo tự xử lý. Nó được chính phần tích hợp trình soạn thảo trả lời và không đến được đầu ra của bản dựng lẫn chẩn đoán.
  • Một biện pháp bảo vệ đứng sau một lần từ chối trước đó. Quy tắc mà nó bảo vệ đã được thực thi trước nó bởi một điều kiện có dừng bản dựng, nên bản dựng gặp điều kiện trước đó trước.
  • Một lần từ chối trên một lệnh không phải là bản dựng. Đây là một điểm dừng cứng có cách khắc phục thực sự — nó kết thúc lệnh gặp phải nó, và không có gì được xuất bản, ghi hay thay đổi — nhưng không giai đoạn biên dịch nào đến được nó, nên không bản dựng nào báo cáo nó. Xuất bản hoặc ký một artifact, ghim các đầu vào của một thực thể, thêm một registry, chỉnh sửa một tài liệu, chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, và kiểm tra toàn bộ một catalog — về tính đúng đắn hoặc theo các quy ước xuất bản — là những nơi gặp các điều kiện này, và mỗi mục cho biết nó thuộc lệnh nào và ai nắm cách khắc phục.

Một annotation binding khai báo một đường dẫn trong cả hai danh sách pillar

Một cảnh báo tư vấn. Một annotation binding của Manifest nêu cùng một đường dẫn dạng dấu chấm trong cả danh sách maps.infra lẫn danh sách maps.values của nó. Việc khai báo phần chồng lấn là hợp lệ và trình biên dịch không kiểm soát nó: quy tắc phá thế hòa khi định tuyến gửi đường dẫn qua infra một cách tất định, khiến phía values của đường dẫn đó không thể truy cập được từ Aggregate.

Thông báo của nó bắt đầu bằng:

annotation binding declares one path in both pillar lists (annotation binding khai báo một đường dẫn trong cả hai danh sách pillar)

Đây là thứ cảnh báo bạn trước khi bản dựng gặp điểm dừng được mô tả trong “An annotation routes through a pillar its authoring side may not use (Một annotation định tuyến qua một pillar mà phía soạn thảo của nó không được dùng)” ở trên — cảnh báo tư vấn là bề mặt sớm, điểm dừng kia là bề mặt thực thi. Lint này được trình bày trong “Binding-map-overlap lint” tại warnings.md.

Tên attachment cách một slot đã khai báo một lần chỉnh sửa

Một cảnh báo tư vấn. Một component gắn một Feature dưới một tên không phải là một trong các slot đã khai báo của kiểu của nó nhưng chỉ cách một slot một lần chỉnh sửa — hình dạng của một lỗi gõ tên slot. Một attachment dưới tên không slot nào khai báo là hợp lệ, nên không có gì dừng lại; điều cảnh báo tư vấn nêu ra là hệ quả: attachment đó là một attachment tự do thay vì lấp đầy slot bạn định, và slot vẫn trống. Trên một connection, cùng lỗi gõ đó không hợp lệ và sẽ dừng bản dựng, nêu tên slot gần đúng; xem “A connection carries an attachment under a name its socket declares no slot for (Một connection mang một attachment dưới một tên mà socket của nó không khai báo slot nào)”. Khi Feature của attachment thỏa selector: của slot gần đúng, cảnh báo tư vấn không được đưa ra: cặp đó được đánh giá bởi điểm dừng trong “An attachment written under another name fits a slot its component leaves empty (Một attachment được viết dưới tên khác khớp với một slot mà component của nó để trống)”, điểm dừng này báo cáo nó khi slot bị để trống.

Thông báo của nó bắt đầu bằng:

attachment name is a near miss for a declared slot (tên attachment gần trùng với một slot đã khai báo)

Được trình bày trong “Attachment-slot near-miss lint” tại warnings.md, cùng với ngưỡng ghép cặp và những gì nó cố ý không bắt.

Tên socket trong uses: cách một socket đã khai báo một lần chỉnh sửa

Một cảnh báo tư vấn. Khối uses: riêng của một component nêu một socket mà kiểu của nó không khai báo nhưng chỉ cách một socket một lần chỉnh sửa. Nhà phát triển sở hữu topology mà Aggregate khai báo và có thể đặt tên một socket mà catalog không lường trước, nên một tên socket mà kiểu không khai báo là hợp lệ trên bề mặt đó và không có gì dừng lại. Điều cảnh báo tư vấn nêu ra là hệ quả: tên viết sai tạo ra một connection ad-hoc riêng, không mang selector nào và không có hợp đồng theo từng cạnh, trong khi socket bạn định vẫn chưa được nối.

Thông báo của nó bắt đầu bằng:

uses socket name is a near miss for a declared socket (tên socket trong uses gần trùng với một socket đã khai báo)

Được trình bày trong “Uses-socket near-miss lint” tại warnings.md. Hai bề mặt lân cận nơi một tên socket không có trong usesSchema của thực thể sở hữu có dừng bản dựng được đề cập trong “uses: socket not declared in the owning entity’s usesSchema (socket không được khai báo trong thực thể sở hữu)” ở trên.

Một Recipe xuất bản một khóa provides mà Component của nó không khai báo

Một cảnh báo tư vấn. Recipe được gắn với một component xuất bản một khóa dưới provides: mà kiểu của component không khai báo trong hợp đồng spec.schema.provides: của nó. Xuất bản nhiều hơn những gì Component khai báo là hợp lệ và vẫn hợp lệ — hợp đồng yêu cầu tập con và cho phép tập cha. Điều cảnh báo tư vấn nêu ra là một hệ quả vô hình từ cả hai phía: một bên tiêu thụ đọc qua một cạnh uses: thấy hợp đồng đã khai báo của đích, không phải bất cứ thứ gì Recipe của nó phát ra, nên một khóa chưa khai báo không được chuyển giao và một template tiêu thụ đọc nó sẽ kết xuất rỗng.

Thông báo của nó bắt đầu bằng:

Recipe publishes a provides key its Component does not declare (Recipe xuất bản một khóa provides mà Component của nó không khai báo)

Trường hợp ngược lại không phải cảnh báo tư vấn: một Component khai báo một khóa mà Recipe của nó không xuất bản sẽ để hợp đồng không được đáp ứng và dừng bản dựng. Được trình bày trong “Undeclared-provides-key lint” tại warnings.md.

Một parameter đã khai báo không được gì đọc

Một cảnh báo tư vấn. Một Aggregate khai báo một mục dưới spec.parameters: và không tham chiếu {{ .parameters.<key> }} nào trong văn bản riêng của Aggregate đó đọc nó, nên dù một Release cung cấp gì cho nó, đầu ra được kết xuất vẫn như nhau. Trình biên dịch không kiểm soát việc tác giả để lộ những núm điều chỉnh nào, và một parameter có thể được khai báo một cách chính đáng trước tham chiếu sẽ đọc nó, nên đây chỉ là tư vấn thay vì dừng bản dựng.

Thông báo của nó bắt đầu bằng:

declared parameter is read by no reference in the Aggregate (parameter đã khai báo không được tham chiếu nào trong Aggregate đọc)

Được trình bày trong “Unread declared-parameter warnings” tại warnings.md, bao gồm lý do một giá trị mặc định không phải là ngoại lệ và những tham chiếu nào việc đọc có thể và không thể thấy.

Một provider binding nêu một capability mà không plugin nào bản dựng đọc phục vụ

Một cảnh báo tư vấn. Một mục plugins.providers nêu một capability mà không nêu plugin nào, và không plugin provider nào mà bản dựng đọc — trong các thư mục catalog, bên trong trình biên dịch, hoặc trong số những plugin được lockfile ghi lại — phục vụ capability đó. Đó là hình dạng của một capability bị viết sai chính tả, và một mục như vậy không được gì đọc: một binding chỉ được tham khảo khi một Recipe yêu cầu capability của nó, và một binding không nêu plugin nào không chọn thứ gì mà quá trình phân giải capability sẽ không chọn khi không có nó.

Nó chỉ tư vấn thay vì dừng bản dựng vì bản dựng không thể chắc chắn. Các binding được viết một lần cho toàn bộ workspace trong khi một bản dựng chỉ thuộc về một Release, nên plugin phục vụ capability có thể là plugin chỉ một Release khác đọc. Mục có nêu một plugin được đánh giá khác, và dừng bản dựng khi chắc chắn sai — xem “A plugins.providers binding names a plugin that does not serve the capability (Một binding nêu một plugin không phục vụ capability đó)” ở trên.

Thông báo của nó bắt đầu bằng:

plugins.providers entry names a capability no provider-rendering plugin the build reads serves (mục plugins.providers nêu một capability mà không plugin kết xuất provider nào bản dựng đọc phục vụ)

và tiếp tục với capability, và một capability đang được phục vụ cách một lần chỉnh sửa nếu có. Được trình bày trong “Provider-binding unserved-capability warning” tại warnings.md.

Một vị trí trong trình soạn thảo nằm ngoài tài liệu

Một điều kiện mà trình soạn thảo tự hấp thụ. Các tính năng của trình soạn thảo phụ thuộc vào vị trí con trỏ — đi tới định nghĩa, hover, gợi ý hoàn thành — trước hết định vị con trỏ bên trong cấu trúc đã phân tích của tài liệu. Điều kiện này là thứ bước đó báo cáo khi vị trí trỏ tới một dòng mà tài liệu không có, điều xảy ra tạm thời khi một chỉnh sửa đang diễn ra và vị trí trình soạn thảo gửi đi được đo trên văn bản mà tài liệu đã thay đổi qua.

Thông báo của nó là:

position out of range (vị trí nằm ngoài phạm vi)

Nó không đến được bản build nào và không tạo ra chẩn đoán nào. Mọi tính năng có thể gặp nó đều trả về không có kết quả thay vì hiển thị lỗi, đó là hành vi mà giao thức trình soạn thảo yêu cầu: một yêu cầu không thể trả lời sẽ không trả về gì, và trình soạn thảo hỏi lại sau lần gõ phím tiếp theo.

Không có gì cần sửa trong các tệp của bạn, và không có gì xuất hiện trong bản build. Một tính năng vẫn không phản hồi thay vì phục hồi ở lần chỉnh sửa tiếp theo thì đáng được báo cáo như một lỗi.

Cơ chế bảo vệ đầu vào của chính bước hợp nhất schema

Một cơ chế bảo vệ mà bản build không chạm tới. Khi một Component hoặc Feature mở rộng một thực thể khác và cả hai đều khai báo schema, các schema đó được kết hợp thành một. Thư viện thực hiện việc kết hợp từ chối một đầu vào mà nó không thể hợp nhất về mặt cấu trúc:

merger: invalid merge input (merger: đầu vào hợp nhất không hợp lệ)

Nó thuộc về bước kết hợp, bước mà bản build có chạm tới mỗi khi một thực thể mở rộng và thực thể cơ sở của nó đều khai báo schema. Điều nó bảo vệ là việc nhận một chuỗi rỗng, hoặc một mục trong chuỗi bị thiếu schema — và bên gọi không thể đưa vào cả hai thứ đó: nó chỉ tạo chuỗi từ các schema mà nó đã xác định là có mặt, và chỉ kết hợp khi chuỗi đó không rỗng.

Cơ chế bảo vệ được giữ lại vì đó là sự từ chối đầu vào sai dạng của một thư viện được xuất ra. Gỡ bỏ nó sẽ không loại bỏ điểm dừng nào mà bản build có thể chạm tới; nó sẽ biến một sự từ chối rõ ràng thành một sự cố crash đối với bên gọi ngoài trình biên dịch truyền vào đầu vào như vậy, điều này hoàn toàn tệ hơn.

Bản thân chuỗi không phải là mối quan tâm của bước này. Một chuỗi lặp vòng và một chuỗi vượt quá giới hạn độ sâu đều bị từ chối bởi lượt duyệt extends: duy nhất trước khi bất kỳ schema nào được kết hợp — xem “Cyclic extends chain” và “An extends: chain runs past the depth bound” ở trên.

Nó được liệt kê ở đây vì nó được khai báo và mang mã riêng, để một mã bạn có trong tay luôn tra ra được. Không có gì bạn viết có thể tạo ra nó, và việc gặp nó có nghĩa là cách sắp xếp mô tả ở trên không còn đúng — đáng được báo cáo như một lỗi thay vì tìm cách lách qua.

Một giá trị tường minh đã thay thế giá trị do một annotation cung cấp

Một cảnh báo tư vấn. Việc mở rộng dựa trên annotation biến một annotation mà một Aggregate hoặc một Release mang theo thành một attachment Feature có cấu hình riêng. Khi cùng attachment đó cũng mang cấu hình được viết tường minh — trên component, trên một phạm vi phía trên nó, hoặc trong Release — giá trị tường minh thắng tại mỗi khóa mà cả hai cùng bao phủ. Đó là quy tắc dự định và đầu ra được phát ra không sai, nên bản build hoàn tất. Điều cảnh báo chỉ ra là hệ quả: phần đóng góp của annotation cho khóa đó không còn hiển thị ở đâu trong đầu ra, và tác giả viết annotation có thể không biết nó đã bị loại bỏ.

Nó báo cáo mọi sự thay thế thay vì chỉ những lần làm thay đổi điều gì đó. Việc hợp nhất ghi đè giá trị bị loại bỏ, nên không còn gì để so sánh và không có gì có thể cho biết hai giá trị có khớp nhau hay không — bản ghi rằng một sự thay thế đã xảy ra là toàn bộ bằng chứng. Nó được đọc khi toàn bộ chuỗi attachment và việc mở rộng đã được gộp lại, đó là thời điểm sớm nhất mà bản ghi đó tồn tại.

Thông báo của nó bắt đầu bằng:

annotation contribution overridden by an explicit value (đóng góp của annotation bị ghi đè bởi một giá trị tường minh)

và tiếp tục với annotation đã bị thay thế, rồi tọa độ của khóa đã thay thế nó, rồi nơi annotation bị thay thế được viết. Vị trí đứng trước nó là tài liệu chứa phát hiện này và khóa bên trong tài liệu đó:

<file> at <authored key>: annotation contribution overridden by an explicit value ("<annotation-key>", component "<component>", attachment "<attachment>", pillar "<pillar>", key "<the key at issue>", annotation declared at "<where the annotation was written>") (tại: đóng góp của annotation bị ghi đè bởi một giá trị tường minh)

Hai trong số các giá trị đó dễ bị đọc nhầm. component chỉ được nêu khi mục thay thế có một component: một mục được viết cho cả một phạm vi không có component riêng, và nêu một component mà nó chưa từng có sẽ dẫn người đọc tới một khóa không ai viết. Còn annotation declared at chỉ nơi annotation bị thay thế được viết, đó là phạm vi mà nó được kế thừa từ đó khi nó không được viết trên component đã thay thế nó — vì vậy nó không phải là khóa component lặp lại dưới một nhãn khác.

Cần làm gì: không cần làm gì, khi giá trị tường minh đúng là điều bạn muốn. Cảnh báo tồn tại để thứ tự ưu tiên là một lựa chọn chứ không phải một bất ngờ. Khi đó không phải điều bạn muốn, có hai cách xử lý và chúng khác nhau về phạm vi. Xóa mục tường minh, và giá trị của annotation sẽ chảy tới khóa đó. Hoặc gỡ annotation khỏi component hoặc phạm vi đang mang nó, và sẽ không có đóng góp nào cả — điều này cũng ảnh hưởng tới mọi khóa khác mà annotation đó cung cấp. Khi cả hai phía đều cần nhưng cho các khóa khác nhau, hãy thu hẹp phía nào đang vươn xa hơn dự định để hai phía không còn chồng lấn.

Một kết nối đi qua giữa các đầu ra đã lắp ráp của hai provider khác nhau

Khi hai đầu của một kết nối phụ thuộc được lắp ráp vào các đầu ra khác nhau, một provider có quảng bá khả năng liên kết xuyên ranh giới sẽ nối nó theo cách gốc — công bố một tham chiếu ở phía sản xuất và phân giải nó ở phía tiêu thụ. Cách nối đó được viết bằng từ vựng riêng của một provider, và một provider không thể phân giải tham chiếu mà provider khác đã công bố. Vì vậy một kết nối có hai đầu được render qua các provider khác nhau sẽ không được bên nào nối.

Đây là cảnh báo tư vấn và không dừng bản build. Kết nối vẫn mang giá trị của nó: hợp đồng injection chuyển giá trị vô hướng của phía sản xuất sang phía tiêu thụ đúng như ở mọi nơi khác, nên kết quả là một kết nối hoạt động được nối theo cách thông thường chứ không phải một kết nối hỏng. Điều phát hiện này cho bạn biết là cách nối gốc mà bạn có thể mong đợi đã không diễn ra — và đầu ra không thay đổi dù bạn có xử lý hay không.

Chỉ cần một provider quảng bá khả năng liên kết là đủ để báo cáo. Không cần cả hai đầu cùng tuyên bố: một lời tuyên bố nghĩa là cách nối gốc đã được mong đợi và là không thể, và tác giả gắn provider đó là người muốn nó. Yêu cầu cả hai lời tuyên bố sẽ không báo gì trong deployment hỗn hợp thông thường, nơi một provider liên kết còn provider kia thì không, chính là trường hợp mà điều này nhắm tới.

Nơi các đầu được đặt không ảnh hưởng. Một đầu ra đã lắp ráp được xác định bởi đường dẫn và provider của nó cùng nhau, nên hai đầu có provider khác nhau luôn nằm ở các đầu ra khác nhau bất kể vị trí đặt. Điều được đọc là hai provider và hai lời tuyên bố của chúng.

Nó được báo cáo một lần cho mỗi kết nối như vậy, gắn vị trí tại tài liệu và khóa nơi kết nối được viết.

Thông báo được phát ra, bắt đầu bằng đầu bên kia rồi nêu socket và provider của mỗi đầu:

cross-boundary link between endpoints rendered by different providers is not supported ("<target-component>", socket "<socket>", consumer provider "<provider>", target provider "<provider>") (không hỗ trợ liên kết xuyên ranh giới giữa các điểm cuối được render bởi các provider khác nhau)

Cách khắc phục: khi giá trị vô hướng mà kết nối đã mang là đủ, không cần làm gì — đây là một thông báo chứ không phải lỗi. Khi cần cách nối gốc, hai đầu phải được render qua cùng một provider: chuyển một đầu vào một ranh giới định tuyến qua provider của đầu kia, hoặc phục vụ cả hai capability bằng một provider. Khi không thể làm cả hai, dạng mang giá trị là thứ deployment có, và kết nối vẫn hoạt động.

Một trình chạy plugin dòng lệnh được dựng mà không có cách tìm plugin

Một plugin đóng góp một lệnh terminal được chạy bởi một thành phần trước tiên phải chuyển tham chiếu của plugin thành byte. Điều kiện này báo rằng thành phần đó đã được dựng mà thiếu phần thực hiện việc chuyển đổi, nên không có đường đi từ tham chiếu đến bất kỳ thứ gì để chạy.

Nó liên quan đến một lệnh terminal chứ không phải một bản build, nên không giai đoạn biên dịch nào chạm tới nó: nó được phát ra tại nơi một lệnh đã cài đặt được điều phối, và kết quả nó tạo ra là lệnh đó không khởi động được, chứ không phải một lần dừng trong bất kỳ bản build nào.

Không đường đi nào trong công cụ dòng lệnh được phát hành có thể phát ra nó. Mọi nơi công cụ dựng thành phần đó đều cung cấp cơ chế tra cứu, nên cơ chế bảo vệ chỉ kích hoạt ở nơi một thứ khác dựng nó và bỏ sót cơ chế tra cứu.

Thông báo được phát ra, chính là câu mô tả của điều kiện này:

cliplugin: no plugin resolver configured (cliplugin: chưa cấu hình trình phân giải plugin)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra điều này, và không gì bạn có thể viết trong một catalog hay một workspace loại bỏ được nó. Nếu bạn đang chạy công cụ dòng lệnh được phát hành, đây không phải điều kiện bạn có thể gặp — một lệnh đã cài đặt mà không khởi động được đang báo một điều khác, và thông báo nó in ra mới là thông báo cần đọc. Nếu bạn nhúng trình chạy plugin vào phần mềm của riêng mình, hãy cung cấp cơ chế tra cứu phân giải tham chiếu plugin thành byte của nó khi bạn khởi tạo nó.

Một bí danh registry đã được gắn với một host khác

Một sự từ chối khi thêm registry vào workspace, không phải khi build. Bí danh là một tên ngắn chọn một mục registry, nên nó là duy nhất giữa các mục. Việc đăng ký một bí danh đã do một host khác nắm giữ bị từ chối thay vì được phép che khuất liên kết hiện có, điều sẽ âm thầm thay đổi nơi mà mọi tham chiếu dùng bí danh đó trỏ tới.

Thêm lại cùng host dưới bí danh hiện có của nó không phải là xung đột — việc đó cập nhật mục tại chỗ, chính là điều xảy ra khi chạy lại lệnh để thay đổi các thiết lập khác của một host.

Thông báo được phát ra, nêu tên bí danh và host đã nắm giữ nó:

workspaceconfig: registry alias "<alias>" is already used by host "<host>"; choose a different alias or address that host directly: registry alias is already used by another host (workspaceconfig: bí danh registry đã được host sử dụng; hãy chọn bí danh khác hoặc gọi trực tiếp host đó: bí danh registry đã được một host khác sử dụng)

Cách khắc phục: việc sửa thuộc về người vận hành, tại dòng lệnh. Đặt cho registry mới một bí danh khác, hoặc để nó không có bí danh và tham chiếu nó bằng host. Nếu bạn định chuyển bí danh sang host mới, trước tiên hãy xóa nó khỏi mục mà thông báo nêu trong .aggrega-config.yaml — sự từ chối tồn tại để việc chuyển một bí danh là điều bạn làm có chủ đích chứ không phải tác dụng phụ của việc thêm một registry.

Một registry cung cấp một tài liệu tin cậy không thể đọc được như một tài liệu tin cậy

Một sự từ chối khi thêm registry, không phải khi build. Một registry có thể công bố các danh tính ký mà nó mong đợi artifact được ký bởi, để việc thêm registry có thể ghim chúng thay vì bắt người vận hành chép lại. Điều kiện này báo một registry đã trả lời bằng một tài liệu không dùng được làm chính sách tin cậy.

Đây là một sự từ chối cứng chính vì endpoint đã trả lời. Một registry không công bố gì là kết quả bình thường, được mong đợi và được chấp nhận; một registry công bố thứ không đọc được là cấu hình sai, và việc không ghim gì từ nó sẽ để registry âm thầm không được ghim trong khi trông như đã được ghim.

Có ba dạng được báo ở đây: nội dung hoàn toàn không giải mã được, kể cả một tài liệu mang một trường mà định dạng không định nghĩa; một mục danh tính không nêu danh tính chính xác lẫn mẫu; và một mục danh tính không có issuer. Hai trường hợp sau bị từ chối vì một mục như vậy không bao giờ khớp được chữ ký, nên nó sẽ làm yếu việc ghim trong khi có vẻ như làm mạnh thêm.

Các thông báo được phát ra. Nội dung không giải mã được:

registrytrust: advertised trust config is malformed: <what the decoder reported> (registrytrust: cấu hình tin cậy được công bố bị sai định dạng)

một mục danh tính không có gì để so khớp:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set identity or identity_regexp (registrytrust: cấu hình tin cậy được công bố bị sai định dạng: một mục danh tính phải đặt identity hoặc identity_regexp)

và một mục không có issuer:

registrytrust: advertised trust config is malformed: <list>[<index>]: an identity entry must set issuer (registrytrust: cấu hình tin cậy được công bố bị sai định dạng: một mục danh tính phải đặt issuer)

Mỗi thông báo được bao bởi lệnh đã gặp nó:

aggrega registry add: <the message above>

Cách khắc phục: việc sửa thuộc về người vận hành registry, không phải bạn — hãy trích thông báo cho họ, vì nó nêu chính xác mục và thứ còn thiếu trong đó. Để tiếp tục trong lúc chờ, hãy thêm registry mà không ghim chính sách được công bố và tự cung cấp các danh tính hoặc khóa; lệnh nhận chúng trực tiếp, đó cũng là điều bạn làm với một registry hoàn toàn không công bố chính sách.

Một registry không công bố tài liệu tin cậy nào

Một kết quả bình thường, được mong đợi chứ không phải lỗi, và nó không dừng gì cả. Một registry có thể công bố các danh tính ký mà nó mong đợi, và đa số thì không. Khi được hỏi, một registry như vậy trả lời rằng nó không có, và việc thêm registry vẫn tiếp tục — kết quả được báo dưới dạng thông báo và các danh tính được ghim thủ công thay thế.

Nó được cố ý phân biệt với một registry không thể kết nối tới. Registry này đã trả lời; câu trả lời là nó không công bố chính sách. Tách riêng hai trường hợp là điều cho phép chấp nhận một sự vắng mặt có chủ đích trong khi một vấn đề kết nối vẫn hiển thị đúng là vấn đề kết nối.

Được báo dưới dạng thông báo, nêu tên registry, câu trả lời của nó, và việc nên làm thay thế:

Notice: <host> publishes no trust policy (HTTP 404); pin its trust by hand with —identity or —key (Thông báo: không công bố chính sách tin cậy (HTTP 404); hãy ghim tin cậy thủ công bằng —identity hoặc —key)

Điều kiện mà nó được ghi nhận là registrytrust: registry advertises no trust config.

Hub chính thức là ngoại lệ: nó mang một baseline tích hợp sẵn, nên khi nó không công bố tài liệu thì baseline đó được ghim thay thế, và thông báo cho biết hub đã trả lời gì và baseline được dùng thay vào đó, thay vì yêu cầu bạn ghim danh tính.

Cách khắc phục: không có gì bị hỏng. Nếu bạn muốn kiểm tra chữ ký từ registry này, hãy cung cấp danh tính hoặc khóa khi thêm nó, đúng như thông báo nói — đó là cách thông thường cho một registry không công bố chính sách. Nếu không, registry được thêm mà không có lập trường ký và các artifact từ nó chỉ được xác minh khi chúng mang chữ ký.

Một registry được thêm khi ngoại tuyến mà không có chính sách tin cậy để ghim

Đây là một sự từ chối khi thêm registry, không phải khi build. Thêm một registry là thời điểm duy nhất độ tin cậy của nó được ghim: các danh tính ký mà nó công bố được tải về một lần và mọi lần pull sau đó đều xác minh dựa trên bản sao đã ghim ấy. Khi workspace ở chế độ ngoại tuyến, việc tải về đó không thể thực hiện, nên registry không bao giờ được hỏi. Thay vì ghi một mục không tin cậy gì cả — và mọi lần pull sau đó sẽ buộc registry theo mục ấy — việc thêm một registry khác với hub chính thức bị từ chối trừ khi bạn tự cung cấp chính sách.

Ba trường hợp không bị từ chối. Cung cấp danh tính hoặc khóa sẽ đăng ký đúng những thứ đó và không tải gì cả, nên hoạt động như nhau khi ngoại tuyến cũng như trực tuyến. Hub chính thức được thêm dựa trên baseline tích hợp sẵn của nó, mà nó mang theo dù việc tải về có được thực hiện hay không. Và yêu cầu không tải — --fetch-trust=false — sẽ đăng ký mục từ các cờ, đúng như khi trực tuyến.

Điều kiện này gặp ở bất cứ nơi nào một registry được thêm: aggrega registry add, aggrega config init --registry <host>, các yêu cầu aggrega/registryAdd và aggrega/configInit của aggrega serve, có thông báo lỗi mang mã ngắn trước câu mô tả, và các công cụ đăng ký của aggrega mcp, vốn chạy các lệnh đó. Việc khởi tạo cấu hình không nhận danh tính hay khóa, nên khi ngoại tuyến nó chỉ có thể khởi tạo hub; hãy thêm mọi registry khác bằng aggrega registry add.

Thông báo được phát ra, chính là câu mô tả của điều kiện này:

a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with aggrega registry add <host> --identity <identity>=<issuer> or --key <public-key-file> (một registry khác với hub chính thức không được đăng ký khi ngoại tuyến nếu không có chính sách tin cậy cung cấp thủ công, vì chính sách nó công bố không thể tải về; hãy đăng ký nó một lần khi trực tuyến, hoặc ghim độ tin cậy của nó thủ công)

được bao bởi lệnh đã gặp nó và registry mà nó nêu tên:

aggrega registry add: <host>: <the message above>

Cách khắc phục: đăng ký registry một lần khi workspace trực tuyến — truyền --offline=false cho lần chạy đó, hoặc xóa thiết lập offline — để chính sách nó công bố được tải về và ghim; sau đó không cần lặp lại gì, vì các lần pull sau xác minh dựa trên bản sao đã ghim. Nếu bạn không thể trực tuyến, hãy cung cấp chính sách thủ công: một hoặc nhiều mục --identity <identity>=<issuer> cho registry keyless, hoặc --key trỏ tới tệp khóa công khai của nó cho registry dùng khóa, chính là thứ bạn lẽ ra đã ghim từ phần công bố của nó.

Một tag đã được công bố với nội dung khác

Đây là một sự từ chối khi công bố, không phải khi build. Các byte đã công bố bị đóng băng: trước khi tải lên bất cứ thứ gì, phiên bản đích được tra cứu và digest mà nó trỏ tới được so sánh với digest mà nội dung hiện có sẽ tạo ra. Một phiên bản đã trỏ tới nội dung khác sẽ bị từ chối.

Công bố lại nội dung giống hệt từng byte không phải là xung đột. Các digest khớp, không có gì được tải lên, và lệnh báo rằng phiên bản đã được công bố — nên chạy lại một lần công bố đã thành công một phần là an toàn, và nó hoàn tất việc công bố: ngày công bố mà phiên bản còn thiếu, và chữ ký của nó nếu lần push có ký, sẽ được gắn vào, còn phiên bản không thiếu thứ nào thì không nhận gì, như Hoàn tất một lần công bố mà lần push trước để dở mô tả.

Không có cờ nào ghi đè điều này. Nội dung đã thay đổi được công bố dưới một phiên bản mới, nhờ đó người dùng có một phiên bản để chủ động chuyển sang thay vì một phiên bản bị thay đổi ngầm dưới chân họ.

Các thông báo được phát ra, nêu tên phiên bản, digest nó đang giữ và digest được đưa ra. Khi công bố một thực thể catalog, thông báo còn nêu tên bước kiểm tra xác minh việc nâng phiên bản:

aggrega push: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version (aggrega lint —pre-publish verifies the bump): oci: tag already published with different content (đã được công bố; từ chối ghi đè — hãy công bố một phiên bản mới (aggrega lint —pre-publish xác minh việc nâng phiên bản): tag đã được công bố với nội dung khác)

và khi công bố một artifact dữ liệu:

aggrega push-artifact: <reference>:<version> is already published as <existing digest>; refusing to overwrite with <proposed digest> — publish a new version: oci: tag already published with different content (đã được công bố; từ chối ghi đè — hãy công bố một phiên bản mới: tag đã được công bố với nội dung khác)

Cách khắc phục: nâng phiên bản và công bố lại. Với một thực thể catalog, điều đó nghĩa là metadata.version và thư mục theo phiên bản chứa thực thể, hai thứ thay đổi cùng nhau. Trước khi làm, hãy kiểm tra rằng thay đổi là điều bạn chủ ý: hai digest khác nhau trên một phiên bản mà bạn tin là mình chưa động tới nghĩa là nội dung trên đĩa không phải nội dung đã được công bố, và tìm ra lý do đáng giá hơn việc công bố đè lên. Bước kiểm tra trước khi công bố được nêu trong thông báo so sánh một phiên bản với phiên bản trước nó và là cách để xác nhận việc nâng phiên bản là đúng.

Một thực thể dùng chung thư mục với một thực thể khác

Đây là một sự từ chối khi ghim và khi công bố, không phải khi build. Mọi loại thực thể đều có thư mục riêng, trừ ba loại mà gốc workspace chứa cạnh nhau: một Aggregate, một Release và một Manifest. Một thực thể đã công bố là một artifact tại một tọa độ cho mỗi phiên bản, và thư mục nơi nó được soạn phản ánh điều đó — bước ghim ghi tệp entity.lock duy nhất mà một thư mục có chỗ chứa, và một lần công bố đóng gói thực thể từ thư mục của nó. Vì vậy, một thực thể thuộc bất kỳ loại nào khác có một thực thể khác bên cạnh sẽ bị từ chối ở cả hai thời điểm đó: bởi aggrega pin, bởi một lần pull hoặc push được yêu cầu ghim thay cho tác giả, và bởi aggrega push dù nó có ghim hay không. Nó bị từ chối trước khi bất cứ thứ gì được tải về, và không có gì được ghi.

Một thư mục chứa nhiều thực thể vẫn được nạp, lint, xác thực và build. Bố cục chỉ được xét khi có thứ gì đó được tạo ra từ thư mục, cũng là thời điểm thông báo có thể nêu tên thực thể gây cản trở. Một lần pull không ghim sẽ không ghi gì bên cạnh thực thể và không bị từ chối.

Thứ được tính là một thực thể bên cạnh là bất kỳ tài liệu YAML nào khác nằm trực tiếp trong cùng thư mục mà kind: là một loại thực thể. Các tệp riêng của một chart, một đoạn compose, một manifest Kubernetes hay một README không phải là thực thể, và một thư mục con — một chart cục bộ, một cây source/ — không nằm bên cạnh thực thể, bất kể nó chứa gì. Chỉ loại và tên của mỗi thực thể lân cận được đọc, nên không gì mà một thực thể lân cận khai báo có thể thay đổi kết quả.

Tên của thư mục không được xét. Một thực thể đứng một mình trong thư mục của nó sẽ được ghim và công bố ở phiên bản nó khai báo, bất kể thư mục đó nằm ở đâu; bố cục <name>/<version>/ mà catalog thư viện chuẩn dùng là một quy ước chứ không phải một bước kiểm tra.

Thông báo được phát ra, nêu tên thực thể, mọi thực thể bên cạnh nó và các tệp cần di chuyển:

the entity shares its directory with another entity, and an entity of its kind has a directory of its own (Recipe "<name>", beside it: Recipe "<name>" in <file>). remediation: give each entity a directory of its own — move <file> into a directory of its own, together with any file only that entity reads; only the Aggregate, Manifest and Release kinds may share a directory with other entities (thực thể dùng chung thư mục với một thực thể khác, và một thực thể thuộc loại này có thư mục riêng. khắc phục: cho mỗi thực thể một thư mục riêng — di chuyển tệp vào một thư mục riêng, cùng với mọi tệp chỉ thực thể đó đọc; chỉ các loại Aggregate, Manifest và Release mới được dùng chung thư mục với các thực thể khác)

Cách khắc phục: di chuyển mỗi thực thể mà thông báo nêu tên vào một thư mục riêng, mang theo các tệp chỉ nó đọc — một chart cục bộ, một tệp được import, và entity.lock nếu tệp này ghi lại các ghim của thực thể đó — rồi chạy aggrega pin trên mỗi thực thể đọc một nguồn từ xa hoặc import một tệp, để mỗi lock ghi lại đúng thực thể của nó. Bố trí mỗi thực thể theo dạng <kind>/<provider-or-publisher>/…/<name>/<version>/ giữ nó ở đúng nơi catalog thư viện chuẩn giữ mọi thực thể. Một thư mục catalog được tìm bằng cách duyệt qua nó, nên một lần build trên catalog sẽ render cùng một đầu ra sau khi di chuyển.

Một kiểu thực thể không có media type cho artifact

Một sự từ chối khi phát hành, không phải khi build. Mỗi kiểu thực thể có thể phát hành có một media type cho mỗi dạng trong hai dạng artifact của nó — chỉ riêng tài liệu của nó, hoặc một kho lưu trữ gồm tài liệu và các tệp nó khai báo — và việc đóng gói một thực thể tra cứu điều đó theo kiểu. Điều kiện này báo một kiểu không có mục nào.

Không bản build nào gặp phải nó. Nơi duy nhất khác chạy cùng phép tra cứu này coi một mục bị thiếu là “đây không phải là một library” và tiếp tục, nên điều kiện này không bao giờ xuất hiện ở đó.

Thông báo được phát ra: câu mô tả của chính điều kiện, được bao bởi lệnh và tệp đang được đóng gói:

aggrega push: bundle <path>: oci: unknown entity kind for mediatype dispatch (aggrega push: bundle: oci: kiểu thực thể không xác định khi chọn mediatype)

Cách khắc phục: đối chiếu trường kind: của tệp bạn đang phát hành với các kiểu mà aggrega push --list-kinds in ra — một kiểu viết sai chính tả hoặc không được hỗ trợ sẽ báo ở đây, và sửa trường đó là toàn bộ cách khắc phục. Khi kiểu đó có trong danh sách ấy, đó là một thiếu sót trong bộ công cụ chứ không phải trong thực thể của bạn, và nên báo cáo nó kèm theo tên kiểu.

Một kho lưu trữ đã phát hành chứa một mục mà Windows không thể dùng

Một cảnh báo tư vấn được đưa ra khi một thực thể được phát hành; nó không bao giờ dừng bất cứ thứ gì, và một bản build không đưa ra nó. Một thực thể mang theo các tệp bên cạnh tài liệu của nó được phát hành dưới dạng một kho lưu trữ, và mỗi tên mà kho lưu trữ chứa — tên tệp của chính tài liệu thực thể, rồi từng tệp nó mang theo — được đánh giá theo quy tắc mà điểm dừng “A name the operation writes holds a part Windows cannot hold (Một tên mà thao tác ghi ra chứa một phần Windows không thể chứa)” ở trên áp dụng trên Windows: một phần mà Windows dành riêng cho thiết bị, ở bất kỳ kiểu chữ hoa thường nào và bất kể phần mở rộng theo sau, hoặc một phần kết thúc bằng dấu chấm hoặc dấu cách. Vì vậy aux/x.yaml gây ra nó do thư mục aux, report. do dấu chấm cuối, và một tài liệu tên con.yaml nhập một tệp schema thì do chính tên của nó. Một thực thể không mang theo gì được phát hành chỉ dưới dạng tài liệu của nó, đặt dưới một cái tên do sản phẩm chọn, và một Plugin không phát hành kho lưu trữ nào, nên cả hai đều không gây ra nó.

Nó được đưa ra trên mọi nền tảng, và nó không từ chối gì. Một workspace trên Windows từ chối bố trí một mục như vậy, theo điểm dừng đó, nên không thể dùng phiên bản này; cảnh báo là cách để bên phát hành biết điều này trước khi ai đó trên Windows gặp phải. Việc phát hành, hoặc lần chạy thử của nó, tiếp tục hoặc dừng đúng như khi không có cảnh báo.

Mọi giao diện phát hành một thực thể đều đưa ra nó, mỗi giao diện theo dạng riêng. aggrega push, và --dry-run của nó, in một dòng cho mỗi mục trên standard error, mỗi dòng bắt đầu bằng warning: . Công cụ publish-entity của trợ lý trả lời với các mục dưới dạng windows_unusable_entries, và văn bản của câu trả lời cũng nêu chúng. aggrega serve trả lời aggrega/publishEntity với chúng dưới dạng windowsUnusableEntries, và chuyển chính các dòng cảnh báo tới một yêu cầu đã yêu cầu được báo cáo. Mỗi câu trả lời bỏ trường này đi khi không có mục nào như vậy.

Thông báo của nó bắt đầu bằng:

an entry this publication carries cannot be used on Windows (một mục mà bản phát hành này mang theo không thể dùng được trên Windows)

và tiếp tục với mục đó và phần đầu tiên của nó mà Windows không thể chứa, rồi đến cách khắc phục. Được giải thích trong mục “A published archive carries an entry Windows cannot use (Một kho lưu trữ đã phát hành chứa một mục mà Windows không thể dùng)” tại warnings.md.

Cách khắc phục: đổi tên phần mà thông báo nêu, trên đĩa và ở bất cứ đâu các khai báo của thực thể nêu tệp đó, rồi phát hành lại. Khi phiên bản không nhằm để dùng trên Windows, không cần thay đổi gì.

Two catalog identities publish to one repository location (Hai định danh catalog cùng xuất bản tới một vị trí kho lưu trữ)

Một sự từ chối khi kiểm tra toàn bộ catalog, không phải khi build. Nơi một thực thể được xuất bản tới được suy ra từ định danh của nó và chuyển thành chữ thường, nên hai định danh chỉ khác nhau về chữ hoa chữ thường sẽ rơi vào cùng một chỗ. Xuất bản cả hai sẽ khiến các byte của thực thể này bị ghi đè bởi các byte của thực thể kia, và không có gì trong cả hai thực thể cho biết điều đó.

Việc kiểm tra chạy trên toàn bộ catalog cùng lúc, vì xung đột là thuộc tính của một cặp chứ không phải của riêng thực thể nào — riêng mỗi thực thể không sai, và đọc riêng lẻ từng thực thể không cho thấy gì.

Thông báo được phát ra. Khung của bước kiểm tra catalog mở đầu thông báo, tiếp theo là câu mô tả của chính điều kiện, rồi đến từng nhóm xung đột, mỗi nhóm nêu vị trí dùng chung và các định danh đi tới vị trí đó:

catalog validation failed: oci: distinct catalog identities map to the same OCI repository location: (xác thực catalog thất bại: oci: các định danh catalog khác nhau ánh xạ tới cùng một vị trí kho lưu trữ OCI:)

  • <location> <- <identity>, <identity>

Cách khắc phục: đổi tên một trong các thực thể mà thông báo nêu, trong metadata.name của nó và trong thư mục phản chiếu tên đó. Đổi tên thực thể nào là do bạn chọn; các cặp chỉ khác chữ hoa chữ thường là dạng thường gặp, và chọn một cách viết rồi dùng nhất quán là điều ngăn cặp đó tái diễn. Đổi tên là một thay đổi thực sự đối với định danh của thực thể, nên mọi thứ tham chiếu tới tên cũ phải thay đổi theo — đó là lý do nên giải quyết xung đột trước khi xuất bản tên nào, thay vì sau đó.

Keyless signing was asked for without the services it needs (Ký không khóa được yêu cầu mà không có các dịch vụ cần thiết)

Một sự từ chối khi ký trong lúc xuất bản, không phải khi build. Ký không khóa không có dạng ngoại tuyến: nó lấy một định danh, xin cấp một chứng chỉ ngắn hạn cho định danh đó, ghi lại chữ ký ở nơi có thể kiểm tra sau này, rồi hủy khóa. Mỗi bước đó đều là một trao đổi với một dịch vụ đang chạy. Điều kiện này báo rằng định danh mà quy trình bắt đầu từ đó không có sẵn, nên quy trình bị từ chối thay vì được bắt đầu rồi bỏ dở giữa chừng.

Hai dạng báo điều kiện này: hoàn toàn không có gì được cấu hình để cung cấp định danh, và có thứ được cấu hình nhưng không trả về gì.

Một workspace ngoại tuyến báo theo cách khác, dưới sự từ chối áp dụng cho mọi bước mạng, vì sự từ chối xảy ra trước khi định danh được yêu cầu.

Các thông báo được phát ra. Không có nguồn định danh:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token source is required (ký: ký không khóa cần một nhà cung cấp định danh đang hoạt động, Fulcio và Rekor: cần một nguồn token định danh)

và một nguồn không tạo ra gì:

signing: keyless signing requires a live identity provider, Fulcio, and Rekor: an identity token is required (ký: ký không khóa cần một nhà cung cấp định danh đang hoạt động, Fulcio và Rekor: cần một token định danh)

Cách khắc phục: việc khắc phục thuộc về người vận hành, ở cách chạy việc xuất bản. Trong một pipeline tự động, định danh đến từ thông tin xác thực của chính pipeline, nên điều này thường có nghĩa là job không được cấp quyền phát hành chúng. Khi chạy tương tác, định danh đến từ việc đăng nhập, mà lệnh sẽ nhắc bạn thực hiện. Nếu bạn hoàn toàn không muốn dùng định danh trực tuyến, hãy ký bằng một khóa đang giữ — cách đó không cần dịch vụ nào trong số này, và là cách nên dùng từ một môi trường không thể kết nối tới chúng.

An unsigned publish targets a registry or a policy that requires a signature (Một lần xuất bản không ký nhắm tới registry hoặc chính sách yêu cầu chữ ký)

Một sự từ chối khi xuất bản, không phải khi build. Ở nơi chữ ký là bắt buộc, nội dung không ký sẽ không được xuất bản. Việc kiểm tra chạy trước khi bất kỳ byte nào được tải lên, nên không có gì dở dang tới được registry.

Hai điều kiện, vì yêu cầu có hai nguồn và cách khắc phục khác nhau. Một là lập trường riêng của registry đích, áp dụng cho mọi thứ được xuất bản ở đó. Cái còn lại là chính sách ký của workspace, bao phủ một tập các loại artifact ở bất cứ nơi nào chúng được xuất bản. Khi cả hai cùng áp dụng, điều kiện của registry được báo, vì nêu tên đích là hữu ích hơn trong hai cái.

Không có cờ nào xuất bản nội dung không ký ở đây. Tắt ký một cách tường minh không nới lỏng sự từ chối — nó chỉ thay đổi mặc định cho các artifact mà việc ký là tùy chọn.

Chữ ký được tạo trước khi tải lên chứ không phải sau, nên một lỗi ký cũng rơi vào đây và không có gì được xuất bản.

Các thông báo được phát ra. Yêu cầu riêng của registry:

aggrega push: registry "<host>" requires signatures; re-run signing the artifact (there is no flag to push unsigned content here): signing: registry requires signatures; refusing to push unsigned content (aggrega push: registry yêu cầu chữ ký; hãy chạy lại và ký artifact (không có cờ nào để đẩy nội dung không ký ở đây): ký: registry yêu cầu chữ ký; từ chối đẩy nội dung không ký)

yêu cầu của chính sách workspace, nêu loại đã đưa artifact vào phạm vi:

aggrega push: the signing policy requires a signature for kind "<kind>"; re-run signing the artifact (there is no flag to push unsigned content here): signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content (aggrega push: chính sách ký yêu cầu chữ ký cho loại này; hãy chạy lại và ký artifact (không có cờ nào để đẩy nội dung không ký ở đây): ký: chính sách ký yêu cầu chữ ký cho loại artifact này; từ chối đẩy nội dung không ký)

và một chữ ký không thể tạo được, được báo dưới điều kiện của registry và trích dẫn lỗi gốc:

aggrega push: sign <reference>:<version>: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: ký: ký: registry yêu cầu chữ ký; từ chối đẩy nội dung không ký)

Một dạng lỗi ký được nêu cụ thể, vì một lời từ chối chung chung khiến người dùng đi lấy lại một thông tin xác thực vốn không giúp được gì:

aggrega push: sign <reference>:<version>: the identity token carries no verified email or subject claim — the OIDC flow/client did not return an email-scoped identity (re-exporting or re-acquiring the token will not help); configure the identity provider/client/scope to return one: <the underlying failure>: signing: registry requires signatures; refusing to push unsigned content (aggrega push: ký: token định danh không mang claim email hoặc subject đã xác minh — luồng/client OIDC không trả về định danh có phạm vi email (xuất lại hoặc lấy lại token sẽ không giúp được); hãy cấu hình nhà cung cấp định danh/client/phạm vi để trả về một định danh như vậy: ký: registry yêu cầu chữ ký; từ chối đẩy nội dung không ký)

Cách khắc phục: việc khắc phục thuộc về người vận hành. Ký artifact và xuất bản lại — bằng một khóa đang giữ hoặc bằng cách ký không khóa, tùy theo workspace được thiết lập cho cách nào. Nếu bạn không ngờ rằng chữ ký là bắt buộc, thông báo cho biết nguồn nào yêu cầu nó: lập trường riêng của một registry nằm trong mục của registry đó trong .aggrega-config.yaml, còn yêu cầu theo loại nằm trong chính sách ký áp dụng cho toàn workspace. Nới lỏng một trong hai là một quyết định về những gì bạn sẵn sàng xuất bản mà không ký, nên thu hẹp phạm vi của chính sách thường tốt hơn là tắt hẳn nó.

Các tham chiếu được ký cùng nhau cần các thông tin xác thực ký khác nhau

Một sự từ chối khi ký, không phải khi build. aggrega sign khi được truyền nhiều tham chiếu, và aggrega deprecate --from khi được truyền một tệp lô, ký mọi thứ được truyền vào bằng một thông tin xác thực duy nhất: một khóa được giữ duy nhất, hoặc một danh tính keyless duy nhất. Thông tin xác thực mà một tham chiếu cần được quyết định bởi cấu hình cho registry của nó — một signing.key_path áp dụng cho registry đó sẽ chọn khóa mà nó chỉ định, và khi không có cái nào áp dụng thì tham chiếu được ký keyless. Khi các tham chiếu được nêu cùng nhau cần các thông tin xác thực khác nhau — một khóa cho registry này và không có khóa cho registry khác, hoặc hai khóa khác nhau — thì không có gì được ký, và thông báo nêu tên các registry ở mỗi bên.

Việc kiểm tra chạy trước khi danh tính được yêu cầu và trước khi bất kỳ registry nào được đọc, nên không có gì được ký hay đính kèm và không ai bị nhắc nhập cho một lần chạy sẽ không tiếp tục. Một chữ ký không thể bị thu hồi từ bất kỳ ai đã tải nó về, đó là lý do lần chạy bị từ chối thay vì được ký bằng thông tin xác thực mà một trong các tham chiếu cần.

Một khóa được truyền bằng --key quyết định cho mọi tham chiếu. Nó áp dụng cho mọi tham chiếu được nêu, bất kể cấu hình nói gì cho từng registry, nên một lần chạy như vậy không bao giờ bị từ chối ở đây.

Bạn gặp nó ở bất cứ đâu một lô được ký: aggrega sign, aggrega deprecate --from, các yêu cầu aggrega/signArtifacts và aggrega/deprecateArtifact của aggrega serve, có thông báo lỗi mang mã ngắn trước câu, và các công cụ sign-artifacts và deprecate-artifact của aggrega mcp. Một lệnh gọi công cụ đến máy chủ qua một listener không bao giờ dùng khóa mà cấu hình chỉ định, nên ở đó mọi tham chiếu được ký bằng danh tính mà lệnh gọi gửi và lệnh gọi không bị từ chối ở đây.

Thông báo được phát ra. Câu của chính điều kiện mở đầu, mỗi thông tin xác thực theo sau cùng các registry mà nó sẽ ký cho, và cách khắc phục đứng cuối:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own (signing: các tham chiếu được nêu cùng nhau cần các thông tin xác thực ký khác nhau, nên không có gì được ký (registry ký bằng khóa được giữ mà signing.key_path chỉ định, registry ký keyless: không có signing.key_path nào áp dụng). cách khắc phục: ký chúng trong các lần chạy riêng, mỗi lần một thông tin xác thực: các tham chiếu trên registry này, rồi các tham chiếu trên registry kia; mỗi lần chạy ký như khi chạy riêng)

và, khi một registry trong lô yêu cầu chữ ký, nêu tên nó ở cuối phần khắc phục:

aggrega sign: signing: the references named together need different signing credentials, so nothing was signed (<registry> signs with the held key signing.key_path names, <registry> signs keyless: no signing.key_path applies). remediation: sign them in separate runs, one per credential: the references on <registry>, then the references on <registry>; each run signs as it would on its own, and <registry> requires signatures, so this refusal holds back signing that would otherwise have gone ahead rather than signing that cannot be done (signing: các tham chiếu được nêu cùng nhau cần các thông tin xác thực ký khác nhau, nên không có gì được ký (registry ký bằng khóa được giữ mà signing.key_path chỉ định, registry ký keyless: không có signing.key_path nào áp dụng). cách khắc phục: ký chúng trong các lần chạy riêng, mỗi lần một thông tin xác thực: các tham chiếu trên registry này, rồi các tham chiếu trên registry kia; mỗi lần chạy ký như khi chạy riêng, và registry yêu cầu chữ ký, nên sự từ chối này giữ lại việc ký lẽ ra đã tiếp tục chứ không phải việc ký không thể thực hiện)

Một registry thứ hai có khóa riêng được nêu là ký “with a different held key” (bằng một khóa được giữ khác). Đường dẫn của khóa không bao giờ được in ra: thông báo nêu tên thiết lập, là thứ bạn có thể thay đổi.

Cách khắc phục: chia các tham chiếu theo thông tin xác thực mà registry của chúng cần và chạy một lần cho mỗi thông tin xác thực — một aggrega sign nêu các tham chiếu trên các registry được ký bằng khóa, một lần khác nêu phần còn lại; với aggrega deprecate --from, mỗi thông tin xác thực một tệp lô. Khi đó mỗi lần chạy ký như khi chạy riêng. Để thay vào đó ký mọi tham chiếu bằng một khóa trong một lần chạy, hãy truyền khóa đó bằng --key.

A detached signature does not verify against the key supplied (Chữ ký tách rời không xác minh được với khóa đã cung cấp)

Kết quả phủ định của việc kiểm tra một chữ ký trần trên một payload với một khóa công khai, hoàn toàn ngoại tuyến: payload khác với thứ đã được ký, chữ ký đã bị thay đổi, hoặc khóa không phải là khóa đã tạo ra nó.

Không có gì trong bộ công cụ phát hành chạm tới nó. Phần kiểm tra chứa nó không có nơi gọi nào ngoài các bài kiểm thử của chính nó, nên không lệnh nào người dùng chạy — build, pull hay publish — báo cáo nó. Nó được liệt kê ở đây để mã có thể tra ra một thứ gì đó, chứ không phải vì một build có thể in nó. Việc xác minh mà một lần pull thực sự thực hiện là trên một bundle chữ ký đầy đủ và được báo cáo riêng.

Thông báo được phát ra, trích dẫn những gì trình xác minh báo cáo:

signing: signature does not verify: <what the verifier reported> (signing: chữ ký không xác minh được)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra điều này, và không có gì bạn viết trong một catalog hay một workspace có thể loại bỏ nó. Khi bạn chạy công cụ dòng lệnh đã phát hành, đây không phải là điều kiện bạn có thể gặp, và một vấn đề chữ ký mà bạn thực sự đang thấy là do một trong các điều kiện xác minh bundle ở trên báo cáo. Khi bạn dùng trực tiếp gói ký từ phần mềm của riêng mình, payload, chữ ký và khóa phải là bộ ba thuộc về nhau — một payload được tuần tự hóa lại giữa lúc ký và lúc xác minh là nguyên nhân thường gặp, vì khi đó các byte khác nhau dù nội dung đọc giống nhau.

A resolved artifact is not a documentation bundle (Artifact đã phân giải không phải là một bundle tài liệu)

Một tham chiếu phân giải tới một artifact thuộc loại khác — một entity của catalog, một plugin — bị từ chối thay vì được lưu vào bộ nhớ đệm như tài liệu, nên một tham chiếu trỏ sai sẽ thất bại tại nơi nó được trỏ thay vì về sau dưới dạng một bundle không đọc được.

Nơi nó phát sinh. Bundle tài liệu được tải vào bộ nhớ đệm dùng chung cho mọi dự án trên máy, từ registry đã cấu hình của workspace dưới namespace dành riêng docs: bởi máy chủ dành cho trợ lý một lần, khi nó khởi động và trước khi nó trả lời bất cứ điều gì, bởi aggrega explain và phần giải thích một mã của trình soạn thảo vào lần đầu tiên một trong hai cần đến nó, và bởi aggrega scaffold --example — trong mỗi trường hợp chỉ khi máy không giữ bản sao nào mà bước kiểm tra chữ ký của workspace chấp nhận. Đây là bước kiểm tra mà mọi lần tải đều chạy trên những gì nhận về.

Nó không bao giờ dừng một phiên. Lần tải báo cáo kết quả trên luồng log của máy chủ và kết nối vẫn tiếp tục dù thế nào; cái giá của một artifact bị từ chối là các tài nguyên tài liệu, khi đó sẽ trả lời không tìm thấy cho phiên đó. aggrega scaffold --example không có gì để ghi nếu thiếu bundle, nên ở đó nó là sự từ chối của lệnh, và không có gì được ghi.

Thông báo được phát ra, nêu tham chiếu và cả hai media type:

docscache: <reference>@<version> has media type "<what was found>", want "<what a documentation bundle is>": docscache: artifact is not a documentation bundle (docscache: tham chiếu có media type không mong đợi: docscache: artifact không phải là một bundle tài liệu)

Cách khắc phục: không có gì trong các tệp entity của bạn gây ra điều này, và không thay đổi soạn thảo nào loại bỏ được nó. Tham chiếu mà lần tải sử dụng đang trỏ tới một thứ không phải là bundle tài liệu — hãy kiểm tra registry đã cấu hình của workspace, vì tham chiếu bundle được suy ra từ đó, và một tham chiếu đúng định dạng trỏ tới một artifact khác sẽ phân giải thành công và chỉ thất bại ở đây.

A page is absent from a documentation bundle (Một trang không có trong gói tài liệu)

Một gói tài liệu đã được lưu vào bộ nhớ đệm và nội dung của nó đã được xác minh, nhưng trang được yêu cầu — hoặc, với aggrega scaffold --example, thư mục của ví dụ — không có trong đó. Tình trạng này khác với việc hoàn toàn không có gói nào: gói có mặt và nguyên vẹn, chỉ là mục đó bị thiếu.

Nó không đến được bản dựng nào. Bề mặt phục vụ các trang tài liệu cho trình soạn thảo hoặc trợ lý biến nó thành một câu trả lời không tìm thấy thông thường cho tài nguyên được yêu cầu. aggrega scaffold --example không ghi gì và báo cáo nó như một sự từ chối nêu tên ví dụ và gói, kèm theo lời chỉ dẫn tới aggrega scaffold --example --list, lệnh in ra các ví dụ mà gói thực sự chứa.

Nên phân biệt được bạn nhận câu trả lời không tìm thấy nào trong hai loại, dù bề mặt hiển thị chúng giống nhau. Loại này nghĩa là gói đã được lưu đệm, nguyên vẹn và trang không có trong đó. Loại còn lại — không có gói nào mà workspace được phép đọc, vì chưa có gói nào được lưu đệm hoặc bản duy nhất là bản bị bước kiểm tra chữ ký của workspace từ chối — nghĩa là việc tải về chưa hoàn tất, và luồng nhật ký của máy chủ cho biết lý do.

Thông báo được phát ra, nêu tên trang và gói đã được tìm kiếm:

page "<page>" in <reference>@<version>: docscache: page not found in documentation bundle (trang trong: docscache: không tìm thấy trang trong gói tài liệu)

Cách khắc phục: không có gì hỏng trong các tệp của bạn. Một trang bị thiếu trong gói là vì gói có trước trang đó, hoặc đường dẫn được yêu cầu không phải đường dẫn mà trang được xuất bản — gói được tải về ở phiên bản mà máy chủ báo là phiên bản của chính nó, nên một trang được thêm sau phiên bản đó không có trong gói. Nếu trang chưa từng tồn tại, yêu cầu đã nêu một đường dẫn mà tài liệu không dùng, và tài liệu đã xuất bản là nơi để tìm đường dẫn đúng.

An edit would produce a document its schema refuses (Một chỉnh sửa sẽ tạo ra tài liệu mà schema của nó từ chối)

Một sự từ chối khi chỉnh sửa tài liệu, không phải khi dựng. Một chỉnh sửa có cấu trúc — thêm một component, gắn một Feature, nối một cạnh, hoặc đặt một giá trị — được tạo ra và ghép vào tài liệu, rồi kết quả được kiểm tra theo schema của loại tài liệu đó. Nếu bước kiểm tra phản đối, chỉnh sửa bị từ chối và không có gì được ghi. Tình trạng này thuộc về aggrega edit-document, và cùng khả năng đó khi được trình soạn thảo truy cập qua aggrega serve hoặc bởi trợ lý, vốn là các điểm vào mỏng trên cùng một triển khai.

Loại được đọc từ tài liệu, không bao giờ do bên gọi cung cấp. Bên gọi nêu loại có thể nêu sai, và khi đó kết quả sẽ được kiểm tra theo một schema mà tài liệu không được viết theo — điều này sẽ chấp nhận đúng chỉnh sửa mà bước kiểm tra này tồn tại để từ chối.

Tệp được giữ nguyên từng byte như trước, và thao tác ghi là nguyên tử, nên một chỉnh sửa bị từ chối không thể phân biệt với một chỉnh sửa chưa từng được thử, và một yêu cầu đã sửa có thể được thử lại trên đúng tài liệu ban đầu.

Đối tượng của nó là một yêu cầu hợp lệ về hình thức. Yêu cầu đã nêu một chỉnh sửa mà khả năng này áp dụng, và tài liệu nó sẽ tạo ra là tài liệu mà schema soạn thảo cũng sẽ từ chối nếu bạn tự gõ bằng tay — đó là lý do không có quy tắc soạn thảo nào được nhắc lại cho nó: yêu cầu một Release mang một giá trị của nhà phát triển bị cùng schema đó từ chối theo cả hai cách. Một yêu cầu chưa từng nhắm tới một chỉnh sửa — đường dẫn nút không trỏ tới gì trong tài liệu, giá trị được viết dưới dạng mapping ở nơi cần scalar, một mục đã có sẵn mang nội dung khác — bị từ chối theo lý do riêng của nó, và mỗi bề mặt báo cáo điều đó qua kênh riêng.

Một tài liệu vốn đã không hợp lệ cũng báo cáo điều này. Bước kiểm tra chạy ngay cả khi chỉnh sửa không thay đổi gì, nên một chỉnh sửa trên tài liệu mà sản phẩm sẽ từ chối đọc sẽ nói ra điều đó thay vì báo thành công.

Việc kiểm tra này chính là việc kiểm tra mà mọi lần đọc tài liệu áp dụng, nên nó cũng từ chối một Recipe hoặc FeatureRecipe có pipeline khai báo một id bước hai lần, một quy tắc mà không schema nào diễn đạt được; khi đó phần phản đối sau câu sẽ mở đầu bằng câu và lời khuyên riêng của điều kiện đó, như được mô tả tại A pipeline declares one step id twice (Một pipeline khai báo một id bước hai lần).

Thông báo được phát ra, mang phản đối của chính schema sau câu — loại tài liệu và tệp, rồi vị trí, khóa có lỗi và điều schema nói tại đó — và kết thúc bằng lời khuyên:

the edit was refused because the resulting document would not be valid, and nothing was written: document envelope validation failed (<kind>, at <path>); <line>:<column>: <field-path>: … <the schema's own objection>. correct the document to match its kind’s schema (chỉnh sửa bị từ chối vì tài liệu kết quả sẽ không hợp lệ, và không có gì được ghi: xác thực phong bì tài liệu thất bại. Hãy sửa tài liệu cho khớp với schema của loại của nó)

Cách khắc phục: mở tài liệu tại vị trí thông báo trích dẫn và đọc phản đối, vốn cho biết schema muốn gì tại khóa đó. Thay đổi cần làm thường nằm ở yêu cầu chứ không phải ở tài liệu — hãy yêu cầu một mục mà schema chấp nhận ở vị trí đó, và cùng yêu cầu ấy sẽ áp dụng gọn gàng. Nếu khóa là khóa mà loại tài liệu đó hoàn toàn không được mang, nó thuộc về bề mặt soạn thảo được phép mang, và trang thực thể của loại đó nêu các trường mà nó khai báo. Điều gì được chấp nhận về mặt ngữ nghĩa không được quyết định ở bước này — chẳng hạn một socket phụ thuộc có phải là socket mà bên sản xuất khai báo hay không — nên sự từ chối này luôn liên quan đến hình dạng của tài liệu, không bao giờ liên quan đến những gì có thể được tiêu thụ qua một kết nối.

An annotation key uses a prefix the platform reserves (Một khóa annotation dùng tiền tố mà nền tảng dành riêng)

Một sự từ chối khi kiểm tra thực thể theo các quy ước xuất bản, không phải khi dựng. Tiền tố aggrega.ai/, và feature.aggrega.ai/ bên ngoài một Feature, thuộc sở hữu của nền tảng: một khóa viết dưới các tiền tố này mang ý nghĩa do nền tảng gán, nên một thực thể của bạn ghi vào đó là đang chiếm một không gian tên mà nó không sở hữu.

Nó đưa ra khuyến cáo khi bạn soạn thảo và từ chối tại cổng xuất bản, và cả hai lần đọc đều nêu cùng tình trạng này. Điều được phát hiện là như nhau; chỉ hệ quả khác nhau. Cách phân chia đó là cách hầu hết các quy tắc quy ước xuất bản được liệt kê ở đây hoạt động, nên nó được nêu một lần và được coi là hiển nhiên trong các mục bên dưới không nói khác — hai quy tắc so sánh với một phiên bản đã xuất bản sẽ nói rõ trong mục riêng của chúng, vì chúng hoàn toàn không thể chạy trên nội dung cục bộ.

Thông báo của nó bắt đầu bằng:

an annotation key on the entity uses a prefix the platform reserves (một khóa annotation trên thực thể dùng tiền tố mà nền tảng dành riêng)

Cách khắc phục: chuyển khóa sang một tiền tố mà tổ chức của bạn sở hữu. Nếu một workspace có lý do để vẫn ghi dưới tiền tố dành riêng, quy tắc này là một trong các tùy chọn bỏ qua được mô tả trong “The discipline rules” tại aggrega-lint.md.

Tên của một thực thể không theo dạng mà loại của nó mong đợi

Một sự từ chối khi kiểm tra một thực thể theo các quy ước xuất bản, không phải khi build. Mỗi loại thực thể mang một quy ước về dạng tên — số đoạn cho các loại cloud-native, PascalCase cho các loại thư viện — và tên mà thực thể này khai báo không khớp với dạng mà loại của nó mong đợi.

Thông báo của nó bắt đầu bằng:

the entity’s name does not follow the documented name shape for its kind (tên của thực thể không theo dạng tên được ghi trong tài liệu cho loại của nó)

Cách khắc phục: đổi tên thực thể theo dạng mà loại của nó mong đợi; các quy ước cho từng loại được liệt kê trong mục “The discipline rules” ở aggrega-lint.md, cùng với tùy chọn bỏ qua dành cho một catalog cố ý đặt tên thực thể theo cách riêng.

Một schema dùng một tham chiếu động không thể phân giải trước

Một sự từ chối khi kiểm tra một thực thể theo các quy ước xuất bản, không phải khi build. Một schema mà thực thể mang theo dùng một cấu trúc tham chiếu động, có đích được chọn trong lúc một tài liệu đang được xác thực thay vì cố định khi schema được viết. Ở đây các tham chiếu được mở rộng trước, nên không có quá trình xác thực nào đang diễn ra để cấu trúc như vậy phân giải theo.

Thông báo của nó bắt đầu bằng:

a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow (một schema trong thực thể dùng một cấu trúc tham chiếu động mà việc phân giải tham chiếu liên tài liệu không thể lần theo)

Cách khắc phục: thay cấu trúc động bằng một tham chiếu thông thường nêu thẳng đích. Khi schema thực sự cần cấu trúc đó và sẽ không được tham chiếu qua các tài liệu, quy tắc này có một tùy chọn bỏ qua được mô tả trong mục “The discipline rules” ở aggrega-lint.md.

Một schema khai báo một định danh thuộc quyền của nền tảng

Một sự từ chối khi kiểm tra một thực thể theo các quy ước xuất bản, không phải khi build. Một schema mà thực thể mang theo khai báo một định danh của riêng nó, trong khi định danh chuẩn được suy ra từ danh tính của thực thể. Định danh được khai báo thay thế định danh được suy ra, nên một tham chiếu viết theo định danh chuẩn sẽ không còn phân giải được.

Thông báo của nó bắt đầu bằng:

a schema in the entity declares an identifier of its own, where the platform owns that schema’s identity (một schema trong thực thể khai báo một định danh của riêng nó, trong khi nền tảng sở hữu danh tính của schema đó)

Cách khắc phục: xóa định danh được khai báo và để nó được suy ra. Tùy chọn bỏ qua, dành cho một schema cố ý được xuất bản dưới một định danh riêng, được mô tả trong mục “The discipline rules” ở aggrega-lint.md.

Nhãn danh mục của một Component và thư mục của nó nêu hai danh mục khác nhau

Một sự từ chối khi kiểm tra một thực thể theo các quy ước xuất bản, không phải khi build. Một Component mang một nhãn danh mục và được đặt trong một thư mục danh mục; quy ước là hai thứ này nêu cùng một danh mục, để thư mục mà người đọc duyệt và nhãn mà một bộ chọn khớp không thể mâu thuẫn nhau.

Thông báo của nó bắt đầu bằng:

the entity’s category label does not match the category directory the entity is filed under (nhãn danh mục của thực thể không khớp với thư mục danh mục chứa thực thể)

Cách khắc phục: sửa cái nào sai trong hai để chúng thống nhất — hoặc chuyển tệp vào thư mục mà nhãn của nó nêu, hoặc sửa nhãn thành danh mục mà thư mục nêu. Tập danh mục đóng và tùy chọn bỏ qua có trong mục “The discipline rules” ở aggrega-lint.md.

Một phần mở rộng schema được viết trực tiếp vào nội dung schema

Một sự từ chối khi kiểm tra một thực thể theo các quy ước xuất bản, không phải khi build. Một Component hoặc Feature viết một phần mở rộng schema của Aggrega trực tiếp vào nội dung schema của nó, trong khi thực thể có sẵn một bề mặt chính thức để khai báo cùng điều đó. Dạng viết trực tiếp vẫn hoạt động, và quy ước ưu tiên bề mặt khai báo vì đó là bề mặt mà các trang thực thể hướng dẫn và công cụ đọc.

Đây là quy tắc duy nhất trong nhóm mà một build cũng báo cáo, dưới dạng một khuyến nghị không dừng build. Việc kiểm tra thực thể theo các quy ước xuất bản tại cổng xuất bản nâng cùng phát hiện đó thành một sự từ chối.

Thông báo của nó bắt đầu bằng:

the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema (thực thể viết một phần mở rộng schema của Aggrega trực tiếp vào nội dung schema thay vì khai báo nó)

Cách khắc phục: chuyển phần mở rộng sang bề mặt socket hoặc attachment của chính thực thể, nơi các trang thực thể component.md và feature.md khai báo nó. Tùy chọn bỏ qua có trong mục “The discipline rules” ở aggrega-lint.md.

Một Plugin không cố định giới hạn runtime nào, nên giới hạn của nền tảng được áp dụng

Một khuyến nghị được đưa ra khi một thực thể được kiểm tra theo các quy ước xuất bản, cả khi bạn đang soạn lẫn tại cổng xuất bản; nó không bao giờ dừng bất cứ thứ gì, và build không đưa ra nó. Một Plugin khai báo mức trần bộ nhớ và giới hạn thời gian mà host áp dụng khi tải và chạy plugin. Một Plugin không khai báo cái nào sẽ chạy với giá trị mặc định của nền tảng, đây là một kết quả được hỗ trợ chứ không phải một lỗi — vì vậy điều được báo cáo là các giá trị mặc định đang có hiệu lực và bạn có thể cố định chúng một cách tường minh.

Thông báo của nó bắt đầu bằng:

the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply (thực thể Plugin không khai báo giới hạn tài nguyên runtime riêng, nên giá trị mặc định của nền tảng được áp dụng)

Cách khắc phục: cố định các giới hạn mà plugin thực sự cần, hoặc cố ý giữ nguyên giá trị mặc định. Nó không có thiết lập bỏ qua, vì nó báo cáo một sự thật về thực thể chứ không phải một đánh giá về nó: không có gì để nới lỏng. Các trường được mô tả trong plugin.md.

Một attachment slot chỉ chấp nhận dữ liệu bí mật mà không nói rằng nó xử lý dữ liệu đó

Một khuyến nghị được đưa ra khi một thực thể được kiểm tra theo các quy ước xuất bản, cả khi bạn đang soạn lẫn tại cổng xuất bản; nó không bao giờ dừng bất cứ thứ gì, và build không đưa ra nó. Một attachment slot có thể cố định, thông qua bộ chọn của nó, rằng chỉ một Feature mang bí mật mới được lấp vào, và có thể ghi nhận riêng rằng bất cứ thứ gì lấp vào nó đều xử lý dữ liệu bí mật. Bộ chọn nêu những gì được phép lấp vào; bản ghi nêu cách xử lý. Một slot cố định điều thứ nhất mà bỏ điều thứ hai sẽ để cách xử lý phải suy ra từ bộ chọn thay vì đọc trực tiếp từ slot. Mọi slot mà một thực thể khai báo đều được kiểm tra: các slot trong khối attachment của chính nó, và, trên một Component, slot mà một socket phụ thuộc khai báo cho mỗi kết nối nối qua nó — phát hiện về slot của một socket nêu tên socket bên cạnh slot.

Thông báo của nó bắt đầu bằng:

an attachment slot admits only secret material and does not declare that it handles it (một attachment slot chỉ chấp nhận dữ liệu bí mật và không khai báo rằng nó xử lý dữ liệu đó)

Cách khắc phục: khai báo cách xử lý trên slot, bên cạnh bộ chọn cố định nó. Nó không có thiết lập bỏ qua, vì cùng lý do quy tắc giới hạn Plugin không có: nó báo cáo một sự thật về thực thể và để quyết định cho bạn.

Một Recipe xuất bản một khóa provides mà Component của nó không khai báo, được kiểm tra khi xuất bản

Một khuyến nghị được đưa ra khi một thực thể được kiểm tra theo các quy ước xuất bản, cả khi bạn đang soạn lẫn tại cổng xuất bản; nó không bao giờ dừng bất cứ thứ gì, và build không đưa ra nó. Một Recipe xuất bản một khóa dưới provides:, và Component mà Recipe triển khai không khai báo khóa đó trong trụ cột provides của schema. Một bên tiêu thụ nối qua một kết nối đọc hợp đồng đã khai báo của Component chứ không phải những gì Recipe phát ra, nên khóa được tạo ra rồi bị từ chối ở nơi có thứ cố tiêu thụ nó.

🔴 Có hai điều kiện mô tả việc này, và chúng không phải là một. Khuyến nghị mà build báo cáo được ghi ở phần trên, mục “A Recipe publishes a provides key its Component does not declare”; điều kiện này được đưa ra khi thực thể được kiểm tra theo các quy ước xuất bản, và có mã riêng. Phát hiện là cùng một sự thật gặp trên hai bề mặt — hãy đọc mã trong chẩn đoán để biết bạn đang gặp cái nào.

Thông báo của nó bắt đầu bằng:

the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused (Recipe xuất bản một khóa provides mà Component nó triển khai không khai báo, nên bên tiêu thụ nối khóa đó bị từ chối)

Cách khắc phục: khai báo khóa trên Component, để hợp đồng mà bên tiêu thụ đọc bao gồm những gì Recipe phát ra — hoặc ngừng xuất bản nó từ Recipe khi không có gì định tiêu thụ nó. Tùy chọn bỏ qua có trong mục “The discipline rules” ở aggrega-lint.md.

Chú thích metrics của một Component và khóa provides của nó không khớp nhau

Một cảnh báo tư vấn được nêu ra khi một thực thể được kiểm tra theo các quy ước xuất bản, cả khi bạn soạn thảo lẫn tại cổng xuất bản; nó không bao giờ dừng bất cứ điều gì, và một bản build không nêu ra nó. Một Component có thể nêu cách các metrics của sản phẩm xác thực, trong chú thích observability.aggrega.ai/metrics-credential — none, target-key hoặc separate-token — và nó có thể khai báo khóa provides metrics_credential_required, mà mỗi Recipes của nó xuất bản để cho biết metrics của một instance có cần thông tin xác thực hay không. Hai điều này là một sự thật về sản phẩm nhìn từ hai phía, vì vậy một Component nêu rằng metrics của nó không cần thông tin xác thực thì không khai báo khóa đó, và một Component nêu rằng chúng cần thông tin xác thực thì khai báo nó. Điều kiện này báo cáo một Component mà hai điều trên không khớp nhau, nêu tên Component, giá trị của chú thích và khóa bị thừa hoặc bị thiếu.

Thông báo của nó bắt đầu bằng:

a Component’s annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance’s metrics need a credential (chú thích của một Component nêu cách metrics của nó xác thực không khớp với việc nó có khai báo khóa provides cho biết metrics của một instance cần thông tin xác thực hay không)

Cách khắc phục: sửa điều nào sai trong hai điều — khai báo metrics_credential_required trong trụ cột provides, và xuất bản nó từ mỗi Recipe, khi metrics cần thông tin xác thực; xóa nó khi chúng không cần; hoặc đổi chú thích sang giá trị mô tả đúng sản phẩm. Quy tắc này không có thiết lập bỏ qua, vì cùng lý do quy tắc giới hạn Plugin không có; nó đọc những giá trị nào, và bỏ qua những Components nào, được nêu trong “The discipline rules” tại aggrega-lint.md.

Một kết nối và đích mà nó tới không cùng chỉ một khóa

Một cảnh báo tư vấn được nêu ra khi một Release được kiểm tra theo các quy ước xuất bản; nó không bao giờ dừng bất cứ điều gì, và một bản build không nêu ra nó. Một máy chủ kiểm tra khóa giữ khóa mà nó xác minh trong một slot riêng, và một bên gọi trình một khóa trên kết nối mà qua đó nó tới máy chủ đó. Không đầu nào thấy khóa của đầu kia, nên hai khóa là một chỉ vì tác giả của chúng viết cùng một locator ở cả hai đầu. Điều kiện này báo cáo một kết nối có đích khai báo slot cho khóa mà nó yêu cầu từ bên gọi, khi chúng không khớp: kết nối mang thông tin xác thực còn slot khóa của đích chưa được điền, slot khóa của đích đã được điền còn kết nối không mang thông tin xác thực, hoặc cả hai đều được điền nhưng viết locator khác nhau.

Khác với các quy tắc ở trên, quy tắc này đọc cả một Release thay vì một thực thể, nên nó chỉ gặp khi một Release được kiểm tra và không bao giờ tại cổng xuất bản, nơi chỉ kiểm tra riêng một thực thể; ở bất cứ đâu nó được báo cáo, nó đều là lời khuyên. Phát hiện nêu tên component, kết nối, đích và hai slot, và không bao giờ trích dẫn locator nào. Một scrape — một kết nối trên socket scrape_target — được đánh giá theo những gì đích nêu về metrics của nó: hoàn toàn không được đánh giá khi chú thích observability.aggrega.ai/metrics-credential của đích ghi none, không bao giờ đối chiếu với khóa của đích khi nó ghi separate-token, và như mọi kết nối khác trong các trường hợp còn lại; một kết nối trên bất kỳ socket nào khác được đánh giá bất kể đích nêu gì.

Thông báo của nó bắt đầu bằng:

a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one (một kết nối và đích mà nó tới không cùng chỉ một khóa: chúng viết locator khác nhau cho khóa đó, hoặc chỉ một trong hai chỉ ra khóa)

Cách khắc phục: để cả hai đầu đọc một tham số — credential của kết nối và api_key của đích — để khóa mà bên gọi trình và khóa mà máy chủ xác minh không thể bị viết khác nhau; hoặc, khi một kết nối không cần trình khóa, gỡ thông tin xác thực khỏi nó. Những slot nào được đọc, điều gì được so sánh và cách bỏ qua được nêu trong “The discipline rules” tại aggrega-lint.md.

The change being published breaks what the evolution rubric allows (Thay đổi đang được xuất bản vi phạm những gì bộ tiêu chí tiến hóa cho phép)

Một sự từ chối ở bước kiểm tra trước khi xuất bản, không phải ở một bản build. Phiên bản đang được xuất bản được so sánh với phiên bản đã xuất bản trước nó, và sự khác biệt giữa chúng được phân loại theo một bộ tiêu chí đã được tài liệu hóa. Điều kiện này báo cáo rằng sự khác biệt đó là điều bộ tiêu chí phản đối.

Nó cần một phiên bản tiền nhiệm đã xuất bản để so sánh, nên nó và bước kiểm tra nâng phiên bản bên dưới là hai quy tắc trong nhóm này không thể chạy chỉ trên nội dung cục bộ: khi không tham vấn registry nào thì không có gì để so sánh, và bước kiểm tra bị bỏ qua chứ không được coi là đạt.

Thông báo của nó bắt đầu bằng:

the version being published changes the published predecessor in a way the documented evolution rubric objects to (phiên bản đang được xuất bản thay đổi phiên bản tiền nhiệm đã xuất bản theo cách mà bộ tiêu chí tiến hóa đã được tài liệu hóa phản đối)

Cách khắc phục: đọc phân loại trong thông báo chẩn đoán, nơi nêu điều gì trong thay đổi bị bộ tiêu chí phản đối, rồi hoặc làm cho thay đổi tương thích, hoặc xuất bản nó dưới một phiên bản chấp nhận nó. Bộ tiêu chí được trình bày trong “The version-bump rubric” tại aggrega-lint.md.

The version offered is a smaller bump than the change requires (Phiên bản được đưa ra tăng ít hơn mức thay đổi yêu cầu)

Một sự từ chối ở bước kiểm tra trước khi xuất bản, không phải ở một bản build. Thay đổi đang được xuất bản được phân loại theo bộ tiêu chí tiến hóa, và phiên bản được đưa ra cho nó là một bước nhỏ hơn mức phân loại đó đòi hỏi — chẳng hạn một việc xóa bỏ hoặc thu hẹp được đưa ra dưới dạng một bản patch. Tăng phiên bản quá mức luôn được chấp nhận; chính việc tăng không đủ mới bị dừng ở đây.

Khác với các quy tắc ở trên, quy tắc này được quyết định ở đây chứ không phải bởi plugin quy ước. Mức tăng nào được đưa ra chỉ được biết vào thời điểm xuất bản, và lúc đó không có quá trình biên dịch nào đang chạy, nên việc so sánh giữa phân loại và phiên bản được đưa ra được thực hiện tại thời điểm đó.

Thông báo của nó bắt đầu bằng:

the version bump being published is smaller than the evolution check’s classification of the change requires (mức tăng phiên bản đang được xuất bản nhỏ hơn mức mà phân loại thay đổi của bước kiểm tra tiến hóa yêu cầu)

Cách khắc phục: xuất bản dưới phiên bản mà phân loại đòi hỏi; thông báo chẩn đoán nêu đó là phiên bản nào. Khi bạn tin rằng thay đổi nhỏ hơn mức được phân loại, bộ tiêu chí trong “The version-bump rubric” tại aggrega-lint.md cho biết điều gì xếp một thay đổi vào mỗi loại. Lần xuất bản đầu tiên của một thực thể không có phiên bản tiền nhiệm, nên việc so sánh bị bỏ qua và được báo cáo là không thực hiện chứ không phải là đạt.

An import stopped partway through translating a source (Một lần import đã dừng giữa chừng khi chuyển đổi một nguồn)

Một sự từ chối khi chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, không phải ở một bản build. Importer đã báo cáo một thông báo chẩn đoán đủ nghiêm trọng để dừng quá trình chuyển đổi, nên những gì nó tạo ra chỉ là một phần: một phần nguồn đã thành tệp soạn thảo nháp và một phần thì không.

Kết quả từng phần là có chủ ý chứ không phải đổ vỡ. Nó nêu kết quả chứ không nêu nguyên nhân — những gì không thể chuyển đổi được báo cáo trong các thông báo chẩn đoán bên cạnh nó, mỗi thông báo cho một cấu trúc mà importer không thể chuyển qua, bằng chính lời của importer. Điều kiện này là thứ giúp bên gọi phân biệt “lần import đã dừng và tạo ra một phần câu trả lời” với “lần import thất bại hoàn toàn”, là hai tình huống khác nhau với các bước tiếp theo khác nhau.

Thông báo của nó bắt đầu bằng:

the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files (importer đã báo cáo một thông báo chẩn đoán làm dừng lần import, nên nguồn chưa được chuyển hết thành các tệp soạn thảo nháp)

Cách khắc phục: đọc các thông báo chẩn đoán được báo cáo bên cạnh nó — mỗi thông báo nêu một cấu trúc trong nguồn mà importer không thể chuyển đổi. Cách khắc phục nằm ở nguồn bạn đưa vào, hoặc ở việc hoàn thiện bản nháp bằng tay: một lần import tạo ra điểm khởi đầu để chỉnh sửa, nên một cấu trúc không qua được quá trình chuyển đổi là thứ cần soạn trực tiếp ở phía Aggrega. aggrega-import.md mô tả lệnh tạo ra gì và ghi vào đâu.

More than one importer recognises the source (Có nhiều hơn một trình nhập nhận diện được nguồn)

Một sự từ chối khi chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, không phải khi build. Lần nhập không chỉ định định dạng nào, nên định dạng được nhận diện từ các chữ ký mà các trình nhập khai báo — cả những trình nhập trong catalog của workspace lẫn các trình nhập lõi của trình biên dịch, mỗi chữ ký nêu cú pháp dùng để đọc nguồn, các tên tệp mà nó áp dụng và các đường dẫn mà cây đã phân tích của nguồn phải có hoặc không được có — và chữ ký của các trình nhập phục vụ nhiều hơn một định dạng đã khớp với nguồn. Lần nhập không chọn giữa chúng: nguồn thuộc định dạng nào là tuyên bố của các trình nhập, không phải của trình biên dịch, và việc chọn sẽ là một phỏng đoán, giao nguồn cho một trình nhập có thể không dành cho nó.

Điều này không giống với trường hợp một định dạng được nhiều hơn một trình nhập quảng bá, được mô tả ở mục “A parse or import format is advertised by more than one plugin (Một định dạng phân tích hoặc nhập được nhiều hơn một plugin quảng bá)” ở trên. Ở đó định dạng đã được xác định và các trình nhập phục vụ nó cạnh tranh nhau, nên một mục plugins.importer sẽ chọn giữa chúng; ở đây chính các định dạng khác nhau, nên không có attachment nào giải quyết được, còn việc chỉ định định dạng thì giải quyết được. Một trình nhập nhận diện một nguồn thì nhận diện nó là mọi định dạng mà nó quảng bá, nên một trình nhập quảng bá nhiều hơn một định dạng, có một chữ ký khớp, cũng bị từ chối tại đây.

Thông báo của nó bắt đầu bằng:

more than one importer recognises the source (có nhiều hơn một trình nhập nhận diện được nguồn)

Phần còn lại của thông báo nêu nguồn và mọi định dạng mà nguồn được nhận diện là, theo thứ tự danh tính và phiên bản của các trình nhập, sau đó là cách khắc phục:

more than one importer recognises the source (source "<source>", recognised as "<format>", "<format>"). Pass —format to name the one to read it as (for example —format <format> or —format <format>) (có nhiều hơn một trình nhập nhận diện được nguồn (nguồn, được nhận diện là các định dạng). Hãy truyền —format để chỉ định định dạng dùng để đọc nguồn)

Cách khắc phục: chỉ định định dạng — --format trên aggrega import, hoặc format trên công cụ nhập của trợ lý và phương thức aggrega/import của phiên. Khi một trong các trình nhập không bao giờ nên nhận diện một nguồn như vậy, cần thay đổi các chữ ký của trình nhập đó, do tác giả của nó khai báo trong bản tự báo cáo describe() và được thực thể Plugin của nó ghi lại khi được tạo; hoặc, khi đó là một trình nhập mà catalog của workspace chứa, hãy loại nó khỏi catalog mà workspace đọc — một trình nhập lõi luôn nằm trong số những trình nhập được thử, nên một nguồn mà một trong số chúng nhận diện cùng với một trình nhập khác sẽ được giải quyết bằng cách chỉ định định dạng. aggrega-import.md mô tả cách một định dạng được nhận diện.

No importer recognises the source (Không có trình nhập nào nhận diện được nguồn)

Một sự từ chối khi chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, không phải khi build. Lần nhập không chỉ định định dạng nào, nên định dạng được nhận diện từ các chữ ký mà các trình nhập khai báo — cả những trình nhập trong catalog của workspace lẫn các trình nhập lõi của trình biên dịch — và chữ ký của không định dạng nào khớp với nguồn. Lần nhập không phỏng đoán: giao nguồn cho một trình nhập chưa từng khai báo rằng nó đọc hình dạng đó sẽ tạo bản nháp từ một nguồn có thể không dành cho nó.

Đây là trường hợp đối ứng của “More than one importer recognises the source (Có nhiều hơn một trình nhập nhận diện được nguồn)” ở trên. Ở đó nhiều định dạng cùng nhận nguồn; ở đây không định dạng nào nhận. Trong cả hai trường hợp, việc chỉ định định dạng sẽ giải quyết vấn đề, và không có gì được ghi cho đến khi định dạng được chỉ định.

Thông báo của nó bắt đầu bằng:

no importer recognises the source (không có trình nhập nào nhận diện được nguồn)

Phần còn lại của thông báo nêu nguồn, sau đó là cách khắc phục và mọi định dạng mà các trình nhập của catalog quảng bá, theo thứ tự chúng được đọc:

no importer recognises the source (source "<source>"). Pass —format to name it explicitly (for example —format <format> or —format <format>) (không có trình nhập nào nhận diện được nguồn (nguồn). Hãy truyền —format để chỉ định rõ định dạng)

Khi không có trình nhập nào quảng bá định dạng nào, phần cách khắc phục sẽ nói như vậy thay cho các ví dụ.

Một thư mục được đề xuất một cách khắc phục khác, vì chỉ định một định dạng bất kỳ không thể giúp ích cho nó. Một thư mục chỉ được đọc thông qua các mẫu tệp mà trình nhập của nó khai báo, và một chữ ký không khai báo mẫu tệp nào thì không áp dụng cho bất kỳ tệp nào của thư mục — vì vậy một thư mục chứa, chẳng hạn, một bản xuất Langflow sẽ không được chữ ký nào nhận diện, và chỉ định định dạng langflow đến lượt nó sẽ bị từ chối theo An importer that declares no file patterns is handed a directory (Một trình nhập không khai báo mẫu tệp nào nhận được một thư mục). Do đó, lời từ chối dành cho thư mục gọi nó là thư mục và đề xuất nhập riêng một trong các tệp của nó, hoặc chỉ định một định dạng có trình nhập khai báo mẫu tệp — chỉ những định dạng đó, được đọc từ chính các khai báo của các trình nhập:

no importer recognises the source (directory "<directory>"). Import one of the directory’s files on its own, or pass —format naming a format whose importer reads a directory through the file patterns it declares (for example —format <format> or —format <format>) (không có trình nhập nào nhận diện được nguồn (thư mục). Hãy nhập riêng một trong các tệp của thư mục, hoặc truyền —format chỉ định một định dạng có trình nhập đọc thư mục thông qua các mẫu tệp mà nó khai báo (ví dụ —format hoặc —format))

Khi không có trình nhập nào khai báo mẫu tệp, lời từ chối đề xuất nhập riêng một trong các tệp của thư mục và cho biết rằng không có trình nhập nào trong danh mục khai báo các mẫu tệp dùng để đọc một thư mục.

Cách khắc phục: chỉ định định dạng — --format trên aggrega import, hoặc format trên công cụ nhập của trợ lý và phương thức aggrega/import của phiên, mỗi nơi diễn đạt lời từ chối theo trường mà nó nhận và mở đầu bằng mã ngắn của điều kiện này; câu trả lời của phiên cũng mang cả hai mã của điều kiện trong dữ liệu của nó. Với một thư mục, hãy nhập riêng một tệp mà bạn muốn — một chữ ký không nêu tên tệp nào áp dụng cho một tệp được nhập riêng, bất kể tên của nó là gì — hoặc chỉ định một trong các định dạng mà lời từ chối liệt kê. Khi nguồn lẽ ra phải được nhận diện, cần thay đổi các chữ ký của trình nhập phục vụ định dạng của nó, do tác giả của trình nhập khai báo trong bản tự báo cáo describe() và được thực thể Plugin của nó ghi lại khi được tạo. aggrega-import.md mô tả cách một định dạng được nhận diện.

An importer that declares no file patterns is handed a directory (Một trình nhập không khai báo mẫu tệp nào được giao một thư mục)

Một sự từ chối khi chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, không phải khi build. Nguồn được chỉ định là một thư mục, và một thư mục được giao cho trình nhập của nó dưới dạng đúng những tệp mà các mẫu tệp đã khai báo của trình nhập chọn — nên trình nhập đọc những tệp nào của một thư mục là tuyên bố của chính trình nhập. Trình nhập phục vụ định dạng của nguồn không khai báo mẫu tệp nào: nó đọc một tệp, và không nói gì về việc những tệp nào của một thư mục là của nó.

Không có gì được mở. Lần nhập dừng ngay khi trình nhập được phân giải và trước khi bất kỳ tệp nào của thư mục được đọc, thay vì giao cho trình nhập mọi tệp mà thư mục chứa.

Thông báo của nó bắt đầu bằng:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (trình nhập phục vụ định dạng của nguồn không khai báo mẫu tệp nào, nên nó đọc một tệp và không thể đọc một thư mục)

Phần còn lại của thông báo nêu định dạng, trình nhập và thư mục như bạn đã chỉ định, sau đó là cách khắc phục:

the importer serving the source’s format declares no file patterns, so it reads one file and cannot read a directory (format "<format>", importer "importer/<name>", directory "<directory>"). Import one of the directory’s files on its own instead; the importer reads a directory once it declares the file patterns its files are named by (trình nhập phục vụ định dạng của nguồn không khai báo mẫu tệp nào, nên nó đọc một tệp và không thể đọc một thư mục (định dạng, trình nhập, thư mục). Thay vào đó, hãy nhập riêng một tệp của thư mục; trình nhập sẽ đọc một thư mục khi nó khai báo các mẫu tệp dùng để đặt tên cho các tệp của nó)

Cách khắc phục: nhập riêng một tệp của định dạng đó. Để một trình nhập đọc được các thư mục của định dạng của nó, tác giả của nó khai báo các mẫu dùng để đặt tên cho các tệp của nó — files của một chữ ký nhận diện trong bản tự báo cáo describe(), được thực thể Plugin của nó ghi lại khi được tạo. aggrega-import.md mô tả những gì một lần nhập thư mục đọc.

No file in the directory matches the importer’s file patterns (Không có tệp nào trong thư mục khớp với các mẫu tệp của trình nhập)

Một sự từ chối khi chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, không phải khi build. Nguồn được chỉ định là một thư mục, định dạng đã được xác định, và trình nhập phục vụ nó có khai báo mẫu tệp — nhưng không tệp nào trong thư mục, ở bất kỳ độ sâu nào, khớp với một trong số đó. Việc không giao cho trình nhập nguồn nào sẽ khiến nó thất bại trên một nguồn rỗng, bằng lời lẽ về nội dung chứ không phải về những tệp nào đã được đọc, nên lần nhập dừng tại đây mà không đọc gì.

Khi định dạng được nhận diện chứ không được chỉ định, trình nhập có chữ ký nhận diện thư mục đã khớp với một trong các tệp của nó, nên trường hợp này chỉ gặp khi trình nhập chạy không phải là trình nhập đó — một trình nhập khác của cùng định dạng do một mục plugins.importer chọn, hoặc một phiên bản khác của nó.

Thông báo của nó bắt đầu bằng:

no file in the directory matches the file patterns the importer serving the source’s format declares (không có tệp nào trong thư mục khớp với các mẫu tệp mà trình nhập phục vụ định dạng của nguồn khai báo)

Phần còn lại của thông báo nêu định dạng, trình nhập, thư mục như bạn đã chỉ định và mọi mẫu mà trình nhập khai báo, sau đó là cách khắc phục:

no file in the directory matches the file patterns the importer serving the source’s format declares (format "<format>", importer "importer/<name>", directory "<directory>", file patterns "<pattern>", "<pattern>"). Name a directory holding a file one of those patterns matches, or the format of an importer whose patterns match the files this directory holds (không có tệp nào trong thư mục khớp với các mẫu tệp mà trình nhập phục vụ định dạng của nguồn khai báo (định dạng, trình nhập, thư mục, các mẫu tệp). Hãy chỉ định một thư mục chứa một tệp khớp với một trong các mẫu đó, hoặc định dạng của một trình nhập có các mẫu khớp với các tệp mà thư mục này chứa)

Cách khắc phục: nhập thư mục chứa các tệp của định dạng đó — một mẫu được so khớp với phần cuối đường dẫn của tệp bên trong thư mục, nên một tệp ở bất kỳ độ sâu nào cũng được tính — hoặc chỉ định định dạng của các tệp trong thư mục. aggrega-import.md mô tả những gì một lần nhập thư mục đọc.

A file read from the directory and a file named in the importer’s with.sources have the same name (Một tệp đọc từ thư mục và một tệp được nêu trong with.sources của importer có cùng tên)

Một sự từ chối khi chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, không phải khi build. Nguồn được nêu là một thư mục, và các tệp của nó đến importer dưới dạng các nguồn có tên, mỗi tệp mang đường dẫn của nó bên trong thư mục. Mục plugins.importer gắn importer nêu các tệp riêng của nó dưới with.sources, các tệp này cũng đến importer dưới dạng nguồn có tên, mỗi tệp mang tên gốc của nó — và có một tên được cả hai mang. Tên là cách một importer phân biệt nguồn này với nguồn khác, nên trao cả hai sẽ khiến một nguồn che khuất nguồn kia mà không có gì cho biết là nguồn nào; thay vào đó, việc import dừng lại, không trao gì cả.

Thông báo của nó bắt đầu bằng:

a file read from the directory and a file named in the importer’s with.sources have the same name (một tệp đọc từ thư mục và một tệp được nêu trong with.sources của importer có cùng tên)

Phần còn lại của thông báo nêu tên đó và tệp with.sources, rồi đến cách khắc phục:

a file read from the directory and a file named in the importer’s with.sources have the same name (name "<name>", the with.sources file "<path>"). Each source reaches the importer under one name, so rename one of the two files, or leave the file out of the importer’s with.sources (một tệp đọc từ thư mục và một tệp được nêu trong with.sources của importer có cùng tên (tên, tệp with.sources). Mỗi nguồn đến importer dưới một tên, nên hãy đổi tên một trong hai tệp, hoặc bỏ tệp đó ra khỏi with.sources của importer)

Cách khắc phục: đổi tên một trong hai tệp, hoặc bỏ tệp ra khỏi with.sources của mục khi thư mục đã chứa nó. Một tệp with.sources giữ tên gốc của nó, nên tệp cùng tên ở cấp cao nhất của thư mục là tệp nó trùng với; một tệp trong thư mục con mang thư mục đó trong tên của nó. Importer nào chuyển một nguồn thành bản nháp mô tả with.sources của một mục.

An import’s target names a capability no Recipe in the catalog binds to (Đích của một lần import nêu một capability mà không Recipe nào trong catalog ràng buộc tới)

Một sự từ chối khi chuyển một mô tả nguồn bên ngoài thành các tệp soạn thảo nháp, không phải khi build. Lần import được cung cấp một đích — --target trên aggrega import, hoặc target trên công cụ import của trợ lý và phương thức aggrega/import của phiên — để nó soạn nháp một Manifest ánh xạ mỗi kiểu component được soạn nháp tới một Recipe của provider đó. Đích là một capability của provider, được so khớp với spec.capability mà mỗi Recipe trong catalog của workspace ràng buộc tới, và không Recipe nào ở đó ràng buộc tới capability đã cho. Một Manifest được soạn nháp cho nó sẽ không ánh xạ gì cả, và mọi kiểu component khi đó sẽ bị coi là thiếu trong catalog trong khi điều sai lại là chính tùy chọn đó — thường nhất là lỗi chính tả.

Không gì chạy và không gì được ghi. Việc import dừng lại ngay khi catalog được tải, trước khi định dạng của nguồn được nhận diện và trước khi importer chạy, nên không bản nháp nào được tạo ra và không tệp nào được ghi, kể cả khi chạy thử (dry run).

Thông báo của nó bắt đầu bằng:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (không Recipe nào trong catalog của workspace ràng buộc tới capability mà đích của lần import nêu)

Phần còn lại của thông báo nêu đích đúng như đã cho và các capability mà các Recipes của catalog có ràng buộc tới, mỗi capability một lần và theo thứ tự đã sắp xếp, rồi đến cách khắc phục:

no Recipe in the workspace’s catalog binds to the capability the import’s target names (target "<target>", the catalog’s Recipes bind to "<capability>", "<capability>"). Name one of those capabilities as the target, or leave the target out and no Manifest is drafted; nothing was drafted or written (không Recipe nào trong catalog của workspace ràng buộc tới capability mà đích của lần import nêu (đích, các Recipes của catalog ràng buộc tới). Hãy nêu một trong các capability đó làm đích, hoặc bỏ đích đi và không Manifest nào được soạn nháp; không gì được soạn nháp hay ghi)

Khi catalog không chứa Recipe nào, thông báo nói rõ điều đó thay cho danh sách, và cách khắc phục là thêm một Recipe của provider vào catalog.

Cách khắc phục: nêu một trong các capability mà thông báo liệt kê — chẳng hạn compose hoặc helm, đúng như spec.capability của một Recipe viết — hoặc bỏ đích đi, khi đó không Manifest nào được soạn nháp. Khi provider bạn muốn là một provider mà catalog chưa có Recipe nào, hãy thêm các Recipes của nó vào một thư mục catalog mà workspace đọc trước. aggrega-import.md mô tả những gì một lần import có đích soạn nháp.

A child Release inherits a boundary directory that resolves where its parent writes (Một Release con kế thừa một thư mục boundary được phân giải tới nơi Release cha ghi)

Một cảnh báo tư vấn. Một Release mở rộng một Release khác và kế thừa thư mục đầu ra của một boundary từ nó, và thư mục đó không chứa biến template nào — nên nó phân giải thành cùng một đường dẫn cho cả hai, và build Release con sẽ ghi vào nơi build Release cha ghi.

Kế thừa thư mục là dạng được hỗ trợ chứ không phải một sai sót. Thư mục là một template, nên Release cha viết nó một lần và một Release con thực hiện một tham số sẽ phân giải nó tới nơi khác mà không trùng lặp gì; đó chính là toàn bộ lý do Release con không cần khai báo lại topology boundary của Release cha. Điều hẹp nhưng có thật là trường hợp còn lại mà điều này nêu: khi không có biến nào trong đó, không còn gì để phân giải khác đi.

Nó không thể dừng build, và đó là một thuộc tính của quy tắc chứ không phải sự thận trọng về nó. Ghi vào cùng một đường dẫn đã phân giải là điều mà tác giả có thể chủ ý một cách hợp lệ — một Release con chỉ hoán đổi các Recipes kết xuất để so sánh đầu ra của chúng, hoặc chỉ thay đổi kích thước — nên một quy tắc dừng build dựa trên suy luận sẽ từ chối đầu vào hợp lệ chỉ vì phỏng đoán.

Thông báo của nó bắt đầu bằng:

inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to (thư mục boundary được kế thừa không chứa biến template nào, nên nó phân giải thành đường dẫn mà Release được mở rộng ghi vào)

Cách khắc phục: khi hai Release được dự định ghi vào những nơi khác nhau, hãy đặt một tham chiếu tham số vào thư mục và để mỗi Release thực hiện nó. Khi ghi vào một đường dẫn chính là điều bạn muốn, không cần thay đổi gì — cảnh báo tư vấn đã cho bạn biết nó sẽ làm gì, và bản build vẫn tạo ra đầu ra trong cả hai trường hợp.

Tìm một lần dừng từ mã ngắn mà bản build đã in ra

Phần đầu trong ngoặc vuông của một chẩn đoán gây dừng nêu tên hạng mục mà lỗi được quy về và, khi lỗi nêu tên một trong các điều kiện được liệt kê ở đây, mã ngắn của điều kiện đó — chữ cái E và bốn chữ số, như trong [CATALOG_ERROR E0209]. Một số được cấp một lần và sau đó cố định, nên một mã ngắn mà bạn dán vào báo cáo hoặc ô tìm kiếm vẫn chỉ đúng điều kiện mà nó đã chỉ khi bạn ghi lại. Hai định danh còn lại mà một điều kiện mang, và khi nào nên dùng định danh nào trong ba định danh, được trình bày trong sentinels.md.

Dòng thông báo riêng của điều kiện bắt đầu bằng một câu cố định nêu điều kiện đó. Mọi thứ sau câu đó thay đổi theo từng lần xảy ra — tài liệu có lỗi, khóa được viết, giá trị vi phạm và lời khuyên cho lần xảy ra đó — và các mục ở trên trích dẫn toàn bộ dạng thông báo cho điều kiện mà mỗi mục mô tả. Câu cố định là phần giống nhau mọi lần, và đó là lý do nó là phần nên dùng để đối chiếu.

Bảng dưới đây ghép hai thứ đó, trong phạm vi trang này: với mỗi điều kiện được liệt kê ở đây, mã ngắn mà một bản build in ra và câu mà dòng thông báo của nó bắt đầu, đối chiếu với mục ở trên giải thích cách sửa khi viết. Tiêu đề các mục được trích nguyên văn, nên tìm một tiêu đề trên trang này sẽ đưa bạn tới mục của nó. Bảng mọi điều kiện tra một mã ngắn trên mọi điều kiện mà trình biên dịch khai báo, kể cả những điều kiện không có mục nào ở đây.

Khi một mục xuất hiện ứng với hai mã ngắn, mục đó bao gồm hai điều kiện riêng biệt và mỗi điều kiện đăng ký câu riêng của nó; hãy đọc các câu thay vì tiêu đề chung để biết bản build đã báo điều kiện nào.

aggrega explain <code> thực hiện việc tra cứu này cho bạn tại terminal, nhận một trong hai mã của điều kiện và in ra điều kiện cùng với mục ở trên mô tả nó. Lệnh này được mô tả trong aggrega explain.

Mã ngắnBắt đầu bằngĐược mô tả tại
E0001cliplugin: no plugin resolver configuredMột trình chạy plugin dòng lệnh được dựng mà không có cách tìm plugin
E0003malformed attachment requirementMalformed attachment requirement (Yêu cầu attachment sai định dạng)
E0004annotation contribution overridden by an explicit valueMột giá trị tường minh đã thay thế giá trị do một annotation cung cấp
E0005policy violationMột governance plugin đã từ chối bản build
E0006required attachment slot unfilledRequired attachment slot not bound (Khe gắn bắt buộc chưa được ràng buộc)
E0007selector violationVi phạm an toàn kiểu giữa các node qua selector:
E0008attachment slot selector unsatisfiedThe Feature filling an attachment slot does not satisfy the slot’s selector (Feature lấp một attachment slot không thỏa mãn selector của slot)
E0009pipeline step typed-I/O contract violationĐầu vào hoặc đầu ra có kiểu của một bước pipeline không thỏa mãn contract đã khai báo
E0010pipeline step failedMột bước pipeline bị lỗi
E0011pipeline patch targets a document not present in the setMột patch pipeline trỏ tới một tài liệu mà tập không chứa, hoặc một tài liệu không có cây để trỏ vào
E0012pipeline patch targets an opaque (non-structured) unitMột patch pipeline trỏ tới một tài liệu mà tập không chứa, hoặc một tài liệu không có cây để trỏ vào
E0013feature type mismatch between Aggregate and ReleaseFeature type mismatch between Aggregate and Release (Kiểu feature không khớp giữa Aggregate và Release)
E0014inject entry carries both `value:` and `from:`; schema requires exactly oneAn inject: entry carries both a literal and a source key (Một mục inject: mang cả một giá trị literal lẫn một khóa nguồn)
E0015uses-edge inject dictates a delivery mechanism the socket does not permituses edge dictates delivery on a socket that allowlists none (Cạnh uses chỉ định cách phân phối trên một socket không cho phép cách nào); uses edge dictates a delivery mechanism outside the socket’s allowlist (Cạnh uses chỉ định một cơ chế phân phối nằm ngoài danh sách cho phép của socket)
E0016jsonpatch: test operation failedA patch’s test operation did not match the document (Thao tác của một bản vá không khớp với tài liệu)
E0017annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeysAn annotation-transform plugin names a component it was not given, or injects a value no annotation takes (Một plugin annotation-transform chỉ định một component mà nó không được cung cấp, hoặc chèn một giá trị mà không annotation nào nhận)
E0018policy attachment settings do not satisfy the plugin's declared settings schemaThiết lập của một governance attachment không khớp với schema mà plugin khai báo
E0019endpoint requires form: referenceA workload: form and the fields beside it do not agree (Dạng của workload và các trường bên cạnh nó không khớp nhau)
E0020schedule is not a valid cron expressionA workload schedule: is not an expression the check accepts (Lịch của workload không phải là biểu thức mà bước kiểm tra chấp nhận)
E0021persistentTemplate volume requires form: statefulA workload: form and the fields beside it do not agree (Dạng của workload và các trường bên cạnh nó không khớp nhau)
E0022pipeline PATCH target is not parseable structured YAML/JSONA pipeline step addresses documents the node does not have (Một bước pipeline trỏ tới các tài liệu mà node không có)
E0023form: reference requires an endpointA workload: form and the fields beside it do not agree (Dạng của workload và các trường bên cạnh nó không khớp nhau)
E0024schedule requires form: scheduledA workload: form and the fields beside it do not agree (Dạng của workload và các trường bên cạnh nó không khớp nhau)
E0025form: scheduled requires a scheduleA workload: form and the fields beside it do not agree (Dạng của workload và các trường bên cạnh nó không khớp nhau)
E0026imported artifact content does not match the digest recorded for it in entity.lockAn imported artifact no longer matches the digest recorded beside its Recipe (Một artifact được nhập không còn khớp với digest được ghi bên cạnh Recipe của nó)
E0027artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)A library $import: is not written in the bare-name form (Một lệnh import thư viện không được viết ở dạng tên trần)
E0028artifacts output filename collision: two artifact outputs carry the same filenameHai đầu ra artifact của một Recipe mang cùng một tên tệp
E0029artifact template references a pillar the Recipe does not declareAn artifacts: template reads a pillar the Recipe does not declare (Một template artifacts: đọc một pillar mà Recipe không khai báo)
E0030artifact-library import references a bundle not present in the ArtifactLibraryMột $import: thư viện nêu tên một thư viện hoặc một mục mà catalog không có
E0031artifact-library import references an ArtifactLibrary not present in the catalogMột $import: thư viện nêu tên một thư viện hoặc một mục mà catalog không có
E0032assembled output collision: two contributors write the same output pathTwo contributors write the same output path (Hai bên đóng góp ghi vào cùng một đường dẫn đầu ra)
E0033assertion failedMột assertion đã dừng bản dựng
E0034duplicate delivery key across attachment-inject and another inject sourceAn attachment delivers a key another inject source already claimed (Một attachment phân phối một khóa mà một nguồn inject khác đã chiếm)
E0035provider expected to assemble its dispatch group provides no boundary assemblerThe plugin serving a provider cannot assemble what that provider combines (Plugin phục vụ một provider không thể lắp ráp những gì provider đó kết hợp)
E0036merged-path assembly has conflicting assembly-name annotation valuesChart-name mismatch on a merged helm-chart umbrella (Tên chart không khớp trên một umbrella helm-chart được hợp nhất)
E0037cross-boundary link between endpoints rendered by different providers is not supportedMột kết nối đi qua giữa các đầu ra đã lắp ráp của hai provider khác nhau
E0038derived name collision: one name is derived more than once in one key spaceThe same name is derived more than once inside the output (Cùng một tên được suy ra nhiều lần bên trong đầu ra)
E0039FeatureRecipe template references a per-component-only field with executionScope: boundaryFeatureRecipe template references a field outside its scope’s allowlist (Template của FeatureRecipe tham chiếu một trường nằm ngoài danh sách cho phép của phạm vi)
E0040library $import: carries a registry host; reference the library by bare-name identityMột $import: thư viện chỉ định thư viện của nó theo vị trí registry
E0041multiple contributors share an instance ID at the same dispatch pathInstance-ID collision across boundaries assembling to the same path (Xung đột instance ID giữa các boundary lắp ráp vào cùng một đường dẫn)
E0042locals entry references a sibling defined later in the same blockMục locals: tham chiếu một mục cùng cấp được định nghĩa sau trong cùng khối
E0043template references a key the locals block does not declarelocals: key does not exist (Khóa locals: không tồn tại)
E0044mapping-library import references an entry not present in the MappingLibraryMột $import: thư viện nêu tên một thư viện hoặc một mục mà catalog không có
E0045valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)A library $import: is not written in the bare-name form (Một lệnh import thư viện không được viết ở dạng tên trần)
E0046mapping-library import references a MappingLibrary not present in the catalogMột $import: thư viện nêu tên một thư viện hoặc một mục mà catalog không có
E0047assembled output retains an unresolved cross-boundary link placeholderAssembled output still carries a cross-boundary placeholder (Đầu ra đã lắp ráp vẫn chứa một placeholder liên ranh giới)
E0048dispatch path produced multiple provider outputsPath collision: two contributors emit at incompatible paths (Xung đột đường dẫn: hai bên đóng góp phát ra tại các đường dẫn không tương thích)
E0049path template references a field not in the documented allowlistPath-template references a variable outside the allowlist (Path-template tham chiếu một biến nằm ngoài danh sách cho phép)
E0050pipeline /host operation from a step with no host componentA pipeline step addresses documents the node does not have (Một bước pipeline trỏ tới các tài liệu mà node không có)
E0051pipeline PATCH targets an assembler provider's pre-assembly fragmentsA pipeline patch addresses output that has not been assembled yet (Một patch pipeline trỏ tới đầu ra chưa được lắp ráp)
E0052pipeline PATCH targets a document the node did not emitA pipeline step addresses documents the node does not have (Một bước pipeline trỏ tới các tài liệu mà node không có)
E0053pipeline plugin is not compatible with the rendering providerA pipeline step’s plugin does not claim the provider rendering what it addresses (Plugin của một bước pipeline không khai nhận provider đang render thứ mà bước đó trỏ tới)
E0054provider rejected node inputA provider refused a node’s input (Provider đã từ chối đầu vào của một node)
E0055Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declaresA Recipe or FeatureRecipe does not publish a provides key its contract declares (Một Recipe hoặc FeatureRecipe không công bố một khóa mà hợp đồng của nó khai báo)
E0056provides template evaluation failedA provides: template could not be evaluated (Không thể đánh giá một template provides)
E0057provides block references a root outside the self-contained setTemplate provides: tham chiếu một gốc không tự chứa
E0058provider render is not deterministicA provider rendered the same input twice and produced different output (Provider đã kết xuất cùng một đầu vào hai lần và tạo ra đầu ra khác nhau)
E0059duplicate delivery key across self-inject and uses-injectDuplicate delivery key across inject sources (Khóa phân phối trùng lặp giữa các nguồn inject)
E0060template references a root the render context does not defineTemplate references a root the render context does not define (Template tham chiếu một gốc mà ngữ cảnh render không định nghĩa); Self-inject value template references cross-node data (Template giá trị self-inject tham chiếu dữ liệu giữa các node)
E0061unknown providerUnknown provider (Provider không xác định)
E0062custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMappingA component declares an inject mechanism the attached Feature maps nothing to (Một component khai báo một cơ chế inject mà Feature đã gắn không ánh xạ gì vào)
E0063workload-library import references an entry not present in the WorkloadLibraryMột $import: thư viện nêu tên một thư viện hoặc một mục mà catalog không có
E0064workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)A library $import: is not written in the bare-name form (Một lệnh import thư viện không được viết ở dạng tên trần)
E0065workload-library import references a WorkloadLibrary not present in the catalogMột $import: thư viện nêu tên một thư viện hoặc một mục mà catalog không có
E0066uses edge target does not existĐích uses treo (không tồn tại)
E0067active toggle did not resolve to a booleanAn active: toggle does not resolve to true or false (Một toggle active: không phân giải thành true hoặc false)
E0068max sub-aggregate nesting depth exceededSub-aggregate nesting depth exceeded (Vượt quá độ sâu lồng sub-aggregate)
E0069mutator patch rejectedBản vá của một plugin label-transform vượt ra ngoài nhãn của node
E0070re-exported component alias forms a cycleA re-published component alias points back at itself (Một alias component được công bố lại trỏ ngược về chính nó)
E0071release edge retargets a developer-declared edgeRelease retargets a developer-declared edge (Release đổi đích một cạnh do nhà phát triển khai báo)
E0072sub-aggregate load failedA module a composition imports cannot be loaded, or imports itself (Một module mà một thành phần hợp nhất nhập vào không thể được tải, hoặc tự nhập chính nó)
E0073flattened node ID collision: rename one of the colliding instances so their flattened IDs differTwo instances flatten to one identifier (Hai instance được làm phẳng thành cùng một định danh)
E0074release per-edge configuration has no edge to apply toRelease per-edge configuration has no edge to apply to (Cấu hình theo từng cạnh của Release không có cạnh nào để áp dụng)
E0075aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)An Aggregate reached graph building without being normalised (Một Aggregate đến bước dựng đồ thị mà chưa được chuẩn hóa)
E0076sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`A sub-module’s components are placed in no boundary (Các component của một module con không được đặt vào ranh giới nào)
E0077uses edge target was pruned because its active toggle resolved to falseA uses edge targets a component an active: toggle removed (Một cạnh uses trỏ tới một component mà một toggle active: đã loại bỏ)
E0078producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption callA plugin asks the host to parse a source while a parse is already running for it (Một plugin yêu cầu host phân tích một nguồn trong khi một lần phân tích đang chạy cho chính nó)
E0079wasm: recorded command mirror does not match plugin describe()Tập lệnh được ghi lại của một thực thể Plugin không khớp với plugin
E0080wasm: entity contract claim does not match plugin describe()Các khẳng định của một thực thể Plugin không khớp với tự báo cáo của chính plugin
E0081wasm: guest plugin returned a diagnostic whose severity the contract does not declareA plugin returned a diagnostic at a severity that is not declared (Một plugin trả về một chẩn đoán ở mức độ nghiêm trọng không được khai báo)
E0082wasm: guest plugin reported an errorA plugin failed while it was running (Một plugin bị lỗi khi đang chạy)
E0083wasm: guest plugin panicked during callA plugin failed while it was running (Một plugin bị lỗi khi đang chạy)
E0084wasm: stamped host-function record does not match .wasm importsCác host function được ghi lại của một thực thể Plugin không khớp với binary
E0085wasm: plugin rejected by the sandboxThe sandbox refused a plugin (Sandbox đã từ chối một plugin)
E0086wasm: plugin invoked proc_exitA plugin failed while it was running (Một plugin bị lỗi khi đang chạy)
E0087wasm: declared plugin type does not match plugin describe()A plugin is not the kind of plugin the socket expects (Plugin không thuộc loại plugin mà socket mong đợi)
E0088wasm: entity metadata.version does not match plugin describe()Phiên bản được ghi lại của một thực thể Plugin không khớp với plugin
E0089every published version this reference could select has been withdrawnEvery version a reference could select has been withdrawn (Mọi phiên bản mà một tham chiếu có thể chọn đều đã bị thu hồi)
E0090format is advertised by more than one importer pluginA parse or import format is advertised by more than one plugin (Một định dạng parse hoặc import được quảng bá bởi nhiều hơn một plugin)
E0091format is advertised by more than one parser pluginA parse or import format is advertised by more than one plugin (Một định dạng parse hoặc import được quảng bá bởi nhiều hơn một plugin)
E0092capability is served by more than one provider plugin; add a plugins.providers entry to select oneA capability is served by more than one provider plugin (Một capability được phục vụ bởi nhiều hơn một plugin provider)
E0093manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguousA Manifest maps two version-distinct keys onto one type (Một Manifest ánh xạ hai khóa khác phiên bản lên một kiểu)
E0094duplicate entity identity within a single catalog directoryTwo catalog entities in one directory share an identity (Hai thực thể catalog trong cùng một thư mục có chung một định danh)
E0095malformed recipe reference in a Manifest mapping valueManifest mapping value is not a shape a recipe reference accepts (Giá trị ánh xạ của Manifest không có hình dạng mà một tham chiếu recipe chấp nhận)
E0096manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type keyimplements của Recipe không khớp với kiểu component được ánh xạ
E0097no importer plugin advertises the requested formatNo plugin advertises a requested parse or import format (Không plugin nào quảng bá định dạng parse hoặc import được yêu cầu)
E0098no parser plugin advertises the requested formatNo plugin advertises a requested parse or import format (Không plugin nào quảng bá định dạng parse hoặc import được yêu cầu)
E0099no recipe resolved for component/feature instance: add an explicit Manifest mapping for its typeNo Recipe is mapped for a component or feature instance (Không có Recipe nào được ánh xạ cho một instance component hoặc feature)
E0100plugins.providers entry names a plugin no provider-rendering plugin serving the capability matchesA plugins.providers binding names a plugin that does not serve the capability (Một liên kết plugins.providers nêu một plugin không phục vụ capability đó)
E0101no provider-rendering plugin version satisfies the recipe's provider version pinNo provider plugin version satisfies a Recipe’s provider pin (Không phiên bản plugin provider nào thỏa mãn ghim provider của một Recipe)
E0102wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact pathMột tham chiếu plugin mang host registry hoặc đường dẫn artifact
E0103no catalog version satisfies the referenced version constraintNo catalog version satisfies a version constraint (Không có phiên bản catalog nào thỏa mãn ràng buộc phiên bản)
E0104wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI locationMột tham chiếu plugin hoặc recipe không có phạm vi
E0105recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI locationMột tham chiếu plugin hoặc recipe không có phạm vi
E0106resolve: invalid library reference URIA library reference is not written in the identity form (Một tham chiếu thư viện không được viết theo dạng định danh)
E0107resolve: minimal version selection conflict — incompatible library version requirementsTwo consumers of one library require incompatible versions (Hai bên sử dụng một thư viện yêu cầu các phiên bản không tương thích)
E0108resolve: catalog lookup cannot load resolved sub-aggregate bodiesThe catalog view a build was given cannot load the bodies pinning needs (Góc nhìn catalog mà một bản build được cung cấp không thể tải các nội dung mà việc ghim cần)
E0109resolve: catalog lookup cannot load resolved recipe and plugin bodiesThe catalog view a build was given cannot load the bodies pinning needs (Góc nhìn catalog mà một bản build được cung cấp không thể tải các nội dung mà việc ghim cần)
E0110resolve: source-template evaluation failure at lock timeViệc phân giải một tọa độ source: đăng ký một tập hàm hẹp hơn
E0111resolve: source-template parse errorViệc phân giải một tọa độ source: đăng ký một tập hàm hẹp hơn
E0112resolve: source-template references .provides (invalid reverse reference)Việc phân giải một tọa độ source: đăng ký một tập hàm hẹp hơn
E0113resolve: sub-aggregate inclusion depth exceededThe chain of module imports is deeper than the pin walk descends (Chuỗi import module sâu hơn mức mà việc duyệt ghim đi xuống)
E0114resolve: no entity in the catalog matches this URIA reference names no entity the catalog holds (Một tham chiếu không chỉ tới thực thể nào mà catalog chứa)
E0115compactform: ambiguous dispatch — $mode requiredMột schema dạng compact khai báo một trường có tên đúng là type
E0116compactform: constraint not valid for declared typeMột ràng buộc dạng compact không áp dụng cho kiểu mà nó được viết trên đó
E0117compactform: $jsonschema content invalidMột lối thoát $jsonschema: mang nội dung không phải là schema
E0118compactform: cross-document $ref carries a registry host; reference the library by identityMột $ref: định địa chỉ thư viện theo vị trí registry
E0119compactform: $ref unresolvableMột $ref: không được viết theo dạng mà trình biên dịch có thể phân giải
E0120compactform: unknown keywordMột schema dạng compact dùng một từ khóa mà dạng compact không biết
E0121compactform: cross-document $ref target not foundMột $ref: không được viết theo dạng mà trình biên dịch có thể phân giải
E0122deprecation: build consumes a deprecated entityThe build consumes an artifact its publisher has deprecated (Bản dựng sử dụng một artifact mà nhà phát hành đã đánh dấu ngừng hỗ trợ)
E0123docscache: artifact is not a documentation bundleA resolved artifact is not a documentation bundle (Artifact đã phân giải không phải là một bundle tài liệu)
E0124docscache: page not found in documentation bundleA page is absent from a documentation bundle (Một trang không có trong gói tài liệu)
E0125egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cacheThe workspace is offline and the step needs the network (Workspace đang ngoại tuyến và bước này cần mạng)
E0126externalinputs: acquisition is disabled for unpinned inputsA render requests an external input the lockfile does not pin (Một lần render yêu cầu một đầu vào bên ngoài mà lockfile không ghim)
E0127externalinputs: fetched bytes mismatch the pinned digestFetched bytes do not match a pinned digest (Các byte tải về không khớp với một digest đã ghim)
E0128externalinputs: URL scheme is not allowedAn external input’s URL uses a scheme that is not allowed (URL của một đầu vào bên ngoài dùng một scheme không được cho phép)
E0129externalinputs: store blob mismatches its pinned recordA stored external input no longer matches its record (Một đầu vào bên ngoài được lưu trữ không còn khớp với bản ghi của nó)
E0130lockfile: out of date; it no longer matches what its Release resolves toThe lockfile no longer matches what the release resolves to (Lockfile không còn khớp với những gì bản phát hành phân giải ra)
E0131lockfile: file failed schema validationThe lockfile does not satisfy its schema (Lockfile không thỏa mãn schema của nó)
E0132oci: manifest has multiple layers of the expected content media typeA manifest carries no layer of the expected kind, or more than one (Một manifest không mang layer nào thuộc loại mong đợi, hoặc mang nhiều hơn một)
E0133oci: cached manifest digest mismatchFetched or cached bytes do not match the digest committed for them (Các byte đã tải về hoặc đã lưu đệm không khớp với digest đã cam kết cho chúng)
E0135oci: content digest mismatchFetched or cached bytes do not match the digest committed for them (Các byte đã tải về hoặc đã lưu đệm không khớp với digest đã cam kết cho chúng)
E0136oci: network unreachableThe registry could not be reached (Không thể kết nối tới registry)
E0137oci: artifact not found at remote sourceAn artifact is not at the source the build was told to find it (Artifact không có ở nguồn mà bản build được chỉ định để tìm nó)
E0138oci: authentication required or failedThe registry will not serve an artifact without credentials it accepts (Registry không cung cấp artifact nếu không có thông tin xác thực mà nó chấp nhận)
E0139oci: tag already published with different contentMột tag đã được công bố với nội dung khác
E0140oci: manifest has no layer of the expected content media typeA manifest carries no layer of the expected kind, or more than one (Một manifest không mang layer nào thuộc loại mong đợi, hoặc mang nhiều hơn một)
E0141oci: distinct catalog identities map to the same OCI repository locationTwo catalog identities publish to one repository location (Hai định danh catalog cùng xuất bản tới một vị trí kho lưu trữ)
E0142oci: referrer discovery could not be completedThe registry could not answer what is attached to an artifact (Registry không thể trả lời những gì được đính kèm vào một artifact)
E0143oci: unknown entity kind for mediatype dispatchMột kiểu thực thể không có media type cho artifact
E0144cached signature bundle does not match its recorded digestA cached signature bundle does not match the digest recorded for it (Gói chữ ký được lưu trong bộ nhớ đệm không khớp với digest được ghi lại cho nó)
E0145plugin reference is not a Plugin entityA plugin reference is not a Plugin entity (Một tham chiếu plugin không phải là một thực thể Plugin)
E0146circular reference expansionA library reference expands into itself (Một tham chiếu thư viện mở rộng vào chính nó)
E0147registrytrust: advertised trust config is malformedMột registry cung cấp một tài liệu tin cậy không thể đọc được như một tài liệu tin cậy
E0148registrytrust: registry advertises no trust configMột registry không công bố tài liệu tin cậy nào
E0149attachment name is a near miss for a declared slotTên attachment cách một slot đã khai báo một lần chỉnh sửa
E0150attachment does not conform to its declared slot shapeAttachment does not conform to its declared slot shape (Attachment không khớp với hình dạng slot đã khai báo của nó)
E0151component declared in more than one boundary: declare each component in exactly one boundaryA component is placed in more than one boundary (Một component được đặt vào nhiều hơn một boundary)
E0152duplicate Aggregate/Manifest identity (metadata.name) in the Release directoryThe Release directory declares one Aggregate or Manifest twice (Thư mục Release khai báo một Aggregate hoặc Manifest hai lần)
E0153feature merge conflict: reconcile the Aggregate and Release declarations for the featureA feature attached by both the Aggregate and the Release cannot be merged (Một feature được gắn bởi cả Aggregate và Release không thể hợp nhất)
E0154the compiler's own views of the catalog disagreeA guard needs a catalog entity the build resolved and cannot see (Một guard cần một thực thể catalog mà build đã phân giải nhưng không thấy được)
E0155duplicate delivery key across inject sourcesDuplicate delivery key across inject sources (Khóa phân phối trùng lặp giữa các nguồn inject)
E0156invalid inject key: the from-key must name a provides key its source publishesInject from key is not in the target’s provides (Khóa from của inject không có trong provides của đích)
E0158invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go templateA {{ .parameters.* }} reference cannot be interpolated (Không thể nội suy một tham chiếu {{ .parameters.* }})
E0160manifest annotation bindings collide on same Feature path+pillarTwo Manifest annotation bindings compete for one routing slot (Hai annotation binding của Manifest tranh nhau một vị trí định tuyến)
E0161manifest annotation binding uses reserved prefixA Manifest annotation binding claims the reserved aggrega.ai/ prefix (Một liên kết annotation của Manifest chiếm tiền tố dành riêng aggrega.ai/)
E0162missing required feature: attach a Feature of the required type to the componentRequired feature not attached (Feature bắt buộc chưa được gắn)
E0163required uses socket not populatedRequired uses: socket not populated (Socket uses bắt buộc chưa được điền)
E0164parameter contract violatedParameter type mismatch / contract violation (Kiểu tham số không khớp / vi phạm hợp đồng)
E0165required parameter not suppliedParameter type mismatch / contract violation (Kiểu tham số không khớp / vi phạm hợp đồng)
E0167Recipe publishes a provides key its Component does not declareMột Recipe xuất bản một khóa provides mà Component của nó không khai báo
E0168authored pillar does not conform to its declared schemaAuthored values or infra do not conform to the declared schema (Values hoặc infra được viết không tuân theo schema đã khai báo)
E0169self-inject on component without spec.inject allowlistSelf-inject on a component without an allowlist (Self-inject trên một component không có danh sách cho phép); Self-inject mechanism not in the component’s allowlist (Cơ chế self-inject không có trong danh sách cho phép của component)
E0170aggregate/manifest reference unresolvableA Release’s aggregate: or manifest: reference resolves to nothing (Tham chiếu aggregate: hoặc manifest: của một Release không phân giải được thành gì)
E0171unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declareuses: socket not declared in the owning entity’s usesSchema (Socket uses không được khai báo trong usesSchema của thực thể sở hữu)
E0172release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)A Release reached resolution without passing through the load path (Một Release đến bước phân giải mà không đi qua đường nạp)
E0173declared parameter is read by no reference in the AggregateMột parameter đã khai báo không được gì đọc
E0174uses socket name is a near miss for a declared socketTên socket trong uses: cách một socket đã khai báo một lần chỉnh sửa
E0175file load failed: the file could not be read, or its bytes did not parseA file cannot be read, or its bytes do not parse (Không thể đọc một tệp, hoặc không phân tích được các byte của nó)
E0176signing: keyless signing requires a live identity provider, Fulcio, and RekorKeyless signing was asked for without the services it needs (Ký không khóa được yêu cầu mà không có các dịch vụ cần thiết)
E0177signing: no signature found for an artifact that requires oneAn artifact that must be signed carries no signature (Một artifact bắt buộc phải được ký nhưng không mang chữ ký nào)
E0178signing: keyless verification requires at least one trusted identityA keyless trust policy names no acceptable signer (Chính sách tin cậy không dùng khóa không nêu tên người ký nào được chấp nhận)
E0179signing: signature does not verifyA detached signature does not verify against the key supplied (Chữ ký tách rời không xác minh được với khóa đã cung cấp)
E0180signing: signature bundle does not verifyA signature does not verify (Một chữ ký không xác minh được)
E0181signing: signing policy requires a signature for this artifact kind; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (Một lần xuất bản không ký nhắm tới registry hoặc chính sách yêu cầu chữ ký)
E0182signing: cannot load pinned trust rootThe pinned trust root cannot be read (Không thể đọc trust root đã ghim)
E0183signing: registry requires signatures; refusing to push unsigned contentAn unsigned publish targets a registry or a policy that requires a signature (Một lần xuất bản không ký nhắm tới registry hoặc chính sách yêu cầu chữ ký)
E0184signing: unsupported held-key typeA pinned verification key is not the key profile the verifier accepts (Khóa xác minh đã ghim không thuộc key profile mà bộ xác minh chấp nhận)
E0185signing: signature identity is not trusted for this registryA signature verifies but its signer is not one the registry trusts (Một chữ ký xác minh được nhưng người ký không phải là người mà registry tin cậy)
E0186no source adapter serves the source kindsource: của một Recipe nêu một loại mà không thành phần nào biết cách thu nhận
E0187cacheslot: empty workspaceRootA source artifact is cached without a workspace root to anchor it (Một artifact nguồn được lưu cache mà không có gốc workspace để neo nó)
E0188artifacts entry: shape must be a string scalar or {$import: <local-path>}Một trường inline-hoặc-import không được viết theo hình dạng nào trong hai hình dạng
E0189artifactlibrary: entry must be a mapping of filename to a string bodyPhần thân của một mục thư viện không có hình dạng mà thư viện đó chứa
E0190schemalibrary: forbidden JSON Schema keywordA schema uses a JSON Schema keyword the library does not admit (Một schema dùng một từ khóa JSON Schema mà thư viện không chấp nhận)
E0191mappinglibrary: entry body must be a string scalarPhần thân của một mục thư viện không có hình dạng mà thư viện đó chứa
E0192a document nests too many levels deepA document nests deeper than the reader will descend (Một tài liệu lồng sâu hơn mức bộ đọc sẽ đi xuống)
E0193parameters: shape must be an inline object or {$import: <local-path>}A Release’s parameters: block is written in neither of its two shapes (Khối parameters: của một Release không được viết theo dạng nào trong hai dạng của nó)
E0194schemalibrary: template not foundA $instantiate: reference cannot be resolved (Không thể phân giải một tham chiếu $instantiate:)
E0195schemalibrary: template parameter missingA $instantiate: reference cannot be resolved (Không thể phân giải một tham chiếu $instantiate:)
E0196schemalibrary: template parameter type mismatchA $instantiate: reference cannot be resolved (Không thể phân giải một tham chiếu $instantiate:)
E0197valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}Một trường inline-hoặc-import không được viết theo hình dạng nào trong hai hình dạng
E0198wellKnownAnnotations: a key is declared at a scope the provider's contract does not renderA provider declares a well-known annotation at a scope it does not render (Một provider khai báo một annotation phổ biến tại một phạm vi mà nó không render)
E0199workloadlibrary: entry body must be a string scalarPhần thân của một mục thư viện không có hình dạng mà thư viện đó chứa
E0200workload: shape must be a string scalar or {$import: <path-or-library-identity>}Một trường inline-hoặc-import không được viết theo hình dạng nào trong hai hình dạng
E0201assertion name declared twice across the extends chainAn assertion name is declared twice along an extends: chain (Một tên assertion được khai báo hai lần dọc theo một chuỗi extends:)
E0202cyclic extends chainCyclic extends chain (Chuỗi extends có vòng lặp); Cyclic extends on Components or Features (extends có vòng lặp trên Components hoặc Features)
E0204FeatureRecipe: valuesMapping requires sourceA FeatureRecipe’s valuesMapping requires source (valuesMapping của FeatureRecipe yêu cầu source)
E0205inheritance merge failedAn extends: chain cannot be assembled (Không thể lắp ráp một chuỗi extends:)
E0207recipe output-component-labels constraint: key is also declared in outputLabelsA promoted component label is also declared literally (Một nhãn component được đưa lên cũng được khai báo literal)
E0208recipe output-labels constraint: key uses a reserved namespaceAn output-label key uses a reserved namespace (Một khóa nhãn đầu ra dùng một namespace dành riêng)
E0209Recipe: valuesMapping requires sourcevaluesMapping requires source (valuesMapping yêu cầu source)
E0210Recipe: at least one input kind requiredPhải có ít nhất một loại đầu vào
E0211filename collision across input kinds: two input-kind blocks produced a file under one output nameEmission-time filename collision across input kinds (Xung đột tên tệp khi xuất giữa các loại đầu vào)
E0212workload attachment slot is not referenceableMột Workload tham chiếu đến một slot mà phần điền của nó không công bố locator nào
E0213workload featuresSchema cross-check failedMột tệp đính kèm Workload nêu tên một slot mà thực thể không khai báo, hoặc một cách phân phối mà slot cấm
E0214workload validation failedA Workload does not satisfy the Workload schema (Một Workload không thỏa mãn schema của Workload)
E0215document envelope validation failedYAML anchor aliased inside its own content (Anchor YAML được alias bên trong chính nội dung của nó); Divergent Release (extends + aggregate pointer) (Release phân kỳ (extends + con trỏ aggregate))
E0216validator/jsonschema: x-aggrega extension evaluation failedAn x-aggrega-when: or x-aggrega-validate: predicate cannot be evaluated (Không thể đánh giá vị từ x-aggrega-when: hoặc x-aggrega-validate:)
E0218validator/jsonschema: schema resolution failedA declared schema cannot be resolved (Một schema đã khai báo không thể được phân giải)
E0220extends chain exceeds maximum depthAn extends: chain runs past the depth bound (Một chuỗi extends: vượt quá giới hạn độ sâu)
E0221merger: invalid merge inputCơ chế bảo vệ đầu vào của chính bước hợp nhất schema
E0222registry alias matches more than one hostA registry alias matches more than one host (Một alias registry khớp với nhiều hơn một host)
E0223a cross-cutting socket is bound by capability but attaches by uriA plugin binding sets a key the socket it attaches to does not read (Một liên kết plugin đặt một khóa mà socket nó gắn vào không đọc)
E0224workspace configuration is invalidThe workspace configuration is invalid (Cấu hình workspace không hợp lệ)
E0225capability is bound to more than one provider pluginA capability is bound to more than one provider plugin (Một capability được liên kết với nhiều hơn một plugin provider)
E0226registry alias is already used by another hostMột bí danh registry đã được gắn với một host khác
E0227a governance attachment declares no role or an unknown roleA governance attachment declares no role, or one that is not a known role (Một attachment governance không khai báo role nào, hoặc khai báo một role không được biết đến)
E0228a provider socket binding sets a field with no referent on that socketA plugin binding sets a key the socket it attaches to does not read (Một liên kết plugin đặt một khóa mà socket nó gắn vào không đọc)
E0229position out of rangeMột vị trí trong trình soạn thảo nằm ngoài tài liệu
E0246the digest recorded as trusted for this plugin does not match the digest its cached manifest reportsA trusted plugin’s recorded digest disagrees with the cached artifact (Digest đã ghi của một plugin tin cậy không khớp với artifact trong bộ nhớ đệm)
E0247a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict roleA plugin recorded as a trusted gate is no longer attached (Một plugin được ghi nhận là cổng tin cậy không còn được gắn nữa)
E0248wasm: guest plugin returned an output that is not the shape the socket readsA plugin returned something that is not the shape the socket reads (Một plugin trả về thứ không có dạng mà socket đọc)
E0250provider named a directory for each contributor's own sub-directory that is not a single directory nameA provider named a directory for a contributor that is not one directory (Một provider đặt tên thư mục cho một contributor không phải là một thư mục duy nhất)
E0251recipe source is an empty string, which names neither sourceless mode nor sourced modesource: của Recipe là một chuỗi rỗng
E0252artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested underAn ArtifactLibrary bundle file names no file of its own under the key it was imported at (Một tệp trong bundle của ArtifactLibrary không đặt tên cho tệp riêng nào dưới khóa mà nó được nhập vào)
E0253annotation binding does not resolve against its target FeatureAnnotation binding does not resolve against its target Feature (Liên kết annotation không phân giải được với Feature đích của nó)
E0254annotation subkey does not conform to the target Feature's schema at the routed pillarA bound annotation value does not conform to the target Feature’s schema (Giá trị annotation được ràng buộc không tuân theo schema của Feature đích)
E0255annotation routes through a pillar its authoring side may not useAn annotation routes through a pillar its authoring side may not use (Một annotation định tuyến qua một pillar mà phía viết nó không được phép dùng)
E0256annotation binding declares one path in both pillar listsMột annotation binding khai báo một đường dẫn trong cả hai danh sách pillar
E0257declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validationA declared schema contract cannot be read as a schema (Một hợp đồng schema đã khai báo không thể được đọc như một schema)
E0259attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares itA boundary-scope Feature is attached only to a component (Một Feature phạm vi boundary chỉ được gắn vào một component)
E0260component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`A component the composition holds is placed in no boundary (Một component mà composition chứa không được đặt vào boundary nào)
E0261boundary names a component the composition does not hold: correct the name, or remove the entryA boundary names a component the composition does not hold (Một ranh giới nêu tên một component mà thành phần hợp nhất không chứa)
E0262component identity cannot be the name its emitted resources are stamped with: rename the componentComponent identity cannot be stamped on what it emits (Không thể đóng dấu định danh của component lên những gì nó phát ra)
E0263the target will not accept a name derived from this component's authored identity: rename the componentThe target will not accept a name derived from an authored identity (Target không chấp nhận một tên được suy ra từ một định danh do tác giả viết)
E0264provider guest never accepted a component identity the compiler composed for itA provider never accepted a name the compiler composed (Một provider không bao giờ chấp nhận một tên do trình biên dịch ghép)
E0265provider does not support the node's input kindworkload: requires a provider that can synthesize (workload: yêu cầu một provider có khả năng tổng hợp)
E0266a schema `$import:` could not be appliedA schema $import: cannot be applied (Không thể áp dụng một $import: của schema)
E0267a schema block declares a key that names no data pillarA schema block names a key that is not a data pillar (Một khối schema nêu tên một khóa không phải trụ cột dữ liệu)
E0268reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokensBước ghép lại của một provider nhận một đơn vị mà chính bước cắt của nó chưa từng tạo ra
E0269provider guest returned two output files under one path; a conforming guest returns each output path at most onceA provider returned two output files under one path (Một provider trả về hai tệp đầu ra dưới cùng một đường dẫn)
E0270link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returnedA provider’s link wiring names an output file that was never emitted (Phần nối liên kết của một provider nêu tên một tệp đầu ra chưa từng được phát ra)
E0271emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and contentA pipeline step’s file emission carries no file (Lần phát tệp của một bước pipeline không mang theo tệp nào)
E0272side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crdA pipeline step declares an emission kind the contract does not define (Một bước pipeline khai báo một loại phát ra mà hợp đồng không định nghĩa)
E0273template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider suppliesA template reads a rendered name the node’s provider does not report (Một template đọc một tên đã render mà provider của node không báo cáo)
E0274the plugin identity recorded as trusted no longer matches what this resolution reportsA gate recorded as trusted resolves to a different identity (Một cổng được ghi nhận là tin cậy phân giải thành một danh tính khác)
E0275the edit was refused because the resulting document would not be valid, and nothing was writtenAn edit would produce a document its schema refuses (Một chỉnh sửa sẽ tạo ra tài liệu mà schema của nó từ chối)
E0276the version being published changes the published predecessor in a way the documented evolution rubric objects toThe change being published breaks what the evolution rubric allows (Thay đổi đang được xuất bản vi phạm những gì bộ tiêu chí tiến hóa cho phép)
E0277an annotation key on the entity uses a prefix the platform reservesAn annotation key uses a prefix the platform reserves (Một khóa annotation dùng tiền tố mà nền tảng dành riêng)
E0278the entity's name does not follow the documented name shape for its kindTên của một thực thể không theo dạng mà loại của nó mong đợi
E0279a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot followMột schema dùng một tham chiếu động không thể phân giải trước
E0280a schema in the entity declares an identifier of its own, where the platform owns that schema's identityMột schema khai báo một định danh thuộc quyền của nền tảng
E0281the entity's category label does not match the category directory the entity is filed underNhãn danh mục của một Component và thư mục của nó nêu hai danh mục khác nhau
E0282the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchemaMột phần mở rộng schema được viết trực tiếp vào nội dung schema
E0283the Plugin entity declares no runtime resource cap of its own, so the platform defaults applyMột Plugin không cố định giới hạn runtime nào, nên giới hạn của nền tảng được áp dụng
E0284an attachment slot admits only secret material and does not declare that it handles itMột attachment slot chỉ chấp nhận dữ liệu bí mật mà không nói rằng nó xử lý dữ liệu đó
E0285the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refusedMột Recipe xuất bản một khóa provides mà Component của nó không khai báo, được kiểm tra khi xuất bản
E0286the version bump being published is smaller than the evolution check's classification of the change requiresThe version offered is a smaller bump than the change requires (Phiên bản được đưa ra tăng ít hơn mức thay đổi yêu cầu)
E0287the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring filesAn import stopped partway through translating a source (Một lần import đã dừng giữa chừng khi chuyển đổi một nguồn)
E0288a plugin has no expression for a construct this build declaresA workload declares a form compose cannot express (Một workload khai báo một dạng mà compose không thể biểu diễn); A container declares a field compose has no primitive for (Một container khai báo một trường mà compose không có primitive tương ứng); An omits entry names a kind or a namespace a compose file does not have (Một mục omits nêu tên một kind hoặc một namespace mà tệp compose không có); An omits entry names a namespace a CloudFormation template does not have (Một mục omits nêu tên một namespace mà template CloudFormation không có); A rule reads a bound CloudFormation parameter by name (Một rule đọc một tham số CloudFormation đã liên kết theo tên); The assembled CloudFormation stack cannot carry a transform (Stack CloudFormation đã lắp ráp không thể mang một transform)
E0289a plugin could not resolve something it requires to exactly one valueA health probe cannot be turned into a compose healthcheck (Không thể chuyển một health probe thành một healthcheck của compose); A configmap volume has no file behind it (Một volume configmap không có tệp nào phía sau); What an omits entry left out is still named by the compose file (Thứ mà một mục omits đã loại bỏ vẫn được tệp compose nêu tên); What an omits entry left out is still named by a CloudFormation template (Thứ mà một mục omits đã loại bỏ vẫn được một template CloudFormation nêu tên); A valuesMapping key names no parameter of a sourced CloudFormation template (Một khóa valuesMapping không nêu tên tham số nào của template CloudFormation được lấy từ nguồn); Another component references a CloudFormation parameter a sourced template’s binding filled (Một component khác tham chiếu một tham số CloudFormation mà liên kết của một template lấy từ nguồn đã điền); Two components order one pair of transforms oppositely (Hai component sắp xếp một cặp transform theo thứ tự ngược nhau); A cross-boundary reference has no consuming stack to be written into (Một tham chiếu xuyên boundary không có stack sử dụng nào để được ghi vào); A synthesized StatefulSet has no single service to govern it (Một StatefulSet được tổng hợp không có một service duy nhất quản lý nó)
E0290two things a plugin produced occupy one name in its outputAn authored export name is one the build derives for a cross-stack reference (Một tên export do tác giả viết trùng với tên mà bản build suy ra cho một tham chiếu xuyên stack); The output a cross-stack reference publishes on already carries an Export (Output mà một tham chiếu xuyên stack công bố trên đó đã mang một Export); Two entries reach one stack output name (Hai mục cùng tới một tên output của stack); A CloudFormation fragment writes one key twice (Một fragment CloudFormation ghi một khóa hai lần); Two rendered resources land at one output file (Hai tài nguyên đã render rơi vào cùng một tệp đầu ra)
E0291a plugin has no representation for a value it was givenA published port declares a transport compose cannot spell (Một cổng được công bố khai báo một giao thức truyền tải mà compose không thể biểu diễn); A resources quantity cannot be converted to a compose value (Không thể chuyển một lượng resources thành một giá trị compose); A resource quantity the helm provider emits is not a quantity (Một lượng tài nguyên mà provider helm phát ra không phải là một lượng); A service type the helm provider cannot render (Một kiểu service mà provider helm không thể render); A Kubernetes version the helm provider cannot render a chart for (Một phiên bản Kubernetes mà provider helm không thể render chart cho nó); A value bound to a CloudFormation parameter cannot take the parameter’s type (Một giá trị được liên kết với một tham số CloudFormation không thể nhận kiểu của tham số đó); A value bound to a CloudFormation parameter is one its constraints refuse (Một giá trị được liên kết với một tham số CloudFormation bị các ràng buộc của nó từ chối); A secret bound to a CloudFormation parameter would be written into the template (Một secret được liên kết với một tham số CloudFormation sẽ bị ghi vào template); A dynamic reference is bound where CloudFormation does not resolve it (Một tham chiếu động được liên kết ở nơi CloudFormation không phân giải nó); A cross-boundary reference was spliced into a longer string (Một tham chiếu xuyên boundary đã bị ghép vào một chuỗi dài hơn)
E0292a plugin reported a failure that none of the declared kinds namesA plugin reported a failure it did not classify (Một plugin đã báo cáo một lỗi mà nó không phân loại)
E0293wasm: guest plugin named a condition the socket does not declareA plugin named a condition the socket does not declare (Một plugin đã nêu một điều kiện mà socket không khai báo)
E0294components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identityTwo subsystems declare a component under one name (Hai subsystem khai báo một component dưới cùng một tên)
E0295library reference: a reference to a library entry carries no whitespace or line breakMột tham chiếu đến một mục thư viện chứa khoảng trắng
E0296release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never bothA Release chain’s links disagree about the routing shape (Các mắt xích của một chuỗi Release không thống nhất về hình dạng định tuyến)
E0297inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes toA child Release inherits a boundary directory that resolves where its parent writes (Một Release con kế thừa một thư mục boundary được phân giải tới nơi Release cha ghi)
E0298oci: published bundle carries no entity documentA published bundle holds no entity, or holds two (Một bundle đã xuất bản không chứa thực thể nào, hoặc chứa hai thực thể)
E0299oci: published bundle carries more than one entity documentA published bundle holds no entity, or holds two (Một bundle đã xuất bản không chứa thực thể nào, hoặc chứa hai thực thể)
E0300oci: published bundle cannot be unpackedA published artifact cannot be read as an entity (Một artifact đã xuất bản không thể được đọc như một thực thể)
E0301oci: published artifact is not an entity documentA published artifact cannot be read as an entity (Một artifact đã xuất bản không thể được đọc như một thực thể)
E0302an input the entity reads has no pin recorded for it in the entity.lock beside itAn entity reads an input the lock beside it records no pin for (Một thực thể đọc một đầu vào mà tệp khóa bên cạnh nó không ghi lại pin nào)
E0303the entity shares its directory with another entity, and an entity of its kind has a directory of its ownMột thực thể dùng chung thư mục với một thực thể khác
E0304a path names content outside the entity's own directoryMột đường dẫn trỏ tới nội dung nằm ngoài thư mục riêng của thực thể
E0305the files of the entity's local source do not match the pins recorded for them in entity.lockA local source no longer matches the pins recorded beside its Recipe (Nguồn cục bộ không còn khớp với các pin được ghi bên cạnh Recipe của nó)
E0306plugin artifact not found on this machineA plugin’s .wasm is not on this machine (.wasm của plugin không có trên máy này)
E0307a value a cache location is built from would place cached files outside the place it names in the cacheA value would place a cached file outside the cache (Một giá trị sẽ đặt một tệp đã lưu cache ra ngoài cache)
E0308a Feature reaches a component alongside a Feature it declares a conflict withTwo Features declared to conflict reach one component (Hai Features được khai báo là xung đột cùng tới một component)
E0309a symbolic link sits among the files an entity carriesA symbolic link sits among the files an entity carries (Một liên kết tượng trưng nằm giữa các tệp mà thực thể mang theo)
E0310a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`Một registry được thêm khi ngoại tuyến mà không có chính sách tin cậy để ghim
E0311reference carries a malformed version pinA version pin is none of the forms a pin takes (Một ghim phiên bản không thuộc dạng nào mà một ghim có thể có)
E0312a provider socket binding names a capability containing a colon, which no Recipe can selectA provider binding names a capability containing a colon (Một liên kết provider chỉ định một capability chứa dấu hai chấm)
E0313plugins.providers entry names a capability no provider-rendering plugin the build reads servesMột provider binding nêu một capability mà không plugin nào bản dựng đọc phục vụ
E0314plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reportsMột plugin được build từ một working tree có thay đổi chưa commit
E0315a connection carries an attachment under a name its socket declares no slot forA connection carries an attachment under a name its socket declares no slot for (Một kết nối mang một attachment dưới một tên mà socket của nó không khai báo slot nào)
E0316a Release attachment takes the name of an attachment one of a component's connections carriesA Release attachment takes the name of a connection’s attachment (Một attachment của Release lấy tên của một attachment thuộc một kết nối)
E0317a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makesA Release connection attachment names no Feature type (Một attachment kết nối của Release không nêu kiểu Feature nào)
E0318duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already deliveredTwo attached Features deliver one key, the later through its FeatureRecipe’s injectMapping (Hai Features được gắn phân phối cùng một khóa, Feature sau thông qua injectMapping của FeatureRecipe của nó)
E0319connection alias is already used by another connection of the same componentHai kết nối của một component dưới cùng một alias
E0320a path this operation writes or deletes leads through a link out of the directory it must stay insideA path the operation writes leads through a link out of the directory it must stay inside (Một đường dẫn mà thao tác ghi đi qua một liên kết ra ngoài thư mục mà nó phải ở bên trong)
E0321a file this operation reads leads through a link out of the directory it must stay insideA file the operation reads leads through a link out of the directory it must stay inside (Một tệp mà thao tác đọc dẫn qua một liên kết ra ngoài thư mục mà nó phải nằm trong)
E0323template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFactsA template reads its callers’ render facts without declaring it (Một template đọc render facts của các bên gọi mà không khai báo)
E0324a reference a document makes to another file leads out of the directory it must stay insideA reference to another file leads out of the directory it must stay inside (Một tham chiếu tới tệp khác dẫn ra ngoài thư mục mà nó phải nằm bên trong)
E0325provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entryA provider reported a render fact whose value is not a list (Một provider đã báo cáo một render fact có giá trị không phải là danh sách)
E0326pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render factsMột bước pipeline đọc render facts của các bên gọi nó
E0327template indexes a map with a key the map does not holdMột template truy cập một map bằng một khóa mà map đó không chứa
E0328attachment written under a name no slot declares fits a slot its component leaves emptyAn attachment written under another name fits a slot its component leaves empty (Một attachment được viết dưới tên khác khớp với một slot mà component của nó để trống)
E0329a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names oneMột kết nối và đích mà nó tới không cùng chỉ một khóa
E0330signing: the references named together need different signing credentials, so nothing was signedCác tham chiếu được ký cùng nhau cần các thông tin xác thực ký khác nhau
E0331signing: no verified signature is recorded for an artifact that requires oneNo verified signature is recorded for an artifact that requires one (Không có chữ ký đã xác minh nào được ghi lại cho một artifact yêu cầu chữ ký)
E0332signing: the recorded signature was made for a different artifactA recorded signature was made for a different artifact (Chữ ký đã ghi được tạo cho một artifact khác)
E0333signing: a recorded signature is not the one a pull would recordA recorded signature is not the one a pull would record (Chữ ký đã ghi không phải là chữ ký mà một lần pull sẽ ghi)
E0334an omits entry left out nothing the source renderedAn omits entry left out nothing the source rendered (Một mục omits không loại bỏ được gì mà nguồn đã kết xuất)
E0335provider does not support omitsThe provider does not support omits (Provider không hỗ trợ omits)
E0336a provider's omitted counts do not match the omits entries it was handedA provider’s omitted counts do not match the omits entries it was handed (Số lượng bị lược bỏ của một provider không khớp với các mục omits mà nó được giao)
E0337no importer plugin version satisfies the plugins.importer entry's version pinMột mục plugins.importer ghim một phiên bản importer mà catalog không có
E0338importer is attached by more than one plugins.importer entryAn importer is attached by more than one plugins.importer entry (Một importer được gắn bởi nhiều hơn một mục plugins.importer)
E0339more than one importer recognises the sourceMore than one importer recognises the source (Có nhiều hơn một trình nhập nhận diện được nguồn)
E0340a name this operation writes holds a path segment Windows cannot hold as writtenA name the operation writes holds a part Windows cannot hold (Một tên mà thao tác ghi chứa một phần mà Windows không thể chứa)
E0341the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directoryAn importer that declares no file patterns is handed a directory (Một trình nhập không khai báo mẫu tệp nào được giao một thư mục)
E0342no file in the directory matches the file patterns the importer serving the source's format declaresNo file in the directory matches the importer’s file patterns (Không có tệp nào trong thư mục khớp với các mẫu tệp của trình nhập)
E0343a file read from the directory and a file named in the importer's `with.sources` have the same nameA file read from the directory and a file named in the importer’s with.sources have the same name (Một tệp đọc từ thư mục và một tệp được nêu trong with.sources của importer có cùng tên)
E0344an entry this publication carries cannot be used on WindowsMột kho lưu trữ đã phát hành chứa một mục mà Windows không thể dùng
E0345a container declares one environment variable twiceA container gives one environment variable two values (Một container gán hai giá trị cho một biến môi trường)
E0346a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credentialChú thích metrics của một Component và khóa provides của nó không khớp nhau
E0347template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFactsMột template đọc render facts của các đích mà không khai báo
E0348pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render factsMột bước pipeline đọc render facts của các đích
E0349no Recipe in the workspace's catalog binds to the capability the import's target namesAn import’s target names a capability no Recipe in the catalog binds to (Đích của một lần import nêu một capability mà không Recipe nào trong catalog ràng buộc tới)
E0350no importer recognises the sourceNo importer recognises the source (Không có trình nhập nào nhận diện được nguồn)
E0351provider does not support boundary artifactsThe provider does not support boundary artifacts (Provider không hỗ trợ boundary artifacts)
E0352boundary output directory does not name a directory beneath the output rootA boundary’s output directory is not a directory beneath the output root (Thư mục đầu ra của một boundary không phải là một thư mục nằm dưới thư mục gốc đầu ra)
E0353boundary-level Feature instance name is not a directory nameA boundary-level Feature is named . or .. (Một Feature cấp boundary được đặt tên là . hoặc ..)
E0354a template does more than copy a value it reads off a cross-boundary linkA template did more than copy a value it read off a cross-boundary link (một template đã làm nhiều hơn việc sao chép một giá trị nó đọc từ một liên kết xuyên boundary)
E0355inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`An inject: delivery is not a list of entries (Một phân phối inject không phải là danh sách các mục)
E0356suspend requires form: scheduledA workload suspend: is set on a form other than scheduled (Trường tạm dừng của workload được đặt trên một form không phải lập lịch)
E0357a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothingA Manifest name mapping names nothing in the build (Một ánh xạ name của Manifest không nêu tên thứ gì trong bản build)
E0358uses edge target names a component its module does not exportA uses target names a module’s component the module does not export (Một đích uses nêu tên một component của module mà module không xuất)
E0359no source adapter is registered in this program for the source kindNo source adapter is registered in this program for a source kind (Không có source adapter nào được đăng ký trong chương trình này cho một loại nguồn)
E0360the netrc file could not be readThe netrc file cannot be read (Không thể đọc tệp netrc)
E0361the source URL carries a credentialA source URL carries a credential (URL nguồn mang theo thông tin xác thực)
E0362inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`An inject: entry on a connection carries a literal (Một mục inject trên kết nối mang một literal)
E0363annotation subkey is not routed by the annotation's bindingAn annotation subkey is not routed by its binding (Một khóa con của annotation không được binding của nó định tuyến)
E0364a value template failed while it ranA value template failed while it ran (Một value template thất bại khi đang chạy)
E0365boundary-level Feature's output is routed to a dispatch path nothing assemblesA boundary-level Feature’s output reaches no assembled file (Đầu ra của một Feature cấp boundary không đến được tệp đã lắp ráp nào)
E0366FeatureRecipe injectMapping output could not be read as a dictionary of deliveriesAn attached Feature’s injectMapping output cannot be read (Không thể đọc đầu ra injectMapping của một Feature được gắn kèm)
E0367a scalar annotation value does not route to exactly one path of its bindingA bare annotation value does not route to exactly one path of its binding (Một giá trị annotation trần không được định tuyến tới đúng một đường dẫn của binding của nó)
E0368FeatureRecipe injectMapping output writes a key no delivery mechanism of the host readsAn attached Feature’s injectMapping output writes deliveries under a key nothing delivers (Đầu ra injectMapping của một Feature được gắn kèm ghi các mục chuyển giao dưới một khóa mà không gì chuyển giao)
E0369template reads a path as a value and iterates it, and the data holds nothing at that pathA template reads and iterates a path that holds nothing (Một template đọc và lặp qua một đường dẫn không chứa gì)
E0370a pipeline declares one step id twiceA pipeline declares one step id twice (Một pipeline khai báo một id bước hai lần)
E0371catalog document declares a kind a catalog does not holdA catalog document declares a kind a catalog does not hold (Một tài liệu catalog khai báo một loại mà catalog không chứa)
E0372inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject blockAn inject: entry on an attached Feature carries a literal (Một mục chèn trên Feature được gắn mang một literal)
E0373a document declares an API version this compiler no longer readsA document declares an API version this compiler no longer reads (Một tài liệu khai báo phiên bản API mà trình biên dịch này không còn đọc nữa)
E0374a plugin declares a plugin ABI version this compiler no longer speaksA plugin declares a plugin ABI version this compiler no longer speaks (Một plugin khai báo phiên bản ABI plugin mà trình biên dịch này không còn hỗ trợ nữa)
E0375oci: artifact carries a media type this compiler no longer readsAn artifact carries a media type this compiler no longer reads (Một artifact mang kiểu media mà trình biên dịch này không còn đọc nữa)
E0376egress: the server did not answer in timeA server did not answer in time (Máy chủ không trả lời kịp thời)
E0377registry: the repository listing did not end in timeA registry’s repository listing did not end in time (Danh sách repository của một registry không kết thúc kịp thời)
E0378oci: the registry kept asking to slow downA registry kept asking to slow down (Registry liên tục yêu cầu giảm tốc độ)

Miền linter (không gây dừng)

Trình biên dịch hoàn toàn không có quan điểm riêng về thực thi. Nó không bao giờ dừng bản build vì những mẫu chỉ đơn thuần đáng ngờ — giá trị không được dùng, secret mồ côi, đích không được kết nối. Nhiều nhất một mẫu như vậy chỉ dẫn đến một cảnh báo tư vấn — của chính bản build, đối với một số ít mẫu được liệt kê trong “Các điều kiện không dừng bản build” ở trên, chẳng hạn một tham số đã khai báo mà không có gì đọc — còn lại thuộc về miền linter, nơi các doanh nghiệp chủ động chọn dùng các Wasm plugin thực thi các quy ước của riêng họ.

Thông tin xác thực mồ côi

Một Feature thông tin xác thực được gắn mà không có hợp đồng phân phối inject: không phải là lỗi biên dịch. Trình biên dịch lõi giữ nguyên khai báo trong đồ thị IR và không phát ra cảnh báo nào. Các plugin linter của doanh nghiệp có thể phát hiện và cảnh báo về mẫu này; các renderer của doanh nghiệp cũng có thể chọn mount ngầm các secret mồ côi theo các quy ước Black-Box của riêng họ. Vì cả hai cách diễn giải đều hợp lệ, trình biên dịch lõi không đứng về phía nào.