Panduan Praktikal Penyelesaian Masalah Runtime Kontena Docker

Senario

Kontena Docker dalam pengeluaran keluar secara tiba-tiba dengan status "Exited (1)". Aplikasi sebelum ini berjalan stabil. Kontena berdasarkan imej tersuai dan menggunakan tetapan runtime lalai.

Gejala

• docker ps menunjukkan status kontena sebagai "Exited"
• docker logs <container> mencetak ralat runtime seperti "exec: permission denied" atau "OCI runtime create failed"
• Log sistem (contohnya journalctl -u docker) menunjukkan ralat containerd atau runc
• Kontena gagal dimulakan walaupun selepas restart manual

Langkah Diagnosis

1. Periksa log kontena: docker logs <container> untuk output terkini
2. Periksa keadaan kontena: docker inspect <container> --format='{{json .State}}' untuk melihat kod keluar dan mesej ralat
3. Periksa kesihatan daemon Docker: systemctl status docker atau journalctl -u docker -n 100
4. Uji runtime asas: docker run --rm busybox echo test untuk mengesahkan enjin kontena berfungsi
5. Periksa had sumber: docker inspect <container> | jq '.[].HostConfig.Memory' untuk mengesahkan tetapan memori dan CPU
6. Sahkan integriti imej: docker run --rm <image> /bin/sh -c 'ls' untuk memastikan imej berfungsi

Arahan Utama

docker logs <container>
docker inspect <container>
docker system df   # Periksa penggunaan cakera
journalctl -u docker -n 50 --no-pager
cat /var/log/syslog | grep docker

Kawalan Risiko

• Gunakan --restart=always atau --restart=on-failure untuk memulakan semula kontena secara automatik
• Tetapkan had sumber (--memory, --cpus) untuk mengelakkan OOM
• Elakkan penggunaan --privileged yang tidak perlu
• Laksanakan arahan HEALTHCHECK dalam Dockerfile

Prosedur Pemulihan

• Jika versi imej baru menyebabkan masalah, kembali ke tag stabil: docker pull <image>:stable kemudian buat semula kontena
• Jika fail konfigurasi diubah, pulihkan dari sandaran dan restart
• Gunakan docker commit untuk membuat snapshot keadaan kontena semasa (langkah sementara sahaja)

Langkah Pengesahan

1. Selepas memulakan kontena, lihat log: docker logs -f <container>
2. Periksa status kontena: docker ps sepatutnya menunjukkan "Up"
3. Lakukan pemeriksaan kesihatan aplikasi (contohnya titik akhir curl)
4. Uji beban untuk memastikan kestabilan di bawah trafik yang dijangka

Bila Menghantar Tiket OpsGlobal

• Penyelesaian masalah asas gagal dan analisis peringkat sistem diperlukan
• Disyaki isu kernel, pemacu storan, atau plugin rangkaian (contohnya overlay)
• Perlu mengubah suai konfigurasi daemon Docker atau menaik taraf versi Docker
• Memerlukan bantuan profesional untuk memulihkan data atau mengoptimumkan prestasi