Trang chủ Bài viết Bản tin công nghệ NuGet.org ra mắt tính năng xuất bản theo giai đoạn (staged publishing)
Bản tin công nghệ 18/11/2026 11 lượt xem

NuGet.org ra mắt tính năng xuất bản theo giai đoạn (staged publishing)

NuGet.org ra mắt tính năng xuất bản theo giai đoạn (staged publishing)

NuGet.org vừa giới thiệu tính năng staged publishing (xuất bản theo giai đoạn), mở cho mọi nhà phát hành gói. Tính năng này cho phép chuẩn bị và kiểm tra gói một cách riêng tư trước khi đưa ra quyết định công bố rõ ràng. Một bản build thành công chỉ cho biết pipeline đã chạy xong, không đảm bảo đó là phiên bản bạn thực sự muốn phát hành.

Ranh giới phát hành do bạn kiểm soát

Với cách push gói thông thường, việc tải lên khởi động ngay quá trình phát hành công khai. Staged publishing thêm một điểm dừng: gói vẫn trải qua kiểm tra hợp lệ trên NuGet.org nhưng giữ ở trạng thái riêng tư cho đến khi người duy trì có thẩm quyền chuyển nó sang công khai qua website. Điều này cho bạn thời gian xem lại nội dung sắp phát hành, sửa lỗi kiểm tra và chọn thời điểm công bố.

Tính năng này là tùy chọn (opt-in), các quy trình `dotnet nuget push` hiện có vẫn hoạt động bình thường. Bạn có thể áp dụng staging cho một gói nhạy cảm về bảo mật mà không cần thay đổi toàn bộ quy trình. Staging cũng khác với unlisting: gói unlisted vẫn có thể được khôi phục theo đúng phiên bản, còn gói staged thì hoàn toàn không khả dụng với người dùng.

Chuẩn bị và kiểm tra trên NuGet.org

Trên trang tải lên của NuGet.org, chọn tùy chọn staging trong mục Publishing Mode, hoặc tải lên từ pipeline bằng CLI. NuGet.org chạy gói qua quy trình kiểm tra gồm quét mã độc, kiểm tra chữ ký và ký kho lưu trữ. Khi kiểm tra thành công, gói sẵn sàng để chuyển công khai nhưng vẫn không xuất hiện trên trang gói, kết quả tìm kiếm hay hoạt động restore.

Lưu ý staging không cung cấp feed restore riêng tư, kể cả với chủ sở hữu. Hãy kiểm thử gói và các phụ thuộc bằng feed cục bộ hoặc riêng tư trước, rồi mới stage các sản phẩm phát hành.

Nhóm staging và chuyển công khai

Một staging group tập hợp các gói của một đợt phát hành dưới cùng một chủ staging (người dùng hoặc tổ chức). Ví dụ một thư viện, các tích hợp và analyzer của nó có thể chung nhóm cho bản phát hành sắp tới. Nhóm cho góc nhìn ở cấp độ phát hành thay vì phải theo dõi từng lần tải lên riêng lẻ. Quyền hạn đi theo chủ staging; là đồng sở hữu một gói không tự động cấp quyền truy cập nội dung được stage thay cho chủ khác.

Trước khi chuyển công khai, cần kiểm tra nhóm chứa đúng ID và phiên bản gói dự định phát hành, mọi gói đều đã qua kiểm tra. Việc chuyển công khai yêu cầu người dùng có thẩm quyền đã đăng nhập với xác thực hai yếu tố. Với nhóm, các gói còn đang kiểm tra hoặc kiểm tra thất bại phải được xử lý trước.

Cần lưu ý: chuyển công khai theo nhóm không phải là phát hành nguyên tử (atomic). Các gói đi qua pipeline phân phối công khai của NuGet.org độc lập nên có thể trở nên khả dụng để restore ở các thời điểm khác nhau. Cần tính đến khoảng thời gian này khi phối hợp phụ thuộc và thông báo.

Điểm kiểm soát con người và bảo mật

Staged publishing tạo ra điểm kiểm tra để một người có thẩm quyền xem xét và thực hiện hành động công bố, trong khi công việc chuẩn bị vẫn có thể tự động hóa và mở rộng. Ranh giới bảo mật mạnh nhất khi tự động hóa chỉ có quyền staging: API key chỉ dùng cho staging có thể tải gói lên nhưng không thể dùng đường push thông thường để phát hành trực tiếp. Chính sách Trusted Publishing cũng có thể bị giới hạn chỉ cho staging.

Nếu kẻ tấn công chiếm được thông tin xác thực của pipeline, họ có thể gửi nội dung để xem xét nhưng không thể phát hành trực tiếp đến người dùng. Tuy vậy điều này không làm nội dung tải lên trở nên đáng tin — vẫn cần xem xét sản phẩm, điều tra các lần tải lên bất thường và bảo vệ hệ thống build cùng tài khoản người duy trì. Nhóm khuyến nghị kết hợp staging với NuGet Trusted Publishing.

Các tình huống sử dụng

  • Bản vá bảo mật: chuẩn bị gói trước khi công bố phối hợp, giữ bản vá riêng tư và chuyển công khai đúng thời điểm đã thống nhất.
  • Phát hành tính năng: tập hợp các gói liên quan trong khi hoàn thiện tài liệu, mẫu và thông báo.
  • Cập nhật lớn: để nhiều bản build đóng góp sản phẩm vào một nhóm staging, kiểm tra và duyệt từ một nơi.
  • Phát hành thường lệ: vẫn có ích nhờ bước kiểm tra cuối về ID, phiên bản và sản phẩm.

Staging là cửa sổ chuẩn bị, không phải lưu trữ vĩnh viễn: nội dung staged sẽ hết hạn nếu không được chuyển công khai.

Hỗ trợ CLI trên .NET 11 RC2

SDK .NET 11 RC2 hỗ trợ tải lên staging cơ bản bằng lệnh `dotnet package stage push` thay cho push thông thường, với các tham số như `--source`, `--api-key` và tùy chọn `--group` để gửi vào nhóm (nhóm sẽ được tạo tự động nếu chưa có). Một lần tải lên được chấp nhận không có nghĩa là kiểm tra đã xong hay gói đã công khai — cần quay lại NuGet.org để xem xét và chuyển công khai.

Các lệnh liệt kê và quản lý nhóm như `dotnet package stage list` hay `dotnet package stage group create` dự kiến có trong bản cập nhật SDK tương lai, nhưng đây là ví dụ lộ trình, không phải cam kết về cú pháp hay ngày phát hành. Việc chuyển công khai vẫn thực hiện trên website NuGet.org.

Nguồn: .NET Blog

Trích nguồn từ: .NET Blog

Tags:

Chia sẻ:

Bài viết liên quan

Ra mắt GPT-6.2 Astra và Sol
18/11/2026 • TEDU

Ra mắt GPT-6.2 Astra và Sol

OpenAI giới thiệu GPT-6.2 Astra và Sol với khả năng xử lý công việc chuyên môn, lập trình và sử dụng máy tính tốt hơn, tiết kiệm chi phí hơn trên ChatGPT Work, Codex và API.

Đọc thêm
Zalo