Cảnh báo và đầu ra của linter
Các cảnh báo không gây dừng mà trình biên dịch phát ra trong quá trình biên dịch. Cảnh báo không làm dừng bản dựng — chúng chỉ ra những dấu hiệu bất ổn trong cách viết, những lựa chọn phân xử tất định mà trình biên dịch đã đưa ra, và những tài nguyên mà các template của nhà phát triển chưa bao giờ sử dụng. Mỗi phát hiện được ghi ra stderr sau một tiền tố cho biết loại của nó — warning:, lint: hoặc notice:, tùy theo lượt xử lý nào đã phát ra nó — để các pipeline CI có thể thu thập và hiển thị lại chúng; các artifact được kết xuất vẫn được tạo ra bất kể thế nào.
Về các lần dừng biên dịch nghiêm trọng (các chẩn đoán làm dừng bản dựng), xem fatal-halts.md.
Mọi cảnh báo tư vấn, theo mã ngắn
Một số điều trình biên dịch báo cáo mà không dừng lại là một điều kiện riêng: nó mang một mã ngắn, cùng loại mã định danh bốn chữ số mà một chẩn đoán gây dừng in ra, và một câu cố định mà thông báo của nó mở đầu bằng. Bảng dưới đây tra cứu từ cái này sang cái kia, để một mã bạn đang có trong tay dẫn đến nội dung của phát hiện đó, ngay cả khi dòng bạn đang đọc là một cảnh báo chứ không phải một lần dừng.
Thứ được có mặt ở đây là một khai báo, không phải một mô tả. Mọi quy tắc mà trình biên dịch đánh giá đều nêu rõ một vi phạm sẽ làm gì — dừng bản dựng, hoặc báo cáo phát hiện và để bản dựng hoàn tất — và các hàng dưới đây thuộc loại thứ hai. Vì vậy, một cảnh báo tư vấn được thêm vào trình biên dịch sẽ xuất hiện ở đây mà không cần viết tay một hàng nào, và một cảnh báo trở thành điều kiện gây dừng sẽ rời khỏi đây.
Có hai giới hạn về phạm vi của bảng, và cả hai đều đáng biết trước khi bạn kết luận rằng một mã bị thiếu:
- Không phải mọi thứ trên trang này đều thuộc loại này. Một số phát hiện được trình bày bên dưới do một lượt xử lý riêng đưa ra chứ không phải do một quy tắc đã khai báo, và một số hoàn toàn không mang điều kiện nào — các dòng chúng in ra vẫn đúng như mô tả trong các mục của chúng, nhưng không có mã nào để tra cứu và do đó không có hàng nào. Mã lớp
unsupported-fieldlà dạng cần chờ đợi ở đó: nó đặt tên cho một lớp phát hiện chứ không phải một điều kiện. - Một hàng ở đây không hứa hẹn có một mục bên dưới. Một cảnh báo tư vấn được đưa ra muộn trong quá trình kết xuất chỉ được liệt kê chứ không được trình bày, nên một mã có thể dẫn đến một câu ở đây và được trình bày đầy đủ hơn trong fatal-halts.md dưới mục “Conditions that do not halt a build”, nơi liệt kê mọi điều kiện mang mã mà không dừng bản dựng.
sentinels.md tra cứu mọi mã ngắn mà một bản dựng in ra, dù là tư vấn hay gây dừng, và là nơi để bắt đầu khi bạn chưa biết mình đang gặp loại nào.
| Mã ngắn | Bắt đầu bằng |
|---|---|
E0004 | annotation contribution overridden by an explicit value |
E0037 | cross-boundary link between endpoints rendered by different providers is not supported |
E0149 | attachment name is a near miss for a declared slot |
E0167 | Recipe publishes a provides key its Component does not declare |
E0173 | declared parameter is read by no reference in the Aggregate |
E0174 | uses socket name is a near miss for a declared socket |
E0256 | annotation binding declares one path in both pillar lists |
E0297 | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
Lint chồng lấn trụ cột schema
Kích hoạt khi một Component hoặc Feature khai báo cùng một tên thuộc tính trong cả hai trụ cột values: và infra: của khối spec.schema: ở cùng một độ sâu lồng nhau. Tác giả schema đặt cùng một tên trường ở cả hai trụ cột thường chỉ định đặt nó vào một trong hai; lint đánh dấu sự trùng lặp để tác giả có thể xác định trụ cột nào sở hữu trường đó.
Vị trí trong pipeline. Lint chạy trong lượt xác thực sau khi hợp nhất schema, trước khi xây dựng topology. Nó duyệt schema sau khi mở rộng dạng rút gọn, không đi theo một $ref: (xem nguyên tắc bỏ qua mềm bên dưới), và báo cáo mỗi thuộc tính chồng lấn thành một cảnh báo riêng.
Dạng xuất ra:
notice: LINT: Component "core/compute/web-server:1.0.0" at ./catalog/component/core/compute/web-server/1.0.0/component.yaml declares property "storage_size" in both values: and infra: pillars (path: storage_size)Với các thuộc tính lồng nhau, đường dẫn là đường dẫn phân cách bằng dấu chấm từ gốc của trụ cột đến thuộc tính:
notice: LINT: Feature "core/db-pool:1.0.0" at ./catalog/feature/core/db-pool/1.0.0/feature.yaml declares property "timeout" in both values: and infra: pillars (path: connection.timeout)Khi tải toàn bộ catalog — aggrega validate không có đối số — mỗi thực thể được gọi theo tên và phiên bản và theo tệp mà nó được đọc từ đó, như trên. Một bản build, hoặc một lần xác thực một Release, chỉ đọc các thực thể mà Release đó chạm tới và gọi mỗi thực thể theo tên và phiên bản — at core/db-pool:1.0.0 — một lần cho mỗi thực thể, bất kể có bao nhiêu tham chiếu trong Release chạm tới nó: một Aggregate gọi một Feature bằng tên trần và một Manifest ánh xạ nó theo tên và phiên bản cùng chạm tới một Feature, và Feature đó chỉ được báo cáo một lần.
Hiển thị trong trình soạn thảo. Phát hiện này đến chẩn đoán của trình soạn thảo thông qua language server, ở mức cảnh báo, tại đầu tệp thay vì trên một khóa — nó gọi tên một thực thể catalog chứ không phải một vị trí trong tài liệu bạn đang chỉnh sửa, nên không có khóa soạn thảo nào để đặt dấu đánh dấu. Nó được phát sinh trước giai đoạn render artifact, nên không cần tùy chỉnh nào: một phiên trình soạn thảo hiển thị nó dù serve.build_on_inspect có được bật hay không.
Nguyên tắc bỏ qua mềm. Bộ duyệt dừng lại mà không cảnh báo khi một nhánh schema mang một trong các lối thoát của JSON Schema 2020-12 vốn ngăn việc suy ra tĩnh tập thuộc tính: $ref (tham chiếu liên tài liệu hoặc trong tài liệu), patternProperties (khai báo thuộc tính dựa trên dạng khóa), additionalProperties được đặt thành true hoặc một schema (các thuộc tính mà nhánh chấp nhận mà không nêu tên), và các toán tử kết hợp oneOf / anyOf / allOf (các phép tuyển và phép hội mà các nhánh có thể khai báo những tập thuộc tính khác nhau). Việc duyệt các nhánh này hoặc sẽ đòi hỏi đánh giá schema được tham chiếu hoặc kết hợp tại thời điểm lint (một loại công việc mà lint không thực hiện), hoặc sẽ tạo ra dương tính giả khi tên thuộc tính values: của một nhánh tình cờ trùng với tên thuộc tính infra: của một nhánh khác. Lint không phát cảnh báo nào cho độ sâu lồng nhau bị ảnh hưởng; các cấp sâu hơn của cùng schema vẫn được duyệt và có thể được lint.
Ghi chú soạn thảo. Trình biên dịch không từ chối việc chồng lấn tên giữa các trụ cột — lint chỉ mang tính khuyến nghị. Một Component có storage_size ở cả hai trụ cột vẫn biên dịch được; values.storage_size phía nhà phát triển và infra.storage_size phía vận hành được xác thực độc lập bởi schema của trụ cột tương ứng, và template valuesMapping: của Recipe chọn giá trị của trụ cột nào đi vào đầu ra được render. Lint tồn tại vì mẫu soạn thảo này gần như luôn là một sai sót; việc cố ý trùng lặp giữa các trụ cột hiếm đến mức tác giả thực sự muốn điều đó có thể bỏ qua cảnh báo. Về cơ chế liên trụ cột rộng hơn — bao gồm các trường hợp hiếm mà việc chủ ý dẫn dữ liệu giữa các trụ cột là hợp lý — xem vocabulary/data-pillars.md “Cross-pillar mechanics”.
Lint chồng lấn binding-map
Kích hoạt khi một annotation binding của Manifest khai báo cùng một đường dẫn dạng chấm trong cả hai danh sách maps.infra và maps.values của nó. Đường dẫn đó sẽ được định tuyến qua cả hai pillar; quy tắc phân xử tất định của trình biên dịch đưa nó qua infra:, khiến phía values: không thể được truy cập từ Aggregate. Lint nêu ra điều này để tác giả có thể thu hẹp binding về một pillar duy nhất hoặc chấp nhận một cách có ý thức việc chỉ định tuyến qua phía infra.
Vị trí trong pipeline. Lint chạy sau khi Manifest được phân giải và trước khi bất kỳ quá trình mở rộng annotation nào diễn ra, nên một bản build báo cáo binding chồng lấn bất kể có annotation nào của Aggregate từng chạm tới binding đó hay không. Nó duyệt các binding dưới mappings.features.annotations theo thứ tự chúng được viết, lấy giao của hai danh sách maps.infra và maps.values của từng binding, và báo cáo một phát hiện cho mỗi đường dẫn chồng lấn. Trong một binding, các đường dẫn chồng lấn được báo cáo theo thứ tự mà danh sách maps.values của binding đó khai báo chúng — thứ tự bạn đã viết — nên các lần chạy lặp lại trên cùng đầu vào báo cáo cùng một chuỗi.
Dạng xuất ra:
lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations, "compliance.aggrega.ai/data-class", on Feature "core/pii-redaction", at path "classifier_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values") lint: annotation binding declares one path in both pillar lists (Manifest, at .spec.mappings.features.annotations.audit-scope, "audit-scope", on Feature "core/pii-redaction", at path "retention_endpoint", which the routing tie-break sends through the pillar "infra", declare a second binding under another annotation key to route it through "values")Hai dòng đó đến từ một bản build trên một Manifest, và điều khác nhau giữa các locator của chúng là hình dạng của khóa annotation. Một locator định vị tài liệu bằng đường dẫn dạng chấm, nên nó dừng ở đoạn đầu tiên tự chứa dấu chấm: audit-scope không chứa dấu chấm nào và locator chạm tới binding, còn compliance.aggrega.ai/data-class thì có, và locator thay vào đó chỉ tới khối annotations chứa nó. Đó là lý do khóa vi phạm cũng là giá trị được trích dẫn đầu tiên của mọi phát hiện — nó là phần duy nhất mà locator không phải lúc nào cũng mang được.
Hiển thị trong trình soạn thảo. Phát hiện này cũng tới chẩn đoán của trình soạn thảo qua language server, ở mức cảnh báo, được đặt tại bất cứ nơi nào locator của nó chạm tới — trên chính binding đối với khóa thông thường, và trên khối annotations bao quanh đối với khóa có dấu chấm. Tác giả không bao giờ đọc đầu ra terminal vẫn thấy nó. Nó được phát ra trước giai đoạn kết xuất artifact, nên không cần tùy chọn nào: một phiên trình soạn thảo hiển thị nó bất kể serve.build_on_inspect có được bật hay không.
Khớp bằng chương trình. Phát hiện mang ErrAnnotationBindingPillarOverlap từ pkg/resolver, nên một bên sử dụng nhận diện lớp lỗi bằng errors.Is thay vì khớp văn bản thông báo. Như mọi sentinel tư vấn, nó không bao giờ ảnh hưởng tới kết luận của bản build — xem sentinels.md để biết hàm truy cập và các mã của điều kiện.
Phân xử tất định. Runtime giải quyết xung đột bằng cách chỉ định tuyến đường dẫn qua pillar infra:. Lựa chọn này nhất quán giữa các bản build; tác giả có thể dựa vào nó. Phía values: bị loại khỏi định tuyến hiệu lực của binding — các annotation phía Aggregate cố gắng chạm tới đường dẫn không nhận được đích định tuyến nào và bản build dừng ở phía Aggregate vào lúc mở rộng, theo điểm dừng được mô tả tại fatal-halts.md “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 tạo của nó không được phép dùng)”. Lint là bề mặt cảnh báo sớm; điểm dừng đó là bề mặt thực thi.
Ghi chú cho tác giả. Giống như lint chồng lấn schema-pillar, lint này mang tính tư vấn — binding vẫn biên dịch và quy tắc phân xử của runtime tạo ra đầu ra tất định. Lint kích hoạt vì mẫu viết này hầu như luôn là ngoài ý muốn; một tác giả binding thực sự muốn cả hai pillar định tuyến cùng một đường dẫn sẽ viết hai binding riêng biệt với các khóa annotation khác nhau.
Lint gần trùng tên slot đính kèm
Kích hoạt khi một instance component đính kèm một Feature dưới một tên không thuộc các slot featuresSchema đã khai báo của kiểu Component của nó, nhưng chỉ cách một slot như vậy đúng một lần chỉnh sửa — một ký tự được chèn, xóa hoặc thay thế, hoặc hai ký tự liền kề bị hoán đổi — và selector của slot đó không được Feature đính kèm thỏa mãn. Đó là hình dạng của một lỗi gõ tên slot, và lint nêu cả hai cách viết để tác giả thấy được cặp này.
Lý do tồn tại. Việc khai báo một slot không đóng bề mặt đính kèm: một đính kèm dưới tên mà không slot nào khai báo là hợp lệ, vì chính sự mở này cho phép một thực thể catalog phục vụ cả một đính kèm lấp slot lẫn một thông tin xác thực được chia sẻ ở phạm vi rộng hơn. Cái giá phải trả là một tên slot bị viết sai sẽ âm thầm trở thành một đính kèm tự do thay vì lấp slot mà tác giả muốn — bản build thành công và slot đó cứ thế để trống. Lint là biện pháp giảm thiểu được công bố cho đúng trường hợp đó.
Vị trí trong pipeline. Lint chạy ở bước phân giải, trong cùng lượt với các kiểm tra ngữ nghĩa có nhận biết catalog, trên Aggregate đã được phân giải. Nó duyệt tên đính kèm của mọi instance component, đối chiếu với tên các slot đã khai báo của kiểu Component của instance đó, và phát ra một cảnh báo cho mỗi cặp gần trùng.
Dạng xuất ra:
lint: attachment name is a near miss for a declared slot (Aggregate nearmiss, at .spec.components.db.features.app_user_passwrod, "app_user_passwrod", on component type "core/datastore/postgres", near the declared slot "app_user_password")Giá trị đầu tiên trong ngoặc kép là tên mà đính kèm được viết dưới đó, cũng là điều câu mở đầu của cảnh báo nói đến. Hai giá trị tiếp theo được giới thiệu bằng những từ cho biết chúng là gì: kiểu Component mà đính kèm nằm trên, và slot đã khai báo mà nó cách một lần chỉnh sửa.
Hiển thị trong trình soạn thảo. Cảnh báo cũng đến được phần chẩn đoán của trình soạn thảo thông qua language server, ở mức độ cảnh báo, đặt tại khóa đính kèm vi phạm. Tác giả không bao giờ đọc đầu ra terminal vẫn thấy được cặp này. Nó được phát ra trước giai đoạn render artifact, nên không cần tùy chọn nào: một phiên trình soạn thảo hiển thị nó bất kể serve.build_on_inspect có bật hay không.
Ngưỡng và sự đánh đổi của nó. Lint chỉ ghép cặp các tên cách nhau đúng một lần chỉnh sửa, và chỉ khi cả hai tên dài ít nhất bốn ký tự. Dưới độ dài đó, hầu như mọi tên ngắn đều cách mọi tên khác một lần chỉnh sửa, nên việc ghép cặp sẽ tạo ra nhiễu thay vì tín hiệu; trên một lần chỉnh sửa, các cặp không còn giống lỗi gõ. Một phép hoán vị được tính là một lần chỉnh sửa chứ không phải hai, vì hai ký tự bị hoán đổi là lỗi phổ biến nhất và một cách tính chặt hơn sẽ bỏ sót nó.
Ghi chú cho tác giả. Lint chỉ mang tính khuyến nghị và không bao giờ thay đổi kết quả của bản build — trình biên dịch không kiểm soát việc tác giả đặt tên cho một đính kèm. Tác giả cố ý đính kèm một Feature dưới một tên giống một slot có thể bỏ qua cảnh báo; đính kèm hoạt động đúng như được viết.
Không áp dụng khi Feature phù hợp với slot. Một tên cách một slot một lần chỉnh sửa mà selector của slot đó được Feature đính kèm thỏa mãn thì không gây cảnh báo. Cặp đó không phải là một đính kèm tự do bị gõ sai mà là một lần lấp slot được viết dưới tên khác, và việc nó có quan trọng hay không phụ thuộc vào việc slot cuối cùng có để trống hay không, điều chỉ biết được khi mọi phạm vi đã được gộp lại. Khi slot bị để trống, bản build dừng lại và nêu tên đính kèm cùng slot — xem “An attachment written under another name fits a slot its component leaves empty (Một đính kèm được viết dưới tên khác phù hợp với một slot mà component của nó để trống)” trong fatal-halts.md — nên việc dừng là phát hiện duy nhất được báo cáo, không bao giờ kèm một cảnh báo bên cạnh. Khi có thứ khác ràng buộc slot, đính kèm là một đính kèm bổ sung thông thường và không có gì được báo cáo. Một slot không khai báo selector thì không Feature nào phù hợp, nên một tên gần slot như vậy luôn gây cảnh báo.
Không áp dụng trên một kết nối. Lint đọc khối features: riêng của một component, vốn là mở. Các đính kèm mà một kết nối mang theo được định khóa bởi các slot mà socket của nó khai báo và không gì khác, nên một tên cách một trong các slot đó một lần chỉnh sửa là không hợp lệ ở đó: thay vào đó bản build dừng lại, và thông báo dừng nêu slot mà tên đó nằm gần ngay trong cùng câu. Không có cảnh báo nào được phát ra bên cạnh. Xem “A connection carries an attachment under a name its socket declares no slot for (Một kết nối mang một đính kèm dưới tên mà socket của nó không khai báo slot nào)” trong fatal-halts.md.
Lint gần khớp socket của uses
Kích hoạt khi khối uses: riêng của một component nêu tên một socket không thuộc các socket usesSchema đã khai báo của kiểu Component của nó, nhưng chỉ cách một socket như vậy một lần sửa — một ký tự được chèn, xóa hoặc thay thế, hoặc hai ký tự liền kề bị hoán đổi. Đó là hình dạng của một lỗi gõ tên socket, và lint nêu cả hai cách viết để tác giả thấy được cặp này.
Lý do tồn tại. Việc khai báo một socket không đóng bề mặt uses: trên component riêng của nhà phát triển: một tên socket không được mục usesSchema nào khai báo vẫn hợp lệ, vì việc catalog không nói gì về một socket có nghĩa là kết nối đó chưa được dự liệu chứ không phải bị cấm, và nhà phát triển là người sở hữu topology của Aggregate. Cái giá phải trả là một tên socket viết sai trở thành một kết nối ad-hoc riêng thay vì nối socket mà tác giả định nói tới — bản build thành công, socket dự định chỉ đơn giản là vẫn chưa được nối, và cạnh ad-hoc không mang selector nào cũng như không có hợp đồng theo từng cạnh nào. Lint là biện pháp giảm thiểu được công bố cho đúng trường hợp đó. Về những gì một socket ad-hoc mất đi và những gì nó giữ lại, xem entities/component.md “Topology Sockets: usesSchema”.
Bề mặt được bao quát. Chỉ khối uses: riêng của component — bề mặt duy nhất nơi một tên socket chưa khai báo được chấp nhận. uses: của một attachment Feature chỉ được nêu tên một socket mà Feature được gắn khai báo, và uses: theo từng cạnh của một Release chỉ được nêu tên một socket mà Component tiêu thụ khai báo; một tên sai ở một trong hai chỗ đó đã dừng bản build, nên một cảnh báo không có gì để bổ sung.
Vị trí trong pipeline. Lint chạy ở giai đoạn phân giải, trong cùng lượt với các guard ngữ nghĩa có nhận biết catalog, trên Aggregate đã được phân giải. Nó duyệt các tên socket riêng của mọi instance component so với các tên socket đã khai báo của kiểu Component của instance đó, và phát ra một cảnh báo cho mỗi cặp gần khớp. Một component đến từ một sub-aggregate không được bao quát: các component bên trong của nó được gộp vào đồ thị sau khi lượt này chạy.
Dạng xuất ra:
lint: uses socket name is a near miss for a declared socket (Aggregate aggregate, at .spec.components.web, "databses", on component type "core/devtool/adminer", near the declared socket "databases")Giá trị đầu tiên trong dấu ngoặc kép là tên socket mà tác giả đã viết, chính là điều câu mở đầu của cảnh báo đề cập. Hai giá trị tiếp theo được giới thiệu bằng những từ cho biết chúng là gì: kiểu Component mà socket được nêu tên trên đó, và socket đã khai báo mà nó cách một lần sửa. Hệ quả mà cảnh báo không nói rõ là điều đã mô tả ở trên: tên viết sai là một kết nối ad-hoc, nên nó không mang selector nào và không có hợp đồng theo từng cạnh nào, và socket mà tác giả định nói tới vẫn chưa được nối.
Hiển thị trong trình soạn thảo. Cảnh báo cũng đến được phần chẩn đoán của trình soạn thảo thông qua language server, ở mức độ cảnh báo, đặt tại component có khối uses: chứa tên vi phạm. Một tác giả không bao giờ đọc đầu ra terminal vẫn thấy được cặp này. Nó được đưa ra trước giai đoạn render artifact, nên không cần tùy chọn nào: một phiên trình soạn thảo hiển thị nó dù serve.build_on_inspect có bật hay không.
Ngưỡng và sự đánh đổi của nó. Lint chỉ ghép cặp các tên ở khoảng cách một lần sửa, và chỉ khi cả hai tên dài ít nhất bốn ký tự — cùng giới hạn mà lint gần khớp attachment-slot sử dụng, vì cùng lý do. Dưới độ dài đó, gần như mọi tên ngắn đều cách mọi tên khác một lần sửa, nên ghép cặp chúng sẽ tạo ra nhiễu thay vì tín hiệu; trên một lần sửa, các cặp không còn giống lỗi gõ. Một phép hoán vị được tính là một lần sửa chứ không phải hai, vì một cặp ký tự bị hoán đổi là lỗi phổ biến nhất và một cách đếm chặt hơn sẽ bỏ sót nó.
Ghi chú cho tác giả. Lint chỉ mang tính tư vấn và không bao giờ thay đổi kết luận của bản build — trình biên dịch không kiểm soát việc tác giả đặt tên socket như thế nào. Một tác giả cố ý tạo một kết nối ad-hoc dưới một tên giống với một socket đã khai báo (một kết nối cache bên cạnh một socket caches đã khai báo, dành cho mục đích khác) có thể bỏ qua cảnh báo; cạnh hoạt động đúng như đã viết. Không có flag nào để tắt nó, và cũng không cần: nó không ảnh hưởng gì đến kết luận.
Lint khóa provides không được khai báo
Kích hoạt khi Recipe được gắn với một thực thể component công bố trong provides: của nó một khóa mà kiểu Component của thực thể đó không khai báo trong hợp đồng spec.schema.provides: của mình.
Lý do tồn tại. Việc công bố nhiều hơn những gì Component khai báo là hợp lệ và vẫn sẽ hợp lệ: hợp đồng provides yêu cầu tập con và cho phép tập cha, nên một Recipe bao phủ hợp đồng của Component của nó và phát ra thêm các khóa khác vẫn là một Recipe thực hiện hợp đồng đó. Điều lint nêu ra là một hệ quả mà nếu không thì sẽ vô hình từ cả hai phía. Một bên tiêu thụ đọc qua một cạnh uses: sẽ thấy hợp đồng đã khai báo của đích chứ không phải bất cứ thứ gì Recipe của đích tình cờ phát ra — chính điều đó giữ cho các Recipes có thể hoán đổi cho nhau, vì khi đó hai Recipes hiện thực hóa một Component sẽ trình bày cùng một bề mặt cho bên tiêu thụ, và việc hoán đổi chúng không thể âm thầm rút lại một khóa mà bên tiêu thụ đã phụ thuộc vào. Vì vậy, một khóa không được khai báo sẽ không được chuyển qua cạnh, và một template tiêu thụ đọc khóa đó sẽ render ra giá trị rỗng thay vì thất bại.
Phát hiện được nêu tại nguyên nhân của nó — trên Recipe đã công bố khóa — vì đó là nơi có thể gọi tên nó. Tại bên tiêu thụ, khóa là một tham chiếu template mà trình biên dịch không thể quy cho một đích cụ thể, và một chẩn đoán dựa trên phỏng đoán sẽ còn tệ hơn không có. Vì vậy hai thứ này được cố ý không đặt cùng chỗ: giá trị rỗng xuất hiện tại bên tiêu thụ, lời giải thích ở đây, và cả hai đều xuất hiện trong cùng một đầu ra build.
Cặp nào được so sánh. Các khóa provides: do tác giả viết của Recipe được gắn, so với các khóa spec.schema.provides: đã khai báo của kiểu Component. Tập đã khai báo đó cũng chính là tập mà một khóa from: bên trong khối inject: được kiểm tra, nên cả hai thống nhất về những gì một Component khai báo. Phép so sánh là chính xác chứ không phải phép thử độ giống nhau, nên khác với hai lint near-miss ở trên, nó không có ngưỡng và không ghép cặp tên nào.
Recipe được so sánh là Recipe mà thực thể thực sự được gắn với, được khớp theo cùng tên thực thể và kiểu catalog mà quá trình render dùng để gắn, nên một ghi đè Recipe theo từng thực thể trong Manifest được tôn trọng chứ không bị san bằng. Một thực thể component có kiểu không phân giải ra Component nào trong catalog sẽ bị bỏ qua: không có khai báo nào được đọc, và điều đó không giống với một khai báo rỗng.
Vị trí trong pipeline. Lint chạy ở bước phân giải, trong cùng lượt với các bộ bảo vệ ngữ nghĩa có nhận biết catalog, trên Aggregate đã được phân giải — trước khi kết xuất, nên nó xuất hiện từ aggrega validate --release cũng như từ aggrega build. Cả các Components được khai báo ở gốc của Aggregate lẫn các component lồng trong các subsystem đều được bao quát. Một component đến từ một sub-aggregate thì không được bao quát: các component bên trong của nó được gộp vào đồ thị sau khi lượt này chạy, nên khóa không được khai báo của một component như vậy vẫn bị giữ lại không giao cho các bên tiêu thụ nhưng không có cảnh báo nào nêu tên nó.
Dạng phát ra. Mỗi dòng cho một thực thể component và một khóa, nêu tên Recipe đã công bố khóa và Component không khai báo nó:
lint: Recipe publishes a provides key its Component does not declare (Recipe broker-with-region, at .spec.provides.region, "region", on component type "core/ai-model/openai-compatible", bound to component instance "gateway")Phát hiện thuộc về thực thể mang nó, nên mười thực thể của cùng một kiểu Component công bố cùng một khóa không được khai báo sẽ tạo ra mười dòng chứ không phải một, mỗi dòng nêu tên thực thể của riêng nó. Mỗi dòng được quy cho Recipe đã công bố khóa, vì đó là tài liệu bạn chỉnh sửa để giải quyết nó. Quá trình duyệt là tất định, nên cùng một đầu vào cho ra cùng một chuỗi cảnh báo ở mọi lần chạy.
Hiển thị trong trình soạn thảo. Cảnh báo cũng đến được phần chẩn đoán của trình soạn thảo thông qua language server, ở mức độ warning, được đặt trên thực thể component có type: gắn với Recipe. Một tác giả không bao giờ đọc đầu ra terminal vẫn thấy nó. Nó được phát ra trước giai đoạn render artifact, nên không cần công tắc nào: một phiên trình soạn thảo hiển thị nó dù serve.build_on_inspect có bật hay không.
Ghi chú cho tác giả. Lint chỉ mang tính tư vấn và không bao giờ thay đổi kết quả của build — một Recipe công bố nhiều hơn những gì Component của nó khai báo vẫn build được. Cách khắc phục là một trong hai, và cách nào đúng là do tác giả quyết định: khai báo khóa trên Component khi bên tiêu thụ cần đọc nó, hoặc để nó không được khai báo khi đó là trạng thái làm việc riêng của Recipe, trong trường hợp đó locals: là nơi dành cho trạng thái như vậy. Trường hợp ngược lại thì không chỉ là tư vấn: một Component khai báo một khóa mà Recipe của nó không công bố sẽ khiến hợp đồng không được thực hiện và dừng build.
Cảnh báo của Ghost Infrastructure Tracker
Phát sinh khi một khóa mà tác giả đã khai báo đến được một nút nhưng không template nào do Recipe được gắn khai báo tham chiếu đến nó. Các khóa không được đọc trở thành hạ tầng im lặng: cấu hình mà nhà phát triển hoặc người vận hành yêu cầu nhưng Recipe không bao giờ đưa vào đầu ra được kết xuất. Tracker làm lộ chúng ra để sự chênh lệch giữa những gì được viết và những gì đầu ra mang theo được nhìn thấy thay vì im lặng.
Những khóa được viết nào được so sánh. Ba nhóm, theo từng nút:
.values— trụ cột phía nhà phát triển của chính nút đó..infra— trụ cột phía người vận hành của chính nút đó..context.uses.<alias>.values— các giá trị theo từng kết nối được mang trên mỗi cạnhuses:mà nút tiêu thụ qua đó. Nhóm này tự nhiên đã được giới hạn theo bên tiêu thụ: bản đồusescủa một nút chỉ chứa các cạnh mà nút đó là nguồn, nên một giá trị theo kết nối không được đọc luôn được quy cho nút đã viết ra nó và không bao giờ cho đích của cạnh.
Những tham chiếu nào được thu thập. Mọi template mà Recipe được gắn khai báo. Cảnh báo nói rằng một khóa được đọc bởi không gì cả, đó là một khẳng định về toàn bộ Recipe, nên bất cứ phạm vi nào hẹp hơn toàn bộ Recipe sẽ khiến nó sai thay vì gần đúng — một khóa mà một tọa độ source: tiêu thụ sẽ bị báo là không được đọc bởi chính lần chạy đã tải phiên bản mà nó chỉ định. Các khối được đọc là:
valuesMapping:, lớp phủ giá trị được chuyển cho provider.source:— toàn bộ trường khi nó được viết dưới dạng một chuỗi đơn, và mọi trường có giá trị chuỗi của nó khi nó được viết dưới dạng một đối tượng. Một tọa độ nguồn là một template được đánh giá theo từng instance tiêu thụ, nên một phiên bản, một tên chart, một tham chiếu git hoặc một thư mục con module được chọn từ.valueshoặc.infrasẽ đọc các khóa đó.locals:vàprovides:, từng mục.assertions:, từng mục.workload:, phần thân Workload được tổng hợp.artifacts:, nội dung của từng mục.pipeline:, đầu vàowith:của từng bước và cổngwhen:của nó.
Có ba giới hạn đi kèm, và cả ba đều là giới hạn về những gì có thể khẳng định một cách trung thực chứ không phải là lựa chọn. Mỗi giới hạn làm im lặng việc đọc thay vì mở rộng nó, đó là hướng ít tốn kém nhất: một khóa không được báo cáo khiến người đọc mất một thông báo mà họ vẫn có thể tìm ra bằng cách đọc Recipe, còn một khóa bị báo cáo sai sẽ nói với họ rằng một thiết lập đang hoạt động đã bị bỏ qua.
- Một Recipe không có
valuesMapping:nội tuyến hoàn toàn không được đọc. Các khóa của nó bị bỏ qua thay vì được báo cáo, bất kể các template khác của nó làm gì. - Một khối mà Recipe nhập từ một tệp hoặc từ một tham chiếu thư viện chưa có sẵn tại thời điểm này, nên không thể thu thập các tham chiếu của nó. Các khóa của nút bị bỏ qua hoàn toàn thay vì được báo cáo — điều đó áp dụng như nhau cho một
valuesMapping:được nhập, mộtworkload:được nhập và một mụcartifacts:được nhập. - Một template không phân tích cú pháp được sẽ không tạo ra tập tham chiếu nào. Báo cáo mọi khóa là không được đọc sẽ chôn vùi chẩn đoán phân tích cú pháp mà quá trình đánh giá đưa ra cho cùng template đó, nên thay vào đó không có gì được báo cáo. Một mục
artifacts:được đọc với các dấu phân cách chuẩn{{ }}, vốn không phải là cặp mà mọi provider khai báo cho trường đó; khi đọc với cặp sai, phần thân như vậy tạo ra những tham chiếu mà tác giả của nó chưa bao giờ viết, hoặc không phân tích cú pháp được, và cả hai kết quả chỉ có thể làm im lặng một cảnh báo.
valueSchema của một socket không bao giờ bị đánh dấu. usesSchema.<socket>.valueSchema khai báo hợp đồng mà một giá trị theo kết nối phải thỏa mãn. Nó là một schema, không phải một instance được viết, và nó không nằm trong các đầu vào được so sánh — nên nó không bao giờ có thể bị báo cáo. Những gì giá trị mặc định được khai báo của một socket tạo ra là một instance như mọi instance khác, được đọc hay không được đọc tùy theo chính nó.
Một tham chiếu chỉ định cả một trụ cột tính mọi khóa bên dưới nó là đã được đọc. {{ .infra.port }} đánh dấu port là đã đọc và để các khóa khác của trụ cột vẫn có thể bị cảnh báo. {{ optional .infra `port` 8080 }} chuyển toàn bộ bản đồ .infra cho một hàm, nên tham chiếu được thu thập chỉ định trụ cột thay vì một khóa bên dưới nó, mọi khóa trong trụ cột đó được tính là đã đọc, và trụ cột không đưa ra cảnh báo nào. Điều tương tự áp dụng khi dùng range trên một trụ cột và khi truy cập một mục uses qua index. Tác giả Recipe muốn có độ bao phủ theo từng khóa thì viết tham chiếu theo từng khóa.
Điều đó áp dụng cho mọi khối ở trên, và đáng biết trước khi một trụ cột im lặng bị hiểu là một cảnh báo bị bỏ sót: một Recipe có phiên bản source: được viết là {{ optional .infra `source_version` "1.2.3" }} đã chuyển toàn bộ bản đồ .infra cho một hàm, nên Recipe đó không báo cáo gì về bất kỳ khóa .infra nào trên bất kỳ nút nào nó kết xuất. Trụ cột .values không bị ảnh hưởng — hai trụ cột được tính riêng.
Vị trí trong pipeline. Tracker chạy ở giai đoạn kết xuất cơ sở, cùng với việc đánh giá template. Mỗi template của Recipe được phân tích cú pháp và duyệt để thu thập các đường dẫn trường dạng chấm mà nó tham chiếu (.values.port, .infra.replicas, .context.uses.<alias>.values.retry_budget); tập khóa đã phân giải của mỗi nhóm được so sánh với hợp của các tham chiếu đó, và phần chênh lệch là tập không được đọc. Thứ được duyệt là Recipe như đã viết: một tọa độ source: được đọc như văn bản template của nó, không phải như giá trị mà template đó đã tạo ra cho instance này.
Dạng đầu ra. Mỗi khóa không được đọc một dòng, nêu tên nút, đường dẫn của nhóm, khóa, và Recipe mà không template nào của nó đọc khóa đó:
warning: node "data.main-db": .values key "database_name" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "data.main-db": .infra key "storage_class" is read by no template in recipe "helm-postgres-sourced-with-artifacts" — correct the spelling, or remove the key warning: node "frontend": .context.uses.my-api.values key "retry_budget" is read by no template in recipe "helm-web-ui-sourced-with-artifacts" — correct the spelling, or remove the keyDòng này không nêu trường nào của Recipe, và đó là có chủ ý: người viết khóa là nhà phát triển, người vận hành, hoặc tác giả của cạnh uses: mà khóa đi kèm, và không ai trong số họ chỉnh sửa Recipe. Nêu tên khối nơi tham chiếu được tìm sẽ đưa cho người đọc đó một tọa độ trong một tài liệu mà họ không mở. Hai cách khắc phục mà dòng này đưa ra là hai cách họ có thể thực hiện — một khóa viết sai chính tả là nguyên nhân phổ biến, và một khóa vốn sẽ không bao giờ được đọc thì nên xóa.
Thứ tự là cố định: .values của nút, rồi .infra của nó, rồi từng alias uses theo thứ tự các cạnh được phát ra, các khóa được sắp xếp trong mỗi nhóm. Do đó cùng một đầu vào tạo ra cùng một chuỗi cảnh báo ở mọi lần chạy.
Hiển thị trong trình soạn thảo. Cảnh báo chỉ đến được chẩn đoán của trình soạn thảo khi language server chạy giai đoạn kết xuất artifact trong lúc kiểm tra một đồ thị IR — aggrega serve --build-on-inspect, hoặc khóa cấu hình serve.build_on_inspect mà nó ghi đè, vốn tắt theo mặc định. Tùy chọn đó thêm các thông báo mà một lần build đưa ra trong lúc kết xuất, và không thêm kiểm tra nào khiến build dừng. Mục này nêu tên một nút chứ không phải một khóa được viết, nên nó được hiển thị trên khóa kind: của Aggregate.
Vì sao là cảnh báo mà không phải dừng nghiêm trọng. Nhà phát triển có thể tiêu thụ các tập con .values khác nhau một cách hợp lệ trong logic template có điều kiện — một Recipe có template rẽ nhánh theo .values.mode sẽ đọc mode nhưng chỉ đọc .values.replication_password có điều kiện khi mode == "replication". Việc duyệt tĩnh không thể biết một khóa không được tham chiếu là không quan trọng hay là lỗi. Mục đích của tracker là làm cho sự chênh lệch được nhìn thấy chứ không phải kiểm soát nó; sự bỏ sót im lặng là kiểu lỗi mà tracker ngăn chặn.
Phản hồi của tác giả Recipe. Khi tác giả Recipe thấy một cảnh báo Ghost Infrastructure cho một khóa mà họ mong Recipe tiêu thụ, cách khắc phục là đưa khóa đó vào template. Khi khóa không được đọc là một sự bỏ qua có chủ ý (một tính năng mà chart không hỗ trợ, một tiện ích viết mà Recipe cố ý bỏ qua), tác giả có thể ghi lại sự bỏ qua đó trong chú thích đầu của Recipe để người đọc sau này biết sự chênh lệch là có chủ đích.
Cảnh báo tham số đã khai báo nhưng không được đọc
Phát sinh khi một Aggregate khai báo một mục dưới spec.parameters: và không có tham chiếu {{ .parameters.<key> }} nào trong chính văn bản của Aggregate đó đọc nó.
Một tham số đã khai báo là bề mặt soạn thảo để thay đổi một giá trị theo từng Release: Release đáp ứng khai báo, và một tham chiếu mang giá trị đã được đáp ứng vào các giá trị component mà nó thuộc về. Một khai báo không được gì đọc khiến sự thay đổi đó không có nơi nào để đến — dù một Release cung cấp gì cho nó, đầu ra được kết xuất vẫn như nhau. Đây là dạng ở phạm vi tham số của cùng dấu hiệu bất thường mà một khóa values đã soạn nhưng không được gì tiêu thụ mang theo.
Giá trị mặc định không phải là ngoại lệ. Một giá trị mặc định không được tham chiếu nào đọc cũng không đến được đầu ra, giống như một giá trị do Release cung cấp, nên một khai báo có giá trị mặc định được báo cáo đúng như một khai báo trống.
Những tham chiếu nào được thu thập. Chính văn bản của Aggregate, và không gì khác. Có ba hệ quả:
- Một tham số chỉ được vị từ
validate:của một schema Component chạm tới thì không hiển thị ở đây. Vị từ như vậy gọi tên tham số qua bản đồ tham số đã phân giải chứ không qua một tham chiếu có dấu chấm trong Aggregate, nên khai báo bị báo cáo là không được đọc dù vị từ có đọc nó. - Văn bản không phân tích được dưới dạng template sẽ không cho ra tập tham chiếu nào. Báo cáo mọi khai báo là không được đọc sẽ che lấp chẩn đoán mà quá trình nội suy đưa ra trên cùng văn bản đó, nên thay vào đó không có gì được báo cáo.
- Một tham chiếu gọi tên toàn bộ bản đồ
parameters— lặp qua nó, hoặc chạm tới một mục qua index — khiến mọi khai báo được tính là đã đọc, vì khi đó tham chiếu thu thập được gọi tên bản đồ chứ không phải một khóa bên dưới nó, và không thể đưa ra khẳng định nào theo từng khóa.
Vị trí trong pipeline. Việc đọc chạy ở giai đoạn phân giải, trên văn bản thô của Aggregate và hợp đồng tham số đã khai báo của nó — trước khi kết xuất. Vì vậy cảnh báo xuất hiện từ aggrega validate cũng như từ aggrega build.
Dạng đầu ra. Mỗi khai báo không được đọc một dòng, nêu tên Aggregate và locator của khai báo:
lint: declared parameter is read by no reference in the Aggregate (Aggregate fullstack-app, at .spec.parameters.unread_probe, "unread_probe")Các phát hiện xuất hiện theo thứ tự Aggregate khai báo các tham số của nó, nên cùng một Aggregate cho ra cùng một chuỗi trong mọi lần chạy. Mỗi phát hiện mang locator của khai báo, vốn nêu tên khóa vi phạm. Thông điệp cũng nêu tên khóa, đó là lý do nó xuất hiện hai lần trên một dòng terminal có in cả locator: trình soạn thảo hiển thị thông điệp tại vị trí nó đặt và không bao giờ hiển thị văn bản locator, nên một thông điệp bỏ sót khóa sẽ đọc giống hệt nhau cho mọi khai báo không được đọc.
Hiển thị trong trình soạn thảo. Cảnh báo này cũng đến được chẩn đoán của trình soạn thảo thông qua language server, ở mức độ warning, được đặt trên khai báo mà locator của nó nêu tên chứ không phải trên toàn bộ Aggregate. Nó được đưa ra trước giai đoạn kết xuất artifact, nên không cần tùy chọn nào: một phiên soạn thảo hiển thị nó dù serve.build_on_inspect có bật hay không.
Vì sao là cảnh báo mà không phải dừng nghiêm trọng. Một tham số có thể được khai báo trước tham chiếu sẽ đọc nó, và một lần duyệt tĩnh không thể phân biệt điều đó với một sai sót — cũng là lý do việc đọc khóa đã soạn chỉ đưa ra khuyến nghị. Trình biên dịch không kiểm soát việc tác giả để lộ những tùy chỉnh nào.
Cảnh báo năng lực không được phục vụ của liên kết Provider
Kích hoạt khi một mục dưới plugins.providers trong cấu hình workspace nêu một capability mà không có uri, và không plugin provider nào mà bản build đọc phục vụ năng lực đó. Các plugin mà một bản build đọc là những plugin trong các thư mục catalog của nó, các provider bên trong trình biên dịch, và các plugin mà lockfile của nó ghi lại.
Vì sao nó tồn tại. Một liên kết chỉ được đọc khi capability: của một Recipe yêu cầu năng lực của nó, và một mục không nêu plugin nào thì không chọn thêm thứ gì mà việc phân giải năng lực sẽ không tự chọn khi không có nó. Vì vậy một mục có năng lực bị viết sai chính tả — hlem thay cho helm — không được thứ gì tham khảo và không thay đổi gì, và nếu không có cảnh báo này thì không có gì báo cho bạn biết.
Vì sao là cảnh báo chứ không phải dừng nghiêm trọng. Các liên kết được viết một lần cho toàn bộ workspace, trong khi một bản build là của một Release. Plugin phục vụ năng lực đó có thể là plugin mà chỉ một Release khác trong workspace đọc, và bản build này không thể thấy nó, nên dừng ở đây sẽ là từ chối một workspace hợp lệ dựa trên phỏng đoán. Một mục cũng nêu một plugin là trường hợp khác: một lần pull sẽ phân giải mọi mục như vậy dù có Recipe nào dùng nó hay không, nên bản build nắm giữ plugin và biết nó phục vụ gì, và một năng lực mà plugin đó không phục vụ sẽ gây dừng — xem fatal-halts.md “A plugins.providers binding names a plugin that does not serve the capability (Một liên kết nêu một plugin không phục vụ năng lực đó)”. Một mục cho năng lực mà một plugin nào đó bản build đọc có phục vụ thì không bị báo gì, dù có Recipe nào trong Release này dùng nó hay không.
Vị trí trong pipeline. Mỗi lần build và mỗi lần xác thực một Release đều đọc từng mục trong cấu hình workspace đã được tổng hợp — các lớp cùng với các phần đi kèm providers_append của chúng — trước khi đồ thị của Release được phân tích, nên cảnh báo xuất hiện từ aggrega validate --release cũng như từ aggrega build, và từ aggrega pull, lệnh render Release một lần, dựa trên lockfile mà nó sắp ghi, để phát hiện các đầu vào bên ngoài mà một bản build của nó tải về. Phán định này không thay đổi gì về việc plugin nào render một Recipe; điều đó được đọc từ lockfile.
Dạng đầu ra. Mỗi mục một dòng, theo thứ tự trong danh sách đã tổng hợp, nêu năng lực và một năng lực được phục vụ cách một lần sửa, nếu có:
warning: plugins.providers entry names a capability no provider-rendering plugin the build reads serves: capability "hlem", which is one edit from "helm"; the entry names no plugin, so it selects nothing a Recipe would not resolve without it, and none of the plugins this build reads — in the catalog directories, inside the compiler, or among those the lockfile records — serves the capability: correct its spelling, or keep it where the plugin serving it is one only another Release readsNgưỡng. Một cách viết chỉ được gợi ý khi cách đúng một lần sửa và chỉ khi cả hai tên dài ít nhất bốn ký tự, cùng giới hạn mà các lint near-miss ở trên dùng và vì cùng lý do.
Hiển thị trong trình soạn thảo. Cảnh báo đến các chẩn đoán của trình soạn thảo thông qua language server ở mức độ cảnh báo. Mục này nằm trong tệp cấu hình chứ không phải trong tài liệu đang được chỉnh sửa, nên nó được đặt ở đầu tài liệu đó thay vì trên một khóa.
Phạm vi metadata theo từng thực thể
Phong bì thực thể nào mang metadata.labels và metadata.annotations thì khác nhau tùy theo loại. Component, Feature và các loại thư viện mang cả hai; Aggregate chỉ mang labels; Recipe, FeatureRecipe, Manifest, Release và Plugin không chấp nhận khóa nào trong hai khóa này ở cấp phong bì. Trạng thái của ngôn ngữ nêu vị trí theo từng thực thể và là nơi cần tra cứu.
Hiển thị trong trình soạn thảo. Không có cảnh báo tư vấn nào đề cập đến điều này, ở bất kỳ thiết lập nào: không có gì để báo cáo, vì một thực thể hoặc mang các khóa này hoặc không chấp nhận chúng, và một khóa mà một loại không chấp nhận là câu hỏi do schema của nó trả lời khi tài liệu được nạp, chứ không phải điều mà giai đoạn render báo cáo về sau. Người viết kiểm tra trang trạng thái thay vì chờ một cảnh báo.
Cảnh báo trường không được hỗ trợ
Một lớp duy nhất bao quát mọi thứ bạn đã viết mà đích không thể đáp ứng. Lớp này có hai thành viên — một trường Workload mà đích không thể biểu diễn, và một annotation aggrega.ai/ mà đích không xử lý — và chúng dùng chung một mã lớp và một cờ tắt, vì một tác giả muốn tắt “những thứ mà đích này bỏ qua” sẽ muốn tắt chúng cùng lúc thay vì tắt từng công tắc một.
Một trường Workload mà đích không thể biểu diễn
Các đích khác nhau về độ trung thực. Một trường Workload mà một đích biểu diễn được một cách tự nhiên có thể không có tương đương trên đích khác — chẳng hạn Docker Compose không có khái niệm ràng buộc lập lịch, service account hay priority class. Khi một Workload khai báo một trường như vậy và đích không thể biểu diễn nó, trường đó bị lược bỏ kèm theo cảnh báo, mỗi trường được viết một cảnh báo. Trường không bị loại bỏ một cách âm thầm, cũng không bị coi là lỗi nghiêm trọng.
Điểm khác biệt so với một lần dừng nghiêm trọng là mức độ chi tiết. Một dạng không được hỗ trợ sẽ dừng bản build một cách rõ ràng — đích hoàn toàn không thể tạo ra hình dạng workload đó. Một dạng được hỗ trợ nhưng mang một trường không thể biểu diễn vẫn được render, trừ trường đó, và thông báo như vậy.
Trên đích compose, lớp này hiện bao gồm scheduling, serviceAccount, replicas, runtimeClassName, priorityClassName, imagePullSecrets, dnsPolicy, dnsConfig.options, runAsNonRoot của container, và mọi khóa extended-resource ngoại trừ nvidia.com/gpu — ví dụ amd.com/gpu — vì khóa đó được dành riêng cho GPU NVIDIA. Các trường hợp dưới đây phát ra một biến thể một phần của cùng lớp, trong đó trường bị thu gọn thay vì bị xóa:
persistentTemplate— không có tạo mẫu volume theo từng replica, nên volume thu gọn thành một persistent volume dùng chung duy nhất thay vì biến mất.- Một mục
attachmentscủa container vớias: env— compose không thể lấy biến môi trường từ một attachment, nên biến được phát ra với giá trị rỗng. Cảnh báo nêu tên mục tại tọa độ đã viết của nó (containers.<name>.attachments.<KEY>, hoặcinitContainers[<i>].attachments.<KEY>với một mục init theo vị trí), nhờ đó biết rõ biến nào nhận giá trị rỗng và nó thuộc container nào. Một mục vớias: fileđược bind-mount bình thường và không phát ra gì. - Một mục
volumeskhông được container nào mount — cảnh báo nêu tên volume tại tọa độ đã viết của nó (volumes.<name>). Những gì xuất hiện trong đầu ra tùy thuộc vào biến thể: một volumepersistenthoặcpersistentTemplatevẫn được khai báo như một named volume, sau đó được tạo ra và bị bỏ không, trong khi một volumeconfigmap,secrethoặcephemeralchỉ xuất hiện trong đầu ra thông qua điểm mount của một container, nên khi không có gì mount nó thì khai báo không tạo ra đầu ra nào. Dù thế nào, volume bạn đã viết cũng không có tác dụng gì: hãy mount nó từ một container, hoặc xóa nó đi. Mọi container của workload đều được tính là bên mount, kể cả init container, nên một volume chỉ được một init container mount sẽ không phát ra gì. - Một khối
healthkhai báo nhiều hơn một slot probe — một service compose chỉ mang mộthealthcheckduy nhất, nên thứ tự ưu tiênlive > ready > startupgiữ lại một slot và mọi slot đã khai báo khác không xuất hiện ở bất kỳ phần nào của đầu ra. Cảnh báo nêu tên khối tại tọa độ đã viết của nó (containers.<name>.health, hoặcinitContainers[<i>].healthvới một mục init theo vị trí) và nêu tên cả slot đã được chuyển đổi lẫn các slot đã bị loại bỏ, nhờ đó biết rõ probe nào hoạt động trong đầu ra và ý định đã viết nào không có tác dụng. Một khối chỉ khai báo một slot được chuyển đổi không mất mát và không phát ra gì. hostNetworktrên một workload cũng khai báoinitContainers— service riêng của workload chạy trên mạng của node, nhưng mỗi init container trở thành một service riêng tự tham gia vào mạng boundary, vì việc dùng chung namespace của service chính sẽ khiến việc service chính chờ nó trở thành vòng lặp. Điều đó hẹp hơn hình dạng pod đang được mô hình hóa, trong đó mọi container dùng chung một namespace, nên sự khác biệt được nêu rõ thay vì để bị phát hiện lúc chạy. Một workload khai báohostNetworkmà không có init container được chuyển đổi không mất mát và không phát ra gì.
Một annotation mà đích không xử lý
Các annotation aggrega.ai/ là chỉ thị nền tảng mà một provider đọc và áp dụng cho những gì nó render — một namespace, một tiền tố registry, một service account. Provider đọc annotation nào là do chính provider đó khai báo, theo từng loại đầu vào, vì một provider sở hữu mọi trường của một đơn vị triển khai do chính nó tổng hợp thường không có chỗ để đặt cùng giá trị đó khi nó render một artifact được vendor. Well-Known Annotations là ma trận tra cứu.
Recipe riêng của một node và mỗi feature gắn vào node đó được render riêng biệt, mỗi cái thông qua đích mà capability: của chính nó chỉ định và ở các loại đầu vào mà source:, workload: và artifacts: của chính nó khai báo. Khi một annotation như vậy đến một trong các lần render đó và khai báo của đích đã phân giải không bao gồm khóa đó trên bất kỳ loại đầu vào nào mà lần render đó khai báo, đích không áp dụng gì cho khóa đó, và bản build thông báo bằng một cảnh báo nêu tên khóa, đích và mọi loại đầu vào mà lần render đó khai báo:
warning: node "frontend" (provider "helm-chart"): target "helm-chart" does not support annotation aggrega.ai/namespace on sourced input and ignored itNhững hệ quả sau đây xuất phát từ cách annotation đến một lần render, và mỗi hệ quả đều có chủ ý:
- Một dòng đã viết có thể tạo ra nhiều cảnh báo. Một annotation của boundary lan xuống mọi component bên dưới nó, và các component đó có thể render qua các đích khác nhau và các loại đầu vào khác nhau. Mỗi cảnh báo là một nhận định đúng về một lần render, nên bạn nhận một cảnh báo cho mỗi lần render không thể xử lý khóa đó — đây cũng chính là điều cho bạn biết những phần nào trong đầu ra bị ảnh hưởng.
- Một feature gắn vào một node được đánh giá dựa trên FeatureRecipe của chính nó, không dựa trên Recipe của node. Một attachment tự tạo tài nguyên riêng sẽ render chúng qua đích mà FeatureRecipe của nó chỉ định, ở các loại đầu vào mà FeatureRecipe đó khai báo — nên một annotation mà đích riêng của node áp dụng có thể không đến được gì trong các tệp của attachment, và điều ngược lại cũng đúng. Bạn được thông báo về từng cái một cách độc lập, vì chúng là các tệp khác nhau. Điều tương tự cũng đúng với một feature gắn vào một boundary thay vì vào một component cụ thể. Một attachment có FeatureRecipe không khai báo
source:,workload:hayartifacts:sẽ không render tệp riêng nào — nó đóng góp bằng cách chèn giá trị, bằng cạnhusesmà Feature của nó mang, hoặc bằng một pipeline trên các tài liệu do thứ khác phát ra — nên không có đầu ra riêng nào để một annotation bị thiếu, và không có cảnh báo nào cho nó. - Một lần render khai báo nhiều loại đầu vào được đánh giá trên tất cả các loại đó. Các loại đã khai báo của nó kết hợp theo phép cộng và đầu ra của chúng được cộng lại với nhau, nên một đích đọc khóa trên bất kỳ loại nào trong số đó sẽ áp dụng nó và giá trị xuất hiện trong đầu ra đã render. Trong trường hợp đó không có cảnh báo nào, vì không có gì để báo cáo. Cảnh báo chỉ xuất hiện khi mọi loại đã khai báo đều bỏ sót khóa, và nó nêu tên tất cả —
on sourced or synthesized input. - Chỉ các khóa
aggrega.ai/trần mới được kiểm tra. Một khóa có tiền tố con —compliance.aggrega.ai/data-class, hoặcacme.aggrega.ai/teamcủa riêng bạn — là từ vựng của bạn, mà trình biên dịch chuyển tiếp mà không diễn giải. Không bao giờ có cảnh báo nào về chúng. - Một đích không khai báo bất kỳ tuyên bố hỗ trợ nào sẽ không phát ra gì. Cảnh báo so sánh những gì bạn đã viết với những gì provider nói rằng nó đọc; một provider không nói gì thì không cho cảnh báo gì để so sánh, và việc suy ra sự từ chối từ sự im lặng sẽ báo cáo một tuyên bố mà tác giả provider chưa bao giờ đưa ra. Một provider không đọc khóa nào sẽ nói rõ điều đó bằng
readsNoWellKnownAnnotations: true, nhưterraformlàm, và khi đó mọi khóa trần đến được một lần render của nó đều bị cảnh báo.
Tại sao là cảnh báo mà không phải dừng. Một boundary trải hợp lệ trên các component ở các đích không đồng nhất sẽ luôn có một node nào đó không thể xử lý một khóa nhất định — đó là hình dạng bình thường của một Release trải trên nhiều đích, không phải lỗi — nên việc từ chối bản build sẽ bác bỏ các Releases đúng. Giá trị được chuyển qua nguyên vẹn, và cảnh báo cho bạn biết điều đó.
Mã lớp và bảo đảm ngoài luồng
Mỗi cảnh báo mang mã lớp ổn định, có thể so khớp bằng máy unsupported-field, để công cụ có thể so khớp theo lớp thay vì phân tích văn bản thông báo. Mọi thành viên của lớp — trường bị lược bỏ hoàn toàn, trường bị rút gọn dạng và annotation không được xử lý — đều mang cùng một mã đó, nhờ vậy một bộ lọc duy nhất có thể ẩn toàn bộ lớp. Các cảnh báo được truyền ngoài luồng so với các artifact được kết xuất, nghĩa là các byte được kết xuất giống hệt nhau từng byte dù cảnh báo có hiển thị hay không — việc ẩn chúng không thể thay đổi đầu ra của bạn.
Hiển thị trong trình soạn thảo. Mọi thành viên của lớp chỉ đến được phần chẩn đoán của trình soạn thảo khi language server chạy giai đoạn kết xuất artifact trong lúc kiểm tra một đồ thị IR — aggrega serve --build-on-inspect, hoặc khóa cấu hình serve.build_on_inspect mà nó ghi đè, vốn tắt theo mặc định. Tùy chọn đó bổ sung các thông báo tư vấn mà một bản build phát sinh trong khi kết xuất, và không bổ sung kiểm tra nào khiến bản build dừng lại. Mã lớp ở trên đi kèm chẩn đoán được công bố giống như trên dòng terminal, nên một client trình soạn thảo so khớp đúng lớp mà tác giả đọc được. Mỗi mục nêu tên một nút và một target thay vì một khóa soạn thảo, nên nó được hiển thị trên khóa kind: của Aggregate.
Ẩn lớp cảnh báo
Cả hai lệnh kết xuất đều chấp nhận --no-unsupported-field-warnings, cờ này chỉ ẩn riêng lớp này trong khi mọi cảnh báo kết xuất khác vẫn hiển thị:
aggrega build --release release.yaml --no-unsupported-field-warningsaggrega validate ./catalog/recipe/compose/mariadb/1.0.0/recipe.yaml --no-unsupported-field-warningsCờ này chỉ ảnh hưởng đến việc hiển thị và không thay đổi đầu ra được kết xuất. aggrega lint không có cờ tương đương vì nó không chạy lượt kết xuất nào — nó chỉ kiểm tra các quy ước xuất bản, nên không cảnh báo kết xuất nào có thể phát sinh ở đó.
Hãy dùng cờ này khi bạn đã chủ ý chấp nhận độ trung thực bị giảm — một target compose dùng cho phát triển cục bộ, nơi các trường scheduling và service-account của Workload production được dự kiến là không có tác dụng. Ngoài trường hợp đó, hãy để cờ tắt: cảnh báo là cách bạn biết rằng một trường bạn đã soạn không đến được target.
Một giá trị được khai báo là nhạy cảm được truyền dưới dạng literal
Phát sinh khi một attachment điền một slot bằng cách đưa một dữ liệu mà schema của nó khai báo là nhạy cảm vào một khóa phân phối dưới dạng giá trị literal, thay vì dưới dạng một tham chiếu mà target phân giải khi triển khai.
Dạng đầu ra. Mỗi khóa phân phối một dòng, nêu tên instance của attachment, cơ chế phân phối mà khóa rơi vào, và chính khóa đó, được gán cho node và target đã render nó:
warning: node "db" (provider "compose"): attachment "user_password" delivers a value declared sensitive to env delivery key "MARIADB_PASSWORD" as a literal; where the target supports it, fill the slot with an attachment that delivers a reference insteadMã lớp. Cảnh báo này mang mã lớp ổn định, có thể so khớp bằng máy sensitive-by-value, để công cụ so khớp theo lớp thay vì phân tích văn bản thông báo. Mã này đi kèm dòng trên terminal và chẩn đoán có cấu trúc mà language server công bố, nên tác giả và client của trình soạn thảo đọc cùng một lớp — theo điều kiện hiển thị trong trình soạn thảo bên dưới, điều kiện quyết định language server có công bố cảnh báo này hay không.
Hiển thị trong trình soạn thảo. Cảnh báo chỉ đến được chẩn đoán của trình soạn thảo khi language server chạy giai đoạn render artifact trong lúc kiểm tra một đồ thị IR — aggrega serve --build-on-inspect, hoặc khóa cấu hình serve.build_on_inspect mà nó ghi đè, vốn tắt theo mặc định. Tùy chọn đó bổ sung các cảnh báo mà một bản build phát sinh khi render, và không bổ sung kiểm tra nào khiến build dừng lại. Mục này nêu tên một node và một target thay vì một khóa khi soạn thảo, nên nó được hiển thị trên khóa kind: của Aggregate.
Đây là một lớp riêng, và --no-unsupported-field-warnings không bao gồm nó. Cờ đó làm im lặng lớp unsupported-field ở trên; cảnh báo này vẫn xuất hiện song song. Không có cờ nào làm im lặng cảnh báo này.
Bản build thành công và các byte được render không thay đổi. Cảnh báo này được truyền tách biệt khỏi các artifact được render, giống như lớp unsupported-field, nên những gì đến đầu ra của bạn là như nhau dù dòng này có xuất hiện hay không.
Một giá trị được khai báo nhạy cảm đến đích thông qua một ánh xạ values
Kích hoạt khi một lần render từ một source: trao cho đích của nó đầu ra của một valuesMapping: trong khi thực thể có các giá trị mà ánh xạ đó đọc khai báo một lá values là nhạy cảm: ánh xạ của một Recipe trên một lá mà Component của nó khai báo, hoặc ánh xạ của FeatureRecipe thuộc một Feature được gắn vào một component trên một lá mà Feature đó khai báo. Một ánh xạ là một template có các khóa đầu ra do chính nó tự đặt ra, nên không khai báo nào gọi tên bất kỳ khóa nào trong số đó, và đích không nhận được dấu đánh nhạy cảm theo từng khóa cho lá đó. Đây là dạng render duy nhất mà ở đó một khai báo không đến được khóa render nào trong khi tác giả vẫn nắm một đòn bẩy đối với nó.
Dạng đầu ra. Mỗi lá được khai báo một dòng, gọi tên lá tại tọa độ được viết của nó và Recipe hoặc FeatureRecipe có ánh xạ quyết định việc ghép nối, được quy cho node và đích đã render nó. Dòng cho một Feature được gắn bắt đầu bằng tên mà nó được gắn dưới đó, vì một component có thể mang nhiều lần gắn của cùng một Feature và nếu không thì các dòng của chúng sẽ giống hệt nhau — dòng thứ hai bên dưới là một Feature được gắn vào component api dưới tên token:
warning: node "api" (provider "terraform"): "values.token" is declared sensitive, but recipe "terraform/api" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a recipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with them warning: node "api" (provider "terraform"): attachment "token": "values.token" is declared sensitive, but FeatureRecipe "terraform/api-token" maps its values through a valuesMapping whose output keys no declaration names, so the target receives no per-key sensitivity marking for it; where the mapping reads it, the mapping's whole output is marked as carrying a value declared sensitive instead; a FeatureRecipe declaring no valuesMapping renders the declared leaf paths as its own keys, and the per-key marking travels with themĐòn bẩy là gì. Khi không có ánh xạ, các giá trị mà một lần render từ source nhận được được đánh khóa bằng chính các đường dẫn lá đã khai báo, nên khai báo ghép đúng với khóa render của nó và dấu đánh đi cùng nó — trên đích Terraform, đó là tệp override được sinh ra, được mô tả tại Các đầu vào module được khai báo nhạy cảm. Khi có ánh xạ, dấu đánh thực sự đến nơi bao trùm toàn bộ đầu ra của ánh xạ, và chỉ ở chỗ ánh xạ đọc giá trị đã khai báo: nó chi phối văn bản mà một plugin soạn khi từ chối hoặc cảnh báo, và không thay đổi byte render nào.
Ba dạng giữ im lặng, và là có chủ ý. Một lần render chỉ artifacts và một lần render chỉ workload không trao cho đích của chúng ánh xạ values nào cả, nên một lá values không có khóa render nào để đánh dấu ở đó, dù nó được viết thế nào. Một Feature được gắn vào một boundary cũng không gây ra cảnh báo nào, bất kể FeatureRecipe của nó ánh xạ gì: một boundary không mang khối values:, nên lần gắn như vậy render dựa trên một trụ values rỗng, không lá values nào của Feature đó có thể mang dữ liệu ở đó, và việc bỏ ánh xạ cũng sẽ không đánh dấu được gì. Mỗi trường hợp là một thuộc tính cố định của dạng đó chứ không phải điều tác giả có thể thay đổi, nên một cảnh báo về nó sẽ kích hoạt ở mọi lần build mà không chỉ ra việc gì để làm; giới hạn này thay vào đó được giảng giải tại Khai báo một lá là nhạy cảm. Một lần render từ một source: không có valuesMapping: cũng im lặng, vì ở đó dấu đánh đến được.
Mã lớp. Cảnh báo mang mã lớp ổn định, có thể so khớp bằng máy sensitivity-not-conveyed, nên công cụ so khớp theo lớp thay vì phân tích văn bản thông điệp: công cụ build của trợ lý liệt kê từng phát hiện dưới advisories cùng mã này. Nó gọi tên một lớp phát hiện chứ không phải một điều kiện đã đăng ký, nên nó không có hàng nào trong bảng ở đầu trang này.
Hiển thị trong trình soạn thảo. Cảnh báo đến được chẩn đoán của trình soạn thảo, ở mức độ warning và mang cùng dòng mà một lần build trên terminal in ra, bất cứ khi nào language server render Release — một lần build hoặc một bản xem trước build mà nó được yêu cầu, hoặc một lần kiểm tra đồ thị IR với aggrega serve --build-on-inspect, hoặc khóa cấu hình serve.build_on_inspect mà nó ghi đè, vốn tắt theo mặc định. Mục này gọi tên một node và một đích chứ không phải một khóa soạn thảo, nên nó được vẽ trên khóa kind: của Aggregate.
Đây là một lớp riêng, và --no-unsupported-field-warnings không bao gồm nó. Cờ đó tắt các thông báo về độ trung thực của một đích, một phán đoán khác được đưa ra vì những lý do khác; cảnh báo này vẫn xuất hiện cùng với nó. Không có cờ nào tắt được cảnh báo này.
Lần build thành công và các byte được render không thay đổi. Cảnh báo báo cáo một sự vắng mặt — không khóa render nào mang dấu đánh — và một ánh xạ là một dạng thông thường, được hỗ trợ, nên không có gì để dừng lại và không có gì trong đầu ra của bạn thay đổi dù dòng đó có xuất hiện hay không.
Một lệnh gọi module Terraform mà engine tải về khi khởi tạo
Phát sinh khi một module Terraform mà bản build vendor, hoặc phần thân Terraform được viết trong một Recipe, khai báo một khối module có source mà Terraform tải về khi cấu hình được khởi tạo thay vì đọc từ các tệp bản build đã đặt sẵn: một địa chỉ registry, một URL git, Mercurial hoặc kho lưu trữ HTTP, một bucket S3 hoặc GCS, hoặc một đường dẫn tuyệt đối — hoặc một đường dẫn cục bộ trèo ra khỏi module đã vendor, trỏ tới các tệp mà bản build không vendor. Tệp khóa cố định commit và digest kho lưu trữ của module đã vendor, còn tệp khóa phụ thuộc riêng của Terraform chỉ ghi lại các provider, nên module mà lệnh gọi như vậy chỉ định sẽ được tải về ở bất kỳ phiên bản nào engine chọn lúc đó, và không có gì bản build này ghi lại bao phủ nó.
Những gì được đọc. Các tệp cấu hình mà engine nạp khi module được gọi — các tệp nằm trực tiếp trong thư mục riêng của module và trong mỗi thư mục mà một source cục bộ đi tới từ đó — và không đọc gì trong thư mục không được gọi tới, nên một lệnh gọi viết trong thư mục examples/ hoặc tests/ của module sẽ không được báo cáo. Nó đọc những gì một source ghi và không bao giờ đọc module mà source đó chỉ định. Một tệp nằm dưới spec.boundary.artifacts của một Recipe được chính trình biên dịch đánh giá và ghi ra, không được giao cho provider nào, nên một khối module viết trong tệp đó không được đọc và không gây cảnh báo. Kiểm tra đầu vào theo cấu trúc trên trang provider nêu đầy đủ quy tắc.
Dạng thông báo. Mỗi lệnh gọi một dòng, nêu node và provider, sau đó là khối, tệp và dòng chứa khối, và source như được viết; một source trèo ra khỏi module sẽ nói rõ điều đó thay vì nêu một lượt tải về:
warning: node "app" (provider "terraform"): module "vpc" (main.tf, line 2) has the source "terraform-aws-modules/vpc/aws", which Terraform downloads when the configuration is initialised, at whatever version it then selects, so no commit or digest this build records covers that module warning: node "app" (provider "terraform"): module "shared" (main.tf, line 2) has the local source "../shared", which resolves outside the module this build placed, so Terraform reads whatever sits at that path when the configuration is initialised rather than files this build vendoredCác lệnh gọi xuất hiện theo thứ tự engine gặp chúng — thư mục riêng của module trước, sau đó là từng thư mục theo thứ tự một source cục bộ đi tới nó lần đầu, và trong một tệp thì theo thứ tự các khối được viết — nên cùng một đầu vào cho ra cùng một chuỗi ở mọi lần chạy. Mọi lần chạy có render đều phát sinh chúng: aggrega build; aggrega pull, lệnh render Release một lần để tìm ra những gì một bản build của nó tải về; và aggrega validate trên một Recipe có module nằm trong workspace, lệnh này render riêng Recipe đó.
Mã lớp. Mỗi cảnh báo mang mã lớp ổn định, máy có thể đối khớp, module-fetched-at-init, để công cụ đối khớp theo lớp thay vì phân tích văn bản thông báo. Mã này đi kèm chẩn đoán có cấu trúc: công cụ build của trợ lý liệt kê mỗi phát hiện dưới advisories cùng với mã, và language server công bố mã trên mỗi mục. Nó chỉ một lớp phát hiện chứ không phải một điều kiện đã đăng ký, nên nó không có hàng trong bảng ở đầu trang này.
Hiển thị trong trình soạn thảo. Cảnh báo đến được chẩn đoán của trình soạn thảo trên lớp aggrega-build, ở mức nghiêm trọng cảnh báo, bất cứ khi nào language server render Release — một bản build hoặc bản xem trước build được yêu cầu, hoặc một lần kiểm tra đồ thị IR với aggrega serve --build-on-inspect, hoặc khóa cấu hình serve.build_on_inspect mà cờ này ghi đè, mặc định tắt. Mục này chỉ một node chứ không phải một khóa soạn thảo, nên nó được hiển thị trên khóa kind: của Aggregate.
Đây là một lớp riêng, và không có cờ nào tắt được nó. --no-unsupported-field-warnings tắt lớp trường không được hỗ trợ và không bao gồm lớp này.
Bản build thành công và các byte được render không thay đổi. Cảnh báo được truyền tách biệt khỏi các artifact đã render, nên module đã vendor, phần thân được viết và cấu hình gốc giống hệt từng byte dù cảnh báo có xuất hiện hay không.
Vì sao là cảnh báo mà không phải dừng. Một module gọi một module khác là đầu vào hợp lệ: Terraform tải module được gọi về và cấu hình hoạt động. Điều tác giả đánh đổi là việc bản build ghim module đó, đây là một sự thật cần báo cáo chứ không phải lỗi cần từ chối, và việc tải về có chấp nhận được hay không là quyết định của tác giả.
Một plugin đã chạy mà không có digest được ghi lại để đối chiếu
Kích hoạt khi trình biên dịch sắp chạy một plugin, một digest được ghi lại lẽ ra phải quản lý các byte của plugin đó, và workspace không ghi lại digest nào cho nó. Plugin vẫn chạy; cảnh báo này là cách bạn biết rằng không có gì đã so sánh các byte nó chạy với các byte mà ai đó đã xem xét.
aggrega pull ghi digest của mọi plugin mà nó thu nhận vào lockfile của Release, và mọi lần phân giải sau đó đều so sánh các byte nó tìm thấy với digest đó. Một workspace chưa được pull, hoặc một workspace có lockfile cũ hơn một plugin mà cấu hình đã gắn vào sau đó, không có digest cho plugin đó — nên phép so sánh không có gì để so, và nếu không có dòng này thì nó sẽ đi qua một cách im lặng.
Một bước pipeline, một provider, hoặc một plugin được gắn tại vai trò phán quyết mà thực thể Plugin của nó được viết trong một trong các thư mục catalog của bạn cũng không có digest, và một lần pull không cung cấp digest cho nó: lần pull không bao giờ ghim một thực thể như vậy, và một lần build đọc .wasm của nó mới mỗi lần — từ bên cạnh thực thể, trong trường hợp thông thường — thay vì đối chiếu với bất cứ thứ gì một lần pull đã ghi lại. Một plugin được gắn tại vai trò biến đổi và được viết ở đó là ngoại lệ: các byte của nó định hình đầu ra được kết xuất, nên một lần pull ghi lại digest của .wasm mà nó tìm thấy cho plugin đó, và một khi đã ghi, một lần build sẽ kiểm tra plugin đó với digest và dòng này không được đưa ra cho nó.
warning: plugin "governance/label-injector:1.0.0" resolved from cache with no recorded digest to check it against, so it runs unverified; run `aggrega pull --release <release>` to record it warning: plugin "pipeline-step/patch" resolved from local with no recorded digest to check it against, so it runs unverified; it is read from beside its Plugin entity in a catalog directory on every build, and a pull records its digest only for a plugin attached at a transform role; otherwise publish the plugin and reference the published entity to have its digest recordedĐó là dòng mà một bản build, một lần pull hoặc một lần xác thực hiển thị cùng các cảnh báo khác của nó. Một lệnh phân giải plugin bên ngoài một lần chạy như vậy — cài đặt, liệt kê hoặc chạy các plugin dòng lệnh riêng của workspace, hoặc aggrega lint phân giải các plugin mà nó dùng để lint — in cùng câu đó trên một dòng riêng, không thụt lề.
Dòng này nêu tên nguồn mà các byte đến từ đó — cùng từ mà aggrega pull và aggrega plugin list dùng cho nó — và kết thúc bằng điều áp dụng cho nguồn đó. Với các byte từ bộ nhớ đệm nội dung, cách khắc phục là pull Release, việc này ghi lại digest và khiến mọi lần chạy sau của plugin đó đều được kiểm tra. Với các byte được đọc từ bên cạnh một thực thể Plugin trong một thư mục catalog, một lần pull chỉ ghi lại digest cho plugin được gắn tại vai trò biến đổi, và dòng này nói rõ điều đó: với bất kỳ plugin nào khác được viết ở đó, không lần pull nào thay đổi được, và cách đưa nó vào diện có digest được ghi lại là xuất bản nó và tham chiếu đến thực thể đã xuất bản.
Nó được hiển thị một lần cho mỗi plugin trong mỗi lệnh, bất kể lệnh đó phân giải plugin đó bao nhiêu lần. Một lần kết xuất phân giải provider của nó một lần cho mỗi node, và một bản build tự điền lockfile của chính nó có thể kết xuất Release nhiều hơn một lần; lặp lại dòng này mỗi lần sẽ chôn vùi nó. Dịch vụ trình soạn thảo hiển thị nó trên luồng lỗi riêng của mình một lần trong suốt thời gian chạy, trong khi mọi yêu cầu mà nó trả lời đều báo cáo lại nó cho trình soạn thảo — nên dù trình soạn thảo lấy thông tin từ câu trả lời nào, câu trả lời đó cũng cho bạn biết những plugin mà lần chạy đó đã dùng mà không được xác minh.
Hiển thị trong trình soạn thảo. Cảnh báo này đến các chẩn đoán của trình soạn thảo cùng với các advisory khác của lần chạy, ở mức độ nghiêm trọng cảnh báo: một lần xác thực Release công bố nó trên Aggregate của Release đó, và một bản build hoặc bản xem trước build mà trình soạn thảo yêu cầu công bố nó trên lớp aggrega-build. Nó nêu tên một plugin chứ không phải một khóa mà bạn đã viết, nên được đặt ở đầu tệp. Vì mỗi lần chạy báo cáo những gì nó đã phân giải, mục này vẫn còn chừng nào một lần chạy còn phân giải plugin mà không xác minh và biến mất ở lần chạy đầu tiên không làm vậy. Nó không thay đổi phán quyết nào và không làm thất bại lần phân giải nào, nên điều một phiên trả lời là như nhau dù nó có được hiển thị hay không.
Hai trường hợp phân giải không đưa ra gì, và không trường hợp nào là sơ suất:
- Một plugin mà trình biên dịch mang sẵn bên trong.
aggrega pullghi lại những gì nó đã tải về, và không có gì để tải về đối với các byte đi kèm trong tệp nhị phân — nên không bao giờ có digest nào được ghi lại cho plugin như vậy, và cũng không có gì bạn có thể chạy để thay đổi điều đó. Tệp nhị phân chính là danh tính của các byte đó. Các plugin riêng của trình biên dịch và phiên bản của chúng được liệt kê bởiaggrega plugin listvà được đóng dấu vào phầntoolchaincủa lockfile. - Một lần phân giải mà không digest nào từng được dự định áp dụng.
aggrega validate --plugin ./some.wasmtrỏ tới một tệp bạn đã nêu tên trên dòng lệnh, vàaggrega lintkiểm tra chính artifact mà nó đang kiểm tra; trong cả hai, plugin là đối tượng được xét chứ không phải một công cụ được tin cậy, nên không có bản ghi nào để đối chiếu nó.
Vì sao là cảnh báo chứ không phải dừng. Việc đọc một tài liệu đáng làm ngay cả trên một workspace chưa ai chuẩn bị — từ chối validate hoặc lint cho đến khi có người chạy aggrega pull sẽ khiến các lệnh báo cáo trở nên vô dụng đúng vào lúc chúng hữu ích nhất. aggrega build sẽ không tạo artifact nếu hoàn toàn không có lockfile, nên lần build chỉ gặp cảnh báo này đối với một plugin mà lockfile của nó không ghi digest — trường hợp thông thường là plugin được đọc từ bên cạnh thực thể của nó trong một thư mục catalog.
Khi thiếu lockfile thì lại bị từ chối. Khi một trình soạn thảo yêu cầu dịch vụ trình biên dịch cung cấp đồ thị của một Release và workspace hoàn toàn không có lockfile, dịch vụ sẽ dừng và yêu cầu một lockfile thay vì vẽ đồ thị. Một lockfile có tồn tại và chỉ đơn giản là không ghi digest cho một plugin thì thuộc trường hợp ở trên: plugin vẫn chạy, và cảnh báo này là cách bạn biết điều đó. Một đồ thị được vẽ ra là thứ người đọc sau đó dựa vào để suy luận, và một đồ thị được xây từ các byte chưa được xác minh sẽ trông giống hệt một đồ thị đã được kiểm tra. Xem aggrega serve.
Một kho lưu trữ đã phát hành chứa một mục mà Windows không thể dùng
Phát sinh khi aggrega push — hoặc --dry-run của nó — xuất bản một kho lưu trữ mà một trong các mục của nó chứa một phần Windows không thể chứa như đã viết: một tên Windows dành riêng cho thiết bị, chẳng hạn CON, PRN, AUX, NUL, COM1 hoặc LPT1, ở bất kỳ kiểu chữ hoa thường nào và với bất kỳ phần mở rộng nào theo sau, hoặc một phần kết thúc bằng dấu chấm hoặc dấu cách. aux/x.yaml chứa một phần như vậy trong thư mục của nó; report. và COM1.yaml chứa một phần như vậy trong tên tệp. Trên Windows, aggrega từ chối giải nén một mục như vậy, nên một workspace trên Windows hoàn toàn không thể dùng phiên bản đó. Cảnh báo phát sinh trên mọi nền tảng, vì một bản xuất bản dành cho bất kỳ ai kéo nó về, và đây là cách tác giả của nó biết điều này trước khi một người dùng Windows gặp phải.
Những gì nó đọc. Các tên mà kho lưu trữ sẽ chứa: tên tệp của chính tài liệu thực thể, rồi từng tệp mà thực thể nêu bên cạnh nó — các tệp mà Bundling liệt kê. Vì vậy, một tài liệu tên con.yaml nhập một tệp schema sẽ nhận cảnh báo cho chính tên của nó. Một thực thể không nêu tệp nào được xuất bản chỉ với tài liệu của nó, mà bên sử dụng đặt dưới một tên do sản phẩm chọn chứ không phải tên bạn đã viết, nên nó không bao giờ bị cảnh báo, dù tệp của nó có tên gì. Một Plugin không xuất bản kho lưu trữ nào và cũng không bao giờ bị cảnh báo.
Dạng đầu ra. Mỗi mục một dòng, trên standard error, theo thứ tự các tên được tạo thành — tài liệu trước, rồi các tệp nó mang theo thứ tự từ điển — trước phần tường thuật riêng của lần chạy thử hoặc của bản xuất bản trên standard output:
warning: an entry this publication carries cannot be used on Windows (the entry "aux/x.yaml", its segment "aux"). 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, so a workspace on Windows refuses to unpack the entry. This warning does not stop the publication; rename that segment to publish a version Windows can useGiá trị được trích dẫn đầu tiên là mục theo cách kho lưu trữ đặt tên nó. Giá trị thứ hai là phân đoạn đầu tiên trong các phân đoạn của nó — các phần mà dấu gạch chéo phân tách — mà Windows không thể chứa, tức là phần cần đổi tên. Dòng bắt đầu bằng câu cố định của điều kiện. Nó được đưa ra bởi việc xuất bản chứ không phải bởi một quy tắc mà bản dựng đánh giá, nên nó không có hàng nào trong bảng ở đầu trang này; bảng mọi điều kiện liệt kê nó dưới E0344.
Nó không từ chối gì cả. Lệnh push, hoặc lần chạy thử của nó, vẫn tiếp tục hoặc bị từ chối đúng như khi không có cảnh báo, và kết thúc như lẽ ra nó sẽ kết thúc.
Nó còn đến những đâu. Công cụ publish-entity của trợ lý trả lời với cùng các mục đó dưới dạng windows_unusable_entries, và aggrega serve trả lời aggrega/publishEntity với chúng dưới dạng windowsUnusableEntries; mỗi trường vắng mặt khi không có mục nào. Xem aggrega mcp và aggrega serve. Dịch vụ cũng chuyển chính dòng cảnh báo cho một yêu cầu đã yêu cầu được báo cáo, cùng với phần còn lại của tường thuật về bản xuất bản.
Khả năng hiển thị trong trình soạn thảo. Không có dưới dạng chẩn đoán: xuất bản không phải là một bản dựng, nên không có gì ở đây đến được danh sách vấn đề. Một trình soạn thảo xuất bản thông qua dịch vụ đọc windowsUnusableEntries trong câu trả lời.
Vì sao là cảnh báo chứ không phải dừng. Một tên như vậy là hợp lệ, và Linux cùng macOS dùng tệp đúng như tên của nó, nên từ chối bản xuất bản sẽ là từ chối một thực thể hoạt động tốt chỉ dựa trên phỏng đoán về ai sẽ kéo nó về. Có đổi tên hay không là quyết định của tác giả.