Menjalankan MongoDB di Docker: Panduan Lengkap dengan Contoh

Jadi Anda ingin melakukan self-hosting MongoDB atau mulai mencoba-coba di lingkungan lokal? Ada beberapa opsi untuk memulai jika Anda tidak ingin langsung menggunakan MongoDB Atlas, salah satunya adalah kontainer dengan Docker. 

Menggunakan Docker adalah pilihan yang solid saat mengelola instance MongoDB karena tidak lebih dari satu menit untuk menyiapkannya serta mudah dirawat atau dipindahkan antar komputer host.

Dalam artikel ini, kita akan melihat beberapa pendekatan untuk melakukan deployment MongoDB dengan Docker dan membahas beberapa kiat praktis sepanjang proses. Anda juga dapat menonton video ini untuk ringkasan cepat topiknya.

Prasyarat

Untuk mengikuti tutorial ini, Anda perlu memasang Docker Engine di komputer Anda. Bisa di macOS, Windows, atau Linux. Anda tidak wajib memasang Docker Desktop, tetapi ini mungkin mempermudah pengalaman penggunaan Docker tergantung sistem operasi yang Anda gunakan. 

Sebagai contoh, saya menggunakan Docker Engine melalui Rancher Desktop di macOS, dan berjalan dengan baik.

Untuk menyegarkan keahlian Docker Anda, ada baiknya membaca Docker for Beginners: A Practical Guide to Containers untuk mempelajari dasar-dasarnya.

Mengunduh Image Docker MongoDB

Sebelum Anda dapat mulai menjalankan MongoDB dalam kontainer Docker, Anda harus terlebih dahulu mengunduh image yang sesuai dengan kebutuhan. Dari baris perintah, jalankan perintah berikut:

docker pull mongodb/mongodb-community-server:latestDidukung oleh

Perintah di atas akan mengunduh image resmi MongoDB Community Edition (CE) dengan tag "latest". 

Penting untuk dicatat bahwa mongodb/mongodb-community-server dan mongodb/mongodb-enterprise-server adalah image Docker resmi yang dikelola oleh MongoDB. Semua image lainnya dikelola oleh komunitas eksternal dan mungkin memberikan hasil yang berbeda atau tidak terduga.

Setelah image diunduh, kita dapat melihat opsi deployment.

Menjalankan MongoDB sebagai Kontainer Terisolasi dengan Perintah Docker Run

Cara tercepat untuk melakukan deployment MongoDB dengan Docker adalah cukup menggunakan perintah docker run dengan beberapa parameter konfigurasi. Misalnya, Anda bisa menjalankan berikut ini dari baris perintah:

docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=nraboy -e MONGO_INITDB_ROOT_PASSWORD=password1234 --name mongodb mongodb/mongodb-community-server:latestDidukung oleh

Perintah di atas akan mengambil image kita dan mendeploy-nya sebagai kontainer bernama "MongoDB." Kontainer akan dipetakan port-nya, artinya host akan bisa berinteraksi dengannya pada port "27017." Informasi autentikasi root juga diatur pada contoh ini, namun bergantung kebutuhan deployment Anda, Anda bisa menggunakan Docker Secrets atau cara terlindungi lainnya untuk mengoper informasi sensitif.

Pada contoh di atas, semua data disimpan di dalam kontainer. Data MongoDB, termasuk database, koleksi, dan bahkan dokumen, hanya akan bertahan selama kontainer tersebut ada. Ini mungkin cocok untuk pengujian, tetapi sering kali Anda memerlukan persistensi data MongoDB yang andal di Docker. Untuk menanganinya, Anda harus membuat volume Docker menggunakan perintah berikut:

docker volume create mongodbDidukung oleh

Untuk memberi tahu kontainer Anda agar menggunakan volume tersebut, Anda dapat mengubah perintah deployment agar terlihat seperti berikut:

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:latestDidukung oleh

Perhatikan bahwa kali ini, kita menentukan volume yang akan digunakan. Saat menggunakan volume, Anda dapat memastikan data Anda akan tetap ada bahkan setelah menghentikan atau memperbarui kontainer.

Dengan MongoDB berjalan di dalam kontainer Docker, Anda dapat terhubung menggunakan mongodb://nraboy:password1234@localhost:27017 sebagai connection string dari alat pilihan Anda.

Menyertakan MongoDB dalam Stack atau Proyek Anda dengan Docker Compose

Jika Anda berencana menggunakan MongoDB dengan proyek tertentu yang juga dikelola dengan Docker, masuk akal untuk mengelola MongoDB dengan konfigurasi Docker Compose. Konfigurasi ini sering digunakan untuk melakukan sandboxing pada proyek Anda, yang sering disebut sebagai stack.

Buat file docker-compose.yml di suatu lokasi di komputer Anda dengan isi berikut:

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: trueDidukung oleh

Konfigurasi di atas menggunakan informasi yang sudah kita lihat pada perintah baris tunggal. Seperti pada metode lainnya, di sini diasumsikan Anda sudah membuat volume mongodb yang dikelola oleh Docker. Jika Anda perlu melakukannya, jalankan kembali perintah berikut:

docker volume create mongodbDidukung oleh

Tentu saja, Anda dapat mengelola volume Docker dengan cara yang paling masuk akal bagi Anda. Membuat volume hanyalah salah satu dari beberapa kemungkinan.

Dengan baris perintah berada pada direktori kerja yang sama dengan file docker-compose.yml Anda, jalankan perintah berikut:

docker compose up -dDidukung oleh

Perintah di atas akan menjalankan stack Anda dalam mode detached. 

Anda dapat memvalidasi bahwa semuanya berfungsi dengan mencoba terhubung ke instance Anda menggunakan alat seperti MongoDB Compass, salah satu driver bahasa seperti Node.js, atau melalui MongoDB Shell. 

Jika mengikuti contoh persis, connection string Anda akan berupa mongodb://nraboy:password1234@localhost:27017, namun bergantung bagaimana Anda mengikuti langkah-langkahnya, ini bisa berbeda.

Untuk mematikan instance MongoDB Anda, jalankan perintah berikut dari baris perintah dengan konfigurasi YAML di direktori kerja yang sama:

docker compose downDidukung oleh

Karena kita menggunakan volume eksternal, saat Anda memulai ulang kontainer, semuanya akan tetap tersimpan.

Kesimpulan

Docker memudahkan bekerja dengan MongoDB di lingkungan self-hosted atau lokal. Anda tidak perlu khawatir tentang konfigurasi sistem operasi umum atau perbedaan pengalaman antar komputer. Anda akan mendapatkan pengalaman yang konsisten setiap saat. 

Untuk melangkah lebih jauh, ada baiknya mempelajari cara membuat database di MongoDB.