ツイートシェアはてブ LINE Pocket

ゴグインテグレーション

このページの手順に従って、自己ホスト型 Gogs サーバーでホストされている VCS リポジトリとプロジェクトを統合します。

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

コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。
各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。
プル（マージ）リクエストのステータスを、プルリクエストのタイトルまたは説明で参照されている課題のアクティビティストリームに直接表示します。詳細については、プルリクエストを参照してください。
コミットメッセージまたはブランチ名に YouTrack の課題へのリンクを追加します。詳細については、VCS コミットのリンクの課題を参照してください。

前提条件

YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。
Gogs への接続に使用するアカウントには、この統合で使用する Gogs リポジトリへのアクセス権があります。これは、認証にプライベートトークンが使用されるユーザーアカウントです。プロジェクトで少なくともマスターまたは所有者のアクセスレベルを持つアカウント、または Gogs 管理者アカウントを使用できます。

Gogs インストールと統合し、サーバーとの安全な（HTTPS）接続を確立する場合は、Gogs サーバーの SSL 証明書を YouTrack にインポートする必要があります。

Gogs サーバーに既知の認証局（CA）によって署名された有効な証明書がある場合、JVM ベンダーはすでにルート（CA）証明書を証明書ストアに追加している可能性があります。SSL 証明書をインポートせずにサーバーに接続できるはずです。
サーバーの証明書が自己署名されている場合は、証明書と公開キーをインポートして安全な接続を確立する必要があります。セキュリティのために、このオプションは、YouTrack と Gogs サーバーの両方がプライベートコンピューターネットワークで実行されている場合にのみ使用してください。この操作は、低レベルの管理者読み取りおよび低レベルの管理者書き込み権限を持つユーザーのみが使用できます。詳細については、SSL 証明書を参照してください。

Gogs でアクセストークンを生成する

最初にすべきことは、Gogs でアクセストークンを生成することです。このトークンは、Gogs アカウントに付与されたアクセスに基づいて、リポジトリへの YouTrack アクセスを許可します。単一のアクセストークンを使用して、複数の統合を設定できます。

Gogs でトークンを生成するには:

Gogs にログインし、アバターをクリックしてユーザーメニューを開き、設定アイテムを選択します。Gogs ユーザーアカウントに、YouTrack プロジェクトと統合する予定のリポジトリへの管理アクセス権があることを確認してください。
設定ページが開いたら、サイドバーでアプリケーションを選択します。
個人用アクセストークンを管理するセクションで、新しいトークンを生成をクリックします。
新しいパーソナルアクセストークンダイアログで、トークンの名前を入力し、トークンの生成ボタンをクリックします。
新しいトークンが生成されたら、それをコピーします。YouTrack で統合を構成するために必要になります。

Gogs 統合を構成する

個人用アクセストークンを取得したため、YouTrack に切り替えて Gogs リポジトリとの接続を確立します。システム管理者権限が付与されたアカウントで YouTrack にログインしていることを確認してください。

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

YouTrack で管理> 統合> VCS 統合ページを開きます。
新しい VCS 統合ボタンをクリックしてください。
- 新しい VCS 統合ダイアログが開きます。
メイン YouTrack プロジェクトリストから、VCS リポジトリと統合するプライマリプロジェクトの名前を選択します。リポジトリへの接続を設定した後で、追加の YouTrack プロジェクトとの統合を追加できます。
サーバータイプの場合は、ゴグを選択します。
Gogs リポジトリを指す URL をリポジトリ URL 入力フィールドに貼り付けます。
生成したアクセストークンを個人アクセストークンフィールドに貼り付けます。
保存ボタンをクリックしてください。
- YouTrack プロジェクトは、Gogs で選択したリポジトリと統合されます。
- プロジェクト内の課題を参照する Gogs リポジトリからのコミットは、参照された課題のアクティビティストリームに表示されます。
- サイドバーには、VCS 統合を設定するための追加設定が表示されます。
これらの設定の詳細については、統合設定を参照してください。

詳細サーバー設定

新しい VCS 統合ダイアログの基本設定を使用してリポジトリへの接続を確立できない場合は、高度なサーバー設定を表示リンクをクリックしてください。

ターゲットサーバーとの新しい VCS 統合の場合、これらの設定に値を入力するだけで済みます。サーバー上の単一リポジトリとの統合がすでに機能している場合は、これらのパラメーターを再度設定せずに、他のリポジトリとの統合を追加できます。

以下のガイドラインを使用して、これらの設定値を設定してください。

設定	説明
URL	この設定は、Gogs リポジトリへのパスを識別できます。Gogs サーバーのリポジトリが `https://host[:port]/SOME_CONTEXT_PATH` で使用可能な場合、YouTrack はこのコンテキストパスがどこで終了し、リポジトリへの実際のパスが始まるかを判別できません。この課題を解決するには、Gogs サーバーのベース URL を入力します。例: `https://host:port/context_path`
SSL キー	サーバー環境がクライアント SSL 認証を要求するように設定されている場合は、YouTrack サーバーの秘密鍵を含むキーストアを選択します。このキーは、Gogs との接続を確立しようとするときに YouTrack サーバーを識別します。この設定は、内部ネットワークへの接続に必要な HTTPS 認証をサポートするためにのみ使用されます。リストには、YouTrack にすでにインポートされている SSL キーのみが表示されます。キーストアファイルを生成して YouTrack にアップロードする方法については、SSL キーを参照してください。

設定

説明

URL

この設定は、Gogs リポジトリへのパスを識別できます。Gogs サーバーのリポジトリが https://host[:port]/SOME_CONTEXT_PATH で使用可能な場合、YouTrack はこのコンテキストパスがどこで終了し、リポジトリへの実際のパスが始まるかを判別できません。

この課題を解決するには、Gogs サーバーのベース URL を入力します。例: https://host:port/context_path

SSL キー

サーバー環境がクライアント SSL 認証を要求するように設定されている場合は、YouTrack サーバーの秘密鍵を含むキーストアを選択します。このキーは、Gogs との接続を確立しようとするときに YouTrack サーバーを識別します。この設定は、内部ネットワークへの接続に必要な HTTPS 認証をサポートするためにのみ使用されます。

リストには、YouTrack にすでにインポートされている SSL キーのみが表示されます。キーストアファイルを生成して YouTrack にアップロードする方法については、SSL キーを参照してください。

統合設定

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

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

設定	説明
リポジトリ	統合バージョン管理システムのリポジトリへのパスを表示します。必要に応じて、統合を設定した後にリポジトリの場所を編集できます。手順については、リポジトリ設定の編集を参照してください。
メイン YouTrack プロジェクト	VCS 統合がアクティブなプライマリプロジェクトを設定します。
追加プロジェクト	リンクされたリポジトリを 1 つ以上の追加プロジェクトと統合します。
コミット者	コミットメッセージ内のコマンドに関する課題を、指定されたグループのメンバーに更新する機能を制限します。選択したグループのメンバーではないユーザーからの VCS の変更は、関連する課題にまだ関連付けられていますが、コミットで指定されているコマンドはすべて無視されます。
VCS 変更の処理スキーム	コミットメッセージが課題 ID を参照する場合に、VCS の変更を処理する方法を選択します。次のオプションがサポートされています。コミットを追加し、コマンドを無視する : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージ内のコマンドはすべて無視されます。すべてのプロジェクトにコミットを追加し、メインにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。現在選択されているメインプロジェクトに属する課題にのみコマンドを適用します。このオプションを選択すると、課題コメントに対するコミットを解析しますオプションが使用可能になります。コミットを追加し、すべてのプロジェクトにコマンドを適用します : コミットメッセージが統合プロジェクトの課題に属する ID を参照している場合、VCS の変更を課題に追加します。コミットメッセージにコマンドが含まれている場合、統合プロジェクトの課題を更新します。スキームは、統合設定で少なくとも 1 つの追加プロジェクトが指定されている場合にのみ使用できます。このオプションを選択すると、課題コメントに対するコミットを解析しますオプションが使用可能になります。
監視対象のブランチ	変更をモニターしたいブランチの名前を保管します。 `+` を使用してブランチを含めます。ブランチを除外するには、`-` を使用します。 `branch name` の場合は、ブランチの完全修飾名を使用してください。例: `refs/heads/<branch name>` ワイルドカードとして `` を使用してください。このプレースホルダは、文字列内の 1 つ以上の文字と一致します。例: すべての機能ブランチを含めるには、次のように使用します。 +:refs/heads/feature/ ブランチパターンごとにワイルドカード文字を 1 つだけ使用できます。複数のアスタリスク文字を含むパターンを指定した場合、最初のアスタリスク文字のみがワイルドカードとして評価されます。すべてのブランチを監視するには、入力フィールドを空のままにします。リポジトリに接続したときにリポジトリ URL として入力したアドレスが特定のブランチを指している場合、このブランチは、接続のセットアップ時に監視対象のブランチのリストに自動的に追加されます。
課題コメントに対するコミットを解析します	このオプションは、次の処理スキームのいずれかが選択されている場合にのみ UI に表示されます。すべてのプロジェクトにコミットを追加し、メインにコマンドを適用しますコミットを追加し、すべてのプロジェクトにコマンドを適用します有効にすると、コミットメッセージ内の特定のテキスト行がコメントとして課題にコピーされます。コミットメッセージの一部をコメントとして課題にコピーすると、@mention 通知をトリガーし、VCS の変更にアクセスできないユーザーに情報を公開できます。この設定は、コミットメッセージが VCS の変更にどのように表示されるかには影響しません。コマンドや課題のコメントを含むコミットメッセージ全体は、アクティビティストリームの VCS 変更レコードの一部として常に表示されます。次の場合にのみこのオプションを有効にしてください。コミットメッセージで他のユーザーにメンションし、テキストが issue のコメントにコピーされたときに通知を生成します。 VCS の変更の可視性を制限し、コミット関連の情報をコメントとして外部ユーザーに見えるようにします。 YouTrack がメッセージをコミットする方法の詳細については、VCS コミットでのコマンドの適用を参照してください。
課題の参照については、ブランチ名を確認してください	有効にすると、統合は、コミットおよびプルリクエストのブランチ名で課題への参照をチェックします。このオプションは、チケットごとのブランチプロセスを使用するチーム向けに追加されたため、開発者はコミットメッセージで課題 ID を明示的にメンションする必要がありません。
VCS 変更の表示対象	VCS 変更の可視性を YouTrack 内の 1 つ以上のユーザーグループに制限します。制限されていない場合、VCS の変更点のリストは、課題を読む権限を持つすべてのユーザーに表示されます。

使用可能なアクション

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

アクション	説明
使用不可	統合プロジェクトと VCS リポジトリ間の接続を遮断します。設定は変更されず、いつでも有効にできます。
編集	選択したプロジェクトとリポジトリのサイドバーにある統合設定ダイアログを開きます。
削除	YouTrack から統合プロジェクトの設定を削除します。このアクションにより、リンクされたリポジトリのコミットの課題に追加されたすべての VCS の変更も削除されます。

アクション

説明

使用不可

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

編集

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

削除

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

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

最終更新日: 2024 年 7 月 02 日

関連ページ：

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

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

VCS の変更の表示と編集

アクティビティストリームには、現在の課題に関連する VCS 変更のリストが表示されます。これらのイベントは、VCS の変更フィルターが有効な場合に表示されます。この情報は、プロジェクトがバージョン管理システムと統合されている場合にのみ利用できます。YouTrack は、バージョン管理システムと直接統合することも、TeamCity や Jenkins などのバージョン管理に接続されている別のアプリケーションを通じて統合することもできます。統合の表示設定が 1 つ以上のグループに制限されている場合、...

VCS コミットのリンクの課題

ソフトウェア開発チームは、課題に応じてアプリケーションコードに変更を適用することがよくあります。これらの更新は通常、バージョン管理システム（VCS）に適用されます。コードを VCS リポジトリにコミットする場合、変更内容とその理由を説明するコミットメッセージを書き込むオプションがあります。YouTrack サーバーが VCS リポジトリと統合されている場合は、コミットメッセージまたはブランチ名で課題を参照できます。これらの参照は、リポジトリ、ビルド、YouTrack の課題へのコミットを指すリン...

SSL 証明書

YouTrack を使用すると、外部サービスから信頼できる SSL 証明書をインポートできます。これらの証明書は外部サービスを信頼できる情報源として識別し、YouTrack とサードパーティサーバーの間に安全な接続を確立させます。キーストアを YouTrack にインポートすることもできます。キーストアは、YouTrack がサードパーティーに接続しようとしたときに YouTrack をクライアントとして識別します。キーストアは YouTrack の別のページで管理されています。詳しくは、SSL...

SSL キー

YouTrack では、SSL キーストアを YouTrack にインポートできます。キーストアは、公開鍵と秘密鍵のペア、それらが関連付けられている証明書のコンテナーです。キーストアは、サードパーティーへの接続を試行するときに、YouTrack をクライアントとして識別します。キーストアを使用して、サードパーティサービスの公開キーを（証明書の形式で）キャッシュすることもできます。外部サービスのキーと証明書を含むキーストアがある場合は、このページでアップロードできます。それ以外の場合は、SSL 証...

Gitea の統合

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