YouTrack サーバー 2024.2 ヘルプ

GitLab からインポート

GitLab(英語) からのインポートにより、プロジェクト、課題、コメント、ユーザー、その他のデータを GitLab から YouTrack に移行できます。

セットアップウィザードは、インポート構成プロセスを移動します。接続設定を入力するように求められ、YouTrack のプロジェクトを GitLab のプロジェクトにマップできます。プロジェクトにカスタム設定がある場合は、YouTrack でインポートスクリプトを直接編集できます。

前提条件

プロジェクトを GitLab から YouTrack にインポートする前に、次の要件を確認してください。

  • GitLab のバージョンは 13.8 以降です。

  • GitLab サーバーはインバウンド接続からアクセスできます。具体的には、ネットワークが YouTrack から GitLab へのリクエストをブロックしないようにする必要があります。

  • GitLab への接続に使用するアカウントは、インポートする GitLab プロジェクトにアクセスできます。これは、プライベートアクセストークンが認証に使用されるユーザーアカウントです。

  • パスワードまたはトークンを使用して、ソースアプリケーションに直接ログインしてアクセスできます。

    YouTrack のインポートエンジンは、外部認証モジュールによる認証をサポートしていません。

詳細のインポート

GitLab データベースに YouTrack にまだ存在しないエンティティへの参照が含まれている場合、それらは作成されます。インポートの実行に使用する YouTrack ユーザーアカウントには、インポートされたすべてのエンティティを作成するための十分な権限が必要です。インポートを実行するには、システム管理者ロールまたは低レベルの管理者書き込み権限を持つアカウントを使用することをお勧めします。

インポートされたエンティティ

GitLab からインポートされたエンティティのリストと YouTrack エンティティへのマッピングは次のとおりです。

GitLab のエンティティ

YouTrack のエンティティ

プロジェクト

プロジェクト

課題

課題

エピック

課題

フィールド値を発行する

カスタムフィールド値

Wiki ページ

記事

コメント

コメント

ラベル

タグ

課題履歴

活動項目の発行

現在、履歴のインポートは制限されています。詳細については、インポートの制限を参照してください。

ユーザー

ユーザー

添付

添付

現在、添付ファイルのインポートは制限されています。詳細については、インポートの制限を参照してください。

マイルストーン

Milestone カスタムフィールドの値

リンクされた課題

課題リンク

インポートの制限

GitLab および YouTrack API の制限により、YouTrack は一部のエンティティを部分的にインポートするか、まったくインポートしません。次のインポート制限があります。

エンティティ

詳細

添付

課題のイメージの添付ファイルのみがインポートされます。場合によっては、記事のイメージの添付ファイルもインポートできます。

添付ファイルが欠落している各課題には、attachments missing タグが付けられます。YouTrack は、課題の説明の最後に欠落している添付ファイルのリストを追加します。

歴史的な出来事

YouTrack は、Milestone、State、Weight フィールドの履歴イベントのみをインポートします。

作業項目

作業項目はインポートされません。

発行フィールド

YouTrack は、Iteration と Severity を除くすべての発行フィールドをインポートします。

ボード

ボードはインポートされません。

GitLab からのインポートを設定する

新しいインポート構成を追加する前に、GitLab のターゲットプロジェクトへのアクセスを許可する個人用アクセストークンを作成する必要があります。次に、YouTrack でインポートを設定するときに、認証にトークンを使用できます。

GitLab でパーソナルアクセストークンを作成する

GitLab からの課題のインポートを設定するには、まず、GitLab で個人用アクセストークンを作成する必要があります。

GitLab でパーソナルアクセストークンを作成するには:

  1. 管理者権限が付与されているアカウントで GitLab にログインします。

  2. 右上隅にあるアバターをクリックします。

  3. 環境設定> アクセストークンページに移動します。

  4. トークンの名前を入力します。

  5. トークンにスコープを設定します。インポートには、read_api および read_user スコープが必要です。

  6. 個人用アクセストークンを作成するボタンをクリックしてください。

    • 新しいパーソナルアクセストークンが作成されます。

    copy token in GitLab

パーソナルアクセストークンの作成の詳細については、GitLab ドキュメント(英語)を参照してください。

YouTrack で GitLab からのインポートを構成する

セットアップウィザードは、セットアッププロセスをガイドします。

GitLab からのインポートを構成するには:

  1. 管理メニューから、統合> インポートを選択します。

  2. 新規インポートをクリックして、セットアップダイアログを開きます。

    New import dialog

  3. GitLab を選択します。

    • GitLab からの新しいインポートの設定が表示されます。

    GitLab import settings

  4. 以下の設定に値を入力します。

    設定

    説明

    GitLab の URL

    GitLab の URL。

    インスタンスが gitlab.com でホストされている場合は、プロジェクトの URL を入力します。自己管理型インストールの場合は、代わりにベース URL を入力してください。

    トークン

    ターゲットの課題にアクセスするために GitLab で生成した個人用アクセストークン。

    GitLab のインストールで必要な場合は、クライアント認証に SSL キーを使用するオプションを有効にします。

  5. 次へボタンをクリックしてください。

    • インポート設定の 2 番目のセットが表示されます。

    Confirm settings and start import.

  6. オプションのデータセットのインポートを管理するセクションを展開します。ここでは、インポート中にソースデータベースの特定の部分を無視するようにインポートエンジンを構成できます。

    設定

    説明

    課題履歴

    このトグルを無効にして、インポート中に課題の変更履歴を無視します。

    課題リンク

    インポート中に課題間のリンクを無視するには、このトグルを無効にします。

    デフォルトでは、これらのトグルは有効になっています。これは、インポートスクリプトがサポートしている場合、YouTrack が過去の変更をプルし、インポートソースからリンクを発行することを意味します。

  7. インポートする GitLab プロジェクトとターゲット YouTrack プロジェクトを選択します。プロジェクトマッピング構成の詳細については、プロジェクトマッピングを参照してください。

    必要に応じて、継続的なインポートを有効にします。有効にすると、YouTrack は選択された GitLab プロジェクトを定期的にポーリングし、最後の同期以降に行われた更新をインポートします。

  8. インポートを開始しますボタンをクリックしてください。

    • YouTrack は、構成されたプロジェクトマッピングに従って、新しいプロジェクトを作成し、既存のプロジェクトにデータをインポートします。

    • YouTrack は、課題、記事、ユーザーをターゲットプロジェクトにインポートします。

    • 継続的なインポートオプションが有効になっている場合、YouTrack はターゲットの GitLab プロジェクトで更新された課題と新しい課題を定期的にチェックします。

インポートを設定すると、インポートリストに表示されます。構成とインポートの詳細を表示するには、リストからインポート構成を選択します。

Import configuration details

サイドバーの YouTrack には、インポートのステータスとインポートされたデータに関する追加情報が表示されます。接続された GitLab プロジェクトから更新をインポートするには、ツールバーの 再開ボタンをクリックします。

インポートログファイルをダウンロードして、必要に応じて調査および調査することもできます。

プロジェクトマッピング

GitLab が自己管理型の場合、1 つのインポート構成内で GitLab から YouTrack に複数のプロジェクトをインポートできます。

インポート設定の最後のステップで、YouTrack にインポートするプロジェクトを選択できます。YouTrack の既存のプロジェクトにデータをインポートするか、インポートするために新しいプロジェクトを作成するかを選択することもできます。

YouTrack は、Web アドレスが以前のインポートによってソースプロジェクトをすでにマップしているかどうかを認識します。YouTrack ですでにマップされているインポートされたソースプロジェクトは選択できません。重複データをインポートせずに、同じソースから複数のインポートジョブを作成できます。

Project Mapping

プロジェクトマッピングを構成するには:

  1. インポートする GitLab プロジェクトを見つけます。リストの GitLab プロジェクト名には、それらが属するグループの名前が含まれていることに注意してください。

    右側のフィルターバーを使用して、プロジェクトを名前でフィルターします。

  2. インポートするプロジェクトを選択します。リストの上部にあるオプションを選択して、使用可能なすべての GitLab プロジェクトをインポートします。

  3. GitLab プロジェクトごとにターゲット YouTrack プロジェクトを選択します。

    • マッピングのために GitLab プロジェクトのリストをロードするとき、YouTrack は対応する名前を持つ既存の YouTrack プロジェクトをチェックします。GitLab プロジェクトと同じ名前の YouTrack プロジェクトが見つかった場合、YouTrack はそれをターゲットプロジェクトとして提案します。

    • 対応する名前の既存の YouTrack プロジェクトがない場合、YouTrack は新しいプロジェクトを作成することを提案します。

  4. ターゲットプロジェクトを変更する場合は、リストの対応するドロップダウンから別のオプションを選択します。

  5. インポートを開始しますをクリックして、インポートの設定を完了し、インポートを開始します。

    • インポートが開始されます。

インポートオプション

最初のインポート後、サイドバーで次のコントロールを使用できます。

Import Options

コントロール

説明

再開

前回のインポート後に選択した GitLab プロジェクトで行われた変更をすぐにインポートします。

編集

統合設定ページを編集モードで開きます。このオプションを使用して、別の GitLab インスタンスに接続したり、ログインクレデンシャルを更新したり、プロジェクトマッピングを更新したりします。

削除

現在のインポート設定を削除します。接続された GitLab インスタンスからインポートされたプロジェクト、課題、コメント、ユーザー、グループは影響を受けません。インポート設定を削除して同じ GitLab インスタンスに接続すると、課題は新しい課題 ID を使用して既存のプロジェクトに再インポートされます。

GitHub からインポート Google スプレッドシートからインポート