Docker untuk Developer: Containerize Aplikasi Node.js

Docker untuk Developer: Containerize Aplikasi Node.js

Docker membantu developer menjalankan aplikasi dalam container. Container berisi runtime, dependency, konfigurasi dasar, dan proses aplikasi sehingga lingkungan development, testing, dan deployment dapat dibuat lebih konsisten.

Masalah klasik dalam pengembangan aplikasi adalah "jalan di laptop saya, tetapi error di laptop orang lain". Docker tidak menghapus semua masalah, tetapi membantu membuat lingkungan lebih eksplisit dan dapat direplikasi.

Tujuan Belajar

Setelah membaca tutorial ini, kamu diharapkan mampu:

• Menjelaskan perbedaan image dan container.
• Membuat Dockerfile untuk aplikasi Node.js sederhana.
• Menjalankan container dengan port dan environment variable.
• Memahami volume untuk data yang perlu bertahan.
• Memakai Docker Compose untuk menjalankan aplikasi dan database bersama.
• Membaca log container dan melakukan debugging dasar.
• Menghindari kesalahan umum seperti memasukkan secret ke image.

Image dan Container

Image adalah blueprint. Container adalah proses yang berjalan dari image. Analogi sederhananya: image seperti resep, container seperti masakan yang dibuat dari resep tersebut.

Satu image dapat dipakai untuk membuat banyak container.

Aplikasi Node.js Sederhana

Misalkan kita punya aplikasi Express kecil.

{
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "express": "^4.18.0"
  }
}

File server.js:

const express = require("express");

const app = express();
const port = process.env.PORT || 3000;

app.get("/", (_req, res) => {
  res.json({
    message: "Aplikasi berjalan di Docker",
    time: new Date().toISOString(),
  });
});

app.listen(port, () => {
  console.log(`Server berjalan di port ${port}`);
});

Aplikasi ini membaca PORT dari environment variable. Pola ini penting karena port dan konfigurasi sering berbeda antara development dan production.

Dockerfile Dasar

Dockerfile berikut membangun image untuk aplikasi Node.js.

Penjelasan singkat:

• FROM menentukan base image.
• WORKDIR menentukan folder kerja di dalam container.
• COPY package*.json ./ menyalin manifest dependency lebih dulu agar cache build lebih efektif.
• RUN npm ci --omit=dev menginstal dependency production.
• COPY . . menyalin source code aplikasi.
• EXPOSE mendokumentasikan port yang dipakai aplikasi.
• CMD menentukan command default saat container berjalan.

.dockerignore

Jangan menyalin semua file lokal ke image. Buat .dockerignore.

File .env sebaiknya tidak masuk image. Secret diberikan saat runtime melalui environment variable atau secret manager.

Build dan Run

Bangun image:

Jalankan container:

Format -p 3000:3000 berarti port 3000 di host diarahkan ke port 3000 di container.

Menjalankan dengan environment variable:

Log dan Debugging Dasar

Melihat container berjalan:

Melihat log:

Masuk ke shell container:

Pada image Alpine, shell yang tersedia biasanya sh, bukan bash.

Volume: Data yang Bertahan

Container bersifat disposable. Jika container dihapus, perubahan file di dalam container bisa ikut hilang. Volume dipakai untuk data yang perlu bertahan, misalnya data database.

Contoh menjalankan PostgreSQL dengan volume:

Pada Windows PowerShell, multiline command bisa berbeda. Jika bingung, tulis command dalam satu baris terlebih dahulu.

Network: Komunikasi Antarcontainer

Jika aplikasi dan database berjalan sebagai container terpisah, keduanya perlu berada di network yang sama.

Database:

Aplikasi:

Perhatikan host database memakai db, yaitu nama container database dalam network yang sama.

Docker Compose

Docker Compose membuat definisi multi-container lebih rapi.

Jalankan:

Hentikan:

Jika ingin menghapus volume juga, gunakan opsi -v dengan hati-hati karena data database akan ikut terhapus.

Development vs Production

Dockerfile production biasanya menginstal dependency production dan menjalankan build final. Untuk development, kita sering butuh hot reload dan bind mount.

Contoh Compose development:

Pola development perlu disesuaikan dengan framework yang digunakan. Tujuannya adalah feedback cepat, bukan image sekecil mungkin.

Kesalahan Umum

Coba Sendiri

Buat aplikasi Node.js kecil dengan endpoint berikut:

• GET / mengembalikan pesan aplikasi berjalan.
• GET /health mengembalikan { "status": "ok" }.
• Port dibaca dari environment variable PORT.

Kemudian:

• Buat Dockerfile.
• Buat .dockerignore.
• Build image.
• Jalankan container di port 3000.
• Ubah port menjadi 8080 melalui environment variable.
• Tambahkan Compose file dengan service app dan db.

Catat command yang kamu jalankan dan error yang muncul jika ada. Dokumentasi kecil seperti ini akan sangat membantu saat deployment.

Cek Pemahaman

Ringkasan

Docker membantu membuat lingkungan aplikasi lebih konsisten. Pahami image, container, Dockerfile, .dockerignore, port, environment variable, volume, network, dan Compose. Untuk aplikasi produksi, jaga image tetap bersih dan jangan memasukkan secret. Untuk development, susun workflow yang memberi feedback cepat tanpa mengorbankan pemahaman terhadap container.