헬스체크 & 자동 재시작 — 24/7 무중단 운영

💡 unless-stopped는 always와 유사하게 동작하지만, 수동으로 docker stop으로 중지한 경우에는 Docker 데몬이 재시작되어도 컨테이너를 자동으로 시작하지 않습니다. 이것이 운영 환경에서 unless-stopped를 권장하는 이유입니다. 유지보수를 위해 의도적으로 중지한 컨테이너가 의도치 않게 재시작되는 것을 방지합니다.

💡 start_period는 컨테이너가 시작된 직후 일정 시간 동안 헬스체크 실패를 무시하는 유예 기간입니다. n8n의 경우 DB 마이그레이션이 완료되기까지 시간이 필요하므로 start_period를 120s 정도로 설정해야 합니다. 유예 기간 없이 바로 체크하면 정상 시작 중인데도 unhealthy로 판단될 수 있습니다.

💡 service_started(기본값)는 컨테이너 프로세스가 시작되기만 해도 조건이 충족됩니다. 하지만 PostgreSQL은 프로세스가 시작된 후에도 초기화가 완료될 때까지 연결을 받지 않습니다. service_healthy를 사용하면 pg_isready 헬스체크가 통과된 후, 즉 실제로 연결 가능한 상태가 된 후에 n8n이 시작됩니다.

💡 docker-compose.yml에서 로그 크기를 제한하려면 logging 섹션에 driver와 options를 설정해야 합니다. max-size는 파일당 최대 크기, max-file은 보관할 최대 파일 수입니다. max-size: 10m, max-file: 3으로 설정하면 총 30MB의 로그가 유지되고 이후 로그는 순환됩니다.

💡 docker inspect 명령어에서 .State.Health 경로를 통해 헬스체크 상태(Status, FailingStreak, Log)를 확인할 수 있습니다. Status는 starting/healthy/unhealthy 중 하나이며, FailingStreak는 연속 실패 횟수, Log는 최근 헬스체크 실행 결과 목록입니다.