YouTrack クラウド 2024.3 ヘルプ

JetBrains Space 統合

このページの指示に従って、JetBrains Space でホストされている VCS リポジトリと統合します。

スペース統合により、YouTrack で次の機能が有効になります。

  • コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。

  • YouTrack で、課題のアクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。

  • コミットハッシュを課題の概要、説明、コメント、補足テキストフィールドに貼り付けて、Space リポジトリへのリンクを追加します。

前提条件

  • YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。

Space で YouTrack 用のアプリケーションを構成する

YouTrack を Space に接続するには、Space にアプリケーションを登録して設定する必要があります。

YouTrack in Space のアプリケーションを登録して構成するには:

  1. Space のメインナビゲーションメニューから、拡張セクションを開きます。

    Space applications
  2. 右上隅にある新しいアプリボタンをクリックします。

    • 新しいアプリダイアログが開きます。

    New Space application
  3. アプリケーションに一意の名前を付けて、作成ボタンをクリックします。

    • スペースに新しいアプリケーションが作成されます。

  4. アプリケーションに移動ボタンをクリックして、アプリケーション設定を開きます。

  5. 許可タブを開きます。

  6. ページのコンテキスト内認証セクションで、要件を構成するボタンをクリックします。

  7. 必須アクセス権ダイアログで、次の権限を有効にします。

    • プロジェクトカテゴリ: プロジェクトの詳細を表示

    • Git リポジトリカテゴリ: Git リポジトリの読み込みGit リポジトリの書き込みGit リポジトリの管理

  8. 「保存してリクエスト」ボタンをクリックしてダイアログを閉じます。

  9. プロジェクトで承認ボタンをクリックしてください。

    • プロジェクトで承認ダイアログが開きます。

  10. ドロップダウンリストから、YouTrack プロジェクトと統合するリポジトリを含むプロジェクトを選択します。

    Authorize application in a Space project
  11. 許可ボタンをクリックしてください。

    • 選択したプロジェクトでのアプリケーションの権限を一覧表示するページに移動します。

    • アプリケーションには、選択したプロジェクトでこの統合に必要なアクションを実行する権限が与えられます。

  12. アプリケーション設定の認証タブに移動し、クライアント ID とシークレットを YouTrack にコピーする準備をします。

    Space application authentication settings

Space に YouTrack のアプリケーションがすでにある場合は、ここに記載されている手順に従って構成されていることを確認し、クライアント ID とシークレットを YouTrack にコピーする準備をしてください。

リポジトリに接続する

最初のステップは、YouTrack のプロジェクトと Space のリポジトリ間の接続を確立することです。Space と接続するには、Space のアプリケーション設定からクライアント ID とシークレットが必要です。これらの資格情報により、YouTrack は、スペースでアプリケーションに付与された権限に従ってリポジトリにアクセスできます。

Space リポジトリに接続するには:

  1. YouTrack で 管理> 統合> VCS 統合ページを開きます。

  2. 新しい VCS 統合ボタンをクリックしてください。

    • 新しい VCS 統合ダイアログが開きます。

      new Space VCS integration
  3. メイン YouTrack プロジェクトリストから、VCS リポジトリと統合するプライマリプロジェクトの名前を選択します。リポジトリへの接続を設定した後で、追加の YouTrack プロジェクトとの統合を追加できます。

  4. サーバータイプの場合は、Space を選択します。

  5. Space リポジトリを指す URL をリポジトリ URL 入力フィールドに貼り付けます。

    オンプレミスのスペースインストールでは、ブラウザーに表示される URL が必要です。このフィールドでは、Git クローン URL はサポートされていません。

  6. Space のクライアント ID をアプリケーションクライアント ID 入力フィールドに貼り付けます。

  7. Space のクライアントシークレットをアプリケーションクライアントシークレット入力フィールドに貼り付けます。

  8. 保存ボタンをクリックしてください。

    • YouTrack プロジェクトは、Space で選択したリポジトリと統合されています。

    • プロジェクト内の課題を参照する Space リポジトリからのコミットは、参照された課題のアクティビティストリームに表示されます。

    • サイドバーには、VCS 統合を設定するための追加設定が表示されます。

      Space integration settings

統合設定

デフォルトでは、VCS 統合は、任意のブランチの任意のユーザーによってリポジトリにコミットされた変更を処理します。YouTrack で課題にアクセスできるユーザーは、課題アクティビティストリームでこれらの変更を確認できます。

指定されたブランチで特定のユーザーによる変更のみを処理する場合、または YouTrack での VCS 変更の表示を制限する場合は、統合設定をカスタマイズできます。統合をカスタマイズするには、次の設定を使用します。

設定

説明

リポジトリ

統合バージョン管理システムのリポジトリへのパスを表示します。

必要に応じて、統合を設定した後にリポジトリの場所を編集できます。手順については、リポジトリ設定の編集を参照してください。

メイン YouTrack プロジェクト

VCS 統合がアクティブなプライマリプロジェクトを設定します。

追加プロジェクト

リンクされたリポジトリを 1 つ以上の追加プロジェクトと統合します。

コミット者

コミットメッセージ内のコマンドに関する課題を、指定されたグループのメンバーに更新する機能を制限します。選択したグループのメンバーではないユーザーからの VCS の変更は、関連する課題にまだ関連付けられていますが、コミットで指定されているコマンドはすべて無視されます。

VCS 変更の処理スキーム

コミットメッセージが課題 ID を参照する場合に、VCS の変更を処理する方法を選択します。次のオプションがサポートされています。

  • コミットを追加し、コマンドを無視する : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージ内のコマンドはすべて無視されます。

  • すべてのプロジェクトにコミットを追加し、メインにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。現在選択されているメインプロジェクトに属する課題にのみコマンドを適用します。

  • コミットを追加し、すべてのプロジェクトにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージにコマンドが含まれている場合、統合プロジェクトの課題を更新します。

監視対象のブランチ

変更をモニターしたいブランチの名前を保管します。

  • + を使用してブランチを含めます。

  • ブランチを除外するには、- を使用します。

  • branch name の場合は、ブランチの完全修飾名を使用してください。例: refs/heads/<branch name>

  • ワイルドカードとして * を使用してください。このプレースホルダは、文字列内の 1 つ以上の文字と一致します。例: すべての機能ブランチを含めるには、次のように使用します。

    +:refs/heads/feature/*

    ブランチパターンごとにワイルドカード文字を 1 つだけ使用できます。複数のアスタリスク文字を含むパターンを指定した場合、最初のアスタリスク文字のみがワイルドカードとして評価されます。

  • すべてのブランチを監視するには、入力フィールドを空のままにします。

リポジトリに接続したときにリポジトリ URL として入力したアドレスが特定のブランチを指している場合、このブランチは、接続のセットアップ時に監視対象のブランチのリストに自動的に追加されます。

課題コメントに対するコミットを解析します

有効にすると、コミットメッセージ内の特定のテキスト行がコメントとして課題にコピーされます。コミットメッセージの一部をコメントとして課題にコピーすると、@mention 通知をトリガーし、VCS の変更にアクセスできないユーザーに情報を公開できます。

この設定は、コミットメッセージが VCS の変更にどのように表示されるかには影響しません。コマンドや課題のコメントを含むコミットメッセージ全体は、アクティビティストリームの VCS 変更レコードの一部として常に表示されます。

次の場合にのみこのオプションを有効にしてください。

  • コミットメッセージで他のユーザーにメンションし、テキストが issue のコメントにコピーされたときに通知を生成します。

  • VCS の変更の可視性を制限し、コミット関連の情報をコメントとして外部ユーザーに見えるようにします。

YouTrack がメッセージをコミットする方法の詳細については、VCS コミットでのコマンドの適用を参照してください。

課題の参照については、ブランチ名を確認してください

有効にすると、統合は、コミットおよびプルリクエストのブランチ名で課題への参照をチェックします。このオプションは、チケットごとのブランチプロセスを使用するチーム向けに追加されたため、開発者はコミットメッセージで課題 ID を明示的にメンションする必要がありません。

VCS 変更の表示対象

VCS 変更の可視性を YouTrack 内の 1 つ以上のユーザーグループに制限します。制限されていない場合、VCS の変更点のリストは、課題を読む権限を持つすべてのユーザーに表示されます。

使用可能なアクション

リストで統合バージョン管理システムを選択すると、ツールバーで次のアクションを使用できます。

アクション

説明

使用不可

統合プロジェクトと VCS リポジトリ間の接続を遮断します。設定は変更されず、いつでも有効にできます。

編集

選択したプロジェクトとリポジトリのサイドバーにある統合設定ダイアログを開きます。

削除

YouTrack から統合プロジェクトの設定を削除します。

このアクションにより、リンクされたリポジトリのコミットの課題に追加されたすべての VCS の変更も削除されます。

関連ページ:

VCS コミットでのコマンドの適用

バージョン管理システムのコードリポジトリへの変更をコミットするときに、コマンドを課題に適用できます。YouTrack を開く必要すらありません。これらの変更を適用するには、特別な形式を使用して、コミットメッセージでコマンドを指定します。YouTrack でサポートされているコマンドの完全なリストについては、コマンドリファレンスを参照してください。コミットメッセージに課題へのリンクを追加する方法をすでに見たかもしれません。これはさらに一歩進んだものです。課題とバージョン管理システム間を移動するのに...

VCS の変更の表示と編集

アクティビティストリームには、現在の課題に関連付けられている VCS 変更のリストが表示されます。これらのイベントは、VCS の変更フィルターが有効になっている場合に表示されます。YouTrack は、バージョン管理システムに直接統合することも、バージョン管理に接続されたビルドサーバーを介して統合することもできます。統合の表示設定が 1 つ以上のグループに制限されている場合、指定したグループのいずれかのメンバーである場合にのみ、VCS の変更が表示されます。課題がメンションされたとき、名前に課題...

リポジトリ設定の編集

必要に応じて、VCS 統合のセットアップ後にリポジトリの URL を編集できます。ただし、この操作は予期しない結果になる可能性があります。リポジトリ URL を更新すると、YouTrack の課題と VCS コミット間のリンクが更新され、新しいリポジトリ URL が使用されます。リポジトリを新しい URL で参照されている場所に移動していない場合、コミットへの既存のリンクは壊れています。リポジトリを実際に別のサーバーまたは VCS プロバイダーに移行した場合にのみ、この設定を更新することを強くお...

ゴグインテグレーション

このページの手順に従って、自己ホスト型 Gogs サーバーでホストされている VCS リポジトリとプロジェクトを統合します。Gogs 統合により、YouTrack で次の機能が有効になります。コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。プル(マージ)リクエストのステータスを、プル...

汎用 VCS 統合

このページの指示に従って、バージョン管理ホストシステム上の VCS リポジトリと統合します。汎用 VCS 統合により、YouTrack の課題にコミットを手動で添付したり、API を使用してプログラムでリンクを追加したりできます。前提条件:YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。VCS 統合を構成する:次に、YouTrack のプロジェクトと VCS...