Chạy MongoDB trong Docker: Hướng dẫn đầy đủ kèm ví dụ

Vậy là bạn đang muốn tự triển khai MongoDB hoặc thử nghiệm với nó trong môi trường cục bộ? Có một vài cách để bắt đầu nếu bạn không muốn nhảy thẳng vào MongoDB Atlas, trong đó có lựa chọn dùng container với Docker. 

Sử dụng Docker là một lựa chọn vững chắc khi quản lý phiên bản MongoDB của bạn vì thao tác không mất quá một phút và dễ bảo trì hoặc di chuyển giữa các máy chủ.

Trong bài viết này, chúng ta sẽ xem qua một vài cách triển khai MongoDB với Docker và khám phá một số mẹo nhỏ trong quá trình thực hiện. Bạn cũng có thể xem video này để có cái nhìn nhanh về chủ đề.

Yêu cầu tiên quyết

Để theo dõi bài hướng dẫn này, bạn cần có Docker Engine được cài đặt trên máy tính. Có thể là trên macOS, Windows hoặc Linux. Bạn không nhất thiết phải cài Docker Desktop, nhưng tùy hệ điều hành bạn dùng, nó có thể giúp trải nghiệm Docker dễ dàng hơn. 

Ví dụ, tôi đang dùng Docker Engine thông qua Rancher Desktop trên macOS và nó hoạt động tốt.

Để ôn lại kỹ năng Docker, bạn nên xem Docker cho người mới bắt đầu: Hướng dẫn thực hành về Containers để nắm lại các kiến thức cơ bản.

Tải một Docker Image của MongoDB

Trước khi có thể chạy MongoDB trong một container Docker, trước hết bạn cần tải về một image phù hợp với nhu cầu. Từ dòng lệnh, hãy chạy lệnh sau:

docker pull mongodb/mongodb-community-server:latestĐược hỗ trợ bởi

Lệnh trên sẽ tải về image chính thức MongoDB Community Edition (CE) với thẻ "latest." 

Lưu ý rằng mongodb/mongodb-community-server và mongodb/mongodb-enterprise-server là các Docker image chính thức do MongoDB duy trì. Tất cả image khác do cộng đồng bên ngoài duy trì và có thể cho kết quả khác hoặc không mong muốn.

Khi đã tải image, chúng ta có thể xem các lựa chọn triển khai.

Chạy MongoDB như một Container độc lập với lệnh Docker Run

Cách nhanh nhất để triển khai MongoDB với Docker là dùng lệnh docker run cùng vài tham số cấu hình. Ví dụ, bạn có thể chạy lệnh sau từ dòng lệnh:

docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=nraboy -e MONGO_INITDB_ROOT_PASSWORD=password1234 --name mongodb mongodb/mongodb-community-server:latestĐược hỗ trợ bởi

Lệnh trên sẽ lấy image của chúng ta và triển khai nó thành một container tên là "MongoDB." Container sẽ được ánh xạ cổng, nghĩa là máy chủ có thể tương tác với nó qua cổng "27017." Thông tin xác thực root cũng được thiết lập trong ví dụ này, nhưng tùy nhu cầu triển khai, bạn có thể dùng Docker Secrets hoặc cách bảo vệ khác để truyền thông tin nhạy cảm.

Trong ví dụ trên, mọi dữ liệu được lưu bên trong container. Dữ liệu MongoDB, bao gồm cơ sở dữ liệu, collection, và thậm chí cả tài liệu, chỉ tồn tại chừng nào container đó còn tồn tại. Điều này có thể phù hợp cho thử nghiệm, nhưng nhiều khi bạn sẽ muốn dữ liệu MongoDB trong Docker được lưu bền vững đáng tin cậy. Để xử lý việc này, bạn nên tạo một Docker volume bằng lệnh sau:

docker volume create mongodbĐược hỗ trợ bởi

Để báo cho container dùng volume đó, bạn có thể thay đổi lệnh triển khai thành như sau:

docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=nraboy -e MONGO_INITDB_ROOT_PASSWORD=password1234 -v mongodb:/data/db --name mongodb mongodb/mongodb-community-server:latestĐược hỗ trợ bởi

Lần này, hãy để ý rằng chúng ta chỉ định volume sẽ dùng. Khi dùng volume, bạn có thể yên tâm dữ liệu sẽ vẫn tồn tại ngay cả sau khi dừng hoặc cập nhật container.

Khi MongoDB đang chạy bên trong một container Docker, bạn có thể kết nối đến nó bằng chuỗi kết nối mongodb://nraboy:password1234@localhost:27017 từ công cụ bạn ưa thích.

Đưa MongoDB vào stack hoặc dự án của bạn với Docker Compose

Nếu bạn dự định dùng MongoDB với một dự án cụ thể cũng được quản lý bằng Docker, có lẽ hợp lý nhất là quản lý MongoDB bằng cấu hình Docker Compose. Các cấu hình này thường được dùng để cô lập môi trường dự án của bạn, thường gọi là stack.

Tạo một tệp docker-compose.yml đâu đó trên máy tính của bạn với nội dung sau:

services:
    mongodb:
        image: mongodb/mongodb-community-server:latest
        container_name: mongodb
        restart: unless-stopped
        ports:
            - "27017:27017"
        volumes:
            - mongodb:/data/db
        environment:
            MONGO_INITDB_ROOT_USERNAME: nraboy
            MONGO_INITDB_ROOT_PASSWORD: password1234

volumes:
    mongodb:
        external: trueĐược hỗ trợ bởi

Cấu hình trên sử dụng những thông tin mà chúng ta đã thấy trong lệnh dòng lệnh đơn lẻ. Tương tự phương pháp trước, giả định ở đây là bạn đã tạo sẵn một volume mongodb để Docker quản lý. Một lần nữa, nếu cần làm điều này, hãy chạy lệnh sau:

docker volume create mongodbĐược hỗ trợ bởi

Tất nhiên, bạn có thể quản lý các Docker volume theo cách nào phù hợp với mình. Tạo một volume chỉ là một trong số nhiều khả năng.

Khi dòng lệnh của bạn đang ở cùng thư mục làm việc với tệp docker-compose.yml, hãy chạy lệnh sau:

docker compose up -dĐược hỗ trợ bởi

Lệnh trên khởi động stack của bạn ở chế độ nền (detached). 

Bạn có thể kiểm tra mọi thứ hoạt động ổn bằng cách thử kết nối tới phiên bản của mình bằng một công cụ như MongoDB Compass, một trong các driver ngôn ngữ như Node.js, hoặc qua MongoDB Shell. 

Nếu làm đúng theo ví dụ, chuỗi kết nối của bạn sẽ là mongodb://nraboy:password1234@localhost:27017, nhưng tùy bạn đã làm theo thế nào, nó có thể khác.

Để dừng phiên bản MongoDB của bạn, hãy chạy lệnh sau từ dòng lệnh khi tệp YAML của bạn ở cùng thư mục làm việc:

docker compose downĐược hỗ trợ bởi

Vì chúng ta đang dùng một volume bên ngoài, lần tới khi bạn khởi động container, mọi thứ vẫn sẽ được lưu lại.

Kết luận

Docker giúp làm việc với MongoDB trong môi trường tự triển khai hoặc cục bộ trở nên dễ dàng. Bạn không cần bận tâm đến cấu hình hệ điều hành chung hay trải nghiệm khác nhau giữa các máy tính. Bạn sẽ có trải nghiệm nhất quán mỗi lần. 

Để tiến xa hơn, rất đáng để học cách tạo cơ sở dữ liệu trong MongoDB.