Backstage 1.55 bổ sung khả năng khôi phục tác vụ Scaffolder, loại bỏ các Catalog API lỗi thời

Backstage, nền tảng cổng thông tin dành cho nhà phát triển do Spotify khởi xướng và hiện được cộng đồng CNCF duy trì, vừa phát hành phiên bản 1.55 với hai thay đổi đáng chú ý: khả năng khôi phục tác vụ Scaffolder và việc loại bỏ các Catalog API đã bị đánh dấu lỗi thời từ trước.

Khôi phục tác vụ Scaffolder: điểm sáng của bản phát hành

Tính năng nổi bật nhất trong Backstage 1.55 là khả năng khôi phục tùy chọn (opt-in recovery) cho các tác vụ Software Template. Trước đây, khi một tác vụ Scaffolder gặp sự cố — chẳng hạn tiến trình bị treo, dịch vụ khởi động lại hoặc vượt quá thời gian chờ — toàn bộ quy trình tạo dự án từ mẫu (template) sẽ phải chạy lại từ đầu.

Với bản cập nhật này, hệ thống có thể tiếp tục tác vụ từ bước đã hoàn thành cuối cùng, thay vì bắt người dùng thực hiện lại toàn bộ chuỗi thao tác. Đây là cải thiện đáng kể đối với trải nghiệm của các nhóm kỹ thuật, bởi quy trình tạo dịch vụ mới trong Backstage thường bao gồm nhiều bước liên tiếp: tạo repository, cấu hình CI/CD, đăng ký catalog, thiết lập quyền truy cập và nhiều tác vụ tự động khác.

Cơ chế này được thiết kế theo hướng opt-in, nghĩa là các nhóm phải chủ động bật tính năng trong cấu hình. Điều này hợp lý bởi việc khôi phục tác vụ đòi hỏi hệ thống phải lưu trạng thái trung gian và xử lý cẩn thận các trường hợp tác vụ chạy dở có thể gây ra hiệu ứng phụ không mong muốn.

Thay đổi phá vỡ tương thích ở catalog, search và TechDocs

Bên cạnh tính năng mới, Backstage 1.55 cũng mang đến các thay đổi phá vỡ tương thích (breaking changes) ở ba mảng quan trọng:

• Catalog: Các API lỗi thời đã bị loại bỏ hoàn toàn. Những nhóm vẫn đang sử dụng các endpoint cũ cần cập nhật mã nguồn hoặc plugin trước khi nâng cấp.
• Search: Một số thay đổi trong cấu hình và giao diện tìm kiếm có thể ảnh hưởng đến các plugin tùy chỉnh.
• TechDocs: Các điều chỉnh liên quan đến cách xử lý và hiển thị tài liệu kỹ thuật.

Đây là lý do các nhóm nên xem xét kỹ cấu hình hiện tại trước khi nâng cấp, đặc biệt nếu đang dùng nhiều plugin bên thứ ba hoặc có các tích hợp tùy chỉnh với catalog.

Việc loại bỏ các Catalog API lỗi thời là bước đi cần thiết để dọn dẹp mã nguồn, nhưng cũng đòi hỏi các nhóm phải rà soát lại toàn bộ hệ sinh thái plugin đang sử dụng.

Khuyến nghị cho các nhóm đang vận hành Backstage

Đối với các tổ chức tại Việt Nam đang sử dụng Backstage làm cổng thông tin nội bộ cho đội ngũ phát triển, đây là thời điểm phù hợp để lên kế hoạch nâng cấp có kiểm soát:

• Kiểm tra phiên bản hiện tại và đối chiếu với danh sách thay đổi phá vỡ tương thích trong ghi chú phát hành chính thức.
• Chạy thử trên môi trường staging trước khi triển khai lên production, đặc biệt nếu hệ thống có nhiều plugin tùy chỉnh.
• Rà soát các lời gọi Catalog API trong mã nguồn nội bộ để đảm bảo không còn phụ thuộc vào các endpoint đã bị loại bỏ.
• Cân nhắc bật tính năng khôi phục tác vụ nếu quy trình tạo dự án của bạn đủ dài và phức tạp để việc chạy lại từ đầu gây tốn kém thời gian.

Bản vá hiện tại là 1.55.3, và theo khuyến nghị từ đội ngũ phát triển, các nhóm nên nâng cấp thẳng lên phiên bản này thay vì dừng ở các bản 1.55.x trước đó để nhận đầy đủ các sửa lỗi.

Bối cảnh: Backstage ngày càng được ưa chuộng

Backstage đang dần trở thành lựa chọn phổ biến cho các doanh nghiệp muốn xây dựng cổng thông tin nội bộ dành cho nhà phát triển (internal developer portal). Nền tảng này giúp tập trung hóa việc quản lý dịch vụ, tài liệu kỹ thuật và quy trình tạo dự án mới — những vấn đề mà nhiều công ty công nghệ tại Việt Nam cũng đang gặp phải khi quy mô đội ngũ tăng lên.

Việc bổ sung khả năng khôi phục tác vụ cho thấy dự án đang chú trọng hơn đến độ tin cậy trong vận hành thực tế, chứ không chỉ dừng ở tính năng. Đây là tín hiệu tích cực cho các nhóm đang cân nhắc áp dụng Backstage vào hạ tầng phát triển của mình.