서비스 후크 소비자

  • 아티클

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

서비스 후크 소비자를 사용하여 프로그래밍 방식으로 구독을 만듭니다. 구독은 이벤트, 소비자 및 작업을 지정합니다.

다음 소비자로부터 구독에 사용할 소비자를 선택합니다. 사용 가능한 서비스에 대한 자세한 내용은 서비스 후크와 통합, 사용 가능한 서비스를 참조 하세요.

Azure Service Bus

Notification Hubs를 포함하여 Microsoft Azure Service Bus와의 통합을 제공합니다.

알림 허브에 메시지 보내기

이 작업은 지정된 Azure Notification Hub에 일반 템플릿 알림을 보냅니다. 자세한 내용은 개요를 참조하세요.

  • 소비자 ID: azureServiceBus
  • 작업 ID: serviceBusNotificationHubSend
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • connectionString
      • SAS 연결 문자열
      • SAS(공유 액세스 서명)는 Azure Service Bus에 연결하는 데 사용할 연결 문자열. 이 연결 문자열 Azure Portal에서 사용할 수 있습니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • notificationHubName
      • 알림 허브 이름
      • 알림을 보낼 알림 허브의 이름입니다. 이름에는 문자, 숫자, 마침표, 하이픈, 슬래시 및 밑줄만 포함될 수 있습니다. 이름은 문자 또는 숫자로 시작하고 끝나야 합니다. 허브가 이미 있어야 합니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • tagsExpression
      • 태그
      • 특정 디바이스 집합을 대상으로 하는 태그 식입니다. 자세히 알아보기.
      • 데이터 형식: 문자열
      • 필수: 아니요

Service Bus 큐에 메시지 보내기

이 작업은 이벤트의 JSON 문자열 표현을 지정된 Azure Service Bus 큐로 보냅니다. 자세한 내용은 Service Bus 큐, 문서 및 구독을 참조 하세요.

  • 소비자 ID: azureServiceBus
  • 작업 ID: serviceBusQueueSend
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • connectionString
      • SAS 연결 문자열
      • SAS(공유 액세스 서명)는 Azure Service Bus에 연결하는 데 사용할 연결 문자열. 이 연결 문자열 Azure Portal에서 사용할 수 있습니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • queueName
      • 큐 이름
      • 메시지를 보낼 큐의 이름입니다. 이름에는 문자, 숫자, 마침표, 하이픈, 슬래시 및 밑줄만 포함될 수 있습니다. 이름은 문자 또는 숫자로 시작하고 끝나야 합니다. 큐가 없으면 지정된 연결 문자열 필요한 권한이 있는 경우 생성됩니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • resourceDetailsToSend
      • 보낼 리소스 세부 정보
      • 보낼 리소스 필드 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • messagesToSend
      • 보낼 메시지
      • 보낼 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • detailedMessagesToSend
      • 보낼 자세한 메시지
      • 보낼 자세한 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요

Service Bus 토픽에 메시지 보내기

이 작업은 이벤트의 JSON 문자열 표현을 지정된 Azure Service Bus 토픽으로 보냅니다. 자세한 내용은 Azure Portal을 사용하여 Service Bus 토픽 및 토픽에 대한 구독을 만듭니다.

  • 소비자 ID: azureServiceBus
  • 작업 ID: serviceBusTopicSend
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • connectionString
      • SAS 연결 문자열
      • SAS(공유 액세스 서명)는 Azure Service Bus에 연결하는 데 사용할 연결 문자열. 이 연결 문자열 Azure Portal에서 사용할 수 있습니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • topicName
      • 주제 이름
      • 메시지를 보낼 토픽의 이름입니다. 이름에는 문자, 숫자, 마침표, 하이픈, 슬래시 및 밑줄만 포함될 수 있습니다. 이름은 문자 또는 숫자로 시작하고 끝나야 합니다. 항목이 없으면 지정된 연결 문자열 필요한 권한이 있으면 만들어집니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • resourceDetailsToSend
      • 보낼 리소스 세부 정보
      • 보낼 리소스 필드 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • messagesToSend
      • 보낼 메시지
      • 보낼 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • detailedMessagesToSend
      • 보낼 자세한 메시지
      • 보낼 자세한 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요

Azure Storage

Microsoft Azure Storage와의 통합을 제공합니다.

Storage Queue에 메시지 삽입

이 작업은 지정된 Azure Storage 큐에 이벤트의 JSON 문자열 표현을 삽입합니다. 자세한 내용은 Azure 큐란?을 참조하세요.

  • 소비자 ID: azureStorageQueue
  • 작업 ID: 큐에 넣기
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • accountName
      • 스토리지 계정 이름
      • Azure Storage 계정과 연결된 이름(예: https://STORAGE_ACCOUNT_NAME.queue.core.windows.net)입니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • accountKey
      • 스토리지 계정 키
      • Azure Storage 계정과 연결된 키입니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • queueName
      • 큐 이름
      • Azure Storage 내에서 사용할 큐의 소문자 전용 이름입니다. 이 이름의 큐가 아직 없는 경우 만들어집니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • visiTimeout
      • 메시지 표시 시간 제한(초)
      • 큐에 추가된 메시지의 표시 시간 제한 값(초)을 서버 시간을 기준으로 지정합니다. 값은 0보다 크거나 같아야 하며 7일 또는 604,800초보다 클 수 없습니다. 표시 시간 제한은 메시지의 TL(Time to Live) 값보다 작은 값으로 설정해야 합니다.
      • 데이터 형식: number
      • 필수: 예
    • Ttl
      • 메시지 TL(Time-to-Live)
      • 큐 메시지의 TL(Time-to-Live) 간격(초)을 지정합니다. 허용되는 최대 라이브 시간은 7일 또는 604,800초입니다.
      • 데이터 형식: number
      • 필수: 예
    • resourceDetailsToSend
      • 보낼 리소스 세부 정보
      • 보낼 리소스 필드 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • messagesToSend
      • 보낼 메시지
      • 보낼 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • detailedMessagesToSend
      • 보낼 자세한 메시지
      • 보낼 자세한 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요

Campfire

Campfire는 인스턴트 메시징과 유사하지만 그룹 전용으로 설계되었습니다.

채팅방에 메시지 게시

캠프 파이어의 방에 이벤트에 대한 메시지를 게시합니다.

  • 소비자 ID: 캠프파이어
  • 작업 ID: postMessageToRoom
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • accountName
      • 계정 이름
      • 다음과 같은 계정 이름 https://{account name}.campfirenow.com
      • 데이터 형식: 문자열
      • 필수: 예
    • authToken
      • API 인증 토큰
      • 메시지가 게시되는 사용자에 대한 API 인증 토큰입니다. Campfire의 사용자 프로필 페이지를 방문하는 이 토큰을 가져올 수 있습니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • roomId
      • 방
      • 메시지를 게시할 공간입니다.
      • 데이터 형식: number
      • 필수: 예
    • showDetails
      • 자세한 메시지 보내기
      • 이벤트에 대한 짧거나 자세한 메시지를 게시합니다.
      • 데이터 형식: boolean
      • 필수: 아니요

Jenkins

Jenkins는 소프트웨어 프로젝트를 지속적으로 빌드하고 테스트할 수 있는 연속 통합 서버입니다.

Git 빌드 트리거

Jenkins Git 플러그 인을 사용하여 Git 리포지토리를 사용하도록 구성된 빌드를 트리거합니다.

  • 소비자 ID: jenkins
  • 작업 ID: triggerGitBuild
  • 지원되는 이벤트: git.push
  • 설정:
    • serverBaseUrl
      • Jenkins 기본 URL
      • Jenkins 서버를 호스트하는 기본 URL
      • 데이터 형식: uri
      • 필수: 예
    • username
      • 사용자 이름
      • 빌드를 트리거할 수 있는 사용자의 Jenkins 사용자 이름
      • 데이터 형식: 문자열
      • 필수: 예
    • password
      • 사용자 API 토큰(또는 암호)
      • Jenkins 사용자 구성 페이지에서 사용할 수 있는 사용자의 API 토큰입니다. API 토큰은 버전 1.426 이후 새로운 토큰입니다. 이전 버전의 Jenkins의 경우 실제 사용자 암호를 지정해야 합니다.
      • 데이터 형식: 문자열
      • 필수: 예

제네릭 빌드 트리거

Jenkins 빌드 URL을 호출하여 일반 Jenkins 빌드를 트리거합니다.

  • 소비자 ID: jenkins
  • 작업 ID: triggerGenericBuild
  • 지원되는 이벤트: git.push, build.complete, tfvc.검사in
  • 설정:
    • serverBaseUrl
      • Jenkins 기본 URL
      • Jenkins 서버를 호스트하는 기본 URL
      • 데이터 형식: uri
      • 필수: 예
    • username
      • 사용자 이름
      • 빌드를 트리거할 수 있는 사용자의 Jenkins 사용자 이름
      • 데이터 형식: 문자열
      • 필수: 예
    • password
      • 사용자 API 토큰(또는 암호)
      • Jenkins 사용자 구성 페이지에서 사용할 수 있는 사용자의 API 토큰입니다. API 토큰은 버전 1.426 이후 새로운 토큰입니다. 이전 버전의 Jenkins의 경우 실제 사용자 암호를 지정해야 합니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • buildName
      • 빌드
      • 트리거할 빌드 이름
      • 데이터 형식: 문자열
      • 필수: 예
    • buildAuthToken
      • 빌드 토큰
      • 알고 있는 사용자만 이 프로젝트의 빌드를 원격으로 트리거할 수 있도록 문자열 형식의 권한 부여 토큰
      • 데이터 형식: 문자열
      • 필수: 아니요
    • buildParameterized
      • 매개 변수 허용
      • 빌드가 매개 변수화되었는지 여부를 나타냅니다(빌드 매개 변수는 선택적으로 이전에 지정됨).
      • 데이터 형식: boolean
      • 필수: 아니요
    • buildParams
      • 빌드 매개 변수
      • 각 이름-값 쌍이 고유한 텍스트 줄에 나타나는 콜론(예: "param1:value1")으로 구분된 매개 변수 이름 및 값 빌드
      • 데이터 형식: 문자열
      • 필수: 아니요

카토

Kato는 최신 조직을 위한 메시징 서비스를 제공합니다.

회의실에 이벤트 게시

카토 룸에 이벤트 게시

  • 소비자 ID: kato
  • 작업 ID: postEventToRoom
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • roomToken
      • 회의실 토큰
      • Kato API를 사용하여 회의실과 상호 작용하기 위한 토큰
      • 데이터 형식: 문자열
      • 필수: 예
    • roomName
      • 방 이름
      • 가토에서 볼 수 있는 방 이름
      • 데이터 형식: 문자열
      • 필수: 아니요

Trello

Trello와의 통합을 제공합니다.

카드 만들기

이 작업은 Trello의 기존 목록에 카드 만듭니다. 카드 작업, 문제, 이벤트 또는 거의 모든 것을 나타낼 수 있습니다. 카드 상태는 일반적으로 현재 목록에 따라 결정됩니다. 자세한 내용은 Trello를 사용하여 서비스 후크 만들기를 참조하세요.

  • 소비자 ID: trello
  • 작업 ID: createCard
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • Usertoken
      • 사용자 토큰(하나 필요하세요? 지금 다운로드하세요.)
      • Trello에서 제공하는 사용자 토큰입니다. 이전에 설명한 작업 설명에서 링크를 선택하여 이 토큰을 가져오는 방법을 알아봅니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • boardId
      • 보드
      • Trello 카드 만들어지는 보드의 이름입니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • listId
      • List
      • Trello 카드 만들어지는 목록의 이름입니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • 레이블
      • 레이블
      • 만든 카드 적용할 레이블 색의 쉼표로 구분된 목록입니다. 유효한 레이블 색 이름은 빨간색, 주황색, 노란색, 녹색, 파랑 및 자주색입니다.
      • 데이터 형식: 문자열
      • 필수: 아니요
    • addToTop
      • 목록의 시작 부분에 만들기
      • 끝 대신 Trello 목록의 시작 부분에 카드 만들어야 하는지 여부를 나타냅니다.
      • 데이터 형식: boolean
      • 필수: 아니요

목록 만들기

이 작업은 Trello의 기존 보드에 목록을 만듭니다. 목록은 보드에서 카드 구성하는 데 사용되며 일반적으로 상태를 나타냅니다. 자세한 내용은 Trello를 사용하여 서비스 후크 만들기를 참조하세요.

  • 소비자 ID: trello
  • 작업 ID: createList
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • Usertoken
      • 사용자 토큰(하나 필요하세요? 지금 다운로드하세요.)
      • Trello에서 제공하는 사용자 토큰입니다. 이전에 설명한 작업 설명에서 링크를 선택하여 이 토큰을 가져오는 방법을 알아봅니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • boardId
      • 보드
      • Trello 목록이 만들어지는 보드의 이름입니다.
      • 데이터 형식: 문자열
      • 필수: 예
    • addToBottom
      • 보드 맨 아래에 만들기
      • 상단이 아닌 보드 아래쪽에 목록을 만들어야 하는지를 나타냅니다.
      • 데이터 형식: boolean
      • 필수: 아니요

웹후크

웹후크는 HTTP를 통해 이벤트 통신을 제공합니다.

HTTP를 통해 게시

이 작업은 이벤트의 JSON 개체 표현을 지정된 URL에 게시합니다. HTTPS 엔드포인트는 이벤트 페이로드의 프라이빗 데이터에 대한 가능성 때문에 권장됩니다. 자세한 내용은 웹후크를 참조 하세요.

  • 소비자 ID: webHooks
  • 작업 ID: httpRequest
  • 지원되는 이벤트: build.complete, git.push, tfvc.검사in, workitem.created, workitem.commented, workitem.updated
  • 설정:
    • url
      • URL
      • HTTP POST가 전송되는 URL입니다.
      • 데이터 형식: uri
      • 필수: 예
    • httpHeaders
      • HTTP 헤더
      • 각 키-값 쌍이 고유한 텍스트 줄에 나타나는 콜론(예: "Key1:value1")으로 구분된 HTTP 헤더 키 및 값입니다.
      • 데이터 형식: 문자열
      • 필수: 아니요
    • basicAuthUsername
      • 기본 인증 사용자 이름
      • 표준 HTTP 인증에 대한 사용자 이름을 입력합니다. 기본 HTTP 인증은 일반 텍스트(암호화되지 않음)로 자격 증명을 전송합니다. 즉, "https"로 시작하는 URL을 사용하여 SSL(보안 전송 계층)을 통해 이러한 자격 증명의 암호화를 사용하도록 설정해야 합니다.
      • 데이터 형식: 문자열
      • 필수: 아니요
    • basicAuthPassword
      • 기본 인증 암호
      • 표준 HTTP 인증에 대한 암호를 입력합니다. 기본 HTTP 인증은 일반 텍스트(암호화되지 않음)로 자격 증명을 전송합니다. 즉, "https"로 시작하는 URL을 사용하여 SSL을 통해 이러한 자격 증명의 암호화를 사용하도록 설정해야 합니다.
      • 데이터 형식: 문자열
      • 필수: 아니요
    • resourceDetailsToSend
      • 보낼 리소스 세부 정보
      • 보낼 리소스 필드 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • messagesToSend
      • 보낼 메시지
      • 보낼 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요
    • detailedMessagesToSend
      • 보낼 자세한 메시지
      • 보낼 자세한 메시지 제어
      • 데이터 형식: 문자열
      • 필수: 아니요

Zendesk

Zendesk는 지원 센터 발권, 문제 추적 및 고객 서비스 지원을 제공하는 SaaS 제품군입니다.

티켓에 비공개 메모 만들기

Zendesk를 사용하여 티켓에 비공개 메모를 만듭니다.

  • 소비자 ID: zendesk
  • 작업 ID: createPrivateComment
  • 지원되는 이벤트: workitem.commented
  • 설정:
    • accountName
      • 계정 이름
      • 다음과 같은 Zendesk 계정 이름 https://{account name}.zendesk.com
      • 데이터 형식: 문자열
      • 필수: 예
    • username
      • 사용자 이름
      • 티켓을 업데이트하는 사용자의 Zendesk 사용자 이름
      • 데이터 형식: 문자열
      • 필수: 예
    • apiToken
      • API 토큰
      • Zendesk API 토큰(관리 > Channels API의 Zendesk 앱에서 찾을 수 있음>)
      • 데이터 형식: 문자열
      • 필수: 예