git filter-repo로 기록 다시 작성하기
git filter-repo를 사용해 대용량 파일이나 민감한 데이터를 제거하도록 저장소 기록을 대규모로 다시 작성하는 방법을 학습해 보세요.
git filter-repo로 기록 다시 작성하기은(는) CoddyKit의 무료 Git & GitHub Professional Workflow 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Git & GitHub Professional Workflow 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Git & GitHub Professional Workflow 강의에는 총 4개의 강의가 포함되어 있습니다.
이력을 다시 작성하는 이유
유출된 비밀번호를 제거하거나, 실수로 커밋한 대용량 파일을 삭제하거나, 모든 커밋의 작성자 이메일을 수정하기 위해 저장소의 전체 이력을 다시 작성해야 할 때가 있습니다.
git filter-repo 알아보기
git filter-repo는 이력을 다시 작성하는 현대적이고 빠른 도구입니다. 오래되고 느린 git filter-branch를 대체합니다.
도구 설치
별도의 프로그램이며, 보통 pip 또는 패키지 관리자를 통해 설치합니다.
pip install git-filter-repo항상 복제본에서 작업하기
이력 다시 작성은 파괴적인 작업입니다. 문제가 발생하면 버릴 수 있도록 새로 복제한 저장소에서 작업하세요.
git clone --mirror git@github.com:you/repo.git이력에서 파일 제거
모든 커밋에서 파일을 완전히 제거하려면 --path 및 --invert-paths 옵션을 사용합니다.
git filter-repo --path secrets.env --invert-paths대용량 객체 제거
크기 기준을 초과하는 파일을 제거하여 비대해진 저장소의 크기를 줄일 수 있습니다.
git filter-repo --strip-blobs-bigger-than 10M작성자 이메일 다시 작성
메일 맵 또는 콜백을 사용하여 모든 커밋에서 잘못된 작성자 이메일을 수정합니다.
git filter-repo --mailmap my-mailmap.txt이력의 텍스트 바꾸기
표현식 파일을 사용하여 비밀 문자열이 나타나는 모든 위치에서 제거합니다.
git filter-repo --replace-text expressions.txt커밋 해시가 변경됩니다
이력을 다시 작성하면 영향을 받은 모든 항목에 대해 새 커밋 해시가 생성됩니다. 저장소의 이력은 기존 복사본의 이력과 달라집니다.
결과 강제 푸시
원격 이력이 더 이상 일치하지 않으므로 다시 작성한 후에는 강제 푸시해야 합니다.
git push --force --all팀과 조율하기
모든 팀원의 복제본이 이제 오래된 상태이므로 팀원은 다시 복제해야 합니다. 제거한 데이터가 되살아나는 일을 방지하려면 이력 다시 작성을 공지하세요.
빠른 확인
이력 다시 작성에 대한 이해도를 테스트해 보세요.
요약
이력을 다시 작성하는 방법을 배웠습니다.
git filter-repo는 filter-branch를 대체합니다- 모든 이력에서 파일, 대용량 객체 또는 비밀 텍스트를 제거합니다
- 항상 복제본에서 작업하며 커밋 해시는 변경됩니다
- 이후 강제 푸시하고 팀원이 다시 복제하도록 합니다
자주 묻는 질문
“git filter-repo로 기록 다시 작성하기” 강의는 무료인가요?
네 — “git filter-repo로 기록 다시 작성하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Git & GitHub Professional Workflow 강의 전체를 잠금 해제할 수 있습니다. Git & GitHub Professional Workflow 강의에는 총 4개의 강의가 포함되어 있습니다.
“git filter-repo로 기록 다시 작성하기”에서 뭘 배우나요?
git filter-repo를 사용해 대용량 파일이나 민감한 데이터를 제거하도록 저장소 기록을 대규모로 다시 작성하는 방법을 학습해 보세요. 브라우저에서 직접 실행하는 실습 코드로 Git & GitHub Professional Workflow을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Git & GitHub Professional Workflow을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Git & GitHub Professional Workflow은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“git filter-repo로 기록 다시 작성하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Git & GitHub Professional Workflow 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Git & GitHub Professional Workflow 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- Git Reflog 및 기록 복구
- 디버깅을 위한 Git Bisect
- 저장소 유지 관리 및 정리
- git filter-repo로 기록 다시 작성하기