[Gitea]Gitea에 Github 마이그레이션

 

서론

• 이번 프로젝트에서 CI/CD를 위해 Gitea를 이용하게 되면서 기존에 개발자들이 따로 개발하고 있었던 소스코드를 한곳에 모아야하는 작업이 필요하게 되었으므로 마이그레이션 작업을 진행하게 되었다.
• 작업 자체는 간략하지만 개발자와의 협업이 필요한 작업이다.

Gitea란?

• Git을 기반으로 하여 관리하기 편하게 웹 서비스 형태로 제공하는 협력 플랫폼 서비스로 경량화된 상태로 자체 git서비스를 제공한다
• 여러가지 소스코드와 개발에 관련된 솔루션을 제공하고 있으며 Github와 공통된 부분이 많아 사설버전이라도 봐도 무방할 정도이다.

마이그레이션 작업

• Gitea로그인 후 오른쪽 위에있는 '+'버튼을 클릭하면 새 마이그레이션 이라는 항목이 나오는데 해당 항목을 선택한다.

 

• Gitea는 타 Git계열 플랫폼을 포함하여 여러가지 플랫폼을 지원한다 우리는 Github에 있는 자료를 마이그레이션 해올 예정이니 해당 부분을 선택한다.

• 여기가 가장 중요한 부분이다. 일단 해당 Github의 URL을 맨위의 칸에 입력하고 만약 private상태의 자료들이라면 Token발행이 필수이니 아래의 링크를 참조하여 토큰을 발행하고 기입하여야 한다.
• https://docs.github.com/ko/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens

개인용 액세스 토큰 관리 - GitHub Docs

• 토큰 발행 진행시 권한은 문제가 없도록 최대를 주기를 권장한다.
• 그후 아래의 체크부분이 있는데 미러옵션과 LFS옵션으로 만약 마이그레이션 소스코드들이 1GB이상이라면 체크를 하고 관련 고급옵션을 설정해야한다.
• 토큰을 기입하였다면 아래의 토큰항목들이 체크가 가능해지는데 기존이슈나 레이블이 필요하다면 체크를 하길 바란다.
• 위의 기입이 완료되면 아래의 소유자 지정 및 저장소 이름과 간단한 설명을 기입한후 마이그레이션 버튼을 선택하면 된다.

• 마이그레이션이 정상적으로 완료되었다면 해당 화면처럼 새로운 저장소가 생성되며 옵션에 따라 추가적으로 커밋 브랜치 이슈 등이 따라오게 된다.

마치며

• 마이그레이션 작업 후 개발자에게 공지하여 혹시 모를 무결성 문제가 생기지 않도록 확인을 부탁하는 것도 방법중 하나이다.