#!/bin/bash
# 이 파일이 하는 일: 사내 Git 서버(Gitea)를 통째로 백업해 S3에 올린다.
# systemd timer가 매일 새벽 3시 10분(KST)에 실행한다. (DB 백업 10분 뒤 — 겹치지 않게)
#
# 학습 포인트 ① — 왜 볼륨을 그냥 tar로 묶지 않고 `gitea dump`를 쓰나?
#   Gitea는 세 가지가 한 몸이다: 저장소 파일(/data/git) + SQLite DB(이슈·PR·계정) + 설정.
#   돌아가는 중에 tar로 묶으면 "파일은 새 것, DB는 옛 것" 같은 어긋난 시점이 섞일 수 있다.
#   gitea dump는 이 셋을 일관된 시점으로 묶어 zip 하나로 만들어 준다.
#   → 교훈: 애플리케이션이 자기 백업 도구를 제공하면 그걸 먼저 찾아본다.
#     "파일만 복사하면 되겠지"가 통하지 않는 경우가 생각보다 많다(DB, 검색엔진 등).
#
# 학습 포인트 ② — 무엇을 지키려는 백업인가?
#   소스 코드 자체는 개발자 PC마다 clone 사본이 있어 사실 덜 급하다(git의 분산 구조!).
#   진짜 잃으면 아픈 건 Gitea에만 있는 것들: 이슈, PR 리뷰 코멘트, 계정, 권한 설정.
#   "무엇이 이 서버에만 있는가"를 묻는 것이 백업 설계의 출발점이다.
set -euo pipefail

BUCKET="awesomedev-mirim-backup-apne2"
CONTAINER="mirim-gitea"
BACKUP_DIR="/home/ec2-user/backups"
LOCAL_KEEP_DAYS=7   # 로컬 사본 보관 (S3는 30일 — 수명주기 규칙이 자동 삭제)

TIMESTAMP="$(date +%Y-%m-%d_%H%M%S)"
FILENAME="gitea-${TIMESTAMP}.zip"
LOCAL_PATH="${BACKUP_DIR}/${FILENAME}"

mkdir -p "$BACKUP_DIR"

echo "[$(date '+%F %T')] Gitea 백업 시작"

# ── 1) 컨테이너 안에서 dump 생성 ──
# 학습 포인트: -u git — Gitea 프로세스를 돌리는 사용자로 실행해야 파일 권한이 꼬이지 않는다.
#   --file 로 이름을 지정하고, /tmp에 만든다(컨테이너가 지워지면 같이 사라지는 임시 공간).
docker exec -u git "$CONTAINER" gitea dump --file "/tmp/${FILENAME}" --quiet --work-path /data/gitea

# ── 2) 컨테이너 밖으로 꺼내기 ──
# 학습 포인트: docker cp 는 컨테이너 안팎으로 파일을 옮긴다.
#   컨테이너는 언제든 지워질 수 있는 존재라, 백업을 그 안에 두면 백업이 아니다.
docker cp "${CONTAINER}:/tmp/${FILENAME}" "$LOCAL_PATH"
docker exec -u git "$CONTAINER" rm -f "/tmp/${FILENAME}"   # 컨테이너 안 임시본은 지운다

# ── 3) 결과 검증 ──
# 명령이 성공했다고 결과물이 쓸모 있는 건 아니다. 크기와 zip 무결성을 확인한다.
SIZE=$(stat -c%s "$LOCAL_PATH")
if [ "$SIZE" -lt 10000 ]; then
  echo "[오류] 백업 파일이 너무 작습니다(${SIZE} bytes). 실패로 간주하고 중단합니다."
  rm -f "$LOCAL_PATH"
  exit 1
fi
# unzip -t : 압축 파일이 깨지지 않았는지 검사 (풀지 않고 검증만)
if ! unzip -tq "$LOCAL_PATH" > /dev/null 2>&1; then
  echo "[오류] zip 무결성 검사 실패. 손상된 백업이므로 올리지 않습니다."
  rm -f "$LOCAL_PATH"
  exit 1
fi
echo "  덤프 완료: ${FILENAME} ($(numfmt --to=iec "$SIZE")) — zip 무결성 OK"

# ── 4) S3 업로드 ──
# 액세스 키가 이 파일 어디에도 없다 — EC2에 붙인 IAM 역할이 임시 자격증명을 자동 제공한다.
aws s3 cp "$LOCAL_PATH" "s3://${BUCKET}/gitea/${FILENAME}" --only-show-errors
echo "  S3 업로드 완료: s3://${BUCKET}/gitea/${FILENAME}"

# ── 5) 오래된 로컬 사본 정리 ──
find "$BACKUP_DIR" -name "gitea-*.zip" -mtime "+${LOCAL_KEEP_DAYS}" -delete
echo "  로컬 사본 ${LOCAL_KEEP_DAYS}일 초과분 정리 완료"

echo "[$(date '+%F %T')] Gitea 백업 성공 ✅"