다음의 경우 Git 원격 URL을 업데이트합니다:

• 다른 Git 저장소 호스트에서 기존 프로젝트를 가져온 경우.
• 조직이 새 도메인 이름을 가진 새 GitLab 인스턴스로 프로젝트를 이동한 경우.
• 동일한 GitLab 인스턴스에서 프로젝트의 이름이 새 경로로 바뀐 경우.

이 튜토리얼에서는 다음과 같이 로컬 저장소의 원격 URL을 업데이트하는 방법을 설명합니다:

• 완료되지 않은 로컬 변경 사항을 잃지 않고.
• GitLab에 아직 게시되지 않은 변경 사항을 잃지 않고.
• 새 URL에서 저장소의 새로 복제된 작업 복사본을 만들지 않고.

이 튜토리얼은 git-remote 명령을 사용하여 원격 및 추적 저장소를 관리합니다.

Git 원격 URL을 업데이트하려면:

• 기존 및 새 URL 확인
• Git 원격 URL 업데이트
• (선택 사항) 원래 원격 URL 유지

시작하기 전에#

다음이 있어야 합니다:

• Git 저장소와 새 GitLab URL이 있는 GitLab 프로젝트.
• 새 GitLab URL로 마이그레이션할 프로젝트의 복제된 로컬 작업 복사본.
• 로컬 컴퓨터에 설치된 Git.
• 로컬 컴퓨터의 명령줄 인터페이스(CLI)에 대한 액세스. macOS에서는 터미널을 사용할 수 있습니다. Windows에서는 PowerShell을 사용할 수 있습니다. Linux 사용자는 이미 시스템의 CLI에 익숙할 것입니다.
• GitLab 인증 자격 증명:
  • Git 원격 URL을 업데이트하려면 GitLab으로 인증해야 합니다. GitLab 계정이 기본 사용자 이름 및 비밀번호 인증을 사용하는 경우 CLI에서 인증하려면 이중 인증(2FA)을 비활성화해야 합니다. 또는 SSH 키를 사용하여 GitLab으로 인증할 수 있습니다.

기존 및 새 URL 확인#

Git 원격 URL을 업데이트하려면 저장소의 기존 URL과 새 URL을 확인합니다:

1. 터미널 또는 명령 프롬프트를 엽니다.

2. 로컬 저장소 작업 복사본으로 이동합니다. 디렉토리를 변경하려면 cd를 사용합니다:

   cd <repository-name>
   

3. 각 저장소에는 origin이라는 기본 원격이 있습니다. 원격 저장소의 현재 원격 가져오기(fetch) 및 푸시 URL을 보려면 다음을 실행합니다:

   git remote -v
   

4. 반환된 URL을 복사하고 메모해 둡니다. 보통 동일합니다.

5. 새 URL을 가져옵니다:

   1. GitLab으로 이동합니다.
   2. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
   3. 왼쪽 사이드바에서 Code > Repository를 선택하여 프로젝트의 Repository 페이지로 이동합니다.
   4. 오른쪽 상단에서 Code를 선택합니다.
   5. 인증 및 git으로 복제하는 데 사용하는 방법에 따라 HTTPS 또는 SSH URL을 복사합니다. 확실하지 않으면 이전 단계의 origin URL과 동일한 방법을 사용합니다.
   6. 복사한 URL을 메모해 둡니다.

Git 원격 URL 업데이트#

Git 원격 URL을 업데이트하려면:

1. 터미널 또는 명령 프롬프트를 엽니다.

2. 로컬 저장소 작업 복사본으로 이동합니다. 디렉토리를 변경하려면 cd를 사용합니다:

   cd <repository-name>
   

3. 복사한 새 저장소 URL로 <new_url>을 교체하여 원격 URL을 업데이트합니다:

   git remote set-url origin <new_url>
   

4. 원격 URL 업데이트가 성공했는지 확인합니다. 다음 명령은 가져오기 및 푸시 작업 모두에 대한 새 URL을 표시하고, 로컬 브랜치를 나열하며, 해당 브랜치가 GitLab에 추적되고 있음을 확인합니다:

   git remote show origin
   

   • 업데이트가 실패한 경우 이전 단계로 돌아가 올바른 <new_url>이 있는지 확인하고 다시 시도합니다.

여러 저장소의 원격 URL을 업데이트하려면:

1. git remote set-url 명령을 사용합니다. origin을 업데이트하려는 원격 이름으로 교체합니다. 예를 들어:

   git remote set-url <remote_name> <new_url>
   

2. 각 원격 URL 업데이트를 확인합니다:

   git remote show <remote_name>
   

원격 URL을 업데이트한 후 Git 명령을 평소대로 계속 사용할 수 있습니다. 다음 git fetch, git pull 또는 git push는 GitLab의 새 URL을 사용합니다.

축하합니다. 저장소의 원격 URL을 성공적으로 업데이트했습니다.

(선택 사항) 원래 원격 URL 유지#

프로젝트에 둘 이상의 원격 위치가 있을 수 있습니다. 예를 들어, GitHub에서 호스팅되는 프로젝트의 포크된 저장소가 있지만 GitHub에 풀 리퀘스트를 만들기 전에 GitLab에서 포크를 작업하려는 경우가 있습니다.

기존 원격을 수정하는 대신 새 원격을 추가하여 원래 원격 URL을 유지하고 새 URL과 이전 URL을 모두 유지할 수 있습니다.

이 방법을 사용하면 원래 저장소에 대한 액세스를 유지하면서 새 URL로 점진적으로 전환할 수 있습니다.

새 원격 URL을 추가하려면:

1. 터미널 또는 명령 프롬프트를 엽니다.

2. 로컬 저장소 작업 복사본으로 이동합니다.

3. 새 원격 URL을 추가합니다. <new_remote_name>을 새 원격의 이름(예: new-origin)으로, <new_url>을 새 저장소 URL로 교체합니다:

   git remote add <new_remote_name> <new_url>
   

4. 새 원격이 추가되었는지 확인합니다:

   git remote -v
   

이제 원래 원격과 새 원격을 모두 사용할 수 있습니다. 예를 들어:

• 원래 원격으로 푸시하려면: git push origin main
• 새 원격으로 푸시하려면: git push <new_remote_name> main