Khách chưa cấp staging? Testcontainers cho bạn Postgres và Redis thật
Chỉ cần Docker, mỗi lần chạy test có database riêng, chạy xong là xoá, không phải chờ ai cấp quyền.
Tóm tắt nhanh
- Testcontainers tạo database và dịch vụ thật trong Docker cho từng lượt test, chạy xong là xoá; ngoài Docker không cần gì thêm.
- Với FDE, công cụ này giúp kiểm tra code tích hợp trước khi khách cấp quyền vào staging.
- Bản Go yêu cầu tự đặt wait strategy và có Snapshot để mỗi test dùng một database sạch.
Tuần đầu ở chỗ khách, ticket xin quyền vào staging thường vẫn nằm im trong hàng đợi của đội hạ tầng. Trong khi đó bạn đã phải viết lớp đọc ghi Postgres và lớp cache Redis cho service họ cần. Mock thì chạy xanh, nhưng mock không cho bạn biết câu SQL có chạy đúng trên Postgres thật hay không.
Testcontainers lấp đúng khoảng trống đó. Theo trang chính thức, đây là thư viện mã nguồn mở cung cấp các instance database “dùng xong bỏ”, nhẹ, cùng mọi thứ chạy được trong Docker container. Bạn khai báo dependency của bài test bằng code, chạy test, container được tạo ra rồi bị xoá.
Với một FDE, ý nghĩa thực tế là bạn bỏ được một phụ thuộc lớn vào lịch của người khác. Code tích hợp có thể được kiểm tra với database thật ngay trên laptop, từ ngày đầu tiên.
Công cụ này đã đủ chín để mang đến chỗ khách chưa?
Bản Java ra đời năm 2015, tác giả là Richard North, dùng giấy phép MIT. Ngày 11/12/2023, Docker công bố mua AtomicJar, công ty đứng sau Testcontainers. Docker cho biết số lượt pull trên Docker Hub đã tăng gấp đôi trong năm trước đó, từ 50 triệu lên 100 triệu, và cam kết không đổi giấy phép của các thành phần mã nguồn mở.
Chi tiết sau cùng quan trọng với bạn hơn con số. Khi đề xuất thêm một thư viện vào repository của khách, câu hỏi đầu tiên của đội bảo mật hay pháp chế thường là giấy phép. Có câu trả lời rõ ràng sẵn sẽ giúp bạn rút ngắn cuộc trao đổi đó.
Trang chính thức nói Testcontainers hỗ trợ nhiều ngôn ngữ và framework test, và chỉ cần Docker. Bản Java nhắm vào test tích hợp cho lớp truy cập dữ liệu với MySQL, PostgreSQL hoặc Oracle chạy trong container. Bản Java cũng có thể chạy cả ứng dụng ở chế độ test ngắn hạn cùng các dependency của nó.
Thử hình dung một service đơn hàng viết bằng Go
Giả sử khách là một chuỗi bán lẻ, và bạn viết bằng Go một service đọc đơn hàng từ Postgres. Bạn có ba bài test: tạo đơn hàng mới, đọc lại đơn hàng vừa tạo, và xoá đơn hàng.
Nếu ba test dùng chung một database, test xoá có thể làm hỏng dữ liệu mà test đọc cần. Thứ tự chạy sẽ quyết định kết quả, và đó là kiểu lỗi “lúc xanh lúc đỏ” làm mất niềm tin của khách vào bộ test nhanh nhất.
Bản Go có sẵn lời giải cho tình huống này: module Postgres có tính năng Snapshot để mỗi test bắt đầu với một database sạch. Khi mỗi test có database của riêng nó, ba test độc lập với nhau và kết quả không còn phụ thuộc thứ tự chạy.
Trước khi mở tài liệu, nên phác thứ tự các bước cho bộ test. Đoạn dưới là mã giả để định hướng, không phải tên hàm thật của thư viện:
// Mã giả: thứ tự các bước, không phải API thật
1. Khởi động container Postgres, đặt wait strategy rõ ràng
2. Chuẩn bị schema và dữ liệu mẫu mà ba test cần
3. Dùng Snapshot để mỗi test làm việc trên database sạch
4. Chạy test: tạo, đọc, xoá đơn hàng
5. Kết thúc lượt chạy, container bị xoá
Khi đọc trang module Postgres của bản Go, hãy tìm đúng hai thứ: ví dụ dùng Snapshot để mỗi test có database sạch, và chỗ khai báo wait strategy. Chép hai đoạn đó vào test đầu tiên, chạy cho xanh, rồi mới viết thêm test thứ hai.
Còn Redis thì sao?
Phần cache cần lưu ý một điểm: các module không nhất thiết có cùng tính năng ở mọi ngôn ngữ. Module Redis được nhắc ở đây thuộc bản Node.js, tức là một bản ngôn ngữ khác với module Postgres của Go ở trên. Nếu service cache của khách viết bằng Node.js, module được cài như một dev dependency:
npm install @testcontainers/redis --save-dev
Cài ở dạng dev dependency nghĩa là thư viện thuộc về bộ test, không phải phần code khách sẽ chạy. Nên ghi rõ điều này trong mô tả pull request, vì đó là câu hỏi người review bên khách sẽ đặt ra. Với service Go, hãy kiểm tra tài liệu bản Go trước khi giả định có module tương đương.
Cái bẫy đầu tiên là “container đã sẵn sàng chưa”
Container khởi động xong không có nghĩa là Postgres bên trong đã nhận kết nối. Tài liệu module Postgres của bản Go ghi rõ không có wait strategy mặc định, bạn phải tự đặt.
Bỏ qua bước này, bộ test có thể chạy ổn trên laptop mạnh nhưng thất bại ngẫu nhiên trên máy CI chậm hơn của khách. Hãy coi wait strategy là một phần bắt buộc của mỗi khai báo container, không phải tuỳ chọn để thêm sau, và chạy thử bộ test trên CI của khách sớm để lộ vấn đề này.
Nó không thay được thứ gì?
Giới hạn rõ nhất nằm ngay ở lời quảng bá: thứ duy nhất cần có là Docker. Vì thế, trong buổi customer discovery, hãy hỏi xem laptop dev và CI của khách có được phép chạy Docker không, trước khi hứa hẹn một bộ test tích hợp.
Giới hạn thứ hai là container chỉ giống môi trường của khách đến mức bạn cấu hình nó. Phiên bản Postgres, extension, dữ liệu mẫu đều là những thứ bạn tự chọn. Một bài test xanh trên Postgres bản khác với bản production chỉ chứng minh được ít hơn bạn tưởng.
Vì thế Testcontainers giúp bạn đi trước staging, nhưng không thay thế staging. Nó bắt lỗi SQL, lỗi cache, lỗi migration từ sớm. Còn quyền truy cập, quy mô dữ liệu và cấu hình mạng thật vẫn phải kiểm tra trên môi trường của khách.
Nên học gì trước và kể nó thế nào trong CV
Thứ tự hợp lý là: nắm Docker cơ bản đủ để đọc log container, rồi viết một test tích hợp cho lớp truy cập dữ liệu bằng ngôn ngữ bạn dùng nhiều nhất, sau đó mới thêm Redis và các kỹ thuật như Snapshot. Mỗi bước nên chạy được cả trên laptop lẫn trong CI.
Khi đọc tin tuyển dụng FDE, hãy để ý những đoạn mô tả việc triển khai vào môi trường của khách hay làm việc khi quyền truy cập còn hạn chế; đó là chỗ kỹ năng này đáng được nhắc trong hồ sơ.
Trong CV, đừng chỉ ghi tên thư viện. Hãy mô tả kết quả: bạn đã kiểm tra tích hợp với database thật trước khi khách cấp quyền staging, với bao nhiêu test và chạy trong bao lâu.
Ticket staging có thể còn nằm im thêm một tuần nữa. Bộ test chạy trên Postgres thật trong laptop của bạn thì không phải chờ ai.
Bài này có hữu ích không?
Cảm ơn bạn đã góp ý!