Đây là bài 3 trong phần 2 của chuỗi demo “Docker & CI/CD: Nhật ký đóng gói và vận hành”. Những tình huống thực hành về image, volume, cấu hình, pipeline và diễn tập khôi phục. Bài viết dùng ví dụ và dữ liệu giả để minh họa; hãy thử trên môi trường riêng trước khi áp dụng vào dự án.
Mục tiêu cụ thể
Dockerfile mô tả từng lớp tạo image. Build context quyết định file nào được gửi cho builder; dockerignore giúp loại secrets, dữ liệu lớn và thư mục không cần thiết.
Tích hợp vào dự án xuyên suốt
Sản phẩm cuối khóa là môi trường ứng dụng có web, database, pipeline kiểm tra và quy trình khôi phục. Ở chương này, bạn cần bàn giao một phần có thể giải thích và kiểm tra độc lập: Build image cho trang tĩnh, chỉ copy thư mục public và kiểm tra trong image không có tệp môi trường. Hãy nêu rõ phần mới phụ thuộc vào kết quả nào của chương trước và phần nào có thể làm riêng.
Kế hoạch thực hiện
- Xác định đầu vào, đầu ra và trạng thái trước khi bắt đầu. Với dockerfile và build context, hãy ghi lại kết quả bạn mong muốn trước khi chạy ví dụ.
- Tạo bản thử nhỏ nhất trong một thư mục hoặc môi trường riêng. Chỉ dùng dữ liệu giả; không sao chép token, tài khoản hoặc dữ liệu cá nhân vào bài tập.
- Thực hiện yêu cầu: Build image cho trang tĩnh, chỉ copy thư mục public và kiểm tra trong image không có tệp môi trường.
- Quan sát kết quả và so sánh từng điều kiện chấp nhận. Khi chưa đạt, thay đổi một yếu tố mỗi lần để biết thay đổi nào tạo ra tác động.
- Lưu kết quả cùng ghi chú giải thích quyết định. Người khác cần tái hiện được thao tác mà không phải đoán cấu hình hoặc dữ liệu ban đầu.
Điều kiện nghiệm thu
- Context không chứa secrets
- Image phục vụ đúng tài nguyên
- Hiểu tác động của cache lớp
Rủi ro cần xử lý
Copy toàn bộ thư mục dự án có thể đưa .env vào image. Xóa file ở lớp sau không đảm bảo bí mật biến mất khỏi các lớp trước.
Yêu cầu bàn giao
- Một phiên bản chạy được hoặc tài liệu thiết kế đủ để kiểm chứng.
- Mô tả đầu vào, đầu ra và cách bắt đầu thử.
- Ít nhất ba ca thử gắn với tiêu chí chương.
- Một ca lỗi được tái hiện và cách xử lý.
- Ghi chú giới hạn: điều gì chưa làm, vì sao và bước tiếp theo.
Bài dự án có thể cần nhiều thời gian thực hành hơn thời gian đọc hiển thị. Bạn tự chọn mức độ mở rộng theo mục tiêu; không cần đưa nội dung lên hệ thống production để hoàn thành bài. Khi review, tập trung vào hành vi quan sát được và tính rõ ràng của giải thích thay vì số dòng mã.
Liên hệ chương tiếp theo
Giữ lại phiên bản đã đạt tiêu chí trước khi thêm yêu cầu mới. Nếu thay đổi tiếp theo làm sai hành vi cũ, dùng các ca thử đã ghi để phát hiện và khoanh vùng thay đổi gây ra vấn đề.