Kamu pasti pernah ngalamin ini: baru clone repo, jalanin npm install, eh langsung error karena versi Node beda. Atau lebih parah — project jalan di laptop kamu, tapi di laptop teman satu tim nggak mau jalan sama sekali. Klasik.
Setup environment manual itu menyita waktu yang harusnya bisa dipake buat nulis kode. Tiap kali ganti laptop, reinstall semua dependencies, atur ulang environment variable, pastiin versi tools cocok — itu bisa makan waktu setengah hari. Kalau kamu solo engineer atau indie hacker, waktu segitu mahal banget.
Solusinya: devcontainer. Satu file konfigurasi, dan environment kamu jalan konsisten di mana aja — laptop sendiri, laptop baru, bahkan di Codespaces kalau butuh.
Apa Itu Devcontainer dan Kenapa Bukan Cuma Docker Biasa
Devcontainer adalah spesifikasi open source (awalnya dari Microsoft, sekarang di bawah Dev Container Spec) yang mendefinisikan development environment dalam sebuah container. Bedanya sama Docker biasa untuk production?
Docker untuk production fokus ke runtime — image sekecil mungkin, proses minimal. Devcontainer fokus ke developer experience — ada debugger, extension VS Code, tools CLI, user yang bukan root, volume mount yang proper.
Kamu define environment di file .devcontainer/devcontainer.json, dan VS Code (atau editor lain yang support) akan otomatis spin up container itu dan connect ke dalamnya. Kamu nulis kode di editor lokal, tapi semua proses jalan di dalam container.
Hasil akhirnya: repo kamu punya "instruksi environment" yang bisa dieksekusi siapapun yang clone repo itu.
Struktur File Devcontainer
Minimal yang kamu butuhkan cuma dua file:
.devcontainer/
├── devcontainer.json
└── Dockerfile ← opsional, bisa pakai image langsung
Contoh paling sederhana pakai image yang udah ada:
// .devcontainer/devcontainer.json
{
"name": "Node.js Dev",
"image": "mcr.microsoft.com/devcontainers/javascript-node:18",
"forwardPorts": [3000],
"postCreateCommand": "npm install",
"customizations": {
"vscode": {
"extensions": [
"dbaeumer.vscode-eslint",
"esbenp.prettier-vscode"
]
}
}
}
Field postCreateCommand itu penting — dia jalan otomatis setelah container dibuat. Jadi begitu kamu buka project, npm install udah selesai, extension udah terpasang, langsung bisa coding.
Bikin Devcontainer Custom dengan Dockerfile
Kalau image bawaan kurang, kamu bisa bikin Dockerfile sendiri. Ini contoh untuk project Python yang butuh PostgreSQL client dan beberapa tools tambahan:
# .devcontainer/Dockerfile
FROM mcr.microsoft.com/devcontainers/python:3.11
# Install system dependencies
RUN apt-get update && apt-get install -y \
postgresql-client \
redis-tools \
httpie \
&& rm -rf /var/lib/apt/lists/*
# Install global Python tools
RUN pip install --no-cache-dir \
black \
ruff \
ipython
# Biarkan user default (vscode) yang handle project files
USER vscode
Lalu di devcontainer.json, ganti field image dengan build:
{
"name": "Python + Postgres Dev",
"build": {
"dockerfile": "Dockerfile"
},
"forwardPorts": [8000, 5432],
"postCreateCommand": "pip install -r requirements.txt",
"remoteUser": "vscode",
"customizations": {
"vscode": {
"extensions": [
"ms-python.python",
"ms-python.black-formatter",
"charliermarsh.ruff"
],
"settings": {
"python.defaultInterpreterPath": "/usr/local/bin/python",
"editor.formatOnSave": true,
"[python]": {
"editor.defaultFormatter": "ms-python.black-formatter"
}
}
}
}
}
Perhatikan "remoteUser": "vscode" — ini penting supaya file yang kamu buat di dalam container punya ownership yang bener, bukan root. Kalau kamu skip ini dan jalan sebagai root, file yang di-generate di dalam container bakal punya permission root:root dan susah diedit dari host.
Tambah Services dengan Docker Compose
Project dunia nyata biasanya butuh lebih dari satu container — database, cache, message queue. Devcontainer support Docker Compose langsung.
Struktur filenya:
.devcontainer/
├── devcontainer.json
├── docker-compose.yml
└── Dockerfile
# .devcontainer/docker-compose.yml
version: '3.8'
services:
app:
build:
context: ..
dockerfile: .devcontainer/Dockerfile
volumes:
- ..:/workspace:cached
- vscode-server:/home/vscode/.vscode-server
command: sleep infinity
environment:
- DATABASE_URL=postgresql://devuser:devpass@db:5432/devdb
- REDIS_URL=redis://cache:6379
db:
image: postgres:15-alpine
environment:
POSTGRES_USER: devuser
POSTGRES_PASSWORD: devpass
POSTGRES_DB: devdb
volumes:
- postgres-data:/var/lib/postgresql/data
cache:
image: redis:7-alpine
volumes:
- redis-data:/data
volumes:
postgres-data:
redis-data:
vscode-server:
// .devcontainer/devcontainer.json
{
"name": "Full Stack Dev",
"dockerComposeFile": "docker-compose.yml",
"service": "app",
"workspaceFolder": "/workspace",
"forwardPorts": [8000, 5432, 6379],
"postCreateCommand": "pip install -r requirements.txt && python manage.py migrate",
"remoteUser": "vscode"
}
Gotcha yang gue temuin di sini: volume vscode-server itu penting banget. Tanpa itu, setiap kali container di-rebuild, VS Code harus download ulang server-nya — bisa makan waktu beberapa menit. Dengan volume itu, server VS Code di-cache dan rebuild jadi jauh lebih cepat.
Gotcha yang Sering Bikin Pusing
1. Port forwarding nggak otomatis ke host
Kadang kamu udah set forwardPorts, tapi akses ke localhost:3000 tetap gagal. Cek dua hal: pastiin aplikasinya listen di 0.0.0.0 bukan 127.0.0.1, dan pastiin port belum dipakai proses lain di host.
Django contohnya — defaultnya 127.0.0.1:8000. Di dalam container itu artinya hanya bisa diakses dari dalam container itu sendiri. Jalanin dengan:
python manage.py runserver 0.0.0.0:8000
2. Git credentials nggak masuk ke container
Kalau kamu pakai SSH key untuk git, kamu perlu forward SSH agent ke container. Tambahkan ini di devcontainer.json:
{
"mounts": [
"source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent,type=bind"
],
"remoteEnv": {
"SSH_AUTH_SOCK": "/ssh-agent"
}
}
Pastiin SSH agent kamu udah jalan di host (eval $(ssh-agent -s) && ssh-add ~/.ssh/id_ed25519).
3. File permission chaos di Linux host
Kalau host kamu Linux (bukan Mac atau Windows), UID di dalam container (vscode = UID 1000) harus match sama UID user kamu di host. Kalau beda, file yang dibuat container bakal punya owner yang salah.
Cek UID kamu di host:
id -u # biasanya 1000 kalau user pertama
Kalau beda, tambahkan ini di Dockerfile:
ARG USERNAME=vscode
ARG USER_UID=1001 # sesuaikan dengan UID kamu
ARG USER_GID=$USER_UID
RUN groupmod --gid $USER_GID $USERNAME \
&& usermod --uid $USER_UID --gid $USER_GID $USERNAME
4. postCreateCommand gagal tapi nggak ada error message jelas
Kalau postCreateCommand gagal, container tetap jalan tapi command-nya silently fail. Selalu test command kamu dulu secara manual di terminal container sebelum masukin ke config. Dan kalau command panjang, bikin script shell terpisah:
{
"postCreateCommand": "bash .devcontainer/setup.sh"
}
#!/bin/bash
# .devcontainer/setup.sh
set -e # exit immediately kalau ada error
echo "Installing dependencies..."
pip install -r requirements.txt
echo "Setting up database..."
python manage.py migrate
echo "Loading fixtures..."
python manage.py loaddata initial_data.json
echo "Setup complete!"
Flag set -e itu krusial — tanpa itu, script lanjut jalan meski ada step yang gagal.
Integrasi dengan Git: Commit devcontainer ke Repo
Ini bukan file yang harus di-gitignore. Justru sebaliknya — commit .devcontainer/ ke repo adalah tujuannya. Siapapun yang clone repo kamu langsung punya environment yang sama.
Satu pengecualian: kalau devcontainer.json kamu reference secret atau credential, jangan hardcode di sana. Pakai localEnv untuk pull dari environment variable host:
{
"remoteEnv": {
"GITHUB_TOKEN": "${localEnv:GITHUB_TOKEN}",
"NPM_TOKEN": "${localEnv:NPM_TOKEN}"
}
}
Variable ini dibaca dari environment host kamu, bukan dari file — jadi aman untuk di-commit.
Yang Gue Lakuin Sekarang
Semua project baru gue sekarang mulai dengan setup devcontainer dulu sebelum nulis satu baris kode pun. Workflow-nya:
mkdir project-baru && cd project-baru- Bikin
.devcontainer/devcontainer.jsonminimal - Buka di VS Code, klik "Reopen in Container"
- Mulai coding dari dalam container
Buat project lama yang belum punya devcontainer, gue tambahkan secara incremental — mulai dari image sederhana dulu, tambah services dan customization sesuai kebutuhan.
Satu hal yang langsung kerasa bedanya: onboarding jadi trivial. Dulu kalau mau ngajak teman review kode atau pair programming, mereka harus setup environment dulu — bisa setengah jam. Sekarang: clone, buka VS Code, tunggu container build (biasanya 2-3 menit pertama kali, selanjutnya cepet karena cache), langsung jalan.
Kalau kamu belum punya Docker Desktop, install dulu — itu prerequisite utama. Di Linux, Docker Engine langsung cukup tanpa perlu Desktop. Setelah itu, install extension "Dev Containers" di VS Code (ID: ms-vscode-remote.remote-containers), dan kamu udah siap.
Coba mulai dari project yang paling sering kamu setup ulang. Itu kandidat pertama yang paling worth dikonversi ke devcontainer.