메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Replit은 손상된 .git 폴더나 커밋 기록 손실과 같은 문제로부터 복구하는 데 도움이 되도록 Git 저장소를 자동으로 백업합니다. 이 백업 시스템은 백그라운드에서 실행되므로 추가적인 노력 없이 작업이 보호됩니다.

작동 방식

모든 Replit 앱은 Git 저장소의 안전한 백업을 유지합니다. Replit 에이전트가 코드를 변경하거나 앱을 배포하면 자동으로 이 백업에 동기화됩니다. 로컬 Git 저장소가 손상되거나 사용할 수 없게 되면 백업에서 전체 커밋 기록을 복원할 수 있습니다.
백업 원격은 gitsafe-backup으로 명명되며 Replit이 자동으로 관리합니다. 아무것도 구성할 필요가 없습니다 — 이미 백그라운드에서 작동하고 있습니다.

백업 기록 보기

커밋 기록을 보는 가장 쉬운 방법은 Git 창을 통해서입니다. 프로젝트 편집기의 도구 섹션에서 열 수 있습니다 — 모든 에이전트 체크포인트를 포함한 전체 커밋 기록을 보여줍니다. 이것은 대부분의 경우에 작동하며 명령이 필요하지 않습니다. gitsafe-backup 원격을 직접 검사해야 하는 경우 셸을 사용할 수 있습니다:
git fetch gitsafe-backup main
git log gitsafe-backup/main
이를 통해 모든 에이전트 체크포인트와 수동 커밋을 포함한 완전한 커밋 기록을 볼 수 있습니다. 작업이 백업되었는지 확인하거나 복원할 특정 커밋을 찾는 데 사용할 수 있습니다.

Git 문제로부터 복구

Git 오류가 발생하거나 저장소가 손상된 경우 Git 창부터 시작하세요. 셸 명령 없이도 이전 커밋으로 재설정하거나 원격에서 가져오는 등 대부분의 일반적인 문제를 해결할 수 있습니다. Git 창이 도움을 줄 수 없는 경우(완전히 손상된 .git 폴더 등)에는 아래의 셸 기반 단계를 사용하세요.

백업 가용성 확인

먼저 백업 원격이 존재하는지 확인하세요:
git remote -v
출력에서 gitsafe-backup을 찾으세요. 있으면 복구를 진행할 수 있습니다.

저장소 복원

이 프로세스는 현재 .git 폴더를 백업된 버전으로 교체합니다. 작업 파일은 변경되지 않지만 로컬 Git 기록은 백업으로 교체됩니다.
1

현재 Git 구성 저장

커스텀 설정이 있는 경우를 대비하여 Git 구성 파일을 백업하세요:
cp .git/config .git_config_backup
2

백업 저장소 복제

백업에서 임시 복제를 생성하세요:
git clone --bare git://gitsafe:5418/backup.git /tmp/gitsafe-restore
3

Git 폴더 교체

손상된 .git 폴더를 옆으로 이동하고 백업으로 교체하세요:
mv .git .git_corrupted_backup
mv /tmp/gitsafe-restore/ .git
4

구성 복원

Git 구성을 다시 복사하세요:
mv .git_config_backup .git/config
이 단계를 완료한 후 git status를 실행하여 저장소가 올바르게 작동하는지 확인하세요.

일반적인 문제 해결

”fatal: repository not found” 또는 백업 원격 없음

백업 시스템이 오래된 프로젝트에는 활성화되어 있지 않을 수 있습니다. 오래된 프로젝트 복구에 도움이 필요하면 지원팀에 문의하세요.

복구에 최근 커밋이 포함되지 않음

백업은 각 에이전트 커밋 후에 동기화됩니다. 변경 사항을 만들었지만 커밋하지 않은 경우 해당 변경 사항은 백업에 포함되지 않습니다. 커밋되지 않은 파일이 있는지 작업 디렉터리를 확인하세요.

Git 작업이 느리거나 멈춤

Git 작업이 응답하지 않게 되면 오래된 잠금 파일이 있을 수 있습니다. 안전하게 제거할 수 있습니다:
rm -f .git/index.lock

데이터 손실 방지

백업 시스템이 자동으로 Git 기록을 보호하지만, 작업을 보호하기 위해 추가적인 단계를 취할 수 있습니다:
  • 자주 커밋하세요: 진행 상황이 지속적으로 백업되도록 작고 자주 커밋하세요
  • 체크포인트를 사용하세요: Replit 에이전트로 작업할 때 체크포인트는 주요 마일스톤에서 자동으로 커밋을 생성합니다
  • GitHub에 연결하세요: 중요한 프로젝트의 경우 추가적인 백업 레이어로 앱을 GitHub에 연결하세요

다음 단계

Replit의 버전 관리에 대해 자세히 알아보려면: