YouTrack サーバー 2024.2 ヘルプ

GitHub からインポート

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

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

前提条件

GitHub から YouTrack に課題をインポートする前に、次の要件を確認してください。

  • github.com(英語) でホストされている GitHub プロジェクト。現時点では、GitHub Enterprise Server からのインポートはサポートされていません。

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

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

詳細のインポート

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

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

GitHub のエンティティ

YouTrack のエンティティ

リポジトリ

プロジェクト

課題

課題

コメント

コメント

ユーザー

ユーザー

カスタムフィールド

カスタムフィールド

添付

添付

Markdown ファイル (*.md)

ナレッジベースの記事

HTML ファイル (*.html)

ナレッジベースの記事

reStructuredText ファイル (*.rst)

ナレッジベースの記事

リポジトリの協力者

プロジェクトチームメンバー

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

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

GitHub でアクセストークンを作成する

GitHub からの課題のインポートを設定するには、まず、GitHub リポジトリ内の課題にアクセスするために使用する GitHub アカウントの個人アクセストークンを作成する必要があります。

GitHub で個人アクセストークンを作成するには:

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

  2. ページの右上隅にあるプロファイル写真をクリックしてから、設定をクリックします。

  3. 左側のサイドバーで、開発者設定、個人アクセストークンの順にクリックします。

  4. 新しいトークンを生成するをクリックして、トークンの説明を入力します。

  5. 必要に応じて、トークンの有効期限を設定します。

  6. トークンのスコープを選択します。

    パブリックリポジトリとプライベートリポジトリでは、基本的なアクセス許可の範囲が異なります。状況に該当するリポジトリタイプを選択し、トークンに対応するスコープを選択します。

    • repo :

      • repo:status

      • public_repo

    • user :

      • read:user

      • user:email

    • project :

      • read:project

    • repo : プライベートリポジトリから課題をインポートするには、すべての repo スコープを有効にします。

    • user :

      • read:user

      • user:email

    • project :

      • read:project

  7. トークンの生成ボタンをクリックしてください。

    • 新しいパーソナルアクセストークンがリストに追加されます。

    The list of Personal access tokens.

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

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

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

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

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

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

    New import dialog

  3. GitHub を選択します。

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

    GitHub import settings

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

    設定

    説明

    GitHub リポジトリ URL

    ターゲットリポジトリの URL を入力します。クローン URL ではないため、.git サフィックスを含めないでください。

    トークン

    ターゲットの課題にアクセスするために使用するユーザーアカウント用に GitHub で生成した個人用アクセストークン。

    設定を開始する前にこのインポート用のトークンを生成しなかった場合は、トークンの生成リンクをクリックして GitHub にアクセスし、今すぐ作成してください。

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

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

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

    Confirm settings and start import.

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

    設定

    説明

    課題履歴

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

    課題リンク

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

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

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

    必要に応じて、継続的なインポートトグルを有効にします。有効にすると、YouTrack は定期的に GitHub リポジトリをポーリングし、最後の同期以降に作成された更新された新しい課題をインポートします。

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

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

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

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

Import configuration details

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

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

プロジェクトマッピング

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

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

Project Mapping

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

  1. ターゲット YouTrack プロジェクトを選択します。

    • YouTrack は、対応する名前を持つ既存の YouTrack プロジェクトをチェックします。GitHub リポジトリと同じ名前の YouTrack プロジェクトが見つかった場合、YouTrack はそれをターゲットプロジェクトとして提案します。

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

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

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

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

インポートオプション

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

Import Options

コントロール

説明

再開

前回のインポート後に接続された GitHub リポジトリで行われた変更をすぐにインポートします。

編集

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

削除

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

XLSX からインポート GitLab からインポート