Jiraから移行

Jiraを使用している場合は、次のいずれかを実行できます:

• Jiraから移行せずにGitLabで新しく開始します。そうすれば、GitLabを使用するメリットを最大化するために、プロセスとワークフローを設定することに集中できます。
• いくつかのオプションのいずれかを使用して、JiraからGitLabへ移行します。

Jiraインポーターを使用

Jiraインポーターを使用して、JiraイシューをGitLabにインポートできます。複数のJiraプロジェクトからのイシューをGitLabプロジェクトにインポートできます。GitLabは、イシューのタイトル、説明、およびラベルを直接インポートします。インポートの準備中に、JiraユーザーをGitLabプロジェクトのメンバーにマッピングすることもできます。

GitLabイシューフィールドに正式にマッピングされていないその他のJiraイシューメタデータは、GitLabイシューの説明にプレーンテキストとしてインポートされます。

Jiraイシュー内のテキストはGitLab Flavored Markdownに解析されないため、テキストの書式設定が破損する可能性があります。詳細については、イシュー379104を参照してください。

Epic 2738では、イシューの割り当て者、コメント、およびその他の改善をGitLab Jiraインポーターに追加することが提案されています。

前提条件

• Jiraイシューへの読み取りアクセスと、インポート先のGitLabプロジェクトのMaintainerまたはOwnerロール。
• GitLab Jiraイシューインテグレーションを設定します。

Jiraイシューのインポート

Jiraイシューのインポートは非同期のバックグラウンドジョブとして実行されるため、次の要因に基づいて遅延が発生する可能性があります:

• インポートキューのロード。
• システムロード。
• その他の要因。

大規模なプロジェクトのインポートには、インポートのサイズによっては数分かかることがあります。

JiraイシューをGitLabプロジェクトにインポートするには:

1. 作業アイテムページで、アクション ( ) > Jiraからのインポートを選択します。

2. インポート元ドロップダウンリストを選択し、イシューをインポートしたいJiraプロジェクトを選択します。

   Jira-GitLabユーザーマッピングテンプレートセクションでは、テーブルにJiraユーザーがどのGitLabユーザーにマッピングされているかを示します。フォームが表示されると、ドロップダウンリストはインポートを実行するユーザーにデフォルトで設定されます。

3. マッピングを変更するには、GitLabのユーザー名列のドロップダウンリストを選択し、各Jiraユーザーにマッピングしたいユーザーを選択します。

   ドロップダウンリストにはすべてのユーザーが表示されない場合があるため、検索バーを使用してこのGitLabプロジェクトの特定のユーザーを見つけてください。

4. 続行するを選択します。インポートが開始されたことを確認するメッセージが表示されます。

   インポートがバックグラウンドで実行されている間、作業アイテムページに移動して、リストに新しいイシュー (Issueタイプの作業アイテム) が表示されていることを確認できます。

5. インポートのステータスを確認するには、もう一度Jiraインポートページにアクセスしてください。

CSVファイルを使用

JiraイシューデータをCSVファイルからGitLabプロジェクトにインポートするには:

1. Jiraデータをエクスポート:
   1. Jiraインスタンスにログインし、移行したいプロジェクトに移動します。
   2. プロジェクトデータをCSVファイルとしてエクスポートします。
   3. CSVファイルを編集して、GitLab CSVインポーターに必要な列名に合わせます。
      • title、description、due_date、milestoneのみがインポートされます。
      • インポートプロセス中に他のイシューメタデータを自動的に設定するために、説明テンプレートフィールドにクイックアクションを追加できます。
2. 新しいGitLabグループとプロジェクトを作成します:
   1. GitLabアカウントにサインインし、移行されたプロジェクトをホストするグループを作成します。
   2. 新しいグループで、移行されたJiraイシューを保持する新しいプロジェクトを作成します。
3. JiraデータをGitLabにインポートします:
   1. 新しいGitLabプロジェクトで、左サイドバーのPlan > 作業アイテムを選択します。
   2. アクション ( ) > Jiraからのインポートを選択します。
   3. 画面の指示に従ってインポートプロセスを完了します。
4. 移行を確認します:
   1. インポートされたイシューをレビューして、プロジェクトがGitLabに正常に移行されたことを確認します。
   2. 移行されたJiraプロジェクトの機能をGitLabでテストします。
5. ワークフローと設定を調整します:
   1. GitLabのプロジェクト設定を次のようにカスタマイズします:
      • 説明テンプレート。
      • ラベル。
      • マイルストーン。
   2. チームにGitLabインターフェースと、移行によって導入された新しいワークフローやプロセスを熟知させます。
6. 移行に満足したら、Jiraインスタンスの廃止とGitLabへの完全な移行を行うことができます。

独自のスクリプトを作成

移行プロセスを完全に制御するために、ニーズに正確に適合する方法でJiraイシューをGitLabに移行する独自のカスタムスクリプトを作成できます。GitLabは、移行の自動化を支援するAPIを提供しています:

• REST API
• GraphQL API

まず、以下のGitLab APIエンドポイントについて理解を深めてください:

• イシュー
• プロジェクト
• ラベル
• マイルストーン

スクリプトを作成する際は、Jiraイシューフィールドを対応するGitLabの同等フィールドにマッピングする必要があります。

Atlassian Document Formatを解析し、それをGitLab Flavored Markdownにマッピングする必要もあります。これにはさまざまなアプローチがあります。参考として、コミットの例をご覧ください。このコミットは、Atlassian Document FormatをGitLab Flavored Markdownに解析し、Jiraインポーター用にマッピングするメソッドを追加しました。

ローカルでGitLabを実行している場合、Atlassian Document FormatをGitLab Flavored MarkdownにRailsコンソールで手動で変換することもできます。これを行うには、以下を実行します:

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

関連トピック

• インポートとエクスポートの設定。
• インポートに関するSidekiqの設定。
• 複数のSidekiqプロセスの実行。
• 特定のジョブクラスの処理。