GitLab의 이름이 변경된 프로젝트로 계속 리다이렉트될 때
주의
들어가기 앞서, 이 글은 GitLab 호스팅이 아닌 GitLab 설치형 또는 옴니버스 기준으로 작성됨을 알린다.
리포지토리 이름 및 경로 변경
GitLab에서는 리포지토리의 이름을 바꾸거나 경로를 바꿀 수 있다. 이름만 바꾼다고 경로까지 바뀌지는 않고, 각각 따로 바꿀 수 있다.
리포지토리 이름 변경
리포지토리의 이름을 변경하려면 리포지토리의 Settings - General로 이동하여 Naming, topics, avatar 섹션을 열고 Project Name을 변경하면 된다.
 |
| 리포지토리 이름 변경 |
리포지토리 경로 변경
하지만 리포지토리 이름을 변경한다고 해서 리포지토리 경로가 바뀌진 않는다. 예를 들어 기존에 https://honsal.io/honsals/HsStringTools 경로로 접근할 수 있었던 리포지토리의 이름을 HsStringTools에서 HsStringToolsLegacy로 변경한다고 해서 URL이 https://honsal.io/honsals/HsStringToolsLegacy로 변경되지는 않는다는 말이다.
이걸 변경하려면 마찬가지로 Settings - General로 이동하되 이번엔 Advanced 섹션에서 작업해야 한다.
 |
| 경로 변경 |
경로 변경은 Change path 버튼을 누르면 적용된다.
리다이렉트 문제
내 생각에 대부분의 상황에서는 이렇게 하고 나서 아예 잊어버려도 아무런 문제가 없을 것이다. 심지어 기존 프로젝트 구성원에게 경로가 바뀌었으니 URL을 다르게 적용하라고 말하지 않아도 아무런 문제가 없을 것이다.
왜냐하면 GitLab이 (GitHub이 그렇듯이)변경되기 전 경로를 자동으로 변경 후 URL로 리다이렉트하기 때문이다.
문제는 리다이렉트하지 말아야 할 때
하지만 내 경우에는 이게 문제가 되었다. 이 GitLab 인스턴스는 사실상 내 프리랜서 개발 용도로 혼자 쓰다시피 하고 있기에 이슈 관리보다 버전 관리에 더욱 치중된 채 운영되고 있다.
그리고 이번에 거의 5년이 넘게 방치되고 있던 스무 개 가량의 레거시 닷넷 프레임워크 프로젝트를 아카이브하고 .NET 7 버전으로 올린 새로운 프로젝트를 푸시하려다가 사건이 발생하게 되었다.
푸시가 안 된다!
푸시가 안 된다. 정확히는 자꾸 리네임된 레거시 프로젝트로 리다이렉트되어 새로운 리포지토리를 동일한 URL에 푸시할 수 없다.
지금 내가 하고자 하는 일은 다음과 같은데,
| 레거시 프로젝트명 | 기존 URL | 새 레거시 프로젝트명 | 새 URL | .NET 7 프로젝트명 | .NET 7 URL |
|---|---|---|---|---|---|
| HsStringTools | honsals/HsStringTools | HsStringToolsLegacy | honsals/HsStringToolsLegacy | HsStringTools | honsals/HsStringTools |
| HsNetworkTools | honsals/HsNetworkTools | HsNetworkToolsLegacy | honsals/HsNetworkToolsLegacy | HsNetworkTools | honsals/HsNetworkTools |
| … | … | … | … | … | … |
즉 .NET Framework로 작성된 기존 리포지토리명의 뒤에 모두 Legacy를 붙여버린 뒤 아카이브하고, .NET 7으로 변환한 새 프로젝트를 기존 명칭으로 푸쉬하려 하는 중이다.
그러나 GitLab이 자동으로 생성한 리다이렉트 때문에 프로젝트명과 경로를 모두 바꿨음에도 새 프로젝트를 해당 경로로 푸쉬할 수 없는 상황이다.
게다가 UI에서 이를 지울 방법을 찾을 수가 없다.
해결 방안: GUI에 없다면 CUI로
어쩌겠는가. 사이트에 기능이 없으면 콘솔을 쓰는 수밖에. 다행히도 이러한 리다이렉트 관계를 정리한 RedirectRoute라는 클래스가 rails console에 정의되어 있다.
우선 다음과 같이 도커 gitlab 인스턴스에서 gitlab rails를 실행하였다.
docker exec -it gitlab gitlab-rails console -e production
그리고 RedirectRoute.all로 현재 리다이렉트 테이블을 확인해봤다.1
irb(main):001:0> RedirectRoute.all
=>
[#<RedirectRoute:0x0000????????????
id: 1,
source_id: 1,
source_type: "Namespace",
path: "root",
created_at: Tue, 02 May 2023 21:40:43.281860000 KST +09:00,
updated_at: Tue, 02 May 2023 21:40:43.281860000 KST +09:00>,
#<RedirectRoute:0x0000????????????
id: 2,
source_id: ??,
source_type: "Project",
path: "SENSORED",
created_at: Tue, 13 Jun 2023 09:27:19.330506000 KST +09:00,
updated_at: Tue, 13 Jun 2023 09:27:19.330506000 KST +09:00>,
#<RedirectRoute:0x0000????????????
id: 3,
source_id: ??,
source_type: "Project",
path: "HsStringTools"
created_at: Mon, 04 Dec 2023 01:10:09.283365000 KST +09:00,
updated_at: Mon, 04 Dec 2023 01:10:09.283365000 KST +09:00>]
irb(main):002:0>
id: 3에 문제의 프로젝트 경로가 보이는 것을 확인할 수 있다. 이걸 지우면 문제가 해결된다. 주의할 점은, 어떠한 경고나 저장 과정 없이 즉시 실행되고 반영되기 때문에 id가 일치하는지 꼼꼼히 확인해야 한다.
irb(main):003:0> RedirectRoute.find_by(id: 3).delete
=>
#<RedirectRoute:0x00007fdc1faf6c40
id: 3,
source_id: 69,
source_type: "Project",
path: "honsals/HsStringTools",
created_at: Mon, 04 Dec 2023 01:10:09.283365000 KST +09:00,
updated_at: Mon, 04 Dec 2023 01:10:09.283365000 KST +09:00>
irb(main):005:0> RedirectRoute.find_by(id: 3)
=> nil
이제 새 리포지토리를 원래의 경로로 푸시할 수 있다.
결론
GitLab은 GitHub과 같이 프로젝트의 경로가 수정되면 기존 경로가 수정된 경로로 자동으로 리다이렉트되도록 라우팅 테이블을 생성한다.
적어도 내가 확인한 바로는 이러한 라우트 테이블을 프로젝트 설정이나 인스턴스 설정 등 사이트 내에서 수정/삭제할 수 없기 때문에 gitlab console을 사용하여 직접 삭제해야 한다.
해결 방법을 알아보던 중 관련 이슈를 몇 개 봤는데, 죄다 수 년동안 반영되지 않은 걸 보면 (내가 못 찾은 게 아니라면)이런 기능은 구현되지 않지 않을까 싶다.
내 경우엔 리다이렉트 된 리포지토리가 많지 않기에 이 방법을 썼으나, 규모가 있는 환경이라면
RedirectRoute.find_by등을 사용하면 된다. ↩︎
댓글
댓글 쓰기