[GIT] 특정 파일 commit history 삭제

개발 중에 env.example인데 실제 키값이 들어가서 동료분이 커밋 히스토리를 삭제하고 다시 커밋해달라고 요청하심
특정 파일만 히스토리를 삭제하는 방법을 Cursor의 도움으로 해결하고 정리용으로 블로그를 작성한 것입니다.

문제 상황

env.example 파일에 실제 API 키실수로 커밋되었습니다

# 노출된 민감정보 예시
KEY=1234

이미 여러 커밋에 걸쳐 히스토리에 남아있고, PR도 생성된 상태였습니다.

해결 과정

1단계: 히스토리에서 완전 제거

git-filter-repo 사용

# 도구 설치
pip3 install --user git-filter-repo

# 전체 히스토리에서 민감파일 제거
git-filter-repo --force --invert-paths --path env.example

주의사항: git-filter-repo는 기존 히스토리를 완전히 재작성하므로 반드시 백업을 먼저 생성하세요.

2단계: 원격 저장소 강제 동기화

# 원격 remote 재설정 (filter-repo가 제거함)
git remote add origin https://github.com/your-repo.git

# 모든 브랜치와 태그에 강제 푸시
git push --force --all origin
git push --force --tags origin

⚠️ 중요: 팀원들에게 사전 공지 후 진행하세요. 다른 팀원들의 로컬 저장소도 재클론이 필요할 수 있습니다.

3단계: 안전한 환경변수 파일 재생성

# 플레이스홀더만 포함한 안전한 env.example 생성 후 
git add env.example

 

 

- 참고 블로그

https://smecsm.tistory.com/260

(Git) 이전 Commit에서 특정 file만 삭제하기 (filter-repo)