elsa in mac

최근, Fedora 업데이트 후 docker.service 가 실행이 되지 않는 경우 대처법 본문

Linux

최근, Fedora 업데이트 후 docker.service 가 실행이 되지 않는 경우 대처법

elsa in mac 2025. 4. 29. 20:14

Fedora 42 업데이트 후, 최근 Docker가 실행되지 않는 버그가 발생하고 있습니다. 

Job for docker.service failed because the control process exited with error code.
See "systemctl status docker.service" and "journalctl -xeu docker.service" for details.
Failed to start Docker

요런 오류가 발생하는데.. 구체적으로 어떤 것이 문제인지를 확인하기 위해서 journalctl -u docker.service -b 를 실행해 보니, 아래와 같은 로고가 표시됩니다. bridge driver를 생성할 수 없는 오류가 발생한 것인데, 그 이유가 iptables라는 것을 실행할 수 없기 때문 이라는 것이네요.

systemd[1]: Starting docker.service - Docker Application Container Engine...
dockerd[1373]: time="2025-04-29T17:45:53.704919965+09:00" level=info msg="Starting up"
dockerd[1373]: time="2025-04-29T17:45:53.705357923+09:00" level=info msg="OTEL tracing is not configured, using no-op tracer provider"
dockerd[1373]: time="2025-04-29T17:45:53.711453298+09:00" level=info msg="Creating a containerd client" address=/run/containerd/containerd.sock timeout=1m0s
dockerd[1373]: time="2025-04-29T17:45:53.762264631+09:00" level=info msg="[graphdriver] using prior storage driver: overlay2"
dockerd[1373]: time="2025-04-29T17:45:53.779856215+09:00" level=info msg="Loading containers: start."
dockerd[1373]: time="2025-04-29T17:45:54.137610631+09:00" level=warning msg="failed to find iptables" error="exec: \"iptables\": executable file not found in $PATH"
dockerd[1373]: time="2025-04-29T17:45:54.140075048+09:00" level=info msg="stopping event stream following graceful shutdown" error="<nil>" module=libcontainerd namesp>
dockerd[1373]: failed to start daemon: Error initializing network controller: error obtaining controller instance: failed to register "bridge" driver: failed to creat>
systemd[1]: docker.service: Main process exited, code=exited, status=1/FAILURE

문제가 되는 log 부분은 

level=warning msg="failed to find iptables" error="exec: \"iptables\": executable file not found in $PATH"

iptables 라는 tool을 실행할 수 없다는 것이고, 확인을 해 보니, 해당 CLI가 존재하지 않는다는 것을 알게 되었습니다. (이게 왜 갑자기 사라진 것일까 ?)

문제를 해결하기 위해서는 iptables-legacy라는 패키지를 재 설치(reinstall) 해야 합니다. 

설치가 되었다면, 아래와 같이 설치가 잘 되었는지를 확인합니다. 

이제, 다시 docker를 실행해 보면, 정상적으로 실행하는 것을 확인할 수 있습니다. 

다시 복구하는 방법을 찾긴 했지만, 근본적으로 왜 이런 문제가 갑자기 발생했는지는 아직 파악되고 있지 않습니다. 흠..

Fedora에서 Docker를 사용하시는 분들 중에 갑지기 docker가 실행되지 않는다면, 검토해 보시기 바랍니다. 

공유하기 링크
Comments