Files
backup_actions/to-do.md

5.1 KiB

Git Mirroring Workflow 개선 작업 목록

  • mirror.yml: 작업 시간 초과(timeout) 설정 추가
  • mirror.yml: 수동 실행 시 특정 브랜치를 지정할 수 있는 입력(input) 기능 추가
  • mirror.yml: Gitea 관련 시크릿 및 변수 이름을 BASE_GITEA_ 접두사로 변경 (secrets.BASE_GITEA_TOKEN, vars.BASE_GITEA_URL, vars.BASE_GITEA_USER)
  • mirror.yml: 스크립트 로직을 수정하여 수동 입력된 브랜치를 처리하거나, 입력이 없을 경우 branch_list 파일을 사용하도록 변경
  • mirror.yml: 대상 저장소가 이미 있으면 재생성 대신 pull/fetch 후 업데이트만 수행하도록 변경
  • mirror.yml: 브랜치명이 Develop_Net8로 시작하지 않으면 브랜치명을 그대로 저장소 이름으로 사용하도록 로직 추가
  • to-do.md: 모든 작업 완료 후 KST 시간 기준으로 완료 시간 기록
  • 문서: AGENTS.md 생성 및 최신 요구사항(기존 저장소 업데이트, 비-Develop_Net8 브랜치 저장소명 규칙) 반영

2025-12-16 09:04:36 KST 업데이트: mirror.yml에서 대상 저장소를 git clone --mirror 대신 --bare로 받도록 변경하여 fatal: --mirror can't be combined with refspecs 오류를 제거. 기존 저장소가 있을 때는 Gitea 원격을 bare 클론 후 source 리모트를 원본 SSH에 추가하고 브랜치만 fetch → originmain으로 강제 푸시하도록 정리. 새 저장소일 때는 원본을 bare 클론해 originsource로 rename 후 Gitea를 origin으로 추가, 같은 fetch→push 동작 수행. 작업 루트 경로를 ROOT_DIR에 저장해 fetch/push 실패 시에도 항상 원위치로 돌아가며 임시 디렉터리를 정리하도록 수정. 2025-12-16 09:42:00 KST 업데이트: mirror.yml에 NOTIFY_WEBHOOK 기반 상태 알림(start/success/error, 소요시간 포함) 추가 및 heredoc 제거로 문법 오류 수정. 브랜치명 매핑을 확장해 Develop_Net8_* 접두사는 제거, Develop_/develop_ 접두사는 제거하여 develop_boxzainerboxzainer로 푸시되도록 수정하고, 접두사 없는 develop 등은 그대로 사용. 2025-12-16 09:42:00 KST 추가 업데이트: mirror.yml에서 타겟이 존재할 때 git ls-remote로 main 커밋을 조회하고 소스 브랜치 커밋과 동일하면 클론/푸시를 건너뛰도록 최적화. 알림에 skip 상태를 추가해 동일 커밋 시 건너뛰는 로그를 남기도록 개선. 2025-12-16 09:46:30 KST 추가 업데이트: mirror.yml에서 기존 타겟 클론을 없애고 임시 bare repo를 직접 init 후 source 브랜치만 fetch(--no-tags)하여 푸시하도록 변경, 불필요한 대상 전체 클론을 제거해 데이터 전송 최소화. 2025-12-16 09:48:20 KST 추가 업데이트: mirror.yml에서 타겟이 새로 생성된 경우 소스 브랜치를 git clone --bare --single-branch로 전체 클론 후 push, 기존 타겟이 있을 때만 빈 bare repo를 init해 필요한 브랜치만 fetch→push 하도록 분기. 생성된 경우에도 백업 모드/알림이 “신규 전체 백업”으로 정확히 표시되도록 just_created 플래그를 추가. 2025-12-16 11:10:39 KST 추가 업데이트: 증분 경로에서 빈 bare init 후 타겟 main을 fetch --no-tags로 선반입해 객체를 시드한 뒤 소스 브랜치 fetch를 수행하도록 변경, 델타 전송을 활용해 변경량이 적을 때 트래픽을 줄이도록 개선. 2025-12-16 13:28:01 KST 추가 업데이트: mirror.yml에 branch_list 주석(#) 스킵 및 sourceRepo/branch,alias 구문을 추가해, 콤마 뒤의 별도 저장소 이름(alias)으로 타겟을 지정할 수 있도록 개선. 2025-12-16 14:03:18 KST 추가 업데이트: mirror.yml에 태그 동기화 옵션(SYNC_TAGS, 기본 true) 추가. 소스 태그를 fetch --prune/--prune-tags 후 타겟으로 push --force --prune해 태그를 미러링하도록 개선하며, 태그 동기화 실패 시 알림을 보냄. 2025-12-16 16:16:39 KST 추가 업데이트: README.md 작성(목적/사용법/입력 규칙/시크릿/러너 조건/태그 옵션 등). mirror.yml의 cron을 매일 02:07 KST로 조정하고 runs-on 라벨을 internal로 제한. 2025-12-16 17:59:05 KST 추가 업데이트: mirror.yml에 runner_label 입력 및 RUNNER_LABEL 변수 기반 실행러너 선택 로직 추가(없으면 ubuntu-latest 사용), README에 러너 지정 방법 반영. 2025-12-16 18:10:22 KST 추가 업데이트: runner 설정을 다시 runs-on: [internal]로 고정한 상태에 맞춰 README 실행 환경 설명을 internal 러너 기준으로 롤백 정리. 2025-12-16 18:16:34 KST 추가 업데이트: 증분 성능 검토를 위해 타겟 main 선-fetch를 켜고 끄기 위한 SEED_FROM_TARGET 옵션(기본 false) 추가. README에 옵션 설명 반영. 2025-12-16 18:20:26 KST 추가 업데이트: 증분 fetch 시 타겟 main 커밋을 shallow-exclude로 지정해 필요한 부분만 받아오도록 변경, README 동작 개요에 반영. 2025-12-16 18:29:58 KST 추가 업데이트: SEED_FROM_TARGET 옵션과 타겟 main 선-fetch 시드를 제거하고 shallow-exclude 기반 증분 fetch만 유지하여 증분 로직을 단순화.