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

GitLab Jiraインポーターを使用すると、JiraイシューをGitLab.comまたはGitLab Self-Managedにインポートできます。

Jiraイシューのインポートは最低限実現可能な変更のプロジェクトレベルの機能です。つまり、複数のJiraプロジェクトのイシューを1つのGitLabプロジェクトにインポートできます。最低限実現可能な変更バージョンのインポートでは、イシューのタイトル、説明、およびその他のイシューメタデータを、イシューの説明のセクションとしてインポートします。

既知の制限事項

GitLabは、次の情報を直接インポートします:

• 件名、説明、ラベル。
• インポートの準備をする際に、JiraのユーザーをGitLabプロジェクトのメンバーにマップすることもできます。

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

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

イシューの担当者、コメントなどを将来のイテレーションで追加することを追跡するエピックがあります。

前提要件

• Jiraプロジェクトからイシューをインポートできるようにするには、Jiraイシューに対する読み取りアクセス権と、インポート先のGitLabプロジェクトに対するメンテナーロール以上が必要です。
• この機能は、既存のGitLab Jiraイシューインテグレーションを使用します。Jiraイシューのインポートを試みる前に、インテグレーションが設定されていることを確認してください。

GitLabにJiraイシューをインポートする

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

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

   

   Jiraからのインポートオプションは、正しい権限がある場合にのみ表示されます。

   次のフォームが表示されます。以前にJiraイシューインテグレーションを設定した場合は、ドロップダウンリストでアクセスできるJiraプロジェクトを確認できるようになりました。

   

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

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

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

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

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

   インポートがバックグラウンドで実行されている間は、イシューページに移動して、リストに新しいイシューが表示されるのを確認できます。

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