#!/bin/sh # 용도: NAS 호스트 프로세스로 떠 있는 cloudflared 터널을 # docker compose 컨테이너(profiles: public-cutover-gate)로 이관한다. # 실행: NAS에서 root 권한으로 다음과 같이 실행한다. # sudo sh scripts/nas-migrate-tunnel-to-compose.sh # 안전성: 4단계 검증(컨테이너 running + 터널 연결 로그 + 공개 health 200)이 실패하면 # 호스트 터널을 절대 건드리지 않고 방금 만든 컨테이너만 정리한다. # 호스트 터널을 이미 끈 뒤에 문제가 드러나면 호스트 터널을 자동 재기동해 # 서비스를 복구한다. 그래도 복구가 안 되면 exit 2로 끝내고 수동 조치를 안내한다. # 즉 이 스크립트는 어떤 경로로 끝나도 서비스가 살아 있는 상태를 목표로 한다. # 주의: docker compose 명령 중 설정을 병합해 평문으로 출력하는 하위 명령(config)은 # env-file에 담긴 시크릿을 그대로 표준출력에 뿌리므로 여기서 절대 쓰지 않는다. set -eu PROJECT_DIR="/volume1/docker/vignette-prod" COMPOSE_FILE="docker-compose.nas.yml" ENV_FILE="private/env.nas" CLOUDFLARED_CONFIG="cloudflared/config.yml" CREDENTIAL_SRC="$PROJECT_DIR/private/cloudflared/vignette-tunnel.json" CREDENTIAL_FILENAME="vignette-tunnel.json" VOLUME_NAME="vignette-prod-cloudflared-secrets-20260830" IMAGE="cloudflare/cloudflared@sha256:d9ff527dc19799e24d3689058161fb01e752a24be1823577bae54c9c2489275f" HEALTH_URL="https://api-vignette.chanpaca.net/health" HOST_PID_FILE="$PROJECT_DIR/private/cloudflared-host.pid" SERVICE_NAME="cloudflared" COMPOSE_PROJECT="vignette-prod" POLL_INTERVAL=5 MAX_WAIT=60 echo "[0/5] 사전 점검" if [ "$(id -u)" -ne 0 ]; then echo "오류: root 권한이 필요하다. 다음과 같이 실행하라: sudo sh scripts/nas-migrate-tunnel-to-compose.sh" >&2 exit 1 fi if ! cd "$PROJECT_DIR"; then echo "오류: 프로젝트 디렉터리로 이동할 수 없다: $PROJECT_DIR" >&2 exit 1 fi DOCKER_BIN="" if [ -x /usr/local/bin/docker ]; then DOCKER_BIN="/usr/local/bin/docker" elif command -v docker >/dev/null 2>&1; then DOCKER_BIN="$(command -v docker)" fi if [ -z "$DOCKER_BIN" ]; then echo "오류: docker 명령을 찾을 수 없다." >&2 exit 1 fi echo " docker 명령: $DOCKER_BIN" if [ ! -f "$CREDENTIAL_SRC" ]; then echo "오류: 자격증명 원본 파일이 없다: $CREDENTIAL_SRC" >&2 exit 1 fi for f in "$COMPOSE_FILE" "$ENV_FILE" "$CLOUDFLARED_CONFIG"; do if [ ! -f "$f" ]; then echo "오류: 필수 파일이 없다: $PROJECT_DIR/$f" >&2 exit 1 fi done BEFORE_PUBLIC=$(curl -s -o /dev/null -w "%{http_code}" --max-time 15 "$HEALTH_URL" || echo "000") echo " 이관 전 공개 health 상태: $BEFORE_PUBLIC" if [ "$BEFORE_PUBLIC" != "200" ]; then echo " 경고: 이관 전 공개 health가 200이 아니다. 그래도 이관을 계속 진행한다." fi HOST_PID=$(ps -ef | grep "[c]loudflared" | grep "cloudflared-host.yml" | awk '{print $2}' | head -1) if [ -n "$HOST_PID" ]; then echo " 탐지된 호스트 터널 PID: $HOST_PID" else echo " 호스트 터널 프로세스를 찾지 못했다(이미 종료된 것으로 보고 계속 진행한다)." fi echo "[1/5] 볼륨 준비" if ! "$DOCKER_BIN" volume inspect "$VOLUME_NAME" >/dev/null 2>&1; then echo " 볼륨이 없다. 생성한다: $VOLUME_NAME" "$DOCKER_BIN" volume create "$VOLUME_NAME" >/dev/null else echo " 볼륨이 이미 존재한다: $VOLUME_NAME" fi VOLUME_MOUNT=$("$DOCKER_BIN" volume inspect -f '{{ .Mountpoint }}' "$VOLUME_NAME") echo " 볼륨 마운트 경로: $VOLUME_MOUNT" CRED_PATH="$VOLUME_MOUNT/$CREDENTIAL_FILENAME" if [ -f "$CRED_PATH" ]; then echo " 자격증명 파일이 이미 존재한다. 복사를 건너뛴다." else echo " 자격증명 파일을 복사한다." cp "$CREDENTIAL_SRC" "$CRED_PATH" fi echo " 자격증명 파일 정보(내용은 출력하지 않는다):" ls -la "$CRED_PATH" echo "[2/5] 권한 맞추기" if ! "$DOCKER_BIN" image inspect "$IMAGE" >/dev/null 2>&1; then echo " 이미지를 로컬에서 찾을 수 없다. pull 한다: $IMAGE" "$DOCKER_BIN" pull "$IMAGE" fi IMG_USER=$("$DOCKER_BIN" image inspect "$IMAGE" --format '{{.Config.User}}') echo " 이미지 지정 사용자: '$IMG_USER'" case "$IMG_USER" in ''|root|0) echo " root 사용자로 판단한다 -> chown root:root, chmod 600" chown root:root "$CRED_PATH" chmod 600 "$CRED_PATH" ;; *[!0-9:]*) echo " 경고: 이미지 사용자가 이름 형태('$IMG_USER')라 UID를 자동으로 추측하지 않는다." echo " 경고: root 소유 600 권한을 유지한 채 다음 단계로 진행한다." echo " 경고: 4단계 검증이 실패하면 이 사용자 불일치를 원인으로 먼저 의심하라." chown root:root "$CRED_PATH" chmod 600 "$CRED_PATH" ;; *) UID_PART=${IMG_USER%%:*} echo " 숫자 UID 사용자로 판단한다 -> chown $UID_PART:$UID_PART, chmod 600" chown "$UID_PART:$UID_PART" "$CRED_PATH" chmod 600 "$CRED_PATH" ;; esac echo "[3/5] 컨테이너 기동" EXISTING_STATUS=$("$DOCKER_BIN" ps --filter "label=com.docker.compose.project=$COMPOSE_PROJECT" --filter "label=com.docker.compose.service=$SERVICE_NAME" --format '{{.Status}}' | head -1) UP_OK=true if [ -n "$EXISTING_STATUS" ]; then echo " 컨테이너가 이미 실행 중이다: $EXISTING_STATUS (중복 기동하지 않는다)" else if ! "$DOCKER_BIN" compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" --profile public-cutover-gate up -d --no-deps "$SERVICE_NAME"; then UP_OK=false echo " 오류: 컨테이너 기동 명령이 실패했다." fi fi echo "[4/5] 검증 (최대 ${MAX_WAIT}초, ${POLL_INTERVAL}초 간격 폴링)" ELAPSED=0 VERIFY_OK=false if [ "$UP_OK" = "true" ]; then while [ "$ELAPSED" -lt "$MAX_WAIT" ]; do CONTAINER_STATUS=$("$DOCKER_BIN" ps --filter "label=com.docker.compose.project=$COMPOSE_PROJECT" --filter "label=com.docker.compose.service=$SERVICE_NAME" --format '{{.Names}} {{.Status}}' | head -1) echo " 컨테이너 상태: ${CONTAINER_STATUS:-(없음, 아직 running이 아니다)}" TUNNEL_LOG_HITS=$("$DOCKER_BIN" compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" --profile public-cutover-gate logs "$SERVICE_NAME" 2>/dev/null | grep -c "Registered tunnel connection" || true) TUNNEL_LOG_HITS=${TUNNEL_LOG_HITS:-0} echo " 터널 연결 로그(Registered tunnel connection) 건수: $TUNNEL_LOG_HITS" CURRENT_PUBLIC=$(curl -s -o /dev/null -w "%{http_code}" --max-time 15 "$HEALTH_URL" || echo "000") echo " 공개 health 상태: $CURRENT_PUBLIC" if [ -n "$CONTAINER_STATUS" ] && [ "$TUNNEL_LOG_HITS" -ge 1 ] && [ "$CURRENT_PUBLIC" = "200" ]; then VERIFY_OK=true break fi sleep "$POLL_INTERVAL" ELAPSED=$((ELAPSED + POLL_INTERVAL)) done else echo " 컨테이너 기동이 실패해 폴링을 건너뛴다." fi if [ "$VERIFY_OK" = "true" ]; then echo " 검증 성공: 컨테이너 running + 터널 연결 로그 확인 + 공개 health 200" else echo " 검증 실패: 조건을 만족하지 못했다." fi echo " 컨테이너 로그 마지막 20줄(연결 로그라 토큰이 없는 것이 통상이지만 그대로 출력한다):" "$DOCKER_BIN" compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" --profile public-cutover-gate logs --tail 20 "$SERVICE_NAME" || true if [ "$VERIFY_OK" = "true" ]; then echo "[5/5] 호스트 터널 종료 (검증 성공 경로)" if [ -n "$HOST_PID" ]; then echo " 호스트 터널 프로세스 종료 시도: PID $HOST_PID" kill "$HOST_PID" 2>/dev/null || true sleep 5 if kill -0 "$HOST_PID" 2>/dev/null; then echo " 아직 살아있다. SIGKILL로 강제 종료한다." kill -9 "$HOST_PID" 2>/dev/null || true fi else echo " 종료할 호스트 터널 PID가 없다(이미 종료된 상태)." fi if [ -f "$HOST_PID_FILE" ]; then rm -f "$HOST_PID_FILE" echo " PID 파일을 삭제했다: $HOST_PID_FILE" fi AFTER_PUBLIC=$(curl -s -o /dev/null -w "%{http_code}" --max-time 15 "$HEALTH_URL" || echo "000") echo " 호스트 터널 종료 후 공개 health 상태: $AFTER_PUBLIC" if [ "$AFTER_PUBLIC" != "200" ]; then echo " 경고: 호스트 터널 종료 후 공개 health가 200이 아니다. 서비스 복구를 위해 호스트 터널을 재기동한다." echo " 1) 방금 만든 컨테이너를 정리한다." "$DOCKER_BIN" compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" --profile public-cutover-gate rm -sf "$SERVICE_NAME" || true echo " 2) 호스트 터널을 재기동한다." cd "$PROJECT_DIR" nohup ./bin/cloudflared tunnel --no-autoupdate --config private/cloudflared-host.yml run >> private/cloudflared-host.log 2>&1 private/cloudflared-host.pid echo " 3) 25초 대기 후 공개 health를 재확인한다." sleep 25 RESTORE_PUBLIC=$(curl -s -o /dev/null -w "%{http_code}" --max-time 15 "$HEALTH_URL" || echo "000") echo " 호스트 터널 재기동 후 공개 health 상태: $RESTORE_PUBLIC" if [ "$RESTORE_PUBLIC" = "200" ]; then echo "MIGRATE_FAILED_HOST_RESTORED" exit 1 fi echo "MIGRATE_FAILED_SERVICE_DOWN" echo " 경고: 서비스가 다운된 상태다. 사람이 즉시 확인하고 조치해야 한다." echo " 수동 복구 명령:" echo " cd $PROJECT_DIR" echo " sh scripts/nas-recover-prod.sh" echo " 위 스크립트로도 복구되지 않으면 cloudflared 대시보드와 컨테이너·호스트 로그를 직접 확인하라." exit 2 fi echo "MIGRATE_DONE" else echo "[5/5] 롤백 (검증 실패 경로) — 호스트 터널은 건드리지 않는다" if [ -n "$EXISTING_STATUS" ]; then echo " 주의: 이 컨테이너는 스크립트 실행 전부터 떠 있던 것이라 제거하지 않는다." echo " 주의: 이미 이관이 끝난 상태일 수 있고, 제거하면 되돌릴 호스트 터널이 없어 서비스가 끊긴다." else "$DOCKER_BIN" compose -f "$COMPOSE_FILE" --env-file "$ENV_FILE" --profile public-cutover-gate rm -sf "$SERVICE_NAME" || true fi ROLLBACK_PUBLIC=$(curl -s -o /dev/null -w "%{http_code}" --max-time 15 "$HEALTH_URL" || echo "000") echo " 롤백 후 공개 health 상태(호스트 터널 기준, 200이어야 정상): $ROLLBACK_PUBLIC" if [ "$ROLLBACK_PUBLIC" != "200" ]; then echo " 경고: 롤백 뒤에도 공개 health가 200이 아니다. 서비스가 끊겼을 수 있으니 즉시 확인하라." echo " 수동 복구: cd $PROJECT_DIR && sh scripts/nas-recover-prod.sh" fi echo " 실패 원인 후보:" echo " (a) 자격증명 권한 불일치 - 2단계에서 이름 형태 사용자 경고가 있었다면 이것을 의심하라." echo " (b) 볼륨 마운트 문제 - $VOLUME_MOUNT 아래 자격증명 파일 경로를 확인하라." echo " (c) 컨테이너 기동 자체 실패 - 3단계 오류 메시지를 확인하라(UP_OK=$UP_OK)." echo " (d) 터널 미연결 - 위에 출력된 컨테이너 로그에서 Registered tunnel connection 여부를 확인하라." echo "MIGRATE_FAILED" exit 1 fi