Git Repository Mirroring Workflow

목적

외부 SSH Git 저장소(센터 공용 코드 관리용 깃)의 특정 브랜치를 Gitea center_dev 조직으로 순차 복제합니다.
브랜치→저장소 매핑 규칙을 적용해 main 브랜치로 강제 푸시하며, 태그 동기화 옵션을 제공합니다.
backup.yml은 소스/타겟의 head 커밋을 먼저 스캔해 건너뜀/증분/신규 여부를 사전 결정하고, mirror.yml은 즉시 복제합니다.

.gitea/workflows/backup.yml: 프리스캔 기반 백업(사전 해시 기록 → 계획 결정 → 실행). 예약 실행: 매일 02:00 KST (cron: 0 17 * * *, UTC 기준) + workflow_dispatch.
.gitea/workflows/mirror.yml: 기존 즉시 복제 워크플로우. 스케줄 없음, workflow_dispatch로만 수동 실행.

입력 또는 branch_list를 파싱해 유효 항목을 확정하고, 소스 저장소별로 git ls-remote --heads를 한 번씩 수행해 브랜치→커밋 해시를 수집합니다.
Gitea에 해당 저장소가 있는지 조회 후 main 해시를 확인합니다.
사전 판정: 타겟이 없거나 main이 없으면 “신규 백업”, 해시가 같으면 “건너뜀”, 다르면 “증분 백업”으로 결정합니다.
해시 스냅샷과 판정 테이블을 backup_reports/ 폴더에 source_heads_*.tsv, target_heads_*.tsv, decisions_*.tsv로 기록합니다.
“건너뜀”은 바로 알림 후 종료, “신규/증분”만 fetch→push 실행합니다.
실행 단계: 저장소 존재 확인/생성(default_branch=main) → shallow-exclude 기반 fetch(미지원 시 타겟 main 얕은 시드 후 일반 fetch) → main으로 강제 푸시 → 태그 동기화(옵션) → 기본 브랜치 main 패치 → 임시 폴더 정리.
알림은 시작/성공/실패/건너뜀에 대해 KST 타임스탬프, 모드, 소요시간을 포함해 전송합니다.

브랜치 존재 여부 확인 (git ls-remote)
타겟 저장소 존재 확인/생성 (default_branch=main)
커밋 동일 시 skip (알림 전송)
신규 생성: 소스 브랜치를 bare single-branch clone 후 main으로 강제 푸시
기존 존재: 빈 bare 저장소 init → 타겟 main 커밋을 shallow-exclude로 지정해 소스 브랜치만 fetch → main으로 강제 푸시
태그 동기화가 켜져 있으면 태그 fetch/push(강제+prune)
기본 브랜치를 main으로 패치, 임시 디렉터리 정리
소스 서버가 --shallow-exclude를 지원하지 않으면 타겟 main을 얕게(depth=50) 받아 시드한 뒤 일반 fetch로 재시도
Gitea API(조회/생성/기본브랜치 설정)는 최대 3회 재시도 후 실패 시 해당 브랜치를 건너뛰고 다음 브랜치로 진행