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.

--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.
