Jira 프로젝트를 GitLab으로 마이그레이션하는 여러 가지 옵션이 있습니다. 마이그레이션 전략을 결정하기 전에 먼저 Jira 이슈를 GitLab으로 이동해야 하는지 여부를 결정하세요. 많은 경우 Jira 이슈 데이터는 더 이상 관련이 없거나 실행 가능하지 않습니다. GitLab에서 새롭게 시작하면 GitLab 사용의 장점을 최대화하는 프로세스와 워크플로우 설정에 집중할 수 있습니다.

Jira 이슈를 마이그레이션하기로 결정한 경우 여러 마이그레이션 옵션 중에서 선택할 수 있습니다:

• GitLab Jira 가져오기 도구 사용.
• CSV 파일 가져오기.
• GitLab Professional Services에서 마이그레이션 처리.
• 타사 서비스를 사용하여 단방향 또는 양방향 데이터 동기화 프로세스 구축.
• 타사 스크립트 사용.
• 자체 스크립트 작성.

GitLab Jira 가져오기 도구 사용#

GitLab에는 Jira 이슈 데이터를 가져오기 위한 내장 도구가 있습니다. GitLab Jira 가져오기 도구를 사용하려면:

1. 대상 프로젝트에서 GitLab Jira 이슈 통합 구성
2. Jira 프로젝트 이슈를 GitLab으로 가져오기

또는 프로세스의 전체 데모를 시청할 수 있습니다: Jira 프로젝트 이슈를 GitLab으로 가져오기

CSV 파일 가져오기#

CSV 파일에서 Jira 이슈 데이터를 GitLab 프로젝트로 가져오려면:

1. Jira 데이터를 내보냅니다:
   1. Jira 인스턴스에 로그인하고 마이그레이션할 프로젝트로 이동합니다.
   2. 프로젝트 데이터를 CSV 파일로 내보냅니다.
   3. GitLab CSV 가져오기 도구에 필요한 열 이름에 맞게 CSV 파일을 편집합니다.
      • title, description, due_date, milestone만 가져옵니다.
      • 가져오기 프로세스 중에 다른 이슈 메타데이터를 자동으로 설정하기 위해 description 필드에 빠른 작업을 추가할 수 있습니다.
2. 새 GitLab 그룹 및 프로젝트를 만듭니다:
   1. GitLab 계정에 로그인하고 마이그레이션된 프로젝트를 호스팅할 그룹을 만듭니다.
   2. 새 그룹에서 마이그레이션된 Jira 이슈를 보관할 새 프로젝트를 만듭니다.
3. Jira 데이터를 GitLab으로 가져옵니다:
   1. 새 GitLab 프로젝트의 왼쪽 사이드바에서 Plan > Work items를 선택합니다.
   2. Actions (⋮) > Import from Jira를 선택합니다.
   3. 화면의 지침에 따라 가져오기 프로세스를 완료합니다.
4. 마이그레이션 확인:
   1. 가져온 이슈를 검토하여 프로젝트가 GitLab으로 성공적으로 마이그레이션되었는지 확인합니다.
   2. GitLab에서 마이그레이션된 Jira 프로젝트의 기능을 테스트합니다.
5. 워크플로우 및 설정 조정:
   1. 팀의 필요에 맞게 description 템플릿, 레이블, 마일스톤과 같은 GitLab 프로젝트 설정을 사용자 정의합니다.
   2. 마이그레이션으로 도입된 새로운 워크플로우나 프로세스를 팀에 숙지시킵니다.
6. Jira 인스턴스 폐기:
   1. 마이그레이션에 만족하면 Jira 인스턴스를 폐기하고 GitLab으로 완전히 전환할 수 있습니다.

GitLab Professional Services에서 마이그레이션 처리#

고수준 개요는 Jira 마이그레이션 서비스 데이터 시트를 참조하세요.

개인화된 견적을 받으려면 GitLab Professional Services 페이지를 방문하고 Request Service를 선택합니다.

타사 서비스를 사용하여 단방향 또는 양방향 데이터 동기화 설정#

Jira와 GitLab 간에 단방향 또는 양방향 데이터 동기화를 설정하려면 다음 타사 서비스를 사용할 수 있습니다:

• Unito.io: GitLab + Jira 통합 문서, GitLab + Jira 양방향 동기화 마켓플레이스 애드온
• Getint: GitLab Jira 동기화 마켓플레이스 애드온

타사 스크립트 사용#

사용 가능한 오픈 소스 마이그레이션 스크립트 중 하나를 사용하여 Jira 이슈를 GitLab으로 마이그레이션할 수 있습니다.

많은 고객이 jira2gitlab을 사용하여 성공적인 결과를 얻었습니다.

프로세스의 전체 데모를 시청하세요: Jira2GitLab로 Jira에서 GitLab으로 마이그레이션

자사 스크립트 사용#

GitLab Professional Services는 앞서 언급한 jira2gitlab 스크립트의 포크인 Jira2Lab을 만들었습니다:

• 블로그 포스트: Jira2Lab으로 Jira에서 GitLab으로 원활하게 대규모 마이그레이션
• 리포지터리

Jira2Lab README에 명시된 바와 같이:

마이그레이션 요구에 가장 적합한 도구를 선택하기 위해 두 도구를 비교해 보시기 바랍니다.

자체 스크립트 작성#

마이그레이션 프로세스를 완전히 제어하기 위해 필요에 맞는 방식으로 Jira 이슈를 GitLab으로 마이그레이션하는 사용자 정의 스크립트를 작성할 수 있습니다. GitLab은 마이그레이션 자동화를 위한 API를 제공합니다:

• REST API
• GraphQL API

시작하려면 다음 GitLab API 엔드포인트를 숙지하세요:

• 이슈
• 프로젝트
• 레이블
• 마일스톤

스크립트를 작성할 때 Jira 이슈 필드를 해당 GitLab 등가물에 매핑해야 합니다. 몇 가지 팁:

• 고정된 수의 옵션을 가진 사용자 정의 필드: 필드 이름을 범위 지정 레이블 키로, 필드 값을 범위 지정 레이블 세트 값으로 사용하는 범위 지정 레이블 세트를 만듭니다(예: input name::value1, input name::value2).
• 텍스트 문자열 또는 정수 값을 가진 사용자 정의 필드: 사용자 정의 필드 이름과 값을 이슈 설명의 섹션에 삽입합니다.
• 상태: 상태를 범위 지정 레이블 키로, 상태 값을 범위 지정 레이블 세트 값으로 사용하는 범위 지정 레이블을 만듭니다(예: status::in progress).
• 우선순위: 우선순위를 범위 지정 레이블 키로, 우선순위 값을 범위 지정 레이블 세트 값으로 사용하는 범위 지정 레이블을 만듭니다(예: priority::1).
• 스토리 포인트: 이 값을 GitLab 이슈의 weight 값에 매핑합니다.
• 스프린트: 이 값을 GitLab 이슈의 iteration 값에 매핑합니다. 이 값은 완료되지 않았거나 미래 스프린트에 예정된 이슈에 대해서만 의미가 있습니다. 데이터를 가져오기 전에 프로젝트의 상위 그룹에서 필요한 이터레이션을 만드세요.

Atlassian Document Format을 파싱하여 GitLab Flavored Markdown으로 매핑해야 할 수도 있습니다. 다양한 방법으로 접근할 수 있습니다. 영감을 얻으려면 예시 커밋을 검토하세요. 이 커밋은 GitLab Jira 가져오기 도구를 위해 Atlassian Document Format을 GitLab Flavored Markdown으로 파싱하는 메서드를 추가했습니다.

로컬에서 GitLab을 실행하는 경우 Rails 콘솔에서 수동으로 Atlassian Document Format을 GitLab Flavored Markdown으로 변환할 수도 있습니다. 실행 방법:

text = <document in Atlassian Document Format>
project = <project that wiki is in> or nil
Banzai.render(text, pipeline: :adf_commonmark, project: project)

관련 주제#

• 가져오기 및 내보내기 설정.
• 가져오기를 위한 Sidekiq 구성.
• 여러 Sidekiq 프로세스 실행.
• 특정 job 클래스 처리.