JetBrains Space 統合
このページの指示に従って、JetBrains Space でホストされている VCS リポジトリと統合します。
スペース統合により、YouTrack で次の機能が有効になります。
コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。
YouTrack で、課題のアクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。
コミットハッシュを課題の概要、説明、コメント、補足テキストフィールドに貼り付けて、Space リポジトリへのリンクを追加します。
前提条件
YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。
クラウド内の JetBrains によってホストされている Space 組織と連携しています。
Space で YouTrack 用のアプリケーションを構成する
YouTrack を Space に接続するには、Space にアプリケーションを登録して設定する必要があります。
YouTrack in Space のアプリケーションを登録して構成するには:
Space のメインナビゲーションメニューから、拡張セクションを開きます。
右上隅にある新しいアプリボタンをクリックします。
新しいアプリダイアログが開きます。
アプリケーションに一意の名前を付けて、作成ボタンをクリックします。
スペースに新しいアプリケーションが作成されます。
アプリケーションに移動ボタンをクリックして、アプリケーション設定を開きます。
許可タブを開きます。
ページのコンテキスト内認証セクションで、要件を構成するボタンをクリックします。
必須アクセス権ダイアログで、次の権限を有効にします。
プロジェクトカテゴリ: プロジェクトの詳細を表示。
Git リポジトリカテゴリ: Git リポジトリの読み込み、Git リポジトリの書き込み、Git リポジトリの管理。
「保存してリクエスト」ボタンをクリックしてダイアログを閉じます。
プロジェクトで承認ボタンをクリックしてください。
プロジェクトで承認ダイアログが開きます。
ドロップダウンリストから、YouTrack プロジェクトと統合するリポジトリを含むプロジェクトを選択します。
許可ボタンをクリックしてください。
選択したプロジェクトでのアプリケーションの権限を一覧表示するページに移動します。
アプリケーションには、選択したプロジェクトでこの統合に必要なアクションを実行する権限が与えられます。
アプリケーション設定の認証タブに移動し、クライアント ID とシークレットを YouTrack にコピーする準備をします。
Space に YouTrack のアプリケーションがすでにある場合は、ここに記載されている手順に従って構成されていることを確認し、クライアント ID とシークレットを YouTrack にコピーする準備をしてください。
リポジトリに接続する
最初のステップは、YouTrack のプロジェクトと Space のリポジトリ間の接続を確立することです。Space と接続するには、Space のアプリケーション設定からクライアント ID とシークレットが必要です。これらの資格情報により、YouTrack は、スペースでアプリケーションに付与された権限に従ってリポジトリにアクセスできます。
Space リポジトリに接続するには:
YouTrack で
ページを開きます。
新しい VCS 統合ボタンをクリックしてください。
メイン YouTrack プロジェクトリストから、VCS リポジトリと統合するプライマリプロジェクトの名前を選択します。リポジトリへの接続を設定した後で、追加の YouTrack プロジェクトとの統合を追加できます。
サーバータイプの場合は、Space を選択します。
Space リポジトリを指す URL をリポジトリ URL 入力フィールドに貼り付けます。
Space のクライアント ID をアプリケーションクライアント ID 入力フィールドに貼り付けます。
Space のクライアントシークレットをアプリケーションクライアントシークレット入力フィールドに貼り付けます。
保存ボタンをクリックしてください。
統合設定
デフォルトでは、VCS 統合は、任意のブランチの任意のユーザーによってリポジトリにコミットされた変更を処理します。YouTrack で課題にアクセスできるユーザーは、課題アクティビティストリームでこれらの変更を確認できます。
指定されたブランチで特定のユーザーによる変更のみを処理する場合、または YouTrack での VCS 変更の表示を制限する場合は、統合設定をカスタマイズできます。統合をカスタマイズするには、次の設定を使用します。
設定 | 説明 |
---|---|
リポジトリ | 統合バージョン管理システムのリポジトリへのパスを表示します。 必要に応じて、統合を設定した後にリポジトリの場所を編集できます。手順については、リポジトリ設定の編集を参照してください。 |
メイン YouTrack プロジェクト | VCS 統合がアクティブなプライマリプロジェクトを設定します。 |
追加プロジェクト | リンクされたリポジトリを 1 つ以上の追加プロジェクトと統合します。 |
コミット者 | コミットメッセージ内のコマンドに関する課題を、指定されたグループのメンバーに更新する機能を制限します。選択したグループのメンバーではないユーザーからの VCS の変更は、関連する課題にまだ関連付けられていますが、コミットで指定されているコマンドはすべて無視されます。 |
VCS 変更の処理スキーム | コミットメッセージが課題 ID を参照する場合に、VCS の変更を処理する方法を選択します。次のオプションがサポートされています。
|
監視対象のブランチ | 変更をモニターしたいブランチの名前を保管します。
リポジトリに接続したときにリポジトリ URL として入力したアドレスが特定のブランチを指している場合、このブランチは、接続のセットアップ時に監視対象のブランチのリストに自動的に追加されます。 |
課題コメントに対するコミットを解析します | 有効にすると、コミットメッセージ内の特定のテキスト行がコメントとして課題にコピーされます。コミットメッセージの一部をコメントとして課題にコピーすると、@mention 通知をトリガーし、VCS の変更にアクセスできないユーザーに情報を公開できます。 この設定は、コミットメッセージが VCS の変更にどのように表示されるかには影響しません。コマンドや課題のコメントを含むコミットメッセージ全体は、アクティビティストリームの VCS 変更レコードの一部として常に表示されます。 次の場合にのみこのオプションを有効にしてください。
YouTrack がメッセージをコミットする方法の詳細については、VCS コミットでのコマンドの適用を参照してください。 |
課題の参照については、ブランチ名を確認してください | 有効にすると、統合は、コミットおよびプルリクエストのブランチ名で課題への参照をチェックします。このオプションは、チケットごとのブランチプロセスを使用するチーム向けに追加されたため、開発者はコミットメッセージで課題 ID を明示的にメンションする必要がありません。 |
VCS 変更の表示対象 | VCS 変更の可視性を YouTrack 内の 1 つ以上のユーザーグループに制限します。制限されていない場合、VCS の変更点のリストは、課題を読む権限を持つすべてのユーザーに表示されます。 |
使用可能なアクション
リストで統合バージョン管理システムを選択すると、ツールバーで次のアクションを使用できます。
アクション | 説明 |
---|---|
使用不可 | 統合プロジェクトと VCS リポジトリ間の接続を遮断します。設定は変更されず、いつでも有効にできます。 |
編集 | 選択したプロジェクトとリポジトリのサイドバーにある統合設定ダイアログを開きます。 |
削除 | YouTrack から統合プロジェクトの設定を削除します。 このアクションにより、リンクされたリポジトリのコミットの課題に追加されたすべての VCS の変更も削除されます。 |
関連ページ:
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/command-related-notifications.png)
VCS コミットでのコマンドの適用
バージョン管理システムのコードリポジトリへの変更をコミットするときに、コマンドを課題に適用できます。YouTrack を開く必要すらありません。これらの変更を適用するには、特別な形式を使用して、コミットメッセージでコマンドを指定します。YouTrack でサポートされているコマンドの完全なリストについては、コマンドリファレンスを参照してください。コミットメッセージに課題へのリンクを追加する方法をすでに見たかもしれません。これはさらに一歩進んだものです。課題とバージョン管理システム間を移動するのに...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/vcs-changes-activity-stream.png)
VCS の変更の表示と編集
アクティビティストリームには、現在の課題に関連付けられている VCS 変更のリストが表示されます。これらのイベントは、VCS の変更フィルターが有効になっている場合に表示されます。YouTrack は、バージョン管理システムに直接統合することも、バージョン管理に接続されたビルドサーバーを介して統合することもできます。統合の表示設定が 1 つ以上のグループに制限されている場合、指定したグループのいずれかのメンバーである場合にのみ、VCS の変更が表示されます。課題がメンションされたとき、名前に課題...
![](https://pleiades.io/icons/youtrack.png)
リポジトリ設定の編集
必要に応じて、VCS 統合のセットアップ後にリポジトリの URL を編集できます。ただし、この操作は予期しない結果になる可能性があります。リポジトリ URL を更新すると、YouTrack の課題と VCS コミット間のリンクが更新され、新しいリポジトリ URL が使用されます。リポジトリを新しい URL で参照されている場所に移動していない場合、コミットへの既存のリンクは壊れています。リポジトリを実際に別のサーバーまたは VCS プロバイダーに移行した場合にのみ、この設定を更新することを強くお...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/gogs-token-user-menu.png)
ゴグインテグレーション
このページの手順に従って、自己ホスト型 Gogs サーバーでホストされている VCS リポジトリとプロジェクトを統合します。Gogs 統合により、YouTrack で次の機能が有効になります。コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。プル(マージ)リクエストのステータスを、プル...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/generic-integration-type.png)
汎用 VCS 統合
このページの指示に従って、バージョン管理ホストシステム上の VCS リポジトリと統合します。汎用 VCS 統合により、YouTrack の課題にコミットを手動で添付したり、Webhook を使用してプログラムでリンクを追加したりできます。前提条件:YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。VCS 統合を構成する:次に、YouTrack のプロジェクトと...