Docker контејнер се одмах гаси: како пронаћи узрок и поправити

Како се проблем препознаје

• `docker ps` не приказује контејнер, а `docker ps -a` га води као Exited
• Контејнер се покрене па нестане у року од неколико секунди
• У логовима нема ничега или само порука о грешци при старту
• Апликација ради локално, али у контејнеру одмах изађе
• Exit код је 0, 1, 127 или 137

Најчешћи узроци

Решење корак по корак

1. 1

   Проверите статус и exit код

   Покрените docker ps -a да видите све контејнере, укључујући угашене. Обратите пажњу на колону STATUS и на exit код. Код 0 значи да је процес завршио нормално, 1 је општа грешка, 127 непостојећа команда, а 137 указује на присилно заустављање, често због меморије.

2. 2

   Прегледајте логове

   Покрените docker logs <ime_ili_id>. Ако је контејнер угашен, додајте --tail 100 да видите последњих сто линија. Логови најчешће садрже тачан разлог, на пример грешку у конфигурацији или поруку да команда није пронађена.

3. 3

   Покрените контејнер интерактивно

   Заобилазите стартну команду и уђите у љуску: docker run -it --entrypoint /bin/sh <slika>. Ако слика нема sh, пробајте bash. Унутар контејнера ручно покрените апликацију и видите грешку коју иначе не видите.

4. 4

   Проверите команду и entrypoint

   Погледајте Доцкерфиле и docker run команду. Уверите се да је CMD или ENTRYPOINT у исправном формату и да путања до извршног фајла постоји. Ако користите docker compose, проверите поље command у docker-compose.yml.

5. 5

   Уверите се да главни процес остаје у првом плану

   Апликација не сме да се покреће у позадини нити да заврши одмах. Ако је у питању скрипта, додајте на крај петљу или покрените server који слуша. За контејнере који само треба да остану активни, користите tail -f /dev/null као привремено решење.

6. 6

   Проверите променљиве окружења и конфигурацију

   Упоредите docker inspect <kontejner> са оним што апликација очекује. Недостајуће променљиве додајте кроз -e или у environment секцији. Проверите и да ли су фајлови конфигурације монтирани на исправну путању.

7. 7

   Проверите дозволе и власништво

   Ако апликација пише у волумен или фолдер, уверите се да корисник унутар контејнера има дозволу. У docker run додајте --user или прилагодите Доцкерфиле. Грешке са дозволама често се виде у логовима као Permission denied.

8. 8

   Искључите хеалтхцхецк и зависности

   Ако користите Цомпосе, привремено коментаришите healthcheck и depends_on да видите да ли контејнер самостално ради. Затим их враћајте једну по једну и посматрајте понашање.

9. 9

   Поново изградите слику

   Ако сте мењали Доцкерфиле, покрените docker build --no-cache -t <ime> . па поново покрените контејнер. Кеширани слој може да сакрије измену која је узрок проблема.

Ако ништа не помогне

Како да спречите да се понови

• Увек користите `docker logs` и exit код пре него што мењате било шта.
• У Доцкерфиле-у експлицитно наведите `CMD` или `ENTRYPOINT` и тестирајте га локално.
• Повремено чистите заустављене контејнере, неискоришћене мреже и данглинг слике командом `docker system prune`; пре покретања проверите шта ће бити уклоњено и направите резервну копију важних података.
• У Цомпосе фајлу дефинишите хеалтхцхецк и `restart: unless-stopped` за сервисе који треба да раде стално.

Честа питања