パイプラインのフィードバック統合

Releases APIは、リリースの作成、読み込み、更新、削除を行うためのエンドポイントを提供します。 リリース・マーカーは、以下の 4 つの異なるスコープで作成できます。

• グローバル
• アプリケーション・パースペクティブ
• サービス
• アプリケーション・パースペクティブ内のサービス

次の例では、curl コマンドを使用して、指定した時点 (ミリ秒単位の UNIX タイム・スタンプ) に My First Global Release という名前の新しいグローバル・リリース・マーカーを作成します。

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Global Release\",
        \"start\": 1601890420046,
}"

このリリース・マーカーは、アプリケーション、サービス、およびエンドポイントのすべてのダッシュボード・ページに表示されます。

既存のアプリケーション・パースペクティブに基づいてリリース・マーカーを作成するには、要求本文にアプリケーション名のリストとともに applications を追加します。

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Application Scoped Release\",
        \"start\": 1601890420046,
        \"applications\": [
      {
        \"name\": \"My Application\" 
      }
    ]
}"

このリリース・マーカーは、アプリケーション マイ・アプリケーションのダッシュボードに表示されます。

特定のサービスに対するリリース・マーカーの作成方法を次のスニペットに示します。

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Service Scoped Release\",
        \"start\": 1601890420046,
        \"services\": [
      {
        \"name\": "\"my-service\"
      }
    ]
}"

このサービス・スコープのリリース・マーカーは、サービスのダッシュボード マイ・サービス およびサービスを含むすべてのアプリケーション・ダッシュボード マイ・サービスに表示されます。 スコープをサービスに限定したリリース・マーカーは、特定のアプリケーションのセットに対して作成することもできます。

curl --location --request POST "{{base}}/api/releases" \
  --header "Authorization: apiToken {{apiToken}}" \
  --header "Content-Type: application/json" \
  --data "{
        \"name\": \"My First Service Scoped Release\",
        \"start\": 1601890420046,
        \"services\": [
      {
        \"name\": \"my-service\",
        \"scopedTo\": {
          \"applications\": [
            {
              \"name\": \"My Application\"
            }
          ]
        }
      }
    ]
}"

ここで示したリリース・マーカーは、特定のアプリケーション My Application 内のサービス my-service に対してのみ表示され、アプリケーション内の他のサービスには表示されません。