본문 바로가기
프로그램 (PHP,Python)

Git 완벽 가이드: 파일 복원, 히스토리 관리, 최적화, GitLab 연동, 그리고 VS Code/Visual Studio 활용

by 날으는물고기 2025. 1. 24.

Git 완벽 가이드: 파일 복원, 히스토리 관리, 최적화, GitLab 연동, 그리고 VS Code/Visual Studio 활용

Git을 활용하여 특정 파일의 이전 버전 복원부터 변경 이력 확인, 불필요한 데이터 제거 및 최적화, 전체 워크플로 관리까지 전반적인 가이드입니다. 또한, .git 폴더만으로 저장소를 복원하는 방법, GitLab과의 연동 관계, VS Code/Visual Studio에서 Git을 효율적으로 활용하는 방법도 함께 다룹니다. 각 단계별로 예시 명령어와 옵션을 통해 자세히 설명하며, 보안 관점에서의 체크 포인트도 함께 제시합니다.

1. 특정 파일의 이전 버전 복원 및 수정 후 최신 상태로 푸시

1.1 특정 파일의 변경 이력 확인

복원하려는 파일의 변경 이력을 확인합니다.

git log --oneline -- <파일 경로>

출력 예시

abc1234 Updated file content
def5678 Added new feature
ghi9012 Initial commit

복원할 커밋 ID가 def5678이라고 가정합니다.

1.2 특정 파일을 이전 버전으로 복원

복원하려는 파일을 특정 커밋 상태로 되돌립니다. (작업 디렉토리에만 반영)

git checkout <커밋 ID> -- <파일 경로>

예

git checkout def5678 -- path/to/file.txt

1.3 파일 수정

복원된 파일을 필요한 대로 수정합니다. (수정 후 파일 상태를 확인)

git status

1.4 변경 사항 스테이징 및 커밋

수정한 파일뿐 아니라 전체 디렉토리를 스테이징한 후 커밋합니다.

git add .
git commit -m "Restored and updated specific file"

1.5 변경 사항 푸시

git push origin <브랜치명>

예:

git push origin main

2. 대용량 파일 문제 해결 및 최적화

2.1 .git 폴더 용량 확인

저장소의 .git 폴더 크기를 확인합니다.

du -sh .git

2.2 대용량 파일 찾기

Git 저장소 내에서 큰 파일을 탐색

git verify-pack -v .git/objects/pack/*.idx | sort -k3 -n | tail -10

출력된 객체 ID로 파일 경로를 확인

git rev-list --objects --all | grep <대상 객체 ID>

2.3 .gitignore에 대용량 파일 등록 및 캐시 제거

.gitignore 파일 열기

nano .gitignore

제외할 파일/폴더 추가

/path/to/large_folder/
/path/to/large_file.ext

캐시에서 파일 제거

git rm -r --cached /path/to/large_folder/
git rm --cached /path/to/large_file.ext

변경 사항 커밋

git commit -m "Ignore large files and folders"

2.4 Git 저장소 최적화

  • 불필요한 참조 제거 
    git reflog expire --expire=now --all
  • 저장소 압축 
    git gc --prune=now --aggressive
  • 최적화 결과 확인 
    du -sh .git

3. 이전 상태로 되돌리기

3.1 특정 커밋으로 되돌리기(파일 유지)

로컬 커밋 이력만 제거하고 파일은 유지

git reset --soft <커밋 ID>

예

git reset --soft def5678

이 명령은 해당 커밋 이후의 변경 사항을 스테이징 상태로 유지합니다.

3.2 특정 파일만 되돌리기

특정 파일만 특정 커밋 상태로 복원

git checkout <커밋 ID> -- <파일 경로>

3.3 되돌린 상태 푸시

로컬 이력을 되돌린 뒤 강제로 원격에 반영

git push origin <브랜치명> --force

--force 옵션은 원격 저장소의 기존 이력을 덮어씌우므로,
최소한의 범위 내에서 신중히 사용하는 것이 좋습니다.

4. Git 히스토리 관리

4.1 특정 파일 변경 이력 확인

파일의 전체 변경 이력

git log -- <파일 경로>

변경된 내용까지 확인

git log -p -- <파일 경로>

파일 변경 요약 (git log + --stat)

git log --stat -- <파일 경로>

각 커밋에서 특정 파일의 변경 요약(추가/삭제된 줄 수)을 확인할 수 있습니다.

4.2 특정 파일 라인별 이력 확인 (git blame)

git blame <파일 경로>

특정 라인 범위만 확인

git blame -L <시작 라인>,<끝 라인> <파일 경로>

예

git blame -L 10,20 path/to/file.txt

4.3 삭제된 파일의 이력 확인

삭제된 파일 찾기

git log --diff-filter=D --summary

삭제된 파일 이력 확인

git log -- <파일 경로>

4.4 이름 변경된 파일의 이력 추적 (--follow)

git log --follow -- <파일 경로>

특정 키워드가 포함된 커밋 메시지를 검색하여 파일의 변경 이력을 필터링할 수도 있습니다.

git log --grep="<키워드>" -- <파일 경로>

예

git log --grep="bugfix" -- path/to/file.txt

5. 작업 시 주의사항

  1. 강제 푸시(--force) 주의
    • 원격 저장소의 이력을 덮어씌우는 작업이므로, 팀원 간 협의 후 신중히 사용합니다.
    • 무분별한 --force로 인해 다른 팀원의 작업이 손실될 수 있습니다.
  2. 백업
    • 중요한 데이터는 작업 전 백업하거나 별도의 브랜치를 생성하여 안전성을 확보합니다.
    • 예) git checkout -b temp-branch
  3. Git 상태 주기적 확인
    • 작업 중 상태를 자주 확인하고 스테이징/커밋을 깔끔하게 관리합니다.
    • 예) git status
  4. 민감정보 유출 방지
    • .gitignore 파일을 사용하여 API 키나 비밀번호 같은 민감 정보를 저장소에 포함시키지 않도록 합니다.
    • 로컬 PC와 원격 저장소 모두에서 민감정보가 노출되지 않도록 점검합니다.
  5. 보안 로그 관리
    • git reflog 등을 통해 작업 로그를 관리하여, 의도치 않은 작업이 이뤄지지 않았는지 정기적으로 점검합니다.
  6. .git 폴더 보호
    • .git 폴더는 저장소의 모든 이력과 구조를 담고 있으므로, 권한 설정과 접근 통제를 통해 내부 사용자라도 불필요한 수정이 불가능하도록 하는 것이 좋습니다.

6. 명령어 요약

  1. 특정 파일 복원 및 수정 
    git log --oneline -- <파일 경로>
git checkout <커밋 ID> -- <파일 경로>
git add .
git commit -m "Restored and updated specific file"
git push origin <브랜치명>
  2. 불필요한 데이터 제거 및 최적화 
    git rm -r --cached /path/to/large_folder/
git commit -m "Ignore large files"
git reflog expire --expire=now --all
git gc --prune=now --aggressive
  3. 이전 상태로 되돌리기 
    git reset --soft <커밋 ID>
git push origin <브랜치명> --force
  4. Git 히스토리 확인 
    git log -- <파일 경로>
git log -p -- <파일 경로>
git blame <파일 경로>
git log --grep="<키워드>" -- <파일 경로>

7. Git에서 특정 파일 변경 이력 상세 확인하기

변경 내역 확인(git log)

  • 특정 파일의 모든 커밋 이력 
    git log -- <파일 경로>
  • 상세 변경 내용 포함 
    git log -p -- <파일 경로>
    • -p: 각 커밋에서의 변경 내용을 패치(patch) 형식으로 확인

파일 변경 요약 (git log --stat)

git log --stat -- <파일 경로>

각 커밋마다 추가/삭제된 줄 수를 통계 형태로 확인 가능

특정 라인의 변경 히스토리(git blame)

git blame <파일 경로>
  • 특정 라인 범위만 
    git blame -L <시작 라인>,<끝 라인> <파일 경로>

특정 커밋 검색 (git log --grep)

특정 키워드가 포함된 커밋 메시지를 검색

git log --grep="<키워드>" -- <파일 경로>

파일의 특정 버전 비교(git diff)

  • 가장 최근 커밋과 비교 
    git diff HEAD -- <파일 경로>
  • 두 커밋 간 비교 
    git diff <커밋1> <커밋2> -- <파일 경로>
  • 특정 커밋과 비교 
    git diff <커밋 ID> -- <파일 경로>

삭제된 파일의 이력 확인

  • 삭제된 파일 찾기 
    git log --diff-filter=D --summary
  • 삭제된 파일의 변경 이력 
    git log -- <파일 경로>

파일 이름 변경 추적 (--follow)

git log --follow -- <파일 경로>

파일 경로는 마지막에 지정해야 제대로 추적됩니다.

특정 커밋에서 파일 내용 보기

git show <커밋 ID>:<파일 경로>

예

git show 35a00bf39:path/to/file.txt

특정 시간 범위 내 파일 변경 이력

git log --since="<시작 날짜>" --until="<종료 날짜>" -- <파일 경로>

예

git log --since="2024-01-01" --until="2024-12-31" -- path/to/file.txt

8. .git 폴더로 가능한 모든 작업

.git 폴더는 Git 저장소의 핵심으로, 모든 커밋, 브랜치, 태그, 변경 이력, 파일 상태가 저장됩니다. 따라서 .git 폴더만 있으면 거의 모든 Git 정보를 복원할 수 있습니다.

  • 전체 파일 복원
    .git 폴더만 있으면 과거 이력부터 현재 상태까지 모두 복원 가능합니다. 
    git checkout <브랜치명>
  • 히스토리 확인 
    git log --oneline
  • 특정 커밋 복원 
    git checkout <커밋 ID>
  • 삭제된 파일 복구 
    git checkout <커밋 ID> -- <파일 경로>
  • 브랜치 및 태그 복원 
    git branch
git tag
  • 원격 정보 확인 
    git remote -v

주의할 점

  1. 작업 디렉토리 파일 없이 .git 폴더만 존재
    • 작업 디렉토리가 없고 .git 폴더만 있다면, 아래 명령으로 파일을 복원할 수 있습니다.
    • git checkout .
  2. 원격 저장소 정보 필요 시
    • .git 폴더만 있다면 원격 저장소 정보도 복원됩니다.
    • 원격 저장소를 확인하려면: git remote -v
  3. .git 손상 방지
    • .git 폴더를 직접 수정하거나 삭제하면 데이터가 손상될 수 있으니 주의하세요.

.git 폴더 없이 Git 저장소 복원 가능 여부

  • .git 폴더가 없다면 Git 이력은 복구할 수 없습니다.
  • .git 폴더는 Git 저장소의 모든 정보를 저장하므로, 이를 백업하거나 잘 관리하는 것이 중요합니다.

 

GitLab에 저장되는 데이터는 기본적으로 로컬 Git 저장소의 .git 폴더에 저장된 데이터와 동일한 구조를 가집니다. 다만, GitLab은 이 데이터를 기반으로 다양한 추가 기능과 협업 도구를 제공합니다.

GitLab과 .git 폴더의 관계

  1. .git 폴더와 GitLab 저장소의 데이터
    • 로컬에서 .git 폴더에 저장된 Git 데이터를 GitLab에 푸시하면, GitLab은 이 데이터를 그대로 저장합니다.
    • 이 데이터에는 커밋 이력, 브랜치, 태그, 파일 객체(blob), 트리(tree) 구조 등이 포함됩니다.
    • 즉, GitLab의 저장소는 로컬 .git 폴더의 복제본이라고 볼 수 있습니다.
  2. .git 폴더의 데이터로 가능한 작업
    • GitLab에 푸시된 데이터는 .git 폴더와 동일한 구조로 저장되므로, 모든 Git 작업(커밋 확인, 파일 복원, 브랜치 관리 등)을 동일하게 수행할 수 있습니다.

GitLab의 추가 기능

GitLab은 .git 폴더의 데이터를 기반으로 다양한 추가 기능을 제공합니다. 주요 기능은 다음과 같습니다.

  1. 웹 인터페이스를 통한 Git 작업
    • GitLab은 커밋 이력, 브랜치, 태그, 파일 내용을 웹 브라우저에서 바로 확인할 수 있는 인터페이스를 제공합니다.
    • 커밋 변경 사항(diff)도 시각적으로 확인 가능합니다.
  2. 협업 도구
    • Merge Request (Pull Request): 브랜치 병합 요청을 관리하고, 코드 리뷰와 승인 프로세스를 통해 협업을 원활하게 진행할 수 있습니다.
    • Issue Tracker: 프로젝트와 관련된 문제를 관리할 수 있는 도구.
    • CI/CD 파이프라인: GitLab CI/CD를 통해 자동화된 테스트 및 배포 프로세스를 설정.
  3. 권한 및 접근 제어
    • 프로젝트별로 읽기/쓰기/관리 권한을 세부적으로 설정 가능.
  4. 원격 백업 및 복제
    • GitLab은 로컬 .git 데이터를 원격 서버에 안전하게 백업하고, 다른 팀원들과 데이터를 공유할 수 있는 기능을 제공합니다.
  5. 기타 기능
    • Wiki: 프로젝트 문서화 지원.
    • Git Hooks: Git 이벤트에 따라 특정 작업(예: 알림, 스크립트 실행)을 자동화.
    • Webhooks: Git 이벤트를 외부 서비스와 연동.

GitLab과 로컬 Git 저장소의 차이

기능 로컬 Git 저장소 (.git 폴더) GitLab
데이터 저장 커밋 이력, 브랜치, 태그, 파일 내용 .git 데이터와 동일한 구조로 저장
접근성 로컬에서만 작업 가능 웹 브라우저, API, CLI를 통해 접근 가능
협업 도구 없음 Merge Request, Issue Tracker, CI/CD 등 제공
백업 및 복제 로컬 디스크에만 저장 GitLab 서버에 안전하게 저장 및 공유 가능
웹 인터페이스 없음 브라우저를 통해 Git 데이터 및 프로젝트 관리 가능
  • GitLab의 저장소는 .git 폴더의 데이터 구조와 동일합니다.
  • GitLab은 .git 데이터를 기반으로 다양한 협업, 관리, 자동화 기능을 추가로 제공합니다.
  • 기본적인 Git 작업은 로컬 .git 폴더에서 가능하며, GitLab은 팀 협업 및 프로젝트 관리를 위한 강력한 도구를 제공합니다.

즉, GitLab은 .git 데이터를 원격에서 관리하고 확장 기능을 제공하는 플랫폼이라고 이해하면 됩니다.

 

Visual Studio (VS) 또는 Visual Studio Code (VS Code)와 같은 도구를 활용하면 GitLab의 일부 주요 기능들을 로컬에서 비슷하게 구현할 수 있습니다. 이러한 툴들은 로컬 Git 작업을 시각적으로 관리하고, 협업을 지원하며, GitLab과 연동하면 더욱 강력한 워크플로를 제공합니다.

VS Code와 Visual Studio에서 Git 활용

VS Code의 Git 통합

VS Code는 기본적으로 Git 기능이 내장되어 있어 Git 저장소를 효율적으로 관리할 수 있습니다.

  1. 시각적 커밋 및 변경 이력 관리
    • 변경된 파일을 직관적으로 확인하고, 스테이징/커밋을 수행할 수 있습니다.
    • Source Control 뷰를 통해 작업 디렉토리의 변경 사항, 스테이징 영역, 커밋 내역을 확인 가능합니다.
  2. 분산형 협업
    • GitLab, GitHub 등과 연동하여 로컬에서 브랜치 생성, 병합, 푸시/풀 작업을 쉽게 수행할 수 있습니다.
    • VS Code의 Pull Requests 확장(extension)을 활용하면 코드 리뷰 및 Merge Request를 GitLab처럼 시각적으로 관리할 수 있습니다.
  3. 브랜치 관리
    • 브랜치를 시각적으로 생성, 전환, 병합, 삭제 가능.
    • 작업 중인 브랜치를 상태바에서 빠르게 확인하고 변경 가능.
  4. GitLens 확장으로 추가 기능 제공
    • GitLens는 VS Code의 Git 기능을 확장하여 다음과 같은 기능을 제공합니다:
      • 변경된 라인의 커밋 이력 및 작성자 확인.
      • 파일 변경 시각화(누가, 언제, 무엇을 변경했는지 추적).
      • 브랜치와 태그의 전체 이력 보기.
  5. 변경 사항 비교
    • 파일의 현재 상태와 커밋된 상태를 비교.
    • 특정 커밋 간의 변경 내용을 시각적으로 확인.

Visual Studio의 Git 통합

Visual Studio는 보다 복잡한 프로젝트 관리와 Git 기능을 통합적으로 제공합니다.

  1. Git Repository 창
    • 저장소의 전체 구조, 커밋 이력, 브랜치 상태를 확인.
    • GUI로 스테이징, 커밋, 푸시/풀 작업을 처리.
  2. 시각적 Merge 및 Conflict 관리
    • 브랜치를 병합하거나 충돌이 발생했을 때 시각적으로 관리 가능.
    • 병합 충돌을 쉽게 해결할 수 있는 도구 제공.
  3. Git 작업 내역 보기
    • 특정 파일의 변경 이력과 커밋 메시지를 확인.
    • 과거 특정 커밋으로 이동하거나 복원.
  4. GitLab 및 GitHub 연동
    • Visual Studio에 GitLab/GitHub 저장소를 연결하여 로컬 작업을 원격과 동기화.
    • GitLab의 Merge Request를 Visual Studio에서 직접 생성 및 관리 가능.

GitLab과 유사하게 활용할 수 있는 기능

  1. 코드 리뷰 (Pull Request/Merge Request)
    • VS Code의 GitHub Pull Requests and Issues 확장을 설치하거나, GitLab Extension for VS Code를 설치하여 GitLab Merge Request를 생성 및 리뷰 가능.
    • Visual Studio에서도 Pull Request를 관리할 수 있는 확장 기능이 제공됩니다.
  2. Git 이력 분석
    • GitLens (VS Code) 또는 Visual Studio의 Repository View를 통해 특정 파일의 변경 이력을 시각적으로 확인.
    • 작성자와 날짜별로 변경된 라인을 추적.
  3. 브랜치 관리
    • Git 브랜치를 직관적으로 관리하고, 브랜치 간 병합 및 충돌 해결을 GUI를 통해 쉽게 수행.
  4. 태스크 및 협업
    • VS Code의 Issue Tracking 플러그인을 통해 GitHub 또는 GitLab과 연동한 이슈 관리 가능.
    • GitLab과 연동하면 GitLab의 이슈를 로컬에서 관리 가능.
  5. CI/CD 연동
    • GitLab의 .gitlab-ci.yml 파일을 로컬에서 생성 및 관리.
    • Visual Studio에서 Azure DevOps와 연동하거나, CI/CD 상태를 모니터링할 수 있는 확장을 활용.

비교: VS Code/Visual Studio와 GitLab

기능 GitLab VS Code / Visual Studio
시각적 Git 관리 웹 인터페이스를 통해 Git 이력을 확인 GUI를 통해 로컬 Git 저장소 관리
코드 리뷰 Merge Request 및 댓글 기능 제공 Pull Request 및 리뷰 확장 기능 활용
이슈 및 태스크 관리 이슈 트래킹 및 프로젝트 관리 기능 포함 GitLab 이슈와 연동 가능한 확장 제공
변경 내역 확인 커밋별 Diff 및 변경 이력 제공 GitLens로 변경 내역 및 작성자 확인
CI/CD GitLab Runner를 통한 자동화 파이프라인 지원 .gitlab-ci.yml 파일 작성 가능
원격 저장소 로컬과 원격 저장소 동기화 원격 저장소와 로컬 동기화, Push/Pull 지원

효율적으로 GitLab 기능을 대체하려면

  1. VS Code 사용
    • GitLens와 GitLab Extension을 설치하여 GitLab처럼 시각적 Git 관리 및 Merge Request를 처리.
    • 이슈 트래커와 연동하여 협업 가능.
  2. Visual Studio 사용
    • GitHub/GitLab과의 통합을 활용해 원격 저장소와의 동기화 및 코드 리뷰를 수행.
    • Azure DevOps 또는 CI/CD 도구와 연동하여 파이프라인 자동화.
  3. GitLab의 고유 기능 활용
    • 완전히 대체하기보다는 GitLab의 협업 기능(Merge Request, CI/CD 등)을 VS Code 또는 Visual Studio와 함께 사용하는 것이 가장 효율적.

Visual Studio 또는 VS Code는 .git 데이터를 시각적으로 관리할 수 있는 강력한 도구로, GitLab의 주요 기능(브랜치 관리, 코드 리뷰, 커밋 이력 확인)을 로컬에서 대체할 수 있습니다. 특히, GitLens와 GitLab Extension 등을 활용하면 협업과 변경 관리가 훨씬 쉬워집니다. 그러나 CI/CD 파이프라인, 이슈 관리, 웹 기반 협업은 GitLab의 고유한 강점이므로 두 도구를 조합하여 활용하면 최상의 워크플로를 구축할 수 있습니다.

728x90
저작자표시 비영리 동일조건

관련글

댓글

티스토리툴바