Bài đọc

Compose và kết nối dịch vụ: tình huống lỗi và cách chẩn đoán

3 phút đọc

Đây là bài 4 của chương 3: Compose và kết nối dịch vụ, thuộc khóa demo Docker & CI/CD. Nội dung được dùng để trải nghiệm cấu trúc chương trình học; hãy thực hành trên dữ liệu và môi trường thử nghiệm riêng. Trong dự án xuyên suốt, bạn sẽ xây dựng môi trường ứng dụng có web, database, pipeline kiểm tra và quy trình khôi phục.

Mục tiêu cụ thể

Compose đặt nhiều dịch vụ vào một cấu hình. Container liên lạc qua tên service trong network chung; localhost bên trong container là chính container đó.

Tình huống lỗi

Depends_on khởi động theo thứ tự không đồng nghĩa mọi dịch vụ đã sẵn sàng. Cần healthcheck hoặc cơ chế retry cho kết nối.

Chẩn đoán có bằng chứng

Trong bài compose và kết nối dịch vụ, hãy cố ý tái hiện tình huống trên ở môi trường thử nghiệm. Mục tiêu là thấy vì sao kết quả sai và thu thập đủ bằng chứng để phân biệt lỗi dữ liệu, lỗi quy tắc và lỗi cấu hình. Không sửa đồng thời nhiều yếu tố vì bạn sẽ khó xác định nguyên nhân.

Ghi rõ bước thao tác và kết quả mong đợi.
Thu nhỏ ví dụ đến mức vẫn tái hiện được lỗi.
Đối chiếu dữ liệu thực với giả định ban đầu.
Đặt giả thuyết và thay đổi một yếu tố.
Xác nhận bằng cách tái chạy ví dụ tối thiểu.

Mẫu đối chiếu

services:
  web:
    image: nginx:alpine
    ports:
      - "127.0.0.1:8080:80"
  redis:
    image: redis:alpine
# Ví dụ tối giản cho network thử nghiệm, chưa phải cấu hình production.

Kiểm tra sau sửa

Hiểu đúng localhost
Dịch vụ nội bộ không publish cổng thừa
Có cách xác định sẵn sàng

Khi lỗi biến mất, thực hiện lại yêu cầu gốc: Tạo stack học tập có web và cache; kiểm tra DNS theo tên service và đọc trạng thái từng container. Sau đó thử trường hợp đầu vào rỗng hoặc trạng thái chưa được khởi tạo nếu phù hợp. Một bản sửa phải khôi phục hành vi đã định nghĩa, không chỉ làm mất thông báo lỗi.

Ghi chú bàn giao