Jenkins 統合

メイン YouTrack プロジェクト

Jenkins のプロジェクトにマップする YouTrack プライマリプロジェクトを選択します。

追加プロジェクト

リンクされたビルドサーバーを 1 つまたは複数の追加プロジェクトと統合します。

Jenkins サーバー

マッピング先のプロジェクトが含まれている Jenkins サーバーを選択します。1 台の Jenkins サーバーにしか接続していない場合は、デフォルトで設定されています。

Jenkins の表示

Jenkins プロジェクトを含むビューの名前を選択します。

Jenkins プロジェクト

Jenkins プロジェクトを選択します。

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

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

VCS 統合

統合が VCS 変更レコードを追加し、コミットメッセージで参照される課題のコマンドを処理するかどうかを決定します。

• 有効にすると、YouTrack 課題 ID への参照を含む VCS の変更が、参照された課題のアクティビティストリームに追加されます。アクティビティストリームのエントリには、変更を含むビルドへのリンクが含まれています。

• Disabled の場合、統合は、ビルドサーバーに接続されているリポジトリへのすべてのコミットを無視します。

  統合でカスタムフィールドにビルド番号を追加するだけの場合、またはすでに VCS との統合を直接構成している場合は、このオプションを無効にします。

課題にコマンドを適用する

YouTrack コマンドのコミットメッセージも解析するかどうかを決定します。YouTrack を有効にすると、アセンブルされたビルドに含まれているコミットメッセージで指定されているすべてのコマンドが、対応する課題に適用されます。

このオプションは、VCS 統合設定が有効になっている場合にのみ使用できます。有効にすると、コマンドをすべての統合プロジェクトの課題に適用するか、メインプロジェクトの課題にのみ適用するかを選択できます。

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

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

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

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

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

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

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

VCS 変更の表示対象

アクティビティストリームで VCS の変更として表示されるコメントと更新の表示を制限するには、リストから 1 つ以上のグループまたはチームを選択します。それ以外の場合、このアクティビティタイプは、課題を読み取るための十分なアクセス権を持つすべてのユーザーに表示されます。

アセンブルされたビルドからデータをプルする

統合がビルドサーバーによってアセンブルされたすべてのビルドをリッスンするか、キャンセルされたビルドを除外するか、成功したビルドのみを考慮するかを決定します。

カスタムフィールドの値のセットにビルド番号を追加する

統合された YouTrack プロジェクトでビルド番号が入力されるカスタムフィールドを決定します。選択は、build タイプを格納するカスタムフィールドに制限されています。

選択したフィールドの値は、統合によって更新されるすべての課題で自動的に設定されます。統合の更新する課題を選択してくださいセクションの設定により、ビルド番号が割り当てられる課題が決まります。

次のオプションを使用できます。

• 課題を参照しないビルドを含める⏤統合によって処理されるすべてのビルドか、YouTrack 課題への参照を含むビルドのみかを決定します。このオプションで考慮されるビルドは、組み立てられたビルドからデータをプルする設定の影響を受けます。

  このオプションを有効にすると、ユーザーは最初に手動でビルド番号を追加しなくても、課題のビルド番号を手動で調整できます。

更新する課題を選択してください

このセクションのオプションにより、統合によってビルド番号が割り当てられる課題が決まります。次のオプションを使用できます。

• 次の検索条件に一致するコミットメッセージまたはブランチ名で参照されている課題を更新します⏤統合がコミットメッセージまたはブランチ名に参照を含む課題を処理する方法を決定します。

  クエリ入力フィールドを使用して、自動ビルド番号割り当てから除外したいメンションのある課題を除外します。コミットメッセージで参照されている課題を更新するオプションが選択解除されている場合、フィルターも同様に無視されます。

• 次の検索条件に一致する課題を更新します issue 課題の参照が含まれているかどうかにかかわらず、どの課題にビルド番号を割り当てるかを決定します。

  標準の検索基準は次のとおりです。

  State: Fixed State: Verified resolved date: ${prev.build.time} .. ${build.time}

  このクエリは、最後に成功したビルドと現在のビルド以降に解決された課題のみが考慮されることを保証します。

  検索条件に一致する課題を更新するオプションが選択解除されている場合、クエリも無視されます。

両方のオプションが有効になっている場合、ビルド番号はこれら 2 つの条件のいずれかを満たす課題に自動的に割り当てられます。

選択した課題を更新

自動ビルド番号の割り当てに加えて、統合が選択した課題に変更を適用するかどうかを決定します。コマンドを適用するオプションを有効にすると、ビルド番号が割り当てられているすべての課題に適用される定義済みのコマンドを入力できます。

${build} 変数を使用して、Jenkins のビルド番号を参照します。例:

Subsystem Testing Test in build ${build}

このコマンドを使用すると、YouTrack によって処理されるすべての課題がテストサブシステムに割り当てられ、ビルドテストフィールドがビルド番号に設定されます。

${build.time}

YouTrack によって処理されるビルドの日時。

${prev.build.time}

YouTrack によって処理されるビルドより前のビルドの日時。

${build}

YouTrack によって処理されたビルドの番号。