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.

Tổng quan về template

Tác giả Recipe và FeatureRecipe viết mã Go text/template tại các vị trí đánh giá cụ thể: các mục provides, các mục locals, valuesMapping (viết trực tiếp hoặc nạp bằng $import:), nội dung workload: (viết trực tiếp hoặc nạp bằng $import:), các mục artifacts: (viết trực tiếp hoặc nạp bằng $import: theo từng mục), injectMapping của FeatureRecipe, source:, các mục assertions:, và with: cùng when: của mỗi bước pipeline:. Mỗi vị trí chạy tại một giai đoạn xác định của pipeline biên dịch và nhận một góc nhìn xác định về ngữ cảnh pillar. Bộ chương này mô tả bề mặt template: template chạy ở đâu, ngữ cảnh cung cấp gì tại mỗi vị trí, và những hàm trợ giúp nào có sẵn.

Hình dạng ngữ cảnh template và thứ tự đánh giá là những hợp đồng chịu lực — thay đổi bất kỳ điều nào trong hai điều này đều làm hỏng mọi template Recipe hiện có. Ngữ cảnh template được định nghĩa chính thức trong một JSON Schema đi kèm với trình biên dịch; ma trận đánh giá theo từng vị trí mô tả pillar nào đọc được tại vị trí nào, và engine template Go đi kèm thư viện trợ giúp Sprig cùng các phần mở rộng riêng của Aggrega. Các giai đoạn pipeline làm điểm neo cho các vị trí đánh giá này được mô tả ở cấp kiến trúc trong ../architecture/10-compilation-pipeline.md — inject mapping cho injectMapping của FeatureRecipe, phần mở đầu locals và phân giải nguồn cho .locals và .source của Recipe, kết xuất cơ sở cho valuesMapping của Recipe cơ sở, và kết xuất feature cho Resource Generation của FeatureRecipe.

Tham chiếu theo chủ đề

  • Ma trận mở rộng template — bảng chính thức theo từng vị trí, bao quát mọi điểm đánh giá template, các pillar mà vị trí đó đọc, và cách đầu ra đi vào đồ thị IR hoặc các sub-pass phía sau.
  • Hợp đồng ngữ cảnh template — hình dạng chính thức của ngữ cảnh template mà trình biên dịch trao cho template, bao gồm cặp hai trạng thái .inject / .inject_raw và phép chiếu JOIN .context.uses được làm giàu.
  • Đặt tên cho tài nguyên được kết xuất — khóa nào trong hai khóa định danh đặt tên cho cái gì, sự khác biệt giữa một target của uses và reference mà một bên sản xuất công bố, những provider nào báo cáo tên cho các tài nguyên chúng kết xuất và vì sao các provider khác không báo cáo tên nào, và lỗi dừng từ chối khóa khi không tồn tại tên như vậy.
  • Các hàm Sprig và hàm trợ giúp — các hàm trợ giúp Sprig có sẵn trong template Go cùng các phần mở rộng riêng của Aggrega và các hàm trợ giúp an toàn, cách một số do tác giả viết được đọc, in ra và so sánh trong một template giá trị, và những hàm trợ giúp nào hỏi một giá trị có được viết hay không, những hàm nào hỏi nó có rỗng hay không.
  • Ngữ cảnh template cho tham số — nơi các giá trị parameters: do Release đáp ứng đi đến một template: được nội suy vào các template giá trị trước khi chúng chạy, và chỉ các template đường dẫn mới đọc trực tiếp.
  • Khối assertions: — các quy tắc liên trường có tên mà một Component, Feature, Recipe hoặc FeatureRecipe khai báo dưới dạng template, được đánh giá trước khi render.