맥 재부팅 후 Docker Django 자동 복구 설정법

맥 재부팅 후 Docker Django 사이트 50개를 자동 복구하려면? restart: unless-stopped, DB healthcheck와 depends_on, Docker Desktop 로그인 시 시작이 필요합니다.

조회 57
맥 재부팅 후 Docker Django 자동 복구 설정법

핵심 요약

  • restart 정책, DB healthcheck, Docker Desktop 자동 시작 셋 중 하나만 빠져도 복구가 멈춘다.
  • unless-stopped는 직접 멈춘 컨테이너를 재부팅 때 되살리지 않아 점검용 사이트를 지켜 준다.
  • 50개 사이트는 템플릿화하고 docker inspect로 정책을 점검한 뒤 재부팅 리허설을 해 보자.

맥을 재부팅한 뒤 Docker로 띄운 Django 사이트 50개를 사람 손 없이 살리려면 세 가지가 필요합니다. 컨테이너마다 restart: unless-stopped를 두고, DB에는 healthcheck와 depends_on: condition: service_healthy를 걸고, Docker Desktop은 로그인 시 자동으로 시작되게 하면 됩니다. 이 셋 중 하나라도 빠지면 복구가 중간에 멈춥니다.

복구 순서부터 그려 보기

맥이 재부팅된 뒤에는 다음 순서로 복구가 진행됩니다.

  1. 맥이 부팅되고 사용자가 로그인합니다.
  2. Docker Desktop이 시작되고 Docker 데몬이 올라옵니다.
  3. 데몬이 restart 정책에 따라 컨테이너를 다시 시작합니다.
  4. DB가 준비된 뒤에 Django 앱이 요청을 받습니다.

1번과 2번 사이가 가장 자주 끊깁니다. Docker Desktop for Mac은 로그인 시 시작 옵션을 켜 두어야 하기 때문입니다. 이 옵션이 꺼져 있으면 컨테이너 설정이 아무리 완벽해도 데몬이 올라오지 않습니다. 또 로그인이 복구의 출발점이라서, 로그인 없이 부팅만 된 상태에서는 시작되지 않을 수 있다는 점을 염두에 두세요. 서버 용도의 맥이라면 자동 로그인 여부도 함께 점검하세요.

restart 정책: unless-stopped를 기본값으로

Docker 공식 문서에 따르면 unless-stopped는 컨테이너가 종료되거나 데몬이 재시작될 때 컨테이너를 다시 시작합니다. 다만 사용자가 직접 멈춘 컨테이너는 다시 시작하지 않습니다. 같은 문서는 always와의 차이도 설명합니다. unless-stopped는 컨테이너가 멈춘 상태라면 데몬이 재시작되어도 되살리지 않습니다.

이 차이는 운영에서 의미가 큽니다. 점검하려고 일부러 내린 사이트가 재부팅 때 제멋대로 올라오는 일을 막아 주기 때문입니다. 같은 문서는 프로세스 매니저로 컨테이너를 띄우기보다 restart 정책을 쓰라고 권장하기도 합니다. launchd 스크립트로 docker start를 돌리는 방식보다 정책 쪽이 낫다는 뜻입니다.

이미 떠 있는 컨테이너는 docker update --restart unless-stopped <이름>으로 정책을 바꿀 수 있습니다. 문서에는 실행 중인 모든 컨테이너에 적용하는 예시도 있으니, 사이트가 50개라면 일일이 고치지 말고 그 방식을 참고하세요. 다만 Compose 파일에 정책이 없으면 다음 up 때 원래대로 돌아갈 수 있으니 파일에도 반드시 적어 두세요.

healthcheck와 depends_on으로 순서 보장

restart 정책만으로는 시작 순서가 보장되지 않습니다. 컨테이너가 동시에 올라오면 Django가 아직 준비되지 않은 DB에 접속하다 실패하고, 재시작을 반복하게 될 수 있습니다. Compose 문서의 depends_on에 따르면 condition: service_healthy를 쓰면 의존하는 서비스가 healthy 상태가 된 뒤에 앱을 시작할 수 있습니다.

services:
  db:
    image: postgres:16
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 3s
      retries: 10
  web:
    build: .
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy

위 설정은 한 사이트 기준의 예시입니다. healthcheck의 간격과 재시도 횟수는 DB 크기와 기동 시간에 맞춰 조절하세요. 이 값들의 적정 수치는 공식 문서에서 정해 주지 않으므로 환경에 맞게 정해야 합니다.

사이트 50개일 때 주의할 점

사이트가 50개면 부팅 직후 컨테이너 수백 개가 한꺼번에 시작될 수 있습니다. 이때 부하가 얼마나 걸리는지, 그에 따라 복구 시간이 얼마나 되는지는 공식 문서에서 확인되지 않았습니다. 그러니 실제 환경에서 재부팅 리허설을 한 번은 해 보세요. 기동이 오래 걸리는 사이트는 healthcheck의 재시도 횟수를 넉넉히 잡는 편이 안전합니다.

50개 사이트를 관리하는 방법으로는 템플릿화를 권합니다. 공통 설정은 하나의 Compose 템플릿에 두고 사이트별 값만 환경 변수로 바꾸면, 정책 누락 같은 사람의 실수가 줄어듭니다. 점검도 한 줄 명령으로 할 수 있습니다. docker inspect로 각 컨테이너의 RestartPolicy를 뽑아 unless-stopped가 아닌 것만 걸러 내면 됩니다.

실천 가이드

다음 체크리스트를 위에서부터 확인하세요.

단계 점검 항목
1 Docker Desktop 설정에서 로그인 시 시작 옵션 켜기
2 맥의 자동 로그인 또는 로그인 절차 정리
3 모든 서비스(web, db, 캐시)에 restart: unless-stopped 지정
4 DB·캐시에 healthcheck 추가
5 앱 서비스에 depends_on과 condition: service_healthy 지정
6 docker inspect로 정책 누락 컨테이너 일괄 점검
7 실제 재부팅 후 50개 사이트 응답을 확인하는 스크립트 실행

이 중 1번과 5번이 가장 많이 빠지는 항목입니다. 자동 복구는 평소에 티가 나지 않다가 재부팅 때 한꺼번에 드러나므로, 점검 날짜를 정해 두고 리허설을 반복하는 것이 좋습니다. 특히 의도적으로 내려 둔 사이트가 재부팅 후에도 내려가 있는지는 unless-stopped 동작과 함께 꼭 확인하세요.

자주 묻는 질문

Q. 맥 재부팅 후 Docker 컨테이너가 안 올라오는 가장 흔한 원인은 무엇인가요?

로그인 시 Docker Desktop이 시작되도록 하는 옵션이 꺼져 있는 경우가 가장 자주 끊기는 지점입니다. 이 옵션이 꺼져 있으면 컨테이너 설정이 완벽해도 데몬이 올라오지 않습니다. 서버용 맥이라면 자동 로그인 여부도 함께 점검하세요.

Q. restart 정책은 always 대신 unless-stopped를 써야 하나요?

unless-stopped는 사용자가 직접 멈춘 컨테이너를 데몬이 재시작되어도 되살리지 않습니다. 점검하려고 내려 둔 사이트가 재부팅 때 제멋대로 올라오는 일을 막아 주므로 기본값으로 권합니다.

Q. Django가 DB보다 먼저 떠서 실패하는 문제는 어떻게 막나요?

DB 서비스에 healthcheck를 설정하고 앱 서비스에 depends_on의 condition: service_healthy를 지정하면 됩니다. 그러면 DB가 healthy 상태가 된 뒤에 앱이 시작됩니다. 간격과 재시도 횟수는 환경에 맞게 조절해야 합니다.

참고 자료

이 글은 웹 검색으로 확인한 위 출처를 바탕으로 AI(claude-sonnet-5-5)가 작성했습니다. 수치·가격은 출처 원문에서 다시 확인하세요.

#Django#Docker#Docker Compose#healthcheck#restart policy#맥#자동 복구#재부팅