GitLab 저장소 미러링

작업을 하다 보면 모종의 이유로 깃랩 저장소에 있는 코드를 다른 깃 저장소로 복제해야 할 수 있습니다. 예를 들어 팀에서 CI/CD 플랫폼으로 GitLab을 연동해서 쓰고 있는데 전사 기준으로 코드를 공유할 때는 Github를 쓰게 돼 있다든가 하는 경우를 생각할 수 있습니다.

이 때 쓸 수 있는 방법이 미러링(mirroring)입니다. GitHub으로 옮기는 경우를 기준으로 설명해 보겠습니다.

1. GitHub에서 저장소를 새로 만듭니다. (어차피 깃랩 내용으로 덮어쓸 거니까 그냥 빈 프로젝트를 만들면 됩니다.)

2. 저장을 위한 토큰을 발급받습니다. GitHub 메뉴에서 Settings > Developer Settings > Personal access tokens로 들어가서 새 토큰을 만듭니다. 자세한 설명은 이 페이지 등을 참고하세요.

3. GitLab에서 미러링 설정 메뉴로 갑니다. 프로젝트에서 왼쪽에 있는 메뉴 항목 중 Settings > Repository로 들어가서 Mirroring repositories 항목에서 Expand 버튼을 클릭하면 됩니다. (사용하는 버전에 따라 바로 정보 입력 화면이 뜨기도 하고 Add new 버튼을 클릭했을 때 정보 입력 화면이 뜨기도 합니다.)

4. 정보를 입력합니다. https를 사용하는 경우라면 GitHub 프로젝트에서 복사해 온 https 주소를 입력하면 됩니다. 이 때 익명으로 커밋을 할 수 없는 구성이라면 주소에 사용자 정보를 넣어줘야 합니다. gitlab.com을 사용한다면 인증 방법으로 Username and Password 옵션을 선택하고 사용자명과 토큰을 넣어주면 되는데, 별도의 gitlab을 직접 설치해 놓고 쓴다면 버전에 따라 인증 방법에 사용자명을 입력하지 못하고 Password만 입력해야 하는 경우도 있습니다. 이럴 때는 https:// 바로 뒤에 USERNAME@을 추가해 줘야 합니다.

그리고 나서 Mirror repository 버튼을 클릭하면 모든 설정이 완료됩니다.