Dữ liệu FDE TimesViệc làm FDE đang mở 924▲33 Thay đổi số việc đang mở trong 7 ngày, so sánh cùng phạm vi: không tính việc của các công ty mới được theo dõi tuần nàyMới trong 7 ngày 80Công ty đang tuyển 196Nhận làm từ xa 25%Lương trung vị (Mỹ) $200kTuyển nhiều nhất Databricks 107
中文EN

Tờ báo của nghề Forward Deployed Engineer

Bách khoa

Viết RFC thế nào để CAB của khách không chặn deploy phút chót

Hội đồng hỏi lại vài câu quen thuộc với mọi thay đổi, nên hãy trả lời sẵn và xin cho bản deploy lặp lại được duyệt tự động.

Chia sẻLinkedInFacebookX

Tóm tắt nhanh

  • Theo nghiên cứu Accelerate, phê duyệt từ bên ngoài gắn với tốc độ release chậm hơn và không đi kèm tỷ lệ thay đổi gây lỗi thấp hơn, nhưng FDE vẫn phải làm việc trong quy trình của khách.
  • CAB hay hỏi đi hỏi lại vài câu giống nhau, nên RFC nào trả lời sẵn rủi ro, phạm vi, lịch, cách triển khai và rollback thì sẽ đi qua nhanh.
  • Về lâu dài, hãy xin cho các bản deploy lặp lại được xếp vào loại standard change, có peer review và pipeline đứng sau bảo đảm.
Hai cột so sánh RFC thêm tài liệu vào index retrieval. Bản nháp: gộp ba thay đổi, ghi “rủi ro thấp”, rollback bằng cách deploy lại bản cũ. Bản viết lại: mỗi RFC một thay đổi, rủi ro nêu cụ thể, rollback bằng cách trỏ alias về index cũ. Dòng rollback được tô màu cam để nhấn mạnh.
Ví dụ giả định trong bài: bản nháp gần như chắc chắn bị hỏi lại, còn bản viết lại trả lời trước từng câu hội đồng sẽ hỏi. Mục rollback trở thành một lệnh duy nhất, có thể đảo ngược.

Nghiên cứu Accelerate từng đo xem việc phê duyệt thay đổi từ bên ngoài có đi kèm production an toàn hơn hay không. Câu trả lời là không thấy dấu hiệu nào như vậy.

Theo Harness dẫn lại, phê duyệt bên ngoài gắn với lead time dài hơn, deploy thưa hơn và khôi phục sự cố chậm hơn, trong khi không hề đi kèm tỷ lệ thay đổi gây lỗi thấp hơn.

Đó là tương quan, chưa chứng minh nhân quả. Nhưng nó đủ để thấy một bước duyệt thêm không tự động đồng nghĩa với production an toàn hơn.

Có điều FDE không được chọn quy trình của khách. Ở nhiều doanh nghiệp lớn, bản deploy của bạn vẫn phải qua Change Advisory Board, hay CAB, dù dữ liệu nói gì. Chuyện quen thuộc là code đã xong, demo đã chạy, rồi RFC bị trả về ngay trong buổi họp cuối tuần vì “chưa rõ rollback”. Thế là mất thêm một chu kỳ họp.

Kỹ năng cần có ở đây là xin duyệt sao cho người duyệt quyết được ngay sau một lần đọc, rồi từng bước kéo các thay đổi lặp lại ra khỏi bàn họp. Đôi co với hội đồng không giúp bản deploy lên sớm hơn được ngày nào. Một RFC viết tốt thì có thể, và cộng dồn qua nhiều chu kỳ họp, nó định hình timeline của cả engagement.

CAB thật ra muốn biết gì?

DORA, nhóm nghiên cứu về hiệu năng giao phần mềm, nói thẳng rằng cách duyệt tập trung qua hội đồng có thể gây chậm trễ và hay kèm theo sai sót, và những quy trình duyệt nặng nề như vậy thường làm chậm việc release.

Theo Octopus, các buổi họp CAB thường trượt thành thủ tục đóng dấu, ai cũng hỏi đúng một hai câu đó cho mọi hạng mục. Với FDE, điều này lại có lợi: câu hỏi đoán trước được thì bạn trả lời trước được.

Tài liệu về change management của AWS nêu rõ chuẩn mực: yêu cầu thay đổi phải có đủ thông tin để người có thẩm quyền duyệt hoặc từ chối. Mẫu RFC ví dụ của AWS có các mục rủi ro đã xác định, phạm vi ảnh hưởng, lịch, cách triển khai và kế hoạch rollback. Rollback là mục cơ bản, yêu cầu nào cũng phải có.

Hãy đọc năm mục đó như năm câu hỏi mà một người không biết gì về hệ thống của bạn sẽ đặt ra. Cái gì có thể hỏng? Ai bị ảnh hưởng nếu nó hỏng? Làm lúc nào? Làm thế nào? Hỏng thì quay lại ra sao? Thiếu một câu trả lời là đủ để họ hẹn tuần sau.

Một RFC được viết lại từ đầu

Lấy một ví dụ giả định. Bạn cần đưa lên production cho khách một bản cập nhật của agent hỗ trợ nội bộ: prompt mới, thêm một nguồn tài liệu vào index retrieval và nâng phiên bản thư viện gọi model. Bản nháp đầu tiên gộp cả ba vào một RFC, ghi “nâng cấp agent, rủi ro thấp, rollback bằng cách deploy lại bản cũ”.

Bản nháp đó gần như chắc chắn bị hỏi lại. “Rủi ro thấp” chỉ là một lời khẳng định, chưa phải bằng chứng. “Deploy lại bản cũ” không trả lời được chuyện index đã thêm tài liệu thì gỡ ra thế nào. Ba thay đổi gộp một chỗ cũng khiến người duyệt không biết đang phải đánh giá thứ gì.

Việc đầu tiên là tách. Octopus khuyên review trên những tập thay đổi nhỏ, và lời khuyên này đúng cả với CAB. Ba thay đổi thành ba RFC, hoặc ít nhất ba mục độc lập, mỗi mục rollback được riêng. RFC cho thay đổi index sẽ trông như sau:

RFC: Thêm bộ tài liệu chính sách nhân sự vào index retrieval của agent hỗ trợ

Rủi ro đã xác định
- Agent có thể trích tài liệu cũ nếu bộ mới trùng nội dung bộ hiện có.
- Thời gian indexing tăng; trong lúc chạy, truy vấn vẫn đọc index cũ.

Phạm vi ảnh hưởng
- Chỉ người dùng agent hỗ trợ nội bộ. Không chạm cơ sở dữ liệu nghiệp vụ.
- Không đổi quyền truy cập; tài liệu thuộc nhóm đã được phép đọc.

Lịch
- Thứ Ba, ngoài giờ cao điểm. Người trực: [tên FDE] và [tên kỹ sư phía khách].

Triển khai
1. Build index mới song song, không ghi đè index cũ.
2. Chạy bộ eval cố định trên index mới; chỉ chuyển nếu đạt ngưỡng đã thống nhất.
3. Chuyển con trỏ alias sang index mới.

Kiểm tra sau triển khai
- Chạy lại bộ câu hỏi mẫu, so kết quả với lần chạy trước.

Rollback
- Trỏ alias về index cũ (giữ nguyên ít nhất 7 ngày). Một lệnh, không cần redeploy.

Peer review
- Link pull request đã được [tên người review] duyệt.

Chú ý mục rollback. Nó không hứa chung chung mà mô tả một thao tác cụ thể và có thể đảo ngược, vì thiết kế triển khai đã chừa sẵn đường lui: index cũ còn nguyên, chỉ đổi con trỏ. Nếu bạn không viết được một mục rollback ngắn như vậy thì vấn đề nằm ở thiết kế deploy, lời văn trong RFC không cứu được.

Từ bàn họp sang loại standard change

RFC tốt chỉ giúp bạn qua từng buổi họp. Mục tiêu lâu dài là bớt phải họp. AWS định nghĩa standard change là thay đổi đã quen thuộc, rủi ro thấp, được hiểu rõ nên không cần quy trình review và phê duyệt chính thức. AWS cũng khuyên các tác vụ lặp lại có rủi ro thấp nên được xếp loại standard và duyệt tự động.

Cập nhật prompt hay làm mới index theo lịch là những ứng viên rất hợp. Sau vài lần đi qua CAB suôn sẻ với cùng một khuôn RFC, bạn có trong tay bằng chứng để đề xuất: loại thay đổi này luôn có cùng các bước, cùng cách rollback, chưa từng gây sự cố.

Đề xuất đó cần một thứ thay thế cho con dấu của hội đồng. DORA gợi ý dùng peer review, ghi lại ngay trên nền tảng phát triển của nhóm, để đáp ứng yêu cầu tách bạch trách nhiệm (segregation of duties).

Bài của Harness bổ sung vế còn lại: quy trình duyệt nhẹ dựa trên peer review, đi cùng một pipeline deploy tự phát hiện và chặn thay đổi xấu. Bộ eval chạy trước khi chuyển alias trong ví dụ trên chính là một mảnh của pipeline đó.

Còn lúc khẩn cấp thì sao? AWS lưu ý thay đổi khẩn cấp vẫn phải theo quy trình đã ghi thành văn bản, chỉ là đi qua một nhóm duyệt nhỏ hơn, gọi là Emergency CAB (ECAB). Hãy hỏi trước ai ngồi trong ECAB của khách và cách gọi họ, đừng đợi đến lúc production sập lúc nửa đêm mới hỏi.

Những lỗi làm RFC chết trong phòng họp

Nhiều FDE chỉ biết lịch họp và hạn nộp RFC khi code đã xong, nên một chu kỳ họp trượt kéo theo cả tuần. Hãy hỏi chuyện này ngay trong tuần đầu của engagement, như khi hỏi quyền truy cập dữ liệu.

Lỗi thứ hai là gộp. Một RFC chứa năm thay đổi khiến người duyệt phải chấp nhận hoặc bác cả năm, và chỉ cần một mục mơ hồ là cả gói bị trả về. Lỗi thứ ba là rollback viết cho có, kiểu “khôi phục bản trước”, với những thay đổi chạm vào dữ liệu hoặc schema mà thật ra không đảo ngược được.

Lỗi thứ tư tinh vi hơn: mang số liệu Accelerate vào phòng họp để chứng minh CAB vô dụng. Dữ liệu đó có giá trị, nhưng người ngồi trong phòng đang chịu trách nhiệm với production của họ.

Hãy dùng nó làm nền cho đề xuất standard change, đừng dùng để tấn công. Cuối cùng, đừng lạm dụng đường khẩn cấp để né lịch họp. Làm vậy, bạn sẽ mất sự tin cậy, thứ cần có để được duyệt nhanh về sau.

Biến kỹ năng này thành lợi thế khi đi xin việc

Khi đọc tin tuyển FDE, những cụm như “regulated environments”, “enterprise customers” hay “change management” là tín hiệu công việc sẽ đụng CAB. Trong CV, đừng chỉ ghi “deploy lên production cho khách”.

Hãy viết rằng bạn đã soạn khuôn RFC và đưa một loại thay đổi lặp lại từ duyệt thủ công sang duyệt tự động. Câu đó cho người phỏng vấn thấy bạn hiểu hệ thống của khách, chứ không chỉ hiểu code của mình.

Ở mỗi khách hàng mới, việc đầu tiên nên làm là xin xem một RFC đã được duyệt gần đây. Nó cho bạn biết hội đồng này coi trọng điều gì nhanh hơn mọi buổi họp làm quen, và có nó trong tay, RFC đầu tiên của bạn đã có thể viết theo đúng cách họ quen đọc.

Bài này có hữu ích không?

Dùng cùng trợ lý AIHỏi Claude ↗Hỏi ChatGPT ↗
4 nguồn
Đọc tiếp trên lộ trình · Chặng 4: Khách hàngKhách hỏi tính năng bao giờ có, FDE được hứa đến đâu?Câu trả lời an toàn tùy vào trạng thái của hạng mục trên roadmap, và chỉ đội product mới được chốt ngày.