튜토리얼: Git 원격 URL 업데이트

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Git 원격 URL을 업데이트하세요 만약에:

이전 원격의 로컬 작업 사본이 없다면, 이 튜토리얼이 필요하지 않습니다. 대신에 새로운 GitLab URL에서 프로젝트를 복제할 수 있습니다.

이 튜토리얼은 다음 사항 없이 로컬 저장소의 원격 URL을 업데이트하는 방법을 설명합니다:

이 튜토리얼에서는 원격 및 추적 저장소를 관리하는 방법에 대해 git-remote 명령어를 사용합니다.

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

시작하기 전에

다음이 있어야 합니다:

GitLab 프로젝트와 Git 저장소, 그리고 새로운 GitLab URL.
새 GitLab URL로 마이그레이션하는 프로젝트의 로컬 작업 사본 복제.
귀하의 로컬 머신에 Git 설치.
로컬 머신의 명령줄 인터페이스(CLI)에 접근할 수 있는 능력. macOS에서는 Terminal을 사용할 수 있습니다. Windows에서는 PowerShell을 사용할 수 있습니다. 리눅스 사용자는 아마도 시스템의 CLI를 이미 알고 있을 것입니다.
GitLab의 인증 자격 증명:
- Git 원격 URL을 업데이트하려면 GitLab에서 인증해야 합니다. 귀하의 GitLab 계정이 기본 사용자 이름 및 암호 인증을 사용하는 경우, 이중 인증 (2FA)을 사용하지 않아도 CLI에서 인증할 수 있어야 합니다. 또는 SSH 키를 사용하여 GitLab을 인증할 수 있습니다.

Git 원격 URL을 업데이트하려면, 저장소의 기존 및 새 URL을 결정하세요:

터미널 또는 명령 프롬프트를 엽니다.
로컬 저장소 작업 사본으로 이동합니다. 디렉토리를 변경하려면 cd를 사용합니다:
```
cd <repository-name>
```
각 저장소에는 기본 원격이라는 이름의 기본 원격이 있습니다. 원격 저장소의 현재 원격 fetch 및 push URL을 보려면 다음을 실행하세요:
```
git remote -v
```
반환된 URL을 복사하고 메모에 보관하세요. 보통 동일합니다.
새 URL을 가져옵니다:
1. GitLab으로 이동합니다.
2. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 귀하의 프로젝트를 찾습니다.
3. 왼쪽 사이드바에서 Code > Repository를 선택하여 프로젝트의 Repository 페이지로 이동합니다.
4. 오른쪽 상단모서리에서 Code를 선택합니다.
5. git으로 인증 및 복제하는 방법에 따라 HTTPS 또는 SSH URL을 복사합니다. 확신이 없으면 이전 단계에서의 origin URL과 동일한 방법을 사용하세요.
6. 복사한 URL을 메모에 보관하세요.

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

터미널 또는 명령 프롬프트를 엽니다.
로컬 저장소 작업 사본으로 이동합니다. 디렉토리를 변경하려면 cd를 사용합니다:
```
cd <repository-name>
```
새 저장소 URL로 원격 URL을 업데이트합니다. 새 저장소 URL로 <new_url>을(를) 대체합니다:
```
git remote set-url origin <new_url>
```
원격 URL 업데이트가 성공적인지 확인하세요. 다음 명령은 새 URL을 사용하여 fetch 및 push 작업을 위한 새 URL을 표시하며, 로컬 브랜치 목록을 나열하고 이들이 GitLab에 추적되었는지 확인합니다:
```
git remote show origin
```
- 업데이트가 실패한 경우, 이전 단계로 돌아가 올바른 <new_url>을 확인하고 다시 시도하세요.

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

git remote set-url 명령을 사용합니다. 업데이트하려는 원격의 이름으로 origin을 대체합니다. 예를 들어:
```
git remote set-url <remote_name> <new_url>
```
각 원격 URL 업데이트를 확인하세요:
```
git remote show <remote_name>
```

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

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

귀하의 프로젝트에는 하나 이상의 원격 위치가 있을 수 있습니다. 예를 들어 GitHub에서 호스팅된 프로젝트에서 분기된(repository) 저장소가 있지만, GitHub에 풀 요청을 하기 전에 GitLab에서 해당 분기에서 작업하려고 합니다.

원본 원격 URL을 업데이트한 후에 이를 유지하기 위해 새로 추가하고 이전과 새 원격 URL을 모두 유지하려면 기존 것을 수정하는 대신 새로운 원격을 추가할 수 있습니다.

이 방법으로 기존 URL에서 새 URL로 점진적으로 전환할 수 있으면서 원본 저장소에 여전히 접근할 수 있습니다.

새 원격 URL을 추가하려면:

터미널 또는 명령 프롬프트를 엽니다.
로컬 저장소 작업 사본으로 이동합니다.
새 원격 URL을 추가합니다. 새로운 원격의 이름으로 <new_remote_name>을 대체하고, <new_url>로 새 저장소 URL을 대체합니다:
```
git remote add <new_remote_name> <new_url>
```
새 원격이 추가되었는지 확인하세요:
```
git remote -v
```

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