Gitea の統合
このページの指示に従って、自己ホスト型 Gitea サーバーでホストされている VCS リポジトリとプロジェクトを統合します。
Gitea の統合により、YouTrack で次の機能が有効になります。
コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。
各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。
プル(マージ)リクエストのステータスを、プルリクエストのタイトルまたは説明で参照されている課題のアクティビティストリームに直接表示します。詳細については、プルリクエストを参照してください。
コミットメッセージまたはブランチ名に YouTrack の課題へのリンクを追加します。詳細については、VCS コミットのリンクの課題を参照してください。
前提条件
YouTrack はインバウンド接続にアクセス可能です。具体的には、ネットワークが VCS サーバーと YouTrack の間の接続をブロックしていないことを確認する必要があります。
Gitea への接続に使用するアカウントは、この統合で使用する Gitea リポジトリにアクセスできます。これは、認証にプライベートトークンが使用されるユーザーアカウントです。プロジェクトで少なくともマスターまたは所有者のアクセスレベルを持つアカウント、または Gitea 管理者アカウントを使用できます。
Gitea インストールと統合し、サーバーとの安全な(HTTPS)接続を確立する場合は、Gitea サーバーの SSL 証明書を YouTrack にインポートする必要があります。
既知の認証局(CA)によって署名された有効な証明書が Gitea サーバーにある場合、JVM ベンダーはすでにルート(CA)証明書を証明書ストアに追加している場合があります。SSL 証明書をインポートせずにサーバーに接続できるはずです。
サーバーの証明書が自己署名されている場合は、証明書と公開鍵をインポートして安全な接続を確立する必要があります。セキュリティのため、このオプションは、YouTrack と Gitea サーバーの両方がプライベートコンピューターネットワークで実行されている場合にのみ使用してください。この操作は、低レベルの管理者読み取りおよび低レベルの管理者書き込み権限を持つユーザーのみが使用できます。詳細については、SSL 証明書を参照してください。
Gitea は、許可されたホストの事前定義されたリストにリクエストを送信する Webhook のみをサポートします。ローカルネットワークを介して YouTrack から Webhook を呼び出すには、Gitea 構成ファイルの ALLOWED_HOST_LIST
の値を更新して、YouTrack サービスを識別する IP アドレスを含める必要があります。
YouTrack クラウドインスタンスに使用されている IP アドレスを見つけるには、YouTrack クラウドインスタンスの IP 範囲を参照してください。
Gitea でアクセストークンを生成する
最初にすべきことは、Gitea でアクセストークンを生成することです。このトークンは、Gitea アカウントに付与されたアクセスに基づいて、リポジトリへの YouTrack アクセスを許可します。
Gitea でトークンを生成するには:
Gitea にログインし、アバターをクリックしてユーザーメニューを開き、設定を選択します。
設定メニューからアプリケーションを選択します。
アクセストークンの管理セクションで、トークンの名前を入力します。
リポジトリのトークン権限を読み書きに設定します。残りのトークン権限は読み取りとして設定できます。
トークンの権限が設定されたら、トークンの生成ボタンをクリックします。
新しいトークンが生成されたら、それをコピーします。YouTrack での統合を構成するために必要になります。
Gitea の app.ini (通常は
/etc/gitea/conf/app.ini
にあります) を開き、許可された Webhook リストに YouTrack 環境を追加します。[webhook] ALLOWED_HOST_LIST = youtrack.xxx
Gitea 統合を構成する
次に、Gitea リポジトリとの接続を確立する必要があります。単一のアクセストークンを使用して、複数の統合を設定できます。
Gitea リポジトリに接続するには:
YouTrack で
ページを開きます。
新しい VCS 統合ボタンをクリックしてください。
メイン YouTrack プロジェクトリストから、VCS リポジトリと統合するプライマリプロジェクトの名前を選択します。リポジトリへの接続を設定した後で、追加の YouTrack プロジェクトとの統合を追加できます。
サーバータイプの場合は、ギテアを選択します。
Gitea リポジトリを指す URL をリポジトリ URL 入力フィールドに貼り付けます。
生成したアクセストークンを個人アクセストークンフィールドに貼り付けます。
保存ボタンをクリックしてください。
YouTrack プロジェクトは、Gitea で選択したリポジトリと統合されます。
プロジェクト内の課題を参照する Gitea リポジトリからのコミットは、参照された課題のアクティビティストリームに表示されます。
サイドバーには、VCS 統合を設定するための追加設定が表示されます。
これらの設定の詳細については、統合設定を参照してください。
詳細サーバー設定
新しい VCS 統合ダイアログの基本設定を使用してリポジトリへの接続を確立できない場合は、高度なサーバー設定を表示リンクをクリックしてください。
![詳細サーバー設定 advanced server settings](https://resources.jetbrains.com/help/img/youtrack/2024.2/github-advanced-server-settings-project.png)
ターゲットサーバーとの新しい VCS 統合の場合、これらの設定に値を入力するだけで済みます。サーバー上の単一リポジトリとの統合がすでに機能している場合は、これらのパラメーターを再度設定せずに、他のリポジトリとの統合を追加できます。
以下のガイドラインを使用して、これらの設定値を設定してください。
設定 | 説明 |
---|---|
URL | この設定は、Gitea リポジトリへのパスを識別できます。Gitea サーバーのリポジトリが この課題を解決するには、Gitea サーバーのベース URL を入力します。例: |
SSL キー | サーバー環境がクライアント SSL 認証を要求するように設定されている場合は、YouTrack サーバーの秘密鍵を含むキーストアを選択します。このキーは、Gitea との接続を確立しようとするときに YouTrack サーバーを識別します。この設定は、内部ネットワークへの接続に必要な HTTPS 認証をサポートするためにのみ使用されます。 リストには、YouTrack にすでにインポートされている SSL キーのみが表示されます。キーストアファイルを生成して YouTrack にアップロードする方法については、SSL キーを参照してください。 |
統合設定
デフォルトでは、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 の変更も削除されます。 アクション自体を元に戻すことはできませんが、インポートアクションを使用して、誤って削除された VCS の変更を復元できます。 |
コミットのインポートとプルリクエストのオープン | リンクされたリポジトリのコミット履歴を確認し、コミットメッセージで参照されている課題に VCS の変更を追加します。このオプションは、現在有効になっている統合でのみ使用できます。 このアクションを使用して、統合が誤って削除されたときに削除された 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 コミットのリンクの課題
ソフトウェア開発チームは、課題に応じてアプリケーションコードに変更を適用することがよくあります。これらの更新は通常、バージョン管理システム(VCS)に適用されます。コードを VCS リポジトリにコミットする場合、変更内容とその理由を説明するコミットメッセージを書き込むオプションがあります。YouTrack サーバーが VCS リポジトリと統合されている場合は、コミットメッセージまたはブランチ名で課題を参照できます。これらの参照は、リポジトリ、ビルド、YouTrack の課題へのコミットを指すリン...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/trusted-ssl-certificates.png)
SSL 証明書
YouTrack を使用すると、外部サービスから信頼できる SSL 証明書をインポートできます。これらの証明書は外部サービスを信頼できる情報源として識別し、YouTrack とサードパーティサーバーの間に安全な接続を確立させます。キーストアを YouTrack にインポートすることもできます。キーストアは、YouTrack がサードパーティーに接続しようとしたときに YouTrack をクライアントとして識別します。キーストアは YouTrack の別のページで管理されています。詳しくは、SSL...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/ssl-keystore.png)
SSL キー
YouTrack では、SSL キーストアを YouTrack にインポートできます。キーストアは、公開鍵と秘密鍵のペア、それらが関連付けられている証明書のコンテナーです。キーストアは、サードパーティーへの接続を試行するときに、YouTrack をクライアントとして識別します。キーストアを使用して、サードパーティサービスの公開鍵を(証明書の形式で)キャッシュすることもできます。外部サービスのキーと証明書を含むキーストアがある場合は、このページでアップロードできます。それ以外の場合は、SSL 証明...
![](https://resources.jetbrains.com/help/img/youtrack/2024.2/bitbucket-server-new-vcs-integration.png)
Bitbucket サーバー統合
YouTrack のプロジェクトを、自己ホスト Bitbucket サーバー上の VCS リポジトリと統合できます。Bitbucket サーバーとの統合により、YouTrack で次の機能が有効になります。コミットメッセージの YouTrack 課題にコマンドを適用します。詳細については、VCS コミットでのコマンドの適用を参照してください。各課題について、アクティビティストリーム内の特定の課題に関連するコミットを追跡します。詳しくは、コミット数を参照してください。プル(マージ)リクエストのステ...