GitLab CI/CD 統合

完了したジョブからデータを取得する

統合が GitLabCI/CD によって終了したすべてのジョブをリッスンするか、成功したジョブのみを考慮するかを決定します。

パイプライン ID をカスタムフィールドの値セットに追加する

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

GitLab CI/CD はビルドではなくパイプラインで動作するため、YouTrack はビルド番号ではなくパイプライン ID をカスタムフィールド値として保存します。

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

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

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

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

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

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

• コミットメッセージ、ブランチ名で参照されている課題を更新するか、次の検索条件に一致するコメントを作成します⏤コミットメッセージ、ブランチ名、ビルドコメントに参照が含まれる課題を統合がどのように処理するかを決定します。

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

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

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

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

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

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

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

選択した課題を更新

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

${build} 変数を使用して、GitLab CI/CD のパイプライン ID を参照します。例:

Subsystem Testing Test in build ${build}

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

編集

統合ジョブの名前を編集できるジョブ名の編集ダイアログを開きます。

除去

YouTrack から統合ジョブを削除します。統合によって行われたすべての変更はそのまま残ります。

${build.time}

YouTrack によって処理されるジョブの日時。

${prev.build.time}

YouTrack によって処理されるジョブより前のジョブの日時。

${build}

YouTrack によって処理されるジョブを含むパイプラインの ID。

GitLab に接続する Webhook が、関連するアクティビティをチェックするように構成されていないか、接続の確立に使用されるユーザーアカウントに十分な権限がありません。

リストから VCS 統合を選択し、無効にするボタンをクリックします。統合を無効にしたら、有効にするボタンをクリックします。

この操作には 2 つの結果があります。

• 既存の Webhook に課題があった場合は、自動的に再構成されます。

• GitLab での認証に使用されるパーソナルアクセストークンが検証されます。トークンに十分な権限がない場合は、必要な権限スコープが付与された別のトークンを生成します。

コミットメッセージでメンションされている課題が、統合設定のクエリと一致しません。

設定でクエリを調整するか、関連する課題を既存のクエリと一致させます。

GitLab の YAML 構成ファイル内のジョブの名前が、統合設定内のどのジョブとも一致しません。

統合設定のジョブ名を GitLab CI/CD のジョブ名と一致するように変更します。または、GitLab CI/CD ジョブと一致する名前を持つ新しい統合ジョブを追加します。