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.

Khi nào nên dùng một bước pipeline

Một FeatureRecipe cho bạn hai cách định hình đầu ra mà một Feature đóng góp: một FeatureRecipe dạng template tự sinh ra các tài liệu của riêng nó, và một bước pipeline (pipeline:) chạy một plugin Wasm trên đầu ra đã được render. Chúng giải quyết những vấn đề khác nhau. Trang này là hướng dẫn ra quyết định: chỉ dùng một bước pipeline khi gặp đúng hai điều kiện kích hoạt, và dùng một FeatureRecipe dạng template cho mọi trường hợp còn lại.

Hai công cụ

Một FeatureRecipe dạng template mang tính cục bộ và sinh mới. Nó tạo ra các tài liệu của riêng nó từ các giá trị của riêng nó thông qua một Go template — ConfigMap của một sidecar, một CRD chính sách, một đối tượng autoscaler. Mọi thứ nó xuất ra đều là hàm của values: và infra: của Feature cùng ngữ cảnh render được truyền cho các template của nó. Nó không bao giờ can thiệp vào đầu ra của một thực thể khác; nó chỉ thêm các tài liệu của riêng mình. Nếu thứ bạn cần tạo ra có thể được viết từ những gì Feature đã biết, thì một FeatureRecipe dạng template là công cụ đúng đắn và đơn giản hơn — không plugin, không pipeline.

Một bước pipeline mang tính toàn cục và biến đổi. Nó chạy sau khi render, trên tập tài liệu thực tế mà bản build đã xuất ra. Host truyền nguyên vẹn tập tài liệu có khóa đó cho bước; bước đọc nội dung thực tế, chọn các tài liệu mà nó nhắm tới, và trả về các bản vá RFC 6902 chính xác cho cấu trúc của chúng — hoặc xuất ra các tài liệu mới như hiệu ứng phụ. Một bước lập luận dựa trên những gì đã được render, không chỉ dựa trên những gì Feature đã khai báo. Phạm vi tác động đó là toàn bộ lý do tồn tại của nó, và cũng là lý do bạn nên dùng nó một cách hạn chế.

Hai điều kiện kích hoạt cho một bước pipeline

Chỉ dùng một bước pipeline khi một trong các điều kiện sau đúng. Nếu không có điều kiện nào đúng, hãy sinh tài liệu bằng một FeatureRecipe dạng template.

  1. Vá phạm vi host — bạn cần can thiệp vào cấu trúc của một thực thể khác đã được render. Trường hợp điển hình là chèn một biến môi trường, một volume mount hoặc một container sidecar vào workload của component tiêu thụ — một tài liệu mà chính Feature không tạo ra. Một FeatureRecipe dạng template không thể làm điều này: nó tạo ra các tài liệu của riêng nó, không chỉnh sửa tài liệu của người khác. Một bước pipeline thì có thể, vì nó hoạt động trên tập đã render và có thể trỏ tới các tài liệu của component host theo khóa.

  2. Xuất hoặc vá phụ thuộc nội dung — đầu ra phụ thuộc vào những gì tập đã render chứa. Khi tài nguyên bạn xuất ra, hoặc bản vá bạn áp dụng, là hàm của nội dung mà bản build tạo ra — các cổng thực tế mà một Deployment khai báo, tên các container cuối cùng có trong manifest, các tài nguyên mà một chart mở rộng thành — thì quyết định cần có sẵn nội dung đã render. Một FeatureRecipe dạng template render từ các giá trị của chính Feature và không bao giờ thấy tập hoàn chỉnh, nên nó không thể đưa ra lựa chọn phụ thuộc nội dung; một bước pipeline đọc nội dung trước, rồi mới hành động.

Cả hai điều kiện kích hoạt có chung một dạng: chúng cần thông tin chỉ tồn tại sau khi render — cấu trúc của một thực thể khác, hoặc chính nội dung đã xuất ra. Việc sinh cục bộ không bao giờ cần điều đó, nên việc sinh cục bộ không bao giờ cần một bước pipeline.

Bước biến đổi; chính sách xác thực

Một bước pipeline là một bộ biến đổi: nó thay đổi tập đã render. Nó không phải là nơi để kiểm tra xem một kết quả có chấp nhận được hay không. Để xác thực một bản build — để khẳng định rằng một workload đã được vá có sidecar, rằng không có secret dạng văn bản thuần nào lọt vào đầu ra, rằng một nhãn bắt buộc có mặt — hãy gắn một chính sách giai đoạn render: một plugin quản trị ở vai trò render-verdict, chạy sau khi render trên các artifact đã xuất ra và trả về một phán quyết. Một phán quyết halt dừng bản build; một phán quyết warn hoặc info đưa ra khuyến nghị mà không chặn.

Hãy tách biệt hai thứ này. Đừng xây dựng logic xác thực trong một bước pipeline, và đừng dùng một chính sách để thay đổi đầu ra — một plugin quản trị gắn ở một vai trò phán quyết trả về các phán quyết và không bao giờ vá, và host chỉ đọc đầu ra của một vai trò phán quyết như một quyết định. Một bước định hình đầu ra; một chính sách render-verdict đánh giá nó. Trang governance socket trình bày cả bốn vai trò quản trị và các mức độ nghiêm trọng của phán quyết.

Các bước kết hợp với nhau

Một bước pipeline có thể khai báo một hợp đồng đầu vào và đầu ra có kiểu, để đầu vào with: và các đầu ra trả về của nó là những dạng đã được xác thực thay vì các khối dữ liệu tự do. Một bước cũng trả về các outputs có tên, và một bước được khai báo sau trong cùng pipeline đọc các đầu ra của một bước trước đó từ template with: của chính nó dưới dạng .steps.<id>.outputs.<key>. Đó là cách một mẫu hai phần kết hợp mà không bị ràng buộc: một bước Fetcher xuất ra một tài nguyên thông tin xác thực và công bố tên của Secret kết quả như một đầu ra; một bước Injector đọc tên đó và vá workload tiêu thụ để mount nó. Mỗi bước đảm nhận một mối quan tâm, và pipeline nối các đầu ra của chúng theo thứ tự đã khai báo.

Tham chiếu chéo