콘텐츠로 이동
개발 기록
← 전체 글

커밋 183개를 버리고, 한 번 더 지운 저장소

지금 cheesetrap 공개 저장소에서 가장 오래된 커밋은 de11318 하나다. 메시지는 “Initial public release of cheesetrap”이고 부모 커밋이 없다. 그 앞의 이력은 두 번 끊겼다. 공개하기 전에 커밋 183개를 버리고 정리한 트리를 첫 커밋으로 올렸다. 공개한 뒤 얼마 지나지 않아 문서에서 내부 기록이 나와, 저장소를 지우고 같은 이름으로 다시 만들었다.

두 번 모두 처음에 이 프로젝트를 개인 프로젝트의 방식으로 만든 데서 시작했다고 본다. 프로젝트를 시작한 이유는 첫 글에 있다.

내 서버에 배포하는 저장소였다

섹션 제목: “내 서버에 배포하는 저장소였다”

처음에는 cheesetrap을 내가 쓰는 개인 프로젝트처럼 만들었다. 개인 프로젝트라면 내 서버에 지속적으로 통합하고 배포하는 쪽이 편하다. 그래서 운영 환경 전용 CI, 배포 경로, 운영 문서, 개발 일지 같은 커밋이 한 저장소에 쌓였다. 공개 준비 때 작성한 계획 문서에는 운영 환경을 언급하는 추적 파일이 107개라고 적혀 있다.

공개 저장소의 CD는 내 서버에서 돌아갈 필요가 없다. 산출물만 게시하고 배포는 사용자가 하는 쪽이 맞다고 생각했다. CD까지 공개 저장소에 두면 내 운영 환경에만 해당하는 배포 경로와 전용 CI가 공개 트리에 남는다.

그래도 내 서버에 계속 배포하며 시험하고 싶었다. 그래서 비공개 운영 저장소를 따로 만들었다. 11월 7일에 개인 운영·개발 기록을 보존하는 곳으로 시작했다. 호스트 구성과 배포 도구는 별도의 비공개 infra 저장소가 맡고, 운영 저장소는 그 저장소의 배포 규약을 복사해 쓴다.

CI에도 사정이 있었다. 처음에는 비공개 저장소에서 GitHub Actions로 지속적으로 시험했다. 사용량 제한에 다다라 CI를 instabox로 옮겼다. instabox는 GitHub Actions 작업마다 새 클라우드 머신을 띄워 실행하고, 작업이 끝나면 머신을 지우는 서비스다.

공개를 준비하면서 보니 공개 저장소에는 GitHub 호스팅 runner가 나았다. 공개 저장소에서 표준 GitHub 호스팅 runner는 무료다. GitHub가 호스팅하지 않는 runner에서 외부 기여자의 PR을 돌리는 것도 좋은 생각 같지 않았다. 그때 근거로 떠올린 것은 self-hosted runner를 공개 저장소에 거의 쓰지 말라는 GitHub 보안 문서였다. 그래서 공개 저장소의 CI는 GitHub 호스팅 runner로 돌아갔고, 비공개 저장소의 CI는 instabox에 남았다.

다만 이 경고는 누군가 PR로 runner 환경을 침해해 다음 작업까지 영향을 주는 경우를 걱정한다. 이 글을 쓰며 다시 보니, 작업마다 머신을 지우는 instabox에는 그대로 들어맞지 않는다. 그래도 공개 저장소의 CI를 GitHub 호스팅 runner로 돌린 판단은 바꾸지 않았다. 무료라는 이유만으로도 충분했다.

공개 전에 추적 중인 파일을 제품 계약, 참조 배포 예시, 개인 운영, 개발 기록으로 나눴다. 개인 운영 자료는 제품 트리와 같은 경로에 두고 운영 저장소에 먼저 커밋한 뒤 제품 트리에서 지웠다.

트리는 정리할 수 있었지만 이력이 남았다. 2026-11-07에 조사한 이력은 이랬다.

  • 커밋이 183개였다.
  • 작성자 신원이 네 가지였다. 그중에 빈 이메일, 인스턴스 호스트 이름, 다른 개인 이메일이 섞여 있었다.
  • 커밋 제목이 개발 일지 모양이었다.

이력을 살리는 방법 두 가지를 검토하고 기각했다.

  • git filter-repo로 이력을 고쳐 공개한다. 작성자는 고칠 수 있다. 하지만 개발 일지 모양의 커밋 제목까지 고치려면 183개를 다시 써야 하고, 공유 브랜치에 강제 push해야 한다. 이 안과 새로 시작하는 안을 같이 저울질했고, 차라리 새로 파는 편이 낫다고 판단했다.
  • 이력을 두고 .mailmap만 추가한다. 표시 이름만 바뀐다. 원본 객체의 이메일과 호스트 이름은 남는다.

그래서 정리한 트리를 첫 커밋 하나로 새 공개 저장소에 올리고, 옛 이력은 비공개 보관 저장소에 두었다. 개발 과정은 공개 이력에서 사라졌다.

첫 공개본은 이 분류와 이력 정리를 마친 상태였다. 그런데 공개하고 나서 한 번 살펴보니, 이건 왜 같이 올라왔지 싶은 것들이 많았다. docs/ 디렉터리에서는 문서에 남은 내부 기록 세 종류를 찾았다. 에이전트 작업 로그를 그대로 커밋한 파일, 비공개 저장소의 커밋을 가리키는 참조, 운영 호스트의 사양이다. 모두 개발 기록을 저장소 안에 함께 두던 방식이 남긴 것이다. 당시 작업 기록에서는 비밀번호 같은 자격 증명을 찾지 못했다.

계획 문서에는 공개 전에 내부 이름, 운영 IP·이메일·호스트 이름, 비밀 값을 찾는다고 적혀 있다. 하지만 문서에 남은 이런 기록을 찾는 검사는 없었다. 있었더라도 내가 꼼꼼히 보지 않았다.

공개된 시간은 기록으로 추정했다. 보관 저장소에는 첫 공개본과 같은 트리의 커밋이 11월 7일 16:04(UTC)에 있고, 계획 문서에는 저장소를 public으로 바꾼 기록이 같은 날 16:21(UTC)에 있다. 옛 저장소는 새 저장소를 만든 11월 8일 10:57(UTC)보다 먼저 지웠다. 그러니 공개된 시간은 하루가 안 된다.

새 커밋으로 파일을 지우면 현재 트리에서만 사라진다. 이전 커밋은 공개 이력에 그대로 남는다. 수정을 PR로 올리면 지운 내용이 PR의 diff와 refs/pull/N에도 남는다. GitHub 문서에 따르면 refs/pull/로 시작하는 ref는 읽기 전용이라 이력을 다시 써서 push해도 바뀌지 않는다. PR에 남은 데이터는 GitHub Support에 요청해야 지울 수 있다. 그래서 수정을 push하거나 PR로 열기 전에 이력을 어떻게 할지부터 정했다.

트리만 고칠까, 저장소를 지울까

섹션 제목: “트리만 고칠까, 저장소를 지울까”

세 가지 안이 있었다.

  • 트리에서만 지운다. 비용이 가장 작다. 당시 작업하던 에이전트는 노출된 것이 비밀 값이 아니므로 이것으로 충분하다고 보았다. 대신 정보는 공개 이력에 남는다.
  • 같은 저장소의 이력을 다시 쓰고 강제 push한다. 이 저장소에는 이미 병합한 PR이 있었다. 이력을 고쳐도 그 PR의 ref는 남는다.
  • 저장소를 지우고, 정리한 커밋 하나로 다시 만든다. 저장소와 함께 PR ref도 사라진다고 보았다. 이 안을 택했다. 옛 저장소의 PR ref가 실제로 사라졌는지는 따로 확인하지 않았다. 저장소 삭제는 되돌릴 수 없어서 에이전트에게 맡기지 않고 내가 직접 했다.

아쉬운 점이 많았다. 기존 커밋 내역이 사라지는 게 가장 아쉬웠다. 그래도 트리에서만 지우면 어차피 이력에 다 남는다. 그래서 새로 만들어야 한다고 생각했고, 에이전트의 판단과 달리 그 방향으로 밀었다.

세 번째 안을 택한 데는 시간 사정도 있었다. 그때 서버를 Ubuntu에서 Oracle Linux로 옮기는 중이었고, GitHub Actions 사용량도 다 써 버린 상태라 급했다. 저장소를 다시 만들지 않고 정리하기에는 첫 공개 뒤에 쌓인 커밋도 이미 너무 많았다. 예전 저장소는 구성이 중구난방이기도 해서, 하는 김에 체계를 다시 잡고 싶었다.

감수한 비용은 이렇다.

  • 병합했던 PR #1~#5의 기록이 사라졌다.
  • issue 번호가 바뀌었다. #6을 같은 내용으로 #1에 다시 등록했다.
  • 공개된 동안 외부에 만들어진 사본은 지울 수 없다.
  • 예전 공개 이력은 공개 저장소에 없고, 번들 파일로만 보관한다.

재생성 직후 원격 ref는 master와 HEAD뿐이었다. 정리한 트리와 새 커밋의 트리는 git diff --stat에서 차이가 없었고, 필수 CI 체크 세 개가 통과했다. 저장소의 보안 설정과 Actions 기본 권한을 복원한 뒤 API로 다시 조회했다. 여기까지는 당시 작업 기록이다.

GitHub API로 다시 조회했다. 첫 커밋 de11318의 시각은 2026-11-08T10:55:00Z이고, 저장소 생성 시각은 2분 뒤인 10:57:10Z다. 작업 기록에 따르면 로컬에서 만든 커밋을 새 저장소에 push했기 때문이다. 예전 첫 공개 커밋을 해시로 조회하면 HTTP 422 “No commit found”가 돌아온다.

재생성 뒤에는 비밀 값 검사를 다시 돌리고 노출 범위도 다시 계산했다.

해시 조회가 실패한다는 것은 공개 저장소에서 예전 이력이 이어지지 않는다는 뜻일 뿐, 예전 이력이 어디에도 없다는 뜻은 아니다. 공개된 동안 만들어진 사본은 확인할 방법이 없다. 외부 계정의 fork에서 PR을 열어 CI가 통과하는지도 아직 시험하지 못했다. 두 번째 계정이 없었기 때문이다.

공개 트리에는 아직 이전 배포 체계와 관련된 문서와 스크립트가 남아 있다. 운영 배포를 옮기면서 함께 정리하기로 미뤄 둔 것이다.

두 번의 재시작은 모두 제품과 내 운영 기록을 한 저장소에 두던 데서 나왔다. 이제 제품은 공개 저장소에, 운영 기록과 배포는 비공개 저장소에 둔다. 이 블로그도 같은 이유로, 글은 공개해도 저장소의 이력은 공개하지 않는다.