正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

Jira移行のオプション

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

複数のオプションを使用して、JiraプロジェクトをGitLabに移行できます。移行戦略を決定する前に、JiraイシューをGitLabに移行する必要があるかどうかを決定してください。多くの場合、Jiraイシューデータは関連性がなく、実用的でもありません。GitLabで新たに開始することで、プロセスとワークフローのセットアップに集中し、GitLabを使用するメリットを最大限に高めることができます。

Jiraイシューを移行することを選択した場合、いくつかの移行オプションから選択できます:

  • GitLab Jiraインポーターを使用します。
  • CSVファイルをインポートします。
  • GitLabプロフェッショナルサービスに移行を依頼します。
  • サードパーティサービスを使用して、一方向または双方向のデータ同期プロセスをビルドします。
  • サードパーティスクリプトを使用します。
  • 独自のスクリプトを作成します。

GitLab Jiraインポーター

GitLabには、Jiraイシューデータをインポートするためのビルドインツールがあります。GitLab Jiraインポーターを使用するには、次の手順に従います:

  1. ターゲットプロジェクトでGitLab Jiraイシューインテグレーションを設定する
  2. JiraプロジェクトイシューをGitLabにインポートします

または、プロセスの完全なデモを視聴できます: JiraプロジェクトイシューをGitLabにインポートします

CSVファイルをインポートする

JiraイシューデータをCSVファイルからGitLabプロジェクトにインポートするには、次の手順に従います:

  1. Jiraデータをエクスポートします:
    1. Jiraインスタンスにログインして、移行するプロジェクトに移動します。
    2. プロジェクトデータをCSVファイルとしてエクスポートします。
    3. GitLab CSVインポーターに必要なカラム名と一致するようにCSVファイルを編集します。
  2. 新しいGitLabグループとプロジェクトを作成します:
    1. GitLabアカウントにサインインし、移行されたプロジェクトをホストするためのグループを作成します。
    2. 新しいグループで、移行されたJiraイシューを保持するための新しいプロジェクトを作成します。
  3. JiraデータをGitLabにインポートします:
    1. 新しいGitLabプロジェクトの左側のサイドバーで、Plan > イシューを選択します。
    2. アクション ( ellipsis_v ) > Jiraからのインポートを選択します。
    3. 画面の指示に従って、インポートプロセスを完了します。
  4. 移行を確認します:
    1. インポートされたイシューをレビューして、プロジェクトがGitLabに正常に移行されたことを確認します。
    2. GitLabで移行されたJiraプロジェクトの機能をテストします。
  5. ワークフローと設定を調整します:
    1. チームのニーズに合わせて、GitLabのプロジェクト設定 （説明テンプレート 、ラベル 、マイルストーンなど）をカスタマイズします。
    2. チームにGitLabインターフェースと、移行によって導入された新しいワークフローまたはプロセスを理解してもらいます。
  6. Jiraインスタンスを停止します:
    1. 移行に満足したら、Jiraインスタンスを停止し、GitLabに完全に移行できます。

GitLabプロフェッショナルサービスに移行を依頼します

Jira移行サービスの概要については、Jira移行サービスデータシートを参照してください。

パーソナライズされた見積もりを取得するには、GitLabプロフェッショナルサービスページにアクセスし、Request Service（サービスをリクエスト）を選択してください。

サードパーティサービスを使用した一方向または双方向のデータ同期を確立します

JiraとGitLabの間で一方向または双方向のデータ同期を確立するには、次のサードパーティサービスを使用できます:

サードパーティスクリプトを使用します

利用可能なオープンソースの移行スクリプトのいずれかを使用して、JiraイシューをGitLabに移行できます。

多くのお客様がjira2gitlabを使用して成功を収めています。

プロセスの完全なデモをご覧ください: JiraからJira2GitLabを使用してGitLabへの移行

ファーストパーティースクリプトを使用する

GitLabプロフェッショナルサービスは、以前に言及したjira2gitlabスクリプトのフォークであるJira2Labをビルドしました:

Jira2Lab Readmeに記載されているように:

ユーザーが両方のツールを比較して、移行のニーズに最適に対応することをお勧めします。

独自のスクリプトを作成します

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

開始するには、次のGitLab APIエンドポイントについて理解してください:

スクリプトを作成するときは、Jiraイシューフィールドを、対応するGitLabの同等物にマップする必要があります。ヒントをいくつか紹介します:

  • Custom fields with a fixed number of options（オプションの数が固定されているカスタムフィールド）: フィールド名をスコープ付きラベルキーとして、フィールド値をスコープ付きラベルセット値として持つスコープ付きラベルセットを作成します（例: input name::value1、input name::value2）。
  • Custom fields with text strings or integer values（テキスト文字列または整数値を持つカスタムフィールド）: カスタムフィールド名と値をイシューの説明のセクションに挿入します。
  • ステータス: ステータスをスコープ付きラベルキーとして、ステータス値をスコープ付きラベルセット値として持つスコープ付きラベルを作成します（例: status::in progress）。
  • 優先順位: 優先順位をスコープ付きラベルキーとして、優先順位値をスコープ付きラベルセット値として持つスコープ付きラベルを作成します（例: priority::1）。
  • Story Point（ストーリー）ポイント: この値をGitLabイシューのweight（ウェイト）値にマップします。
  • Sprint（スプリント）: この値をGitLabイシューのイテレーション値にマップします。この値は、完了していないイシュー、または将来のスプリントにスケジュールされているイシューにのみ意味があります。データをインポートする前に、プロジェクトの親グループに必要なイテレーションを作成します。

解析中のAtlassianドキュメント形式を処理し、GitLab Flavored Markdownにマッピングする必要がある場合もあります。これにはさまざまな方法で取り組むことができます。インスピレーションを得るために、コミットの例をレビューします。このコミットは、GitLab JiraインポーターのAtlassianドキュメント形式をGitLab Flavored Markdownに解析するためのメソッドを追加しました。

GitLabをローカルで実行する場合は、RailsコンソールでAtlassianドキュメント形式を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)