Trả lời nhanh: Công cụ agent phát hành bản mới rất thường xuyên, nên chiến lược hợp lý không phải là cập nhật ngay mọi bản mà là: cập nhật đều đặn theo nhịp của bạn, đọc ghi chú thay đổi ở ba mục quan trọng là tính năng ảnh hưởng tới cấu hình, thay đổi phá vỡ tương thích và vá bảo mật, và ghim phiên bản trên máy chạy tự động để một bản mới không làm hỏng luồng đang chạy vào lúc bạn không có mặt.
Công cụ đang phát triển nhanh thì bản mới ra liên tục, và mỗi bản đều có thứ đáng dùng. Nhưng cập nhật vô tội vạ trên máy đang chạy việc thật là cách tự tạo sự cố. Bài này nói nhịp cập nhật hợp lý và cách đọc ghi chú thay đổi cho nhanh.
Nhịp cập nhật theo từng loại máy
Máy làm việc cá nhân của bạn: cập nhật đều đặn, ví dụ mỗi tuần một lần vào đầu tuần. Đây là nơi bạn phát hiện sớm nếu bản mới có gì đó khác đi, và bạn có mặt để xử lý.
Máy chạy tự động: ghim phiên bản cụ thể. Một bản mới đổi hành vi có thể làm hỏng luồng đang chạy vào lúc ba giờ sáng, và không ai biết cho tới sáng hôm sau. Cập nhật máy này theo lịch riêng, sau khi bạn đã thử trên máy cá nhân.
Máy dùng chung của đội: cập nhật cùng lúc và báo trước, để mọi người không gặp khác biệt bất ngờ giữa các máy.
Ngoại lệ duy nhất: có vá bảo mật thì cập nhật ngay ở mọi nơi.
Đọc ghi chú thay đổi cho nhanh
Ghi chú thay đổi thường dài, nhưng chỉ ba mục thật sự cần bạn chú ý:
- Thay đổi phá vỡ tương thích. Đọc mục này trước tiên. Nếu có, kiểm tra xem nó có chạm tới cấu hình hoặc quy trình của đội bạn không.
- Thay đổi liên quan tới cấu hình. Khóa cấu hình bị đổi tên, cơ chế quyền đổi cách hoạt động, cách khai báo công cụ ngoài thay đổi. Đây là những thứ làm hỏng thiết lập hiện tại của bạn.
- Vá bảo mật. Cập nhật ngay, không chờ nhịp thường lệ.
Phần tính năng mới thì đọc lướt, và chỉ đào sâu khi có cái nào giải quyết đúng một vấn đề bạn đang gặp. Đừng đổi cách làm việc chỉ vì có tính năng mới; hãy đổi khi cách hiện tại thật sự đang vướng.
Giữ cho cấu hình của đội không vỡ
Với đội nhiều người, bản mới hay gây ra tình huống mỗi máy một hành vi. Ba việc phòng:
- Ghi phiên bản đang dùng vào tài liệu đội. Một dòng trong file quy ước hoặc trong tài liệu nội bộ là đủ.
- Cập nhật cùng lúc. Chọn một ngày, báo trước, ai cũng nâng cùng nhau.
- Thử trên dự án nhỏ trước. Nếu bản mới đổi cách hoạt động của quyền hoặc hook, bạn phát hiện ở dự án ít rủi ro thay vì ở dự án chính.
Ba việc này nghe nặng nề nhưng thực tế chỉ tốn vài phút mỗi tháng, và chúng tránh được kiểu sự cố khó chịu nhất: một người gặp lỗi mà những người khác không tái hiện được.
Khi bản mới đổi hành vi
Thỉnh thoảng bạn cập nhật rồi thấy mọi thứ hành xử khác đi. Ba chỗ kiểm tra theo thứ tự:
Cấu hình có bị bỏ qua không. Khóa bị đổi tên là nguyên nhân phổ biến nhất, và thường không có thông báo lỗi, cấu hình chỉ đơn giản là không có tác dụng. Cách kiểm nằm ở bài về cấu hình.
Hook còn chạy không. Nếu cơ chế hook đổi, hàng rào an toàn của bạn có thể im lặng ngừng hoạt động, thứ nguy hiểm hơn là báo lỗi. Hãy thử cố ý một thao tác bị chặn để kiểm chứng, theo bài về hooks.
Máy chủ công cụ ngoài còn kết nối không. Cách khai báo thay đổi thì chúng có thể không được nạp.
Nếu cần quay lui, hãy cài lại phiên bản cũ. Đây cũng là lý do nên ghi lại phiên bản đang chạy tốt trước khi nâng.
Trên máy chủ chạy tự động
Vài lưu ý riêng cho máy chạy agent không có người ngồi cạnh:
- Ghim phiên bản cụ thể trong script cài đặt, không dùng bản mới nhất.
- Cập nhật theo lịch có kế hoạch, sau khi đã chạy thử trên máy cá nhân ít nhất một tuần.
- Chạy một lượt thử sau khi nâng để chắc luồng vẫn hoạt động, thay vì chờ tới lần chạy thật.
- Giữ khả năng quay lui: ghi phiên bản cũ và cách cài lại vào tài liệu vận hành.
Cách dựng môi trường chạy tự động nằm ở bài chạy Claude Code trên VPS. Với môi trường đóng gói bằng container, việc ghim phiên bản còn dễ hơn: chỉ cần chốt nhãn ảnh thay vì dùng nhãn mới nhất.
Nhịp cập nhật theo loại máy
| Loại máy | Nhịp hợp lý | Lý do |
|---|---|---|
| Máy cá nhân của người phát triển | Cập nhật sớm, chấp nhận vài trục trặc nhỏ | Phát hiện vấn đề trước khi nó chạm vào bản chạy thật |
| Máy chủ tích hợp liên tục | Cố định một phiên bản, nâng theo lịch | Bản dựng phải cho ra kết quả giống nhau giữa các lần chạy |
| Máy chủ chạy tự động không người trực | Nâng sau khi đã chạy ổn trên máy cá nhân ít nhất một tuần | Ở đây không ai ngồi cạnh để xử lý khi hành vi đổi |
Sai lầm hay gặp là để mọi nơi tự cập nhật. Khi bản dựng hỏng, bạn không phân biệt được lỗi do mã của mình hay do công cụ vừa đổi.
Đọc phần phá vỡ tương thích trước tiên
- Tìm mục nói về thay đổi phá vỡ tương thích trước. Đây là phần duy nhất bắt buộc phải đọc kỹ.
- Tiếp theo là mục về mặc định thay đổi. Một giá trị mặc định đổi âm thầm nguy hiểm hơn một tính năng bị bỏ, vì nó không báo lỗi.
- Phần tính năng mới đọc sau cùng, khi bạn đã yên tâm là bản cập nhật không làm hỏng gì.
Cố định phiên bản cho cả đội
# Nguyen tac: may ca nhan tu do, may chay tu dong thi co dinh # Ghi phien ban dang dung vao tai lieu cua du an# de nguoi moi vao khong cai nham ban khac # Truoc khi nang tren may chay tu dong:# 1. Nang tren mot may ca nhan truoc# 2. Chay lai toan bo luong tu dong tren nhanh thu# 3. So ket qua voi lan chay truoc do# 4. Chi khi giong nhau moi nang tren may that # Neu ban moi doi hanh vi va ban chua kip xu ly:# quay ve phien ban cu la lua chon hop le, khong phai that bai# ghi lai ly do vao tai lieu de lan sau khong lap laiQuay về bản cũ trước, xử lý tương thích sau
Đừng sửa mã của bạn để chạy được với bản mới ngay trong lúc đang gấp. Quay về bản cũ trước, hoàn thành việc đang dở, rồi mới xử lý việc tương thích như một đầu việc riêng có kế hoạch. Trộn hai việc này vào nhau là cách chắc chắn để mất cả buổi.
Câu hỏi thường gặp
Có nên cập nhật ngay khi có bản mới không?
Trên máy cá nhân thì cập nhật đều đặn là hợp lý. Trên máy chạy tự động thì nên ghim phiên bản và nâng theo lịch, sau khi bạn đã dùng thử. Ngoại lệ là vá bảo mật, khi đó nâng ngay ở mọi nơi.
Cập nhật xong thấy cấu hình không có tác dụng thì sao?
Kiểm tra xem khóa cấu hình có bị đổi tên trong bản mới không. Đây là nguyên nhân phổ biến nhất, và nó thường không báo lỗi mà chỉ đơn giản là bị bỏ qua.
Đội nhiều người thì quản lý phiên bản thế nào?
Ghi phiên bản đang dùng vào tài liệu nội bộ, và nâng cùng lúc theo lịch báo trước. Như vậy tránh được tình huống một người gặp lỗi mà những người khác không tái hiện được.
Ghi chú thay đổi nên đọc phần nào?
Ba phần: thay đổi phá vỡ tương thích, thay đổi liên quan tới cấu hình và quyền, và vá bảo mật. Phần tính năng mới thì đọc lướt, chỉ đào sâu khi nó giải quyết đúng vấn đề bạn đang gặp.