Jalankan Dev Environment Lokal dengan Devcontainer

by Marcus Chen
Jalankan Dev Environment Lokal dengan Devcontainer

Masalah yang Bikin Frustrasi: "Works on My Machine"

Kamu pernah nggak, baru clone repo terus langsung npm install atau pip install -r requirements.txt, dan yang keluar malah error panjang karena versi Node-nya beda, Python-nya nggak cocok, atau ada native dependency yang belum keinstall?

Atau lebih parah: kamu onboarding junior dev baru, dan mereka butuh setengah hari cuma buat bikin environment-nya jalan. Padahal kerjaan belum mulai.

Ini bukan masalah skill — ini masalah tooling. Dan solusinya ada di devcontainer.

Devcontainer (Development Container) adalah standar yang dikembangkan oleh Microsoft untuk mendefinisikan environment development kamu dalam sebuah container Docker. Konfigurasinya cukup satu file .devcontainer/devcontainer.json, dan VS Code (atau editor lain yang support) akan otomatis spin up container yang identik di mana pun kamu buka project-nya.

Artinya: laptop lama, laptop baru, laptop teman, bahkan GitHub Codespaces — semua pakai environment yang sama persis.


Kenapa Devcontainer Lebih Enak dari Setup Manual

Setup manual itu nyebelin karena beberapa alasan:

  1. State-nya ada di kepala kamu. Kamu ingat harus install libpq-dev karena pernah error dulu, tapi nggak ada yang dokumentasiin.
  2. Version drift. Bulan depan kamu upgrade Node untuk project lain, dan project ini tiba-tiba rusak.
  3. Beda OS, beda masalah. Yang jalan di macOS belum tentu jalan di Ubuntu atau WSL.

Devcontainer solve semua ini karena environment-nya didefinisikan sebagai kode — bisa di-commit, di-review, dan di-reproduce.

Dan ini bukan cuma buat tim besar. Sebagai solo engineer pun ini berguna banget: kamu bisa pindah laptop atau reset mesin tanpa khawatir kehilangan konfigurasi environment.


Prasyarat Sebelum Mulai

Sebelum lanjut, pastiin kamu punya:

  • Docker Desktop (atau Docker Engine di Linux) yang udah jalan
  • VS Code dengan extension Dev Containers (ms-vscode-remote.remote-containers)
  • Project yang mau kamu setup — kita pakai contoh project Node.js + PostgreSQL

Install extension-nya via command line kalau mau:

code --install-extension ms-vscode-remote.remote-containers

Struktur File Devcontainer

Buat folder .devcontainer di root project kamu, lalu buat dua file:

my-project/
├── .devcontainer/
│   ├── devcontainer.json
│   └── docker-compose.yml
├── src/
└── package.json

Kita mulai dari devcontainer.json:

// .devcontainer/devcontainer.json
{
  "name": "Node.js + PostgreSQL Dev",
  "dockerComposeFile": "docker-compose.yml",
  "service": "app",
  "workspaceFolder": "/workspace",

  "customizations": {
    "vscode": {
      "extensions": [
        "dbaeumer.vscode-eslint",
        "esbenp.prettier-vscode",
        "ckolkman.vscode-postgres"
      ],
      "settings": {
        "editor.formatOnSave": true,
        "editor.defaultFormatter": "esbenp.prettier-vscode",
        "terminal.integrated.shell.linux": "/bin/bash"
      }
    }
  },

  "forwardPorts": [3000, 5432],

  "postCreateCommand": "npm install",

  "remoteUser": "node"
}

Beberapa field penting di sini:

  • dockerComposeFile — nunjuk ke file compose yang define service-nya
  • forwardPorts — port dari container yang di-forward ke localhost kamu
  • postCreateCommand — command yang jalan otomatis setelah container dibuat (perfect buat npm install atau pip install)
  • customizations.vscode.extensions — extension VS Code yang otomatis keinstall di dalam container

Sekarang docker-compose.yml-nya:

# .devcontainer/docker-compose.yml
version: '3.8'

services:
  app:
    image: mcr.microsoft.com/devcontainers/javascript-node:18
    volumes:
      - ..:/workspace:cached
    command: sleep infinity
    environment:
      - DATABASE_URL=postgresql://devuser:devpass@db:5432/devdb
    depends_on:
      - db

  db:
    image: postgres:15-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: devuser
      POSTGRES_PASSWORD: devpass
      POSTGRES_DB: devdb
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

Kita pakai image resmi dari Microsoft (mcr.microsoft.com/devcontainers/javascript-node:18) yang udah include Node 18, npm, git, dan tools dasar lainnya. Nggak perlu bikin Dockerfile dari nol kalau kebutuhan kamu standar.


Buka Project di Devcontainer

Setelah dua file itu ada, buka VS Code di folder project kamu. VS Code akan detect file .devcontainer/devcontainer.json dan muncul notifikasi di pojok kanan bawah:

Folder contains a Dev Container configuration file. Reopen folder to develop in a container.

Klik Reopen in Container. VS Code akan:

  1. Pull image Docker yang dibutuhkan
  2. Spin up container lewat Docker Compose
  3. Install extension yang kamu definisikan
  4. Jalankan postCreateCommand
  5. Attach VS Code ke dalam container

Proses pertama kali bakal agak lama karena pull image. Tapi setelah itu, buka ulang container cuma butuh beberapa detik.

Kalau mau buka manual tanpa nunggu notifikasi, tekan Ctrl+Shift+P (atau Cmd+Shift+P di Mac) dan cari:

Dev Containers: Reopen in Container

Verifikasi Environment Kamu

Setelah masuk ke container, buka terminal di VS Code. Terminal ini jalan di dalam container, bukan di host machine kamu.

# Cek versi Node
node --version
# Output: v18.x.x

# Cek koneksi ke database
psql $DATABASE_URL -c "SELECT version();"
# Output: PostgreSQL 15.x ...

# Cek npm install udah jalan
ls node_modules | head -5

Kalau semuanya jalan, berarti environment kamu udah reproducible. Commit folder .devcontainer ke repo, dan siapa pun yang clone repo ini bisa dapat environment yang sama.


Gotcha yang Gue Temuin

Beberapa hal yang bikin stuck waktu pertama kali setup:

1. Volume mount lambat di macOS

Default volume mount di Docker Desktop macOS itu lambat. Makanya di docker-compose.yml gue tambahin :cached di volume mount:

volumes:
  - ..:/workspace:cached

Ini kasih sinyal ke Docker bahwa host adalah sumber kebenaran, dan container boleh cache read. Buat dev environment, ini cukup dan bikin file access jauh lebih cepat.

2. Extension VS Code nggak keinstall

Kadang postCreateCommand jalan sebelum container fully ready. Kalau extension nggak keinstall, coba tambah postStartCommand sebagai fallback, atau rebuild container via Dev Containers: Rebuild Container.

3. Port conflict

Kalau port 5432 udah dipake PostgreSQL lokal di host kamu, forwardPorts bakal conflict. Solusinya: matiin PostgreSQL lokal sebelum buka devcontainer, atau ganti port forward ke port lain:

"forwardPorts": [3000, 5433]

Lalu akses database dari host di port 5433, tapi dari dalam container tetap pakai 5432.

4. Permission issue di Linux

Kalau kamu pakai Linux dan Docker Engine (bukan Docker Desktop), file yang dibuat di dalam container kadang punya owner root di host. Fix-nya: pastiin remoteUser di devcontainer.json match dengan UID user kamu, atau tambah ini di devcontainer.json:

"updateRemoteUserUID": true

Field ini bikin VS Code sync UID user di dalam container dengan UID kamu di host.


Tambah Dev Tools Tanpa Polusi Host

Salah satu hal yang gue paling suka dari devcontainer: kamu bisa install tools apa pun di dalam container tanpa nyentuh host machine.

Misalnya, mau pakai pgcli (PostgreSQL CLI yang lebih enak) cukup tambah di postCreateCommand:

"postCreateCommand": "npm install && pip3 install pgcli"

Atau kalau mau lebih proper, pakai features — fitur bawaan devcontainer spec yang bisa tambah tooling ke container:

// .devcontainer/devcontainer.json
{
  "name": "Node.js + PostgreSQL Dev",
  "dockerComposeFile": "docker-compose.yml",
  "service": "app",
  "workspaceFolder": "/workspace",

  "features": {
    "ghcr.io/devcontainers/features/github-cli:1": {},
    "ghcr.io/devcontainers/features/python:1": {
      "version": "3.11"
    }
  },

  "customizations": {
    "vscode": {
      "extensions": [
        "dbaeumer.vscode-eslint",
        "esbenp.prettier-vscode"
      ]
    }
  },

  "forwardPorts": [3000, 5432],
  "postCreateCommand": "npm install",
  "remoteUser": "node"
}

features adalah cara yang clean buat add tooling karena udah ada ratusan feature yang di-maintain komunitas di containers.dev/features. Dari AWS CLI, Terraform, sampai Rust — tinggal tambah satu baris.


Devcontainer untuk Project Lain

Setup di atas pakai Node.js, tapi konsepnya sama untuk stack lain. Ganti imagenya:

# Untuk Python
image: mcr.microsoft.com/devcontainers/python:3.11

# Untuk Go
image: mcr.microsoft.com/devcontainers/go:1.21

# Untuk PHP
image: mcr.microsoft.com/devcontainers/php:8.2

Microsoft maintain semua image ini di GitHub Container Registry, dan semuanya udah include tools dasar yang dibutuhin untuk masing-masing bahasa.


Yang Gue Lakuin Sekarang

Semua project gue sekarang punya .devcontainer di dalamnya — dari side project kecil sampai project client. Onboarding jadi tinggal:

git clone https://github.com/username/project.git
cd project
code .
# Klik "Reopen in Container"
# Done.

Nggak ada lagi "install ini dulu", "oh iya butuh ini juga", atau "versi kamu beda sama gue".

Langkah lanjutan yang bisa kamu explore:

  • Pakai devcontainer di GitHub Codespaces — kalau kamu butuh environment di cloud, .devcontainer yang sama langsung jalan di Codespaces tanpa perubahan apa pun.
  • Tambah initializeCommand untuk task yang harus jalan di host sebelum container naik (misalnya generate SSL cert lokal).
  • Gunakan devcontainer CLI kalau mau build dan test devcontainer dari CI pipeline.

Coba setup satu project kamu hari ini. Waktu investasi awalnya sekitar 30 menit, tapi kamu bakal hemat berjam-jam tiap kali ganti mesin atau onboard orang baru. Untuk tips lebih lanjut tentang setup yang reproducible, this guide on safe online shopping menunjukkan pentingnya verifikasi sebelum commit—prinsip yang sama berlaku untuk environment configuration.