다음을 통해 공유


서비스 훅과 통합하기

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Azure DevOps 프로젝트에서 이벤트가 발생할 때 서비스 후크를 사용하여 다른 서비스에서 작업을 실행할 수 있습니다.

예를 들어 Azure DevOps에서 작업 항목을 만들 때 서비스 후크를 사용하여 Trello에서 카드를 자동으로 만들 수 있습니다. 또는 빌드가 실패할 때 팀의 모바일 디바이스에 푸시 알림을 자동으로 보낼 수 있습니다. 또한 사용자 지정 앱 및 서비스에서 서비스 후크를 사용하여 프로젝트에서 이벤트가 발생할 때 활동을 보다 효율적으로 구동할 수 있습니다.

서비스 후크는 어떻게 작동합니까?

서비스 후크 게시자는 구독할 수 있는 이벤트 집합을 정의합니다. 구독은 이러한 이벤트를 수신 대기하고 이벤트를 기반으로 수행할 작업을 정의합니다.

또한 구독은 이벤트가 발생할 때 자체 작업을 실행할 수 있는 외부 서비스인 소비자를 대상으로 합니다.

게시자 상자에서 구독 상자로의 이벤트 레이블이 지정된 화살표와 구독 상자에서 소비자 및 작업 상자로의 화살표가 있는 다이어그램

참고

서비스 후크를 사용하려면 서비스 엔드포인트에 대한 인바운드 연결에 대해 특정 IP 주소 범위를 허용해야 합니다. 서비스 엔드포인트는 서비스 후크에 제공되는 속성 집합입니다. 자세한 내용은 IP 주소 및 범위 제한을 참조하세요.

사용 가능한 서비스

다음 서비스는 서비스 후크의 대상으로 사용할 수 있습니다. Azure DevOps와 통합되는 다른 앱 및 서비스에 대한 자세한 내용은 Visual Studio Marketplace를 참조하세요.

서비스 지원되는 이벤트 지원되는 작업 구독 관리
Visual Studio App Center 작업 항목을 업데이트함 알림 보내기 App Center에서
AppVeyor 코드 푸시됨 AppVeyor 빌드를 실행합니다 AppVeyor에서
아즈쿠아 모두 FLO(흐름 언어 개체)에 이벤트 게시 아즈쿠아에서
Azure 앱 서비스 코드 푸시됨 웹 앱 배포 앱 서비스 내에서
Azure Service Bus 모두 Azure Notification Hubs, Service Bus 큐 또는 Service Bus 토픽에 메시지 보내기 Azure DevOps에서
Azure Storage 모두 Storage 큐에 메시지 삽입 Azure DevOps에서
대나무 빌드 완료, 코드 푸시 빌드를 큐에 추가하세요 Azure DevOps에서
Datadog 모두 Datadog에 이벤트 게시 Azure DevOps에서
그라파나 주 릴리스 배포가 완료되었습니다. Grafana 데이터베이스에 주석 추가 Azure DevOps에서
젠킨스 빌드 완료, 코드 푸시, PR 병합 시도 제네릭 또는 Git 빌드 트리거 Azure DevOps에서
마이크로소프트 팀 모두 채널에 메시지 게시 Teams에서
MyGet 빌드 완료, 코드 푸시 MyGet에 NuGet 패키지 게시, MyGet 빌드 트리거 MyGet에서
Office 365 모두 그룹에 메시지 게시 Office 365에서
슬랙 모두 채널에 메시지 게시 Azure DevOps에서
트렐로 모두 카드 또는 목록 만들기 Azure DevOps에서
UserVoice 작업 항목이 생성됨, 작업 항목 업데이트됨 연결된 작업 항목 이벤트 보내기 UserVoice에서
웹후크 모두 HTTP를 통해 요청 게시 Azure DevOps에서
작업 공간 메시징 앱 모두 알림 보내기 회사 메시징 앱에서
Zapier 모두 알림 보내기 자피어에서
Zendesk 댓글을 달고 있는 작업 항목 티켓에 비공개 메모 만들기 Azure DevOps에서
서비스 지원되는 이벤트 지원되는 작업 구독 관리
Azure Service Bus 모두 Azure Notification Hubs, Service Bus 큐 또는 Service Bus 토픽에 메시지 보내기 Azure DevOps에서
Azure Storage 모두 Storage 큐에 메시지 삽입 Azure DevOps에서
대나무 빌드 완료, 코드 푸시 빌드를 큐에 추가하세요 Azure DevOps에서
Datadog 모두 Datadog에 이벤트 게시 Azure DevOps에서
그라파나 주 릴리스 배포가 완료되었습니다. Grafana 데이터베이스에 주석 추가 Azure DevOps에서
젠킨스 빌드 완료, 코드 푸시, PR 병합 시도 제네릭 또는 Git 빌드 트리거 Azure DevOps에서
마이크로소프트 팀 모두 채널에 메시지 게시 Teams에서
Office 365 모두 그룹에 메시지 게시 Office 365에서
슬랙 모두 채널에 메시지 게시 Azure DevOps에서
트렐로 모두 카드 또는 목록 만들기 Azure DevOps에서
UserVoice 작업 항목이 생성됨, 작업 항목 업데이트됨 연결된 작업 항목 이벤트 보내기 UserVoice에서
웹후크 모두 HTTP를 통해 요청 게시 Azure DevOps에서
Zendesk 댓글을 달고 있는 작업 항목 티켓에 비공개 메모 만들기 Azure DevOps에서

구독 만들기

이러한 서비스 중 하나를 Azure DevOps와 통합하려면 구독을 만듭니다. 대부분의 경우 대상 서비스를 구성해야 합니다. 자세한 내용은 통합하려는 서비스에 대한 설명서를 참조하세요.

  1. 프로젝트로 이동하여 프로젝트 설정을 선택한 다음 서비스 후크를 선택합니다.

    Azure DevOps 프로젝트를 보여 주는 스크린샷 측면에서 프로젝트 설정 및 서비스 후크가 강조 표시됩니다.

  2. 구독 만들기를 선택합니다.

    Azure DevOps 프로젝트의 서비스 후크 페이지 스크린샷 구독 만들기 단추가 강조 표시됩니다.

  3. 통합하려는 서비스를 선택합니다.

    서비스 대화 상자의 스크린샷. 다양한 서비스가 나열되고, Trello가 선택되고, Trello에 대한 설명이 표시됩니다.

  4. 트리거할 이벤트 및 적용 가능한 필터를 선택합니다.

    트리거 대화 상자의 스크린샷. 코드 푸시 이벤트가 선택됩니다. 필터는 리포지토리 및 그룹에 설정됩니다.

  5. 대상 서비스에서 실행할 작업을 선택합니다.

    참고

    사용 가능한 작업은 선택한 이벤트 유형에 따라 달라집니다.

    작업 대화 상자의 스크린샷. 카드 만들기가 선택되었습니다. 필드는 토큰, 보드 및 기타 설정을 지정하는 데 사용할 수 있습니다.

  6. 설정이 올바른지 확인하려면 구독을 테스트한 다음 마법사를 완료합니다.

    테스트 알림 창의 스크린샷. 요약 탭에서 푸시에 대한 메시지는 성공 상태를 표시합니다.

    테스트 알림 창의 스크린샷. 요청 탭에는 푸시된 커밋에 대한 정보가 포함된 POST 요청이 Trello에 표시됩니다.

FAQ

Q: 구독을 설정하려면 어떤 권한이 필요합니까?

A: 구독 편집구독 보기 권한이 필요합니다. 기본적으로 프로젝트 관리자만 이러한 권한을 갖습니다. 다른 사용자에게 직접 부여하려면 명령줄 도구 또는 보안 REST API를 사용할 수 있습니다.

그룹에 보기 권한을 부여하려면 서비스 후크의 그룹에 대한 보기 권한 설정을 참조하세요.

Q: 구독 편집 및 구독 보기 권한 부여의 보안 영향은 무엇인가요?

A: 구독 편집구독 보기 권한이 있는 사용자는 다음을 수행할 수 있습니다.

  • 프로젝트의 모든 구독을 확인합니다.
  • 프로젝트의 모든 구독에 대한 알림 기록을 참조하세요.
  • 프로젝트에서 모든 유형의 서비스 후크 구독을 만듭니다.

사용자가 액세스 권한이 없는 리소스에 대한 구독을 설정하는 경우 구독이 트리거되지 않습니다.

예를 들어 특정 영역 경로의 작업 항목이 업데이트되면 알림을 보내는 구독을 만드는 경우를 가정해 보겠습니다. 해당 영역 경로의 작업 항목에 액세스할 수 없는 경우 알림이 전송되지 않습니다. 그러나 다른 사용자가 작업 항목에 액세스할 수 있는 경우 업데이트에 대해 경고하는 구독에 대한 알림 기록을 볼 수 있습니다.

Q: 프로그래밍 방식으로 프로젝트에 대한 서비스 후크 구독을 만들 수 있나요?

A: 예. 자세한 내용은 프로그래밍 방식으로 서비스 후크 구독 만들기를 참조하세요.

Q: 권한을 부여한 후 조직에 대한 앱의 액세스를 제거할 수 있나요?

A: 예. 프로필에서 권한 부여를 취소할 수 있습니다.

  1. https://visualstudio.microsoft.com로 이동합니다. 프로필 사진을 선택한 다음 Visual Studio 프로필을 선택합니다.

    권한 부여를 관리할 때 Visual Studio 사이트에서 https://visualstudio.microsoft.com시작해야 합니다. 해당 사이트에서 권한 부여 관리 기능의 올바른 구현에 액세스할 수 있습니다. 조직에서 시작하지 마세요(https://dev.azure.com/{organization-name}).

  2. 권한 부여 관리를 선택합니다.

    사용자에 대한 연락처 정보가 있는 Visual Studio 프로필 페이지의 스크린샷. 권한 부여 섹션에서 애플리케이션 관리가 강조 표시됩니다.

  3. 더 이상 허용하지 않으려는 권한 부여를 취소합니다.

    권한 부여 대화 상자의 스크린샷. 사용 권한 목록이 표시되고 해지 링크가 강조 표시됩니다.

Q: HipChat에 대한 서비스 후크를 더 이상 설정할 수 없는 이유는 무엇인가요?

A: Atlassian은 더 이상 HipChat을 지원하지 않습니다. 자세한 내용은 Atlassian 질문과 대답을 참조하세요.