PublishToAzureServiceBus@0 - v0 タスクに発行Azure Service Bus
このタスクを使用して、サービス接続を使用してAzure Service Busにメッセージを送信します (エージェントは必要ありません)。
構文
# Publish To Azure Service Bus v0
# Sends a message to azure service bus using a service connection (no agent required).
- task: PublishToAzureServiceBus@0
inputs:
azureSubscription: # string. Alias: connectedServiceName. Required. Azure service bus connection.
messageBody: '{"JobId": "$(system.jobId)", "PlanId": "$(system.planId)", "TimelineId": "$(system.timelineId)", "ProjectId": "$(system.teamProjectId)", "VstsUrl": "$(system.CollectionUri)","AuthToken": "$(system.AccessToken)"}' # string. Required. Message body. Default: {"JobId": "$(system.jobId)", "PlanId": "$(system.planId)", "TimelineId": "$(system.timelineId)", "ProjectId": "$(system.teamProjectId)", "VstsUrl": "$(system.CollectionUri)","AuthToken": "$(system.AccessToken)"}.
#waitForCompletion: false # boolean. Wait for task completion. Default: false.
入力
azureSubscription
- Azure Service Bus 接続
入力エイリアス: connectedServiceName
。 string
. 必須です。
Azure Service Bus接続を指定します。
messageBody
- メッセージ本文
string
. 必須です。 既定値: {"JobId": "$(system.jobId)", "PlanId": "$(system.planId)", "TimelineId": "$(system.timelineId)", "ProjectId": "$(system.teamProjectId)", "VstsUrl": "$(system.CollectionUri)","AuthToken": "$(system.AccessToken)"}
。
JSON を指定します messageBody
。
waitForCompletion
- タスクの完了を待つ
boolean
. 既定値: false
。
を に true
設定すると、このタスクは TaskCompleted イベントが指定されたタスクタイムアウトまで待機します。
タスク コントロール のオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。
出力変数
[なし] :
解説
このタスクは、(エージェントを使用せずに) サービス接続を使用してAzure Service Busにメッセージを送信するために、リリース パイプラインのエージェントレス ジョブで使用します。
Note
リリース パイプラインの エージェントレス ジョブ でのみ使用できます。
タスクはどこで完了を通知する必要がありますか?
完了を通知するには、外部サービスで完了データを次のパイプライン REST エンドポイントに POST する必要があります。
{planUri}/{projectId}/_apis/distributedtask/hubs/{hubName}/plans/{planId}/events?api-version=2.0-preview.1
**Request Body**
{ "name": "TaskCompleted", "taskId": "taskInstanceId", "jobId": "jobId", "result": "succeeded" }
詳細については 、この単純なコマンドライン アプリケーション を参照してください。
さらに、C# ヘルパー ライブラリを使用して、エージェントレス タスクのライブ ログ記録とタスク状態の管理を可能にします。 非同期 HTTP エージェントレス タスクの詳細については、こちらを参照してください。
必要条件
要件 | 説明 |
---|---|
パイプラインの種類 | YAML、クラシック ビルド、クラシック リリース |
実行日 | サーバー |
確認要求 | なし |
Capabilities | このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。 |
コマンドの制限 | Any |
設定可能な変数 | Any |
エージェントのバージョン | サポートされているすべてのエージェント バージョン。 |
タスクのカテゴリ | ユーティリティ |