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.

appliesTo và bộ chọn

Hệ thống bổ ngữ quyết định một Feature gắn vào những nút nào. Một Feature khai báo các bộ chọn nhãn; công cụ so khớp nhãn gốc của trình biên dịch đánh giá chúng đối với metadata.labels của từng Component đích trong giai đoạn phân tích tĩnh. Cùng công cụ đó — và cùng ngữ pháp bộ chọn đó — cũng đánh giá các bộ chọn socket usesSchema để bảo đảm an toàn kiểu giữa các nút, nên một bộ từ vựng phục vụ mọi bề mặt bộ chọn trong ngôn ngữ.

Hai lớp bao

Một spec của Feature mang tối đa hai trường bộ chọn:

  • appliesTo — bề mặt kết hợp AND. Một chuỗi bộ chọn nhãn kiểu Kubernetes duy nhất; mọi yêu cầu phân tách bằng dấu phẩy đều phải thỏa mãn thì việc gắn mới hợp lệ.
  • appliesToAnyOf — bề mặt kết hợp OR. Một danh sách các mục bộ chọn; chỉ cần một mục khớp là việc gắn được thỏa mãn. Mỗi mục là hoặc một bộ chọn dạng chuỗi (cùng ngữ pháp với appliesTo, các yêu cầu bên trong chuỗi kết hợp AND), hoặc một map khóa-giá trị phẳng chỉ so khớp bằng phép bằng.

Khi một Feature khai báo cả hai, kết quả được kết hợp AND giữa các lớp bao: chuỗi appliesTo phải thỏa mãn và ít nhất một mục appliesToAnyOf phải khớp. Một bộ chọn bị bỏ qua hoặc rỗng không khai báo ràng buộc nào và khớp với mọi tập nhãn — một Feature không có trường nào trong hai trường này sẽ gắn vào bất cứ nơi nào nhà phát triển đặt nó.

spec:
appliesTo: "compliance.aggrega.ai/scope in (pci), tier notin (dev, staging)"
appliesToAnyOf:
- { component.aggrega.ai/type: stateful-server }
- "datastore.aggrega.ai/engine in (relational, document, vector)"

Ngữ pháp chuỗi

Chuỗi bộ chọn tuân theo cú pháp bộ chọn nhãn mà kubectl get -l chấp nhận: các yêu cầu phân tách bằng dấu phẩy, kết hợp AND, mỗi yêu cầu ở một trong sáu dạng:

DạngÝ nghĩa
key=valuenhãn tồn tại với đúng giá trị này
key!=valuenhãn không có, hoặc có với một giá trị khác
key in (v1, v2)giá trị của nhãn là một phần tử của tập
key notin (v1, v2)nhãn không có, hoặc giá trị của nó nằm ngoài tập
keynhãn tồn tại (giá trị bất kỳ)
!keynhãn không có

Khóa có thể mang tiền tố kiểu DNS (team.aggrega.ai/owner). Bộ từ vựng toán tử là một tập đóng gồm sáu toán tử; công cụ không hỗ trợ regex, so khớp chuỗi con hay so sánh số.

appliesTo: "component.aggrega.ai/type in (server, worker), !legacy.aggrega.ai/exempt"

Một yêu cầu nằm ngoài sáu dạng sẽ bị từ chối, không bao giờ bị đoán:

  • Một yêu cầu rỗng — một dấu phẩy ở đầu, ở cuối hoặc lặp đôi, hay một chuỗi chỉ gồm các dấu phân tách. "tier=frontend," và " , , " bị từ chối thay vì được đọc thành ít yêu cầu hơn, hoặc không có yêu cầu nào.
  • Một khóa chứa khoảng trắng hoặc một trong các ký tự của chính ngữ pháp — =, !, (, ) và dấu phẩy, vốn là những ký tự phân biệt dạng này với dạng khác. ! chỉ đặt tên một khóa nhãn, không gì khác, nên !tier=frontend bị từ chối: được viết ra để loại trừ frontend, nếu không nó sẽ được đọc là “nhãn có tên tier=frontend không có”, điều mà mọi component đều thỏa mãn. tier!=frontend là cách loại trừ một giá trị. Tương tự, tier in frontend bị từ chối — một tập được viết là tier in (frontend) — và tier: frontend cũng vậy.
  • Một tập không được đóng — in ( hoặc notin ( thiếu ).

Một giá trị không bị giới hạn ở bất kỳ tập ký tự nào: đó là phần văn bản sau toán tử, đã bỏ khoảng trắng bao quanh, được so sánh với giá trị của nhãn đúng như đã viết. Vì vậy tier==frontend yêu cầu một nhãn có giá trị là =frontend; == không phải là một cách viết khác của phép bằng. Ngoài quy tắc về khóa ở trên, cả khóa lẫn giá trị đều không bị đánh giá — nhãn là các chuỗi mờ mà công cụ so sánh.

Nơi diễn ra việc xác thực

Hai lớp kiểm tra một bộ chọn, với mức độ nghiêm ngặt khác nhau có chủ ý:

  • pattern của JSON Schema là một cổng ngoài lỏng lẻo. Schema của Feature khai báo appliesTo (và các mục appliesToAnyOf dạng chuỗi) là các chuỗi với một mẫu giới hạn chỉ loại bỏ những hình dạng rõ ràng là sai. Nó được thiết kế dễ dãi có chủ ý — schema không bao giờ từ chối một bộ chọn mà công cụ sẽ đánh giá.
  • Trình phân tích cú pháp là trình xác thực. Trình phân tích cú pháp bộ chọn của trình biên dịch nắm giữ ngữ pháp: một bộ chọn mà nó từ chối — bất kỳ hình dạng nào ở trên — sẽ dừng quá trình build với một chẩn đoán nêu tên bộ chọn, Feature, socket hoặc slot khai báo nó, và yêu cầu mà nó không đọc được. Lỗi phân tích cú pháp được báo rõ ràng và cụ thể, không bao giờ bị bỏ qua âm thầm. Trong một lần build, trình phân tích cú pháp chạy ở nơi một bộ chọn được đánh giá — cho mỗi lần gắn một Feature, mỗi cạnh nối qua một socket, mỗi lần điền một slot. aggrega validate, trên toàn bộ catalog hoặc trên một Component hay Feature, cũng đọc mọi bộ chọn socket và slot mà tài liệu của thực thể khai báo, nên một bộ chọn sai trên một socket hay slot không được dùng sẽ bị từ chối ở đó, với cùng mã và cùng lời lẽ mà một lần build dùng. Một appliesTo sai trên một Feature không được gắn vào đâu sẽ không bị báo cáo cho đến khi có thứ gì đó gắn nó.

Một bộ chọn phân tích được nhưng không khớp thì tự nó không phải là lỗi — nó là một ràng buộc không được thỏa mãn. Ở giai đoạn phân tích tĩnh, mỗi lần gắn Feature mà nhãn đích không thỏa các bộ chọn của Feature sẽ tạo ra một chẩn đoán vi phạm nêu tên thể hiện feature, nút đích, các nhãn của nó, và ràng buộc; trình phân tích thu thập mọi vi phạm trước khi dừng, nên một lần biên dịch hiển thị tất cả chúng.

Những gì trình biên dịch không làm

Trình biên dịch không phụ thuộc vào ngữ nghĩa của nhãn. Nó đánh giá bất kỳ chuỗi nhãn nào nó tìm thấy — nó không coi component.aggrega.ai/type là đặc biệt, không xác thực rằng một giá trị danh mục thuộc tập đóng của catalog chuẩn, và không suy ra ý nghĩa từ tên khóa. Bản thân bộ từ vựng nhãn — hợp đồng kiểu vận hành, trục danh mục nhận thức, các nhãn năng lực theo vai trò — là một quy ước của thư viện chuẩn được các tác giả catalog và linter xuất bản duy trì, không phải bởi trình biên dịch. Các doanh nghiệp tự viết catalog của mình có thể tự do định nghĩa bộ từ vựng nhãn riêng; công cụ bộ chọn đánh giá nó theo cùng một cách. Về lược đồ nhãn ba trục mà catalog chuẩn sử dụng, xem architecture/13-catalog-and-registry.md; về hướng dẫn cho từng nhãn, xem architecture/09-ai-features.md §1.2.

Sự tương đồng của bộ chọn trong toàn ngôn ngữ

Các bộ chọn socket usesSchema (selector: "component.aggrega.ai/type=stateful-server") và các chú thích x-aggrega-selector: được tổng hợp từ chúng dùng cùng ngữ pháp và cùng công cụ với appliesTo của Feature. Kiến thức soạn thảo chuyển đổi một-một: một chuỗi dùng được làm bộ chọn socket thì dùng được làm bộ chọn gắn. Về hướng dẫn phía socket, xem topology-triad.md và entities/component.md.

Về bề mặt soạn thảo phía Feature — các trường spec, các ví dụ gắn hoàn chỉnh, và sự tương tác với kế thừa extends — xem entities/feature.md §Label-Based Attachment.