Debugging aplikasi yang dikontainerisasi melibatkan inspeksi logs, mendapatkan shell di dalam container, memeriksa konfigurasi dan state, dan mendiagnosis masalah umum (crash, networking, resources). Mengetahui cara melakukan troubleshooting adalah keterampilan praktis yang esensial.
docker ps -a
docker logs <container>
docker logs -f -- 100 <container>
docker inspect <container>
docker events
docker logs biasanya merupakan langkah pertama — menampilkan output aplikasi dan error. docker ps -a menunjukkan apakah container telah keluar (dan kode exit-nya).
# run an interactive shell inside a RUNNING container to investigate
docker exec -it <container> bash # or sh (alpine)
# → inspect files, run commands, check the environment, test connectivity from inside
# if the container won't STAY running, override the entrypoint to get a shell
docker run -it --entrypoint sh myimage
docker exec -it ... bash memberikan shell di dalam container yang sedang berjalan — sangat berharga untuk inspeksi file, pengecekan environment, dan testing konektivitas dari perspektif container.
Container EXITS immediately → check `docker logs`; the main process crashed or finished
(a container stops when its main process exits) — check CMD/ENTRYPOINT, errors
CAN'T CONNECT between containers → check they're on the same network; use service NAMES
(not localhost); verify ports; `docker network inspect`
PORT not accessible → check -p mapping; the app must listen on 0.0.0.0 (not 127.0.0.1)
OUT OF MEMORY / killed → check `docker stats`, resource limits (OOMKilled in inspect)
PERMISSION errors → file ownership/user (non-root user vs mounted volume permissions)
IMAGE issues → rebuild without cache (--no-cache); check the build context/.dockerignore
Mengetahui cara melakukan debug dan troubleshooting Docker container adalah keterampilan praktis yang esensial, karena aplikasi yang dikontainerisasi pasti memiliki masalah (crash, connectivity problems, configuration errors) yang harus didiagnosis, dan lingkungan yang dikontainerisasi menambah lapisan yang memerlukan teknik debugging spesifik.
Keterampilan fundamental — inspeksi logs (docker logs, biasanya langkah pertama, menampilkan output aplikasi dan error), pengecekan status (docker ps -a menunjukkan apakah dan mengapa container keluar, termasuk exit codes), dan pemeriksaan konfigurasi/state (docker inspect) — adalah cara Anda mulai mendiagnosis sebagian besar masalah.
Mendapatkan shell di dalam container (docker exec -it ... bash) adalah teknik yang sangat berharga untuk investigasi dari perspektif container — inspeksi file, pengecekan environment, dan testing konektivitas — dan mengetahui cara mendapatkan shell bahkan ketika container tidak tetap berjalan (override entrypoint) menangani kasus yang sulit.
Memahami masalah umum dan diagnosis mereka sangat berharga: container yang keluar segera (proses utama crash atau selesai — periksa logs dan CMD/ENTRYPOINT), masalah konektivitas antar-container (network membership, menggunakan service names bukan localhost), port tidak dapat diakses (mapping, dan gotcha umum bahwa aplikasi harus listen pada 0.0.0.0 bukan 127.0.0.1), out-of-memory kills, dan permission errors — ini adalah masalah nyata dan berulang yang mengetahui cara mengenali dan memperbaikinya menghemat waktu signifikan.
Karena aplikasi yang dikontainerisasi memiliki masalah yang harus didebug, dan karena troubleshooting yang efektif (logs, exec ke container, inspect, dan pengenalan common failure patterns) diperlukan untuk mendiagnosis dan menyelesaikannya, mengetahui cara melakukan debug Docker container adalah keterampilan praktis yang esensial dan sering diterapkan untuk siapa pun yang menjalankan aplikasi yang dikontainerisasi, kompetensi operasional inti yang mengubah masalah container yang membingungkan menjadi masalah yang dapat diselesaikan.