웹후크 구성 및 테스트

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 3분

    • 에서 웹후크를 Azure DevOps 수동으로 구성하고 테스트합니다.

    수동으로 웹후크 Azure DevOps 구성

    애플리케이션에 동기화 알림을 보내도록 웹후크 Azure DevOps 를 DevOps 변경 속도 구성합니다.

    시작하기 전에

    필요한 역할: 의 sn_devops.admin 또는 sn_devops.tool_owner DevOps 변경 속도, Azure DevOps admin

    이 태스크 정보

    의 DevOps 변경 속도도구 기록에서 수동 구성에 Azure DevOps 액세스할 수도 있습니다.

    프로시저

    1. 에서 Azure DevOps웹후크를 구성할 프로젝트를 엽니다.
    2. 다음으로 이동 설정 > 서비스 후크 에서 NEW SERVICE HOOKS SUBSCRIPTION Azure DevOps을 생성합니다.
    3. 에서 DevOps 변경 속도데이터를 전송하도록 도구 인스턴스를 구성할 때 수동으로 구성을 선택합니다.
      Azure DevOps 구성 도구
    4. 에서 DevOps 변경 속도에 대한 ServiceNow 인스턴스 연결 상세 정보에서 웹후크 URL 필드를 복사합니다 Azure DevOps.
      주:
      해당 필드에서 복사 를 선택하여 값을 클립보드에 복사합니다. 필드 레이블이 복사됨으로 변경되지만 여러 번 복사할 수 있습니다.
      Azure DevOps 수동으로 웹후크 구성
    5. 복사한 웹후크 URL을 수정하여 도구 상세 정보를 반영하고 URL Azure DevOps을 에 붙여넣습니다.

      예:

      https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/{code | plan | artifact | orchestration | test | softwarequality }?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id>

      1. 도구와 일치하는 도구 기능 {code | plan | artifact | orchestration | test | softwarequality } 중 하나를 선택합니다.
        예:

        https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/orchestration?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id>

      2. <project_sys_id>Azure DevOps sn_devops_project 테이블의 native_id 열에서 ServiceNow 프로젝트 ID로 바꿉니다.
      3. 수정된 URL을 에 있는 NEW SERVICE HOOKS SUBSCRIPTION의 URL 필드에 복사합니다 Azure DevOps.
    6. DevOps 변경 속도에서 Azure DevOps에 대한 ServiceNow 인스턴스 연결 상세 정보에서 비밀 토큰 필드를 복사합니다.
    7. Azure DevOps의 NEW SERVICE HOOKS SUBSCRIPTION의 헤더 필드에 복사한 시크릿 토큰을 올바른 형식으로 붙여넣습니다.
      1. Azure DevOps HTTP 헤더 필드에 다음 형식을 사용합니다.
        "토큰 : <tokenValue>"
      2. <tokenValue>를 에 대한 Azure DevOpsServiceNow 인스턴스 연결 세부 정보에서 복사한 비밀 토큰으로 바꿉니다.
      표 1. 필드 값 복사
      소스 DevOps 변경 속도 필드 대상 GitHub 필드
      웹후크 URL(수정됨) URL
      비밀 토큰

      HTTP 헤더

      형식:

      토큰 : <tokenValue>
      Azure DevOps 수동으로 웹후크 구성

    에서 웹후크 테스트 Azure DevOps

    각 프로젝트에 대해 웹후크가 올바르게 구성되었는지 직접 Azure DevOps 수동으로 테스트할 수 있습니다.

    시작하기 전에

    필요한 역할: Azure DevOps admin 권한

    프로시저

    1. 웹후크를 테스트할 프로젝트로 Azure DevOps 이동하여 선택합니다.
    2. 다음으로 이동 프로젝트 설정 > 서비스 후크.
      각 프로젝트에 대해 다음 DevOps 변경 속도 이벤트에 대한 웹후크를 생성합니다.
      • 빌드 완료
      • 코드 푸시됨
      • 릴리스 생성됨
      • 릴리스 배포 완료됨
      • 실행 스테이지 상태 변경됨
      • 업무 항목이 작성됨
      • 업무 항목 삭제됨
      • 업무 항목이 복원됨
      • 작업 항목 업데이트함
    3. 웹후크를 선택하고 편집을 선택합니다.
    4. 다음을 선택하여 URL 및 인증 세부 정보를 확인합니다.

      구성된 웹후크의 상세 정보입니다.

    5. 웹후크를 테스트하려면 테스트를 선택합니다.

      • 웹후크가 올바르게 구성된 경우 성공 메시지를 받게 됩니다.

        웹후크가 올바르게 구성된 경우의 성공 메시지입니다.

      • 웹후크가 잘못 구성된 경우 실패 메시지가 표시됩니다.

        웹후크가 올바르게 구성된 경우의 실패 메시지입니다.

        웹후크를 수정하려면 다음 옵션을 시도해 볼 수 있습니다.
        • 의 DevOps 변경 속도프로젝트 기록 페이지에서 구성을 선택하여 웹후크를 재구성합니다. 그러면 프로젝트의 모든 기존 웹후크가 재구성됩니다.

        • URL 필드에서 및이 toolIdprojectId 올바른지 확인합니다. DevOps 변경 속도의 도구 기록 페이지에서 올바른 값을 찾을 수 있습니다.

          toolId 및 projectId를 입력합니다.

        • 인증에 통합 사용자 자격 증명을 사용하는 경우 기본 인증 사용자 이름 및 암호 필드에서 자격 증명이 올바른지 확인합니다.

          웹후크의 기본 인증 필드입니다.

        • 인증에 비밀 토큰을 사용하는 경우 토큰 값은 기본 인증 암호 필드에서 마스킹됩니다. 이 필드의 토큰을 바꿀 수 있습니다.

          웹후크의 토큰입니다.