Sửa .env drift trong CI với env-doctor

Mục tiêu

Để CI fail khi .env lệch khỏi .env.example, để key thiếu không bao giờ làm hỏng deploy nữa.

Điều kiện

• Đã clone env-doctor (xem quickstart)
• File workflow CI (ví dụ GitHub Actions bên dưới)

Các bước

1. Tái hiện local:

   python -m env_doctor check --env .env --example .env.example

   Copy
2. Sửa: thêm key thiếu vào .env.example (placeholder rỗng) hoặc xóa key chết. Thêm bằng tay — đừng trông chờ tự sửa (chưa làm xong).
3. Thêm vào CI:

   - name: Audit .env drift
     run: python -m env_doctor check --env .env --example .env.example --format text

   Copy
4. Nếu bạn có nhiều cặp file env, lặp lại cùng bước check cho từng cặp trong CI.

Kiểm chứng

Push một branch xóa một key khỏi .env.example — CI nên fail với lỗi missing-in-env. Khôi phục key — CI pass.

Sửa lỗi

• CI fail: đọc dòng lỗi — sửa key thiếu/trùng mà nó nêu, rồi chạy lại. Warning riêng không làm fail; xử lý warning bằng tay (đừng tự sửa).
• Báo unused-var sai: --scan chỉ thấy code bạn chỉ tới — mở rộng đường quét.
• Secret trong log CI: không bao giờ in nội dung .env trong CI. Che trước khi chia sẻ log.