PublishToAzureServiceBus@1 - Azure Service Bus v1 작업에 게시

아티클
06/11/2024

이 작업을 사용하여 서비스 연결을 사용하여 Azure Service Bus 메시지를 보냅니다(에이전트가 필요하지 않음).

이 작업을 사용하여 서비스 연결을 사용하여 Azure Service Bus 메시지를 보냅니다(에이전트 필요 없음).

Syntax

# Publish To Azure Service Bus v1
# Sends a message to Azure Service Bus using a service connection (no agent is required).
- task: PublishToAzureServiceBus@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceName. Required. Azure Service Bus service connection. 
    #messageBody: # string. Message body. 
    #waitForCompletion: false # boolean. Wait for task completion. Default: false.
    #useDataContractSerializer: true # boolean. Use .NET data contract serializer. Default: true.
  # Advanced
    #sessionId: # string. Session Id. 
    #signPayload: false # boolean. Sign the Message. Default: false.
    #certificateString: # string. Required when signPayload = true. Certificate Variable. 
    #signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.

# Publish To Azure Service Bus v1
# Sends a message to Azure Service Bus using a service connection (no agent is required).
- task: PublishToAzureServiceBus@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceName. Required. Azure Service Bus service connection. 
    #messageBody: # string. Message body. 
    #waitForCompletion: false # boolean. Wait for task completion. Default: false.
  # Advanced
    #sessionId: # string. Session Id. 
    #signPayload: false # boolean. Sign the Message. Default: false.
    #certificateString: # string. Required when signPayload = true. Certificate Variable. 
    #signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.

# Publish To Azure Service Bus v1
# Sends a message to azure service bus using a service connection (no agent required).
- task: PublishToAzureServiceBus@1
  inputs:
    azureSubscription: # string. Alias: connectedServiceName. Required. Azure Service Bus service connection. 
    #messageBody: # string. Message body. 
    #waitForCompletion: false # boolean. Wait for task completion. Default: false.
  # Signing Properties
    #signPayload: false # boolean. Sign the Message. Default: false.
    #certificateString: # string. Required when signPayload = true. Certificate Variable. 
    #signatureKey: 'signature' # string. Optional. Use when signPayload = true. Signature Property Key. Default: signature.

입력

azureSubscription - Azure Service Bus 서비스 연결
입력 별칭: connectedServiceName. string. 필수 요소.

Azure Service Bus 서비스 연결을 지정합니다.

messageBody - 메시지 본문
string.

JSON messageBody을 지정합니다.

sessionId - 세션 ID
string.

메시지가 게시되는 세션 ID를 지정합니다. 세션 기반 큐의 경우 값을 지정하지 않으면 게시가 실패합니다. 세션 기반이 아닌 큐의 경우 값을 지정할 필요가 없습니다.

signPayload - 메시지에 서명
boolean. 기본값은 false입니다.

로 true설정하면 프라이빗 인증서가 메시지에 추가됩니다.

certificateString - 인증서 변수
string. 필요한 경우 signPayload = true입니다.

인증서 콘텐츠를 포함하는 비밀 변수를 지정합니다. 릴리스 파이프라인에서 사용하는 변수 그룹에 연결된 Azure Key Vault에 저장된 인증서일 수도 있습니다.

signatureKey - 서명 속성 키
string. 선택 사항입니다. 을 사용할 때 signPayload = true사용합니다. 기본값은 signature입니다.

메시지 속성에서 서명이 있는 키를 지정합니다. 비워 두면 기본값은 입니다 signature.

waitForCompletion - 작업 완료 대기
boolean. 기본값은 false입니다.

로 true설정하면 이 작업은 지정된 작업 시간 제한에 대한 TaskCompleted 이벤트를 기다립니다.

useDataContractSerializer - .NET 데이터 계약 직렬 변환기를 사용합니다.
boolean. 기본값은 true입니다.

false 개체 대신 스트림으로 메시지를 전달하려는 경우 를 로 설정합니다useDataContractSerializer.

작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

릴리스 파이프라인의 에이전트 없는 작업에서 이 작업을 사용하여 에이전트를 사용하지 않고 서비스 연결을 사용하여 Azure Service Bus 메시지를 보냅니다.

참고

릴리스 파이프라인의 에이전트 없는 작업 에서만 사용할 수 있습니다.

작업 신호 완료 위치는 어디인가요?

완료를 알리기 위해 외부 서비스는 다음 파이프라인 REST 엔드포인트에 완료 데이터를 게시해야 합니다.

{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" }

자세한 내용은 이 간단한 cmdline 애플리케이션 을 참조하세요.

또한 C# 도우미 라이브러리를 사용하여 라이브 로깅을 사용하도록 설정하고 에이전트 없는 작업에 대한 작업 상태 관리할 수 있습니다. 비동기 HTTP 에이전트 없는 작업에 대해 자세히 알아봅니다.

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	서버
요청	없음
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	모두
설정 가능한 변수	모두
에이전트 버전	지원되는 모든 에이전트 버전.
작업 범주	유틸리티

다음을 통해 공유