GitHub 마켓플레이스의 ServiceNow DevOps 사용자 지정 작업

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기9분
  • 마켓플레이스의 GitHub 사용자 지정 작업을 사용하여 SonarQube 스캔 데이터, 보안 데이터를 수집하고, 워크플로우를 일시 중지 또는 다시 시작하거나, 인스턴스에서 변경 요청이 승인 또는 거부될 때까지 워크플로우를 다시 시작하거나, 변경 요청 상세 정보를 가져오고 업데이트하는 등의 작업을 수행할 수 있습니다.

    또는 Docker 컨테이너 이미지를 사용하여 파이프라인에 대한 GitHub Actions 사용자 지정 작업을 구현할 수 있습니다. 자세한 내용은 일반 Docker 컨테이너 이미지를 사용하여 파이프라인에 대한 사용자 지정 작업 구현 문서를 참조하십시오.

    ServiceNow DevOps SonarQube 사용자 지정 작업

    인스턴스에서 실행되는 ServiceNow 워크플로우에 의해 시작된 프로젝트의 SonarQube 스캔 결과를 저장합니다. 인스턴스에 SonarQube 도구를 생성하고 워크플로우의 작업 단계 수준에서 SonarQube 사용자 지정 작업을 사용해야 ServiceNow DevOps 합니다.

    다음 방법 중 하나를 사용하여 SonarQube 분석 결과를 봅니다.
    • 다음으로 이동 DevOps > 소프트웨어 품질 결과 > 소프트웨어 품질 요약.
    • 다음으로 이동 DevOps > 오케스트레이션 > 작업 실행 관련 작업 실행 기록을 선택합니다.
    사용자 지정 작업을 사용하려면 다음 작업을 수행합니다.
    • 인스턴스에서 SonarQube 도구를 생성합니다.

      토큰 작성 위치 사용자 > 내 계정 > 보안 페이지를 열고 생성된 토큰을 사용하여 인스턴스에 도구를 ServiceNow 생성합니다. 자세한 내용은 온보딩 SonarQube 대상 DevOps 변경 속도 — 작업 공간온보딩 SonarQube 대상 DevOps 변경 속도 - 클래식 문서를 참조하십시오.

    • 다음 비밀을 생성하여 SonarQube 스캔 결과를 ServiceNow 인스턴스에 저장합니다.
      • SONAR_HOST_URL: SonarQube 인스턴스 URL. 예: https://sonarcloud.io
      • SONAR_PROJECT_KEY: SonarQube 인스턴스에서 프로젝트를 식별하는 키입니다. 예: org.examples:demo
    • 워크플로우에서 ServiceNow DevOps SonarQube 사용자 지정 작업을 구성합니다.

      사용자 지정 작업 servicenow-devops-snaruses 키워드를 사용하여 워크플로우의 작업 단계 수준에서 구성해야 합니다. SonarQube 분석 결과를 ServiceNow 인스턴스에 저장하기 위해 이 사용자 지정 작업의 입력을 변조해서는 안 됩니다. 자세한 내용은 ServiceNow DevOps Sonar 문서를 참조하십시오.

    ServiceNow DevOps 테스트 보고서 사용자 지정 작업

    인스턴스에서 실행되는 ServiceNow 워크플로우에 의해 시작된 프로젝트의 단위 테스트 결과를 저장합니다. ServiceNow DevOps 테스트 보고서 사용자 지정 작업은 워크플로우의 작업 단계 수준에서 사용해야 합니다.

    다음으로 이동하여 인스턴스에 저장된 ServiceNow 단위 테스트 결과를 봅니다. DevOps > 테스트 결과 > 테스트 요약.

    다음으로 이동하여 볼 수도 있습니다. DevOps > 오케스트레이션 > 작업 실행 을 클릭하고 관련 작업 실행 기록을 클릭합니다.

    사용자 지정 작업을 사용하려면 다음 작업을 수행합니다.
    • 리포지토리에 비밀을 GitHub 생성합니다.
    • DevOps 워크플로우에서 테스트 보고서 사용자 지정 작업을 구성합니다.

      사용자 지정 작업 servicenow-devops-test-reportuses 키워드를 사용하여 워크플로우의 작업 단계 수준에서 구성해야 합니다. 단위 테스트 결과를 ServiceNow 인스턴스에 저장하기 위해 이 사용자 지정 작업의 입력을 변조해서는 안 됩니다. 자세한 내용은 ServiceNow DevOps 테스트 보고서를 참조하십시오.

    ServiceNow DevOps 아티팩트 등록 사용자 지정 작업

    인스턴스에서 실행되는 ServiceNow 워크플로우에 의해 작성되거나 배포된 아티팩트를 저장합니다. ServiceNow DevOps 아티팩트 등록 사용자 지정 작업은 워크플로우의 작업 단계 수준에서 사용합니다.

    다음으로 이동하여 인스턴스에 저장된 아티팩트 상세 정보를 봅니다. DevOps > 아티팩트 > 아티팩트.

    사용자 지정 작업을 사용하려면 다음 작업을 수행합니다.
    • 리포지토리에 비밀을 GitHub 생성합니다.
    • 워크플로우에서 아티팩트 등록 사용자 지정 작업을 구성합니다 ServiceNow DevOps .

      사용자 지정 작업 servicenow-devops-register-artifactuses 키워드를 사용하여 워크플로우의 작업 단계 수준에서 구성해야 합니다. 인스턴스에 아티팩트 상세 정보를 저장하기 위해 이 사용자 지정 작업의 입력을 변조해서는 안 됩니다. 자세한 내용은 ServiceNow DevOps 레지스터 아티팩트를 참조하세요.

    ServiceNow DevOps 패키지 등록 사용자 지정 작업

    인스턴스에서 실행되는 워크플로우로 만들거나 배포한 ServiceNow 패키지를 저장합니다. ServiceNow DevOps 패키지 등록 사용자 지정 작업은 워크플로우의 작업 단계 수준에서 사용합니다.

    로 이동하여 인스턴스에 저장된 ServiceNow 패키지 상세 정보를 봅니다. DevOps > 아티팩트 > 패키지.

    사용자 지정 작업을 사용하려면 다음 작업을 수행합니다.
    • 리포지토리에 비밀을 GitHub 생성합니다.
    • 워크플로우에서 아티팩트 등록 사용자 지정 작업을 구성합니다 ServiceNow DevOps .

      사용자 지정 작업 servicenow-devops-register-packageuses 키워드를 사용하여 워크플로우의 작업 단계 수준에서 구성해야 합니다. 인스턴스에 아티팩트 상세 정보를 저장하기 위해 이 사용자 지정 작업의 입력을 변조해서는 안 됩니다. 자세한 내용은 ServiceNow DevOps 등록 패키지를 참조하십시오.

    ServiceNow DevOps 변경 자동화 사용자 지정 작업

    인스턴스에 변경 요청을 ServiceNow 만들어 인스턴스에서 실행되는 ServiceNow 워크플로우를 일시 중지하고 다시 시작합니다.

    워크플로우의 ServiceNow DevOps 작업 단계 수준에서 자동화 변경 사용자 지정 작업을 사용합니다. 임계치(changeCreationTimeOut)에 지정된 기간 내에 변경이 생성되지 않고 abortOnChangeCreationFailure 매개변수가 활성화된 경우 파이프라인이 중단됩니다.

    이 사용자 지정 작업은 에서 ServiceNow변경 요청을 작성하고, 변경 제어 옵션을 활성화하며, 변경이 승인 또는 거부되거나 시간 제한 임계치(시간 제한)에 도달할 때까지 변경 상태에 대해 정의된 시간 간격으로 인스턴스를 폴링 ServiceNow 합니다. GitHub 시간 제한 임계치에 도달하고 abortOnChangeStepTimeout 매개변수가 활성화되면 워크플로우 실행을 중단합니다. GitHub 작업 콘솔 - 변경 단계 시간 제한

    이 사용자 지정 작업은 파이프라인에 대한 영수증 변경이 활성화되면 인스턴스에서 변경이 승인되거나 거부 ServiceNow 될 때까지 기다리지 않고 워크플로우 ServiceNow 실행을 즉시 재개합니다.

    로 이동하여 인스턴스에서 실행되는 ServiceNow 워크플로우에 대해 작성된 변경 사항을 봅니다. DevOps > 오케스트레이션 > 파이프라인 변경 요청.

    인스턴스에서 변경 상태를 폴링하는 ServiceNow 동안 상태 pending_decision 있는 변경 번호가 작업 콘솔에 표시됩니다GitHub. 인스턴스에서 사용자가 ServiceNow 변경을 승인하거나 거부 또는 취소한 후에는 변경 코멘트, 승인자, 승인 날짜 및 상태와 같은 상세 정보가 작업 콘솔에 기록됩니다GitHub. GitHub Actions 콘솔 - 변경 승인됨

    파이프라인의 콘솔 로그로 이동하여 변경 요청의 상태를 볼 수 있습니다. 변경 요청이 생성되면 폴링 시간 간격에 따라 변경 세부 정보가 표시됩니다. 변경 요청 상태와 연결된 정책 조건도 평가되어 로그에 표시됩니다. 예를 들어 DevOps 변경 요청 고급 자동화 정책이 활성화되면 정책 조건이 평가되고 해당 결정(자동 승인/자동 거부/수동 승인)이 로그에 표시됩니다.

    다음 변경 요청 정보가 표시됩니다.
    • 번호
    • 상세 정보
    • 상태
    • sys_id
    • 유형
    • 위험
    • 우선순위
    • changeState
    • plannedStartDate
    • plannedEndDate
    • changeRequestURL

    GitHub 파이프라인 콘솔 로그의 상태 변경

    주:
    changeState 는 변경 요청의 상태이고 status 는 단계 실행의 상태입니다.
    기본 시스템 변경 플로우에 대해 정책 조건에 대한 로그가 다음과 같이 표시됩니다.
    • DevOps 모델 변경 정책: 변경 생성 시 및 변경 상태가 업데이트될 때 로그만 표시됩니다.
    • DevOps 변경 요청 최소 자동화 정책: 변경 결정에 해당하는 변경 결정 및 정책 조건과 함께 로그가 표시됩니다.
    • DevOps 변경 요청 고급 자동화 정책: 변경 결정에 해당하는 변경 결정 및 정책 조건과 함께 로그가 표시됩니다.
    변경 정책 입력 및 결정 조건은 결정 [sys_decision_question] 테이블에 저장됩니다. 다음 필드와 연산자가 정책 조건의 입력으로 사용되는 경우 로그가 표시됩니다.
    필드
    • code_coverage
    • commits_without_work_item
    • integration_tests_failed
    • load_tests_failed
    • regression_tests_failed
    • num_of_outages_in_last_7_days
    • num_of_current_outages
    • num_of_open_incidents
    • total_num_of_commits
    • tests_passing_percent
    • 위험
    • code_security
    • 커밋
    연산자
    • <=
    • >=
    • !=
    • =
    • <
    • >
    • ISNOTEMPTY
    • 비어 있음
    • 사이
    • 아무것도
    • 은사메스
    • 동일
    • GT_FIELD
    • LT_FIELD
    주:
    변경 정책에서 기본 시스템 필드 이외의 필드가 수정되는 경우, 정책 조건을 평가하려면 해당 필드를 플로우에 수동으로 추가해야 합니다.
    사용자 지정 작업을 사용하려면 다음 작업을 수행합니다.
    • 리포지토리에 비밀을 GitHub 생성합니다.
    • 워크플로우에서 변경 자동화 사용자 지정 작업을 구성합니다 ServiceNow DevOps .

      사용자 지정 작업 servicenow-devops-changeuses 키워드를 사용하여 워크플로우의 작업 단계 수준에서 구성해야 합니다. 인스턴스에서 변경을 생성하고 초 수마다 변경 상태를 폴링하기 위해 이 사용자 지정 작업의 입력을 변조해서는 안 됩니다. 자세한 내용은 ServiceNow DevOps 변경 자동화 섹션을 참조하세요.

    ServiceNow DevOps 변경 사항 GitHub 작업 가져오기

    특정 변경 세부 정보에 따라 GitHub Actions 파이프라인에서 변경 요청 번호를 검색합니다.

    변경 상세 정보를 지정하여 ServiceNow 인스턴스에서 변경 요청 번호를 검색하려면 ServiceNow DevOps 변경 Github 작업 가져오기 사용자 지정 작업을 파이프라인 작업의 단계 수준에서 추가해야 합니다.

    ServiceNow DevOps 업데이트 변경 Github 작업

    GitHub Actions 파이프라인과 연결된 변경 요청 상세 정보를 업데이트합니다.

    ServiceNow 인스턴스에서 변경 요청을 업데이트하려면 ServiceNow DevOps 변경 업데이트 Github 작업 사용자 지정 작업을 파이프라인 작업의 단계 수준에서 추가해야 합니다. 상세 정보를 업데이트해야 하는 변경 요청 번호와 업데이트할 변경 요청 상세 정보를 입력으로 지정해야 합니다.

    ServiceNow DevOps 보안 결과 작업

    ServiceNow에서 보안 스캔 결과를 검색합니다.

    ServiceNow에서 보안 검사 결과를 검색하려면 ServiceNow DevOps 보안 결과 작업 사용자 지정 작업을 파이프라인 작업의 단계 수준에서 추가해야 합니다.