🐳 컨테이너 세탁소: 재시작만으론 안 되는 도커의 깊은 세탁 비밀

들어가며

도커 컨테이너를 운영하다 보면 가끔 이상한 일이 발생합니다. "분명히 설정을 바꿨는데 왜 적용이 안 되지?" 하는 순간들... 도커 컨테이너를 재시작했는데도 변경 사항이 적용되지 않아 당황스러웠던 경험이 있으신가요?

나의 좌충우돌 도커 경험담

최근 저는 Kibana와 Fluentd를 사용하여 로그 수집 시스템을 운영하고 있었습니다. 어느 날 Fluentd의 설정을 일부 변경해야 했습니다. 변경 후 당연히 docker-compose restart로 재시작하면 적용될 거라 생각했죠. 하지만...

변경 사항이 적용되지 않았습니다! 로그를 확인해보니 볼륨에 설정 파일이 제대로 복사되지 않았던 겁니다. 결국 docker-compose down을 하고 docker-compose up을 했더니 모든 것이 정상 작동했습니다.

"도대체 무슨 차이지?" 하는 의문이 생겼고, 이 차이점을 이해하기 위한 여정이 시작되었습니다.

restart vs down-up: 도커의 두 가지 재부팅 방식

🔄 docker-compose restart

docker-compose restart는 마치 컴퓨터의 '재부팅' 버튼을 누르는 것과 비슷합니다. 컨테이너의 프로세스를 중지하고 다시 시작하지만, 컨테이너 자체는 그대로 보존합니다.

• 실행 중인 컨테이너를 중지한 후 동일한 컨테이너를 재시작합니다.
• 기존 컨테이너, 네트워크, 볼륨 및 설정이 모두 그대로 유지됩니다.
• 프로세스만 재시작하므로 재시작 과정이 빠릅니다.
• 중요: docker-compose.yml 파일에 변경이 있어도 이를 반영하지 않습니다.
• 더 중요: 이미지가 업데이트되어도 새 이미지를 가져오지 않습니다.

🧹 docker-compose down 후 up

반면 down-up 조합은 마치 컴퓨터를 완전히 끄고 다시 켜는 것과 같습니다. 모든 것을 제거한 후 처음부터 다시 시작하는 것이죠.

• down 명령어로 현재 생성된 컨테이너와 네트워크를 모두 제거합니다.
• up 명령어로 최신 설정을 바탕으로 컨테이너를 새로 생성하고 시작합니다.
• 완전히 새로운 컨테이너가 생성되므로 docker-compose.yml 파일의 모든 변경 사항이 반영됩니다.
• 새 이미지가 있다면 풀(pull)하여 사용합니다(기본적으로 또는 --pull 옵션 사용 시).
• 다만, 컨테이너를 완전히 제거하고 재생성하기 때문에 재시작보다 시간이 더 오래 걸립니다.

왜 내 설정은 적용되지 않았을까?

제 경우에는 Fluentd의 설정 파일을 변경했지만, 이 변경 사항이 도커 볼륨에 제대로 반영되지 않았습니다. restart는 단순히 컨테이너 내부의 프로세스만 재시작하므로 이미지를 다시 빌드하거나 볼륨을 다시 마운트하지 않았던 것입니다.

반면 down-up 방식은 컨테이너를 처음부터 다시 생성하기 때문에:
1. 모든 볼륨이 새로 마운트됩니다
2. docker-compose.yml의 변경 사항이 새 컨테이너에 적용됩니다
3. 이미지도 필요하다면 다시 빌드되거나 풀됩니다

이것이 제 설정 변경이 down-up 후에야 적용된 이유입니다.

어떤 상황에서 어떤 명령어를 사용해야 할까?

restart를 사용해야 할 때

• 간단한 애플리케이션 재시작이 필요할 때
• 컨테이너 내부의 프로세스 문제만 있을 때
• 빠른 재시작이 필요하고 설정 변경이 없을 때
• 세션 정보 등 컨테이너의 현재 상태를 유지하고 싶을 때

down-up을 사용해야 할 때

• docker-compose.yml 파일을 변경했을 때
• 이미지를 업데이트했을 때
• 볼륨 마운트나 환경 변수를 변경했을 때
• 네트워크 설정을 변경했을 때
• 컨테이너를 완전히 초기화하고 싶을 때

유용한 팁

하나만 알고 가자! down 명령어의 옵션들

docker-compose down에는 중요한 옵션들이 있습니다:

• --volumes 또는 -v: 이름 있는 볼륨도 함께 제거합니다
• --rmi all: 모든 이미지를 제거합니다
• --remove-orphans: 더 이상 docker-compose.yml에 정의되지 않은 서비스의 컨테이너도 제거합니다

이 옵션들을 상황에 맞게 사용하면 더 깔끔하게 환경을 정리할 수 있습니다.

설정 변경 시 권장 워크플로우

1. docker-compose.yml 또는 관련 설정 파일 변경
2. docker-compose down으로 기존 컨테이너와 네트워크 제거
3. docker-compose up -d로 백그라운드에서 새 설정으로 시작

마치며

도커 컨테이너를 세탁하는 데는 두 가지 방법이 있습니다. 표면적인 먼지만 털어내는 '재시작 세탁'과 속까지 깨끗하게 하는 '완전 세탁(down-up)'. 상황에 맞는 적절한 세탁 방법을 선택하는 것이 도커 컨테이너의 건강한 운영을 위한 첫걸음입니다.

제 실수 덕분에 여러분은 이런 문제를 미리 예방할 수 있게 되었네요! 행복한 도커 라이프를 즐기세요~ 🐳