Docker run --rm - co usuwa i kiedy go używać?

Tymoteusz Maciejewski • 17 listopada 2026
Docker, n8n, PostgreSQL, certbot, Qdrant, Baserow. Użyj `docker run --rm` do uruchomienia i usunięcia kontenera.

Spis treści

Uruchamiasz jednorazowy kontener do testu albo skryptu w CI, a po chwili na liście zostaje kolejny wpis ze statusem `Exited`. Flaga `--rm` usuwa kontener po zakończeniu procesu, choć przy danych zapisanych w wolumenie anonimowym trzeba uważać na dodatkowy skutek.

Diagram stanów kontenera Docker: od Created przez Started, Exited, Paused do Dead. `docker run` tworzy i uruchamia.

--rm sprząta kontener po zakończeniu procesu, ale nie każdy zapisany plik

  • Składnia: dodaj `--rm` do `docker run`, na przykład `docker run --rm alpine echo gotowe`.
  • Dane: system plików kontenera i przypisane do niego wolumeny anonimowe zostaną usunięte.
  • Trwałość: nazwany wolumen i bind mount pozostają poza cyklem życia kontenera.
  • Debugowanie: jeśli potrzebujesz później sprawdzić zatrzymany kontener, nie dodawaj tej flagi.
  • Restart: `--rm` nie łączy się z polityką `--restart` w zwykłym `docker run`.

Dodaj `--rm` do jednorazowego zadania, nie do usługi

Krótki kontener do konwersji pliku, testu lub migracji powinien zwykle zniknąć po wykonaniu swojej pracy. W typowym poleceniu umieść flagę przed nazwą obrazu: docker run --rm alpine echo gotowe. Docker usunie kontener po zakończeniu procesu, więc nie trzeba później ręcznie wykonywać `docker rm`.

Uważam, że to dobry domyślny wybór dla zadań jednorazowych, o ile wynik trafia na standardowe wyjście albo do miejsca, które przetrwa usunięcie kontenera. Pełne zachowanie flagi opisuje dokumentacja polecenia `docker run`.

W kontenerze interaktywnym możesz połączyć sprzątanie z terminalem: docker run -it --rm ubuntu bash. Po wyjściu z powłoki kontener zniknie, więc ten wariant jest wygodny do krótkich eksperymentów, ale kiepski, gdy chcesz później wrócić do jego stanu.

Anonimowy wolumen znika, nazwany wolumen zostaje

Tu najłatwiej o nieprzyjemną niespodziankę. `--rm` usuwa anonimowe wolumeny przypisane do kontenera, ale nie usuwa wolumenu nazwanego ani bind mountu, czyli katalogu hosta podpiętego do kontenera.

Przykład: zapis do `/tmp/wynik` wewnątrz systemu plików kontenera przepadnie, a zapis do `/dane` podpiętego z nazwanego wolumenu pozostanie. Z kolei przy `-v /dane` bez nazwy wolumenu Docker może utworzyć wolumen anonimowy i usunąć go wraz z kontenerem. Różnicę między tymi przypadkami opisuje dokumentacja wolumenów Docker.

To rozwiewa częsty mit, że `--rm` kasuje wszystkie dane powiązane z uruchomieniem. Usuwa kontener i jego warstwę zapisu, a także powiązane wolumeny anonimowe; trwałość danych zależy od tego, gdzie zostały zamontowane.

Po logach i stanie kontenera dobierz flagę do zadania

Wyobraź sobie test w potoku CI, który kończy się błędem. Jeśli uruchomiono go z `--rm`, kontener zostaje posprzątany i nie da się później obejrzeć jego zatrzymanego stanu przez `docker inspect` ani pobrać logów poleceniem `docker logs`. W takiej sytuacji logi trzeba przechwycić podczas uruchomienia albo zostawić kontener do diagnostyki.

Prosta reguła: jeśli polecenie ma jednorazowo wykonać pracę i nie potrzebujesz oglądać kontenera po zakończeniu, użyj `--rm`; jeśli diagnozujesz awarię, pomiń flagę i usuń kontener dopiero po sprawdzeniu logów.

Sytuacja Skutek Co zrobić
Jednorazowy skrypt wypisuje wynik w terminalu Kontener znika po zakończeniu Uruchom z `--rm`
Proces zakończył się błędem, a potrzebne są logi lub inspekcja Usunięty kontener nie będzie dostępny do późniejszej kontroli Pomiń `--rm`, sprawdź `docker logs` i `docker inspect`
Wynik ma przetrwać usunięcie kontenera Pliki w warstwie kontenera znikną, dane na trwałym montowaniu pozostaną Zapisuj do nazwanego wolumenu lub bind mountu
Usługa ma uruchamiać się ponownie po awarii `--rm` nie pasuje do polityki restartu w `docker run` Usuń `--rm` i skonfiguruj `--restart`

W Compose użyj `run --rm` dla zadania, nie dla procesu usługi

Gdy projekt korzysta z Docker Compose, jednorazowe polecenie uruchamia się przez `docker compose run --rm`. Na przykład docker compose run --rm web python manage.py migrate wykona komendę w usłudze `web`, a potem usunie utworzony kontener zadania.

To odrębny przypadek od stałego procesu aplikacji opisanego w pliku Compose. Dokumentacja polecenia `docker compose run` wskazuje też, że `run` domyślnie nie mapuje portów skonfigurowanych dla usługi. Jeśli polecenie ma wystawić te porty, dodaj `--service-ports`.

W zwykłym `docker run` nie łącz `--rm` z `--restart`: Docker zgłasza błąd, bo automatyczne usunięcie kontenera po wyjściu kłóci się z jego ponownym uruchamianiem. Krótki job sprzątaj, usługę restartuj; te dwa zamiary wymagają różnych konfiguracji.

Najpierw zdecyduj, co ma zostać po zakończeniu

Jeśli po wykonaniu zadania potrzebujesz wyłącznie wyniku, `docker run --rm` ogranicza ręczne porządki i nie pozostawia kolejnych zatrzymanych kontenerów. Gdy może przydać się analiza awarii, zachowaj kontener do czasu sprawdzenia logów, a pliki, które mają przetrwać w obu wariantach, zapisuj poza jego warstwą zapisu.

W praktyce decyzję można sprowadzić do jednego pytania: czy po zakończeniu procesu chcesz zachować sam kontener, czy tylko jego wynik? Od odpowiedzi zależy, czy `--rm` będzie poręcznym sprzątaniem, czy utrudni debugowanie.

FAQ - Najczęstsze pytania

Docker usuwa kontener wraz z jego warstwą zapisu oraz przypisane do niego wolumeny anonimowe. Flaga nie usuwa nazwanego wolumenu ani bind mountu, czyli katalogu hosta podpiętego do kontenera.

Pliki, które mają przetrwać usunięcie kontenera, zapisuj w nazwanym wolumenie albo bind mouncie. Zapis do ścieżki należącej do systemu plików kontenera, na przykład /tmp/wynik, zniknie, natomiast dane w trwałym montowaniu pozostaną. Przy -v /dane bez nazwy może powstać wolumen anonimowy, który zostanie usunięty.

Jeśli po awarii chcesz sprawdzić stan kontenera, obejrzeć logi przez docker logs lub użyć docker inspect, pomiń --rm. Po zakończeniu analizy możesz usunąć kontener ręcznie.

Dla jednorazowego zadania użyj polecenia docker compose run --rm web python manage.py migrate. Utworzony kontener zadania zostanie później usunięty, ale run domyślnie nie mapuje portów skonfigurowanych dla usługi. Jeśli są potrzebne, dodaj --service-ports.

Te opcje realizują sprzeczne cele: --rm usuwa kontener po zakończeniu procesu, a --restart ma uruchamiać go ponownie po awarii lub zakończeniu. Dla krótkiego zadania użyj --rm, a dla usługi pomiń tę flagę i skonfiguruj politykę --restart.

Oceń artykuł

Ocena: 0.00 Liczba głosów: 0

Tagi

docker
kontenery
docker compose
debugowanie
wolumeny
Autor Tymoteusz Maciejewski
Tymoteusz Maciejewski
Moje dni wypełnia zgłębianie kodu i analiza nowych technologii, zawsze z myślą o tym, jak najlepiej przekazać tę wiedzę dalej. Nazywam się Tymoteusz Maciejewski i od 12 lat aktywnie działam w świecie programowania, technologii i kariery w IT. Interesuje mnie nie tylko samo tworzenie oprogramowania, ale także proces, który prowadzi do zrozumienia złożonych zagadnień i uporządkowania ich w przystępny sposób. Na lukasz-zielinski.pl staram się dzielić się tym, co sam odkrywam, sprawdzając informacje u podstaw i dbając o to, by treści były aktualne i zrozumiałe dla każdego, kto chce rozwijać się w tej dynamicznej branży.

Udostępnij artykuł

Napisz komentarz