다음을 통해 공유


서비스 후크와 통합

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

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

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

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

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

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

서비스 후크의 다이어그램.

참고 항목

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

사용 가능한 서비스

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

서비스 지원되는 이벤트 지원되는 작업
앱 센터 작업 항목을 업데이트함 알림을 보냅니다. 구독은 App Center를 통해 관리됩니다.
AppVeyor 코드 푸시됨 AppVeyor 빌드를 트리거합니다. 구독은 AppVeyor를 통해 관리됩니다.
아즈쿠아 주쿠아 모두 FLO에 이벤트를 게시합니다. 구독은 Azuqua를 통해 관리됩니다.
Azure App Service 코드 푸시됨 웹앱을 배포합니다. 구독은 Azure 앱 서비스를 통해 관리됩니다.
Azure Service Bus 모두 알림 허브, Service Bus 큐 또는 Service Bus 토픽에 메시지를 보냅니다. 구독은 Azure 앱 서비스를 통해 관리됩니다.
Azure Storage 모두 스토리지 큐에 메시지를 삽입합니다.
대나무 빌드 완료, 코드 푸시됨 빌드를 큐에 대기합니다.
Datadog 모두 Datadog에 이벤트를 게시합니다.
Grafana 릴리스 배포가 완료되었습니다. Grafana 데이터베이스에 주석을 추가합니다.
Jenkins 빌드 완료, 코드 푸시, PR 병합 시도, 릴리스 배포 완료 제네릭 또는 Git 빌드를 트리거합니다.
Microsoft Teams 모두 채널에 메시지를 게시합니다. 구독은 Microsoft Teams에서 관리됩니다.
MyGet 빌드 완료, 코드 푸시 MyGet에 NuGet 패키지를 게시합니다. MyGet 빌드를 트리거합니다. 구독은 MyGet에서 관리됩니다.
Office 365 모두 그룹에 메시지를 게시합니다.
Slack 모두 채널에 메시지를 게시합니다.
Trello 모두 카드 또는 목록을 만듭니다.
UserVoice 작업 항목이 생성됨, 작업 항목 업데이트됨 연결된 작업 항목 보내기 이벤트입니다. 구독은 UserVoice를 통해 관리됩니다.
웹 후크 모두 HTTP를 통해 게시합니다.
Workplace Message Apps 모두 알림을 보냅니다. 구독은 Workplace Message Apps를 통해 관리됩니다.
Zapier 모두 알림을 보냅니다. 구독은 Zapier를 통해 관리됩니다.
Zendesk 댓글을 달고 있는 작업 항목 티켓에 비공개 주석을 만듭니다.
서비스 지원되는 이벤트 지원되는 작업
Azure Service Bus 모두 알림 허브, Service Bus 큐 또는 Service Bus 토픽에 메시지를 보냅니다. 구독은 Azure 앱 서비스를 통해 관리됩니다.
Azure Storage 모두 스토리지 큐에 메시지를 삽입합니다.
대나무 빌드 완료, 코드 푸시됨 빌드를 큐에 대기합니다.
Datadog 모두 Datadog에 이벤트를 게시합니다.
Grafana 릴리스 배포가 완료되었습니다. Grafana 데이터베이스에 주석을 추가합니다.
Jenkins 빌드 완료, 코드 푸시, PR 병합 시도, 릴리스 배포 완료 제네릭 또는 Git 빌드를 트리거합니다.
Microsoft Teams 모두 채널에 메시지를 게시합니다. 구독은 Microsoft Teams에서 관리됩니다.
Office 365 모두 그룹에 메시지를 게시합니다.
Slack 모두 채널에 메시지를 게시합니다.
Trello 모두 카드 또는 목록을 만듭니다.
[UserVoice] ((https://www.uservoice.com) 작업 항목이 생성됨, 작업 항목 업데이트됨 연결된 작업 항목 보내기 이벤트입니다. 구독은 UserVoice를 통해 관리됩니다.
웹 후크 모두 HTTP를 통해 게시합니다.
Zendesk 댓글을 달고 있는 작업 항목 티켓에 비공개 주석을 만듭니다.

구독 만들기

이러한 서비스 중 하나를 Azure DevOps와 통합하는 경우 새 구독을 만들어야 합니다. 대부분의 경우 다른 서비스에서도 일부 구성을 수행해야 합니다. 자세한 내용은 관심 있는 서비스에 대한 정보를 확인하세요.

  1. 웹 액세스에서 프로젝트에 대한 관리 페이지를 엽니다.

    강조 표시된 프로젝트 설정 단추의 스크린샷
  2. 마법사를 실행하여 구독을 만듭니다.

    강조 표시된 단추, 구독 만들기의 스크린샷.

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

    통합할 서비스 선택

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

    트리거할 이벤트 및 필터 선택

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

    참고 항목

    사용 가능한 작업 목록은 선택한 이벤트 유형에 따라 제한될 수 있습니다.

    대상 서비스에 대한 작업 선택을 보여 주는 스크린샷.

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

    테스트 알림 1을 보여 주는 스크린샷

    테스트 알림 2를 보여 주는 스크린샷

FAQ

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

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

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

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

A: 이러한 권한이 있는 사용자는 프로젝트에서 만든 모든 구독과 해당 구독에 대한 알림 기록을 볼 수 있습니다. 그런 다음 해당 사용자는 해당 프로젝트에서 모든 유형의 서비스 후크 구독을 만들 수 있습니다. 사용자가 액세스 권한이 없는 리소스에 대한 구독을 설정하는 경우 구독이 트리거되지 않습니다.

예를 들어 영역 경로 XYZ에서 작업 항목 업데이트 이벤트에 대해 만든 구독은 해당 작업 항목에 대한 액세스 권한이 없는 경우 알림을 보내지 않습니다. 그러나 해당 작업 항목에 액세스할 수 있는 다른 사용자의 알림 기록을 볼 수 있습니다.

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

A: 예. 자세한 내용은 서비스 후크 구독 만들기를 참조하세요.

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

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

  1. 에서 https://visualstudio.microsoft.com/프로필 페이지로 이동합니다.

    조직에서 액세스한 프로필이 권한 부여 관리 기능의 잘못된 구현으로 이동하므로 조직()이 아닌 Visual Studio 사이트(https://visualstudio.microsoft.com/https://dev.azure.com/{orgName})에서 시작해야 합니다.

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

    강조 표시된 애플리케이션 관리 단추를 보여 주는 스크린샷

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

    권한 부여에 대한 해지 옵션을 보여 주는 스크린샷

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

A: 아틀라시안은 공식적으로 HipChat에 대한 지원을 중단했습니다. 자세한 내용은 공지를 참조하세요.