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:
- State-nya ada di kepala kamu. Kamu ingat harus install
libpq-devkarena pernah error dulu, tapi nggak ada yang dokumentasiin. - Version drift. Bulan depan kamu upgrade Node untuk project lain, dan project ini tiba-tiba rusak.
- 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-nyaforwardPorts— port dari container yang di-forward ke localhost kamupostCreateCommand— command yang jalan otomatis setelah container dibuat (perfect buatnpm installataupip 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:
- Pull image Docker yang dibutuhkan
- Spin up container lewat Docker Compose
- Install extension yang kamu definisikan
- Jalankan
postCreateCommand - 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,
.devcontaineryang sama langsung jalan di Codespaces tanpa perubahan apa pun. - Tambah
initializeCommanduntuk task yang harus jalan di host sebelum container naik (misalnya generate SSL cert lokal). - Gunakan
devcontainer CLIkalau 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.