의 일반적인 오류 DevOps 변경 속도

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 15분

    • 에서 DevOps 변경 속도발생하는 오류의 근본 원인을 식별하고 이를 해결할 수 있는 해당 단계를 확인합니다.

    도구 연결

    다음 표에는 도구 연결 프로세스에서 도구 세부 정보를 입력한 후 제출 또는 연결 단추를 선택할 때 발생할 수 있는 오류를 해결하는 데 필요한 단계가 나열되어 있습니다.

    메시지 작업
    도구 이름을 입력하지 않았기 때문에 도구를 생성할 수 없습니다. 도구 이름을 입력하고 다시 시도하십시오. 도구 이름을 다시 입력합니다.
    도구 통합이 선택되지 않았기 때문에 도구를 생성할 수 없습니다. 올바른 도구 통합 값을 선택하고 다시 시도하십시오. 올바른 도구 통합 값을 선택합니다.
    도구 URL이 유효하지 않거나 잘못되었기 때문에 도구를 생성할 수 없습니다. 도구 URL을 다시 입력하고 다시 시도하십시오. 도구 URL을 다시 입력합니다.
    플랫폼 버전을 확인할 수 없으므로 도구를 생성할 수 없습니다. glide.buildtag.last 시스템 속성을 생성하고 다시 시도하십시오.
    1. 다음으로 이동 DevOps > 관리 > 속성.
    2. glide.buildtag.last sys 속성이 있는지 확인합니다.
    3. 그렇지 않은 glide.buildtag.last sys 경우 속성을 생성합니다.
    연결된 CreateDevOps 도구 연결이 잘못되어 도구를 생성할 수 없습니다. 올바른 연결 별칭을 생성하고 다시 시도하십시오.
    1. 다음으로 이동 모든 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭 을 클릭하고 CreateDevOpsTool 기록을 엽니다.
    2. 연결 관련 목록에서 기록을 생성하고 연결 이름을 입력합니다.
    3. 연결 양식에서 자격 증명 필드 조회 목록을 선택한 다음 새로 만들기를 선택하여 관리자 자격 증명을 만듭니다.
    4. 기본 인증 자격 증명을 선택하고 이름을 입력합니다.
    5. 관리자 사용자 이름 및 암호를 입력합니다(DevOps 환경의 도구에 액세스하는 데 필요).

      connection_admin 역할을 가진 사용자는 HTTP 연결을 구성할 수 있습니다.

    6. 연결 양식에서 연결 URL에 https://<instance name>.service-now.com/ 을 입력합니다.
    CreateDevOpsTool 별칭 자격 증명이 잘못되었기 때문에 도구를 생성할 수 없습니다. 자격 증명 기록을 업데이트하고 다시 시도하십시오.
    1. 메시지에서 자격 증명 기록 링크를 선택합니다. 작업 영역 UI에서 도구에 연결하는 경우 자격 증명 기록 링크를 마우스 오른쪽 단추로 클릭하고 새 탭에서 열기를 선택합니다.
    2. 자격 증명 기록 페이지에서 사용자 이름 및 암호 필드에 올바른 자격 증명을 입력합니다.
    3. 변경 내용을 저장하고 도구에 대한 연결을 다시 시도합니다.
    CreateDevOpsTool 별칭의 연결 URL이 잘못되었기 때문에 도구를 생성할 수 없습니다. https://<instancename>.service-now.com URL을 사용하고 다시 시도하십시오.
    1. 다음으로 이동 모든 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭 을 클릭하고 CreateDevOpsTool 기록을 엽니다.
    2. 연결 양식에서 연결 URL에 https://<instance name>.service-now.com/ 을 입력합니다.
    연결 별칭을 생성하려면 connection_admin 역할이 필요합니다. 시스템 관리자에게 문의하십시오. 이 오류는 도구 기록에 대한 연결 별칭 필드가 비어 있는 경우에 발생합니다. 도구 연결을 생성하려면 연결 별칭이 필요합니다. 역할이 있는connection_admin 사용자만 연결 별칭을 만들 수 있습니다. 관리자와 같이 이 역할을 가진 사용자에게 연락하여 생성된 연결 별칭을 가져와야 합니다.
    <toolname> 도구 이름이 이미 있기 때문에 도구를 생성할 수 없습니다. 다른 이름을 입력하고 다시 시도하십시오. 도구에 다른 이름을 사용합니다.
    <toolname>에 유효한 MID 서버 구성이 없으므로 도구를 생성할 수 없습니다. 올바른 MID 서버를 구성하고 다시 시도하십시오.
    1. 작업 공간을 사용하는 경우 MID 서버가 실행 중이고 연결할 수 있는지 확인합니다.
    2. 카탈로그 및 기록 생성자를 사용하는 경우 애플리케이션이 DevOps로, 역량이 REST인 MID Server가 실행 중이고 연결할 수 있는지 확인합니다.
    DevOps Data Model 범위에 사용할 수 있는 연결 및 자격 증명 별칭이 없기 때문에 도구를 생성할 수 없습니다. 새 연결 및 자격 증명 별칭을 생성하고 다시 시도하십시오.

    이 오류는 OAuth 인증에 대해 발생합니다.

    1. 다음으로 이동 모든 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭.
    2. 애플리케이션을 DevOps Data Model로 사용하여 새 별칭을 생성합니다.
    자격 증명 기록을 만드는 동안 기술적인 문제로 인해 도구를 만들 수 없습니다.
    1. 다음으로 이동 모든 > 프로세스 자동화 > 플로우 디자이너 > 실행.
    2. 오류의 세부 정보를 알아보려면 sn_devops.devops_create_credentials 하위 플로우의 최신 실행을 확인합니다.
    활성 기록에 대한 자격 증명 및 도메인 조합이 이미 있으므로 도구를 만들 수 없습니다.

    이 오류는 OAuth 인증에 대해 발생합니다.

    1. 다른 자격 증명을 사용합니다.
    2. 활성 연결에서 기존 자격 증명을 사용하는지 확인합니다.
    연결 기록을 생성하는 동안 기술적인 문제로 인해 도구를 생성할 수 없습니다.
    1. 다음으로 이동 모든 > 프로세스 자동화 > 플로우 디자이너 > 실행.
    2. 작업의 최신 실행을 sn_devops.create_connection_for_tool 확인하여 오류의 세부 정보를 확인합니다.
    도구를 생성할 수 없는 이유는 다음과 같습니다.
    • 확인 하위 플로우가 구성되지 않았으며
    • 연결된 도구 통합에 대해 하위 플로우 이름이 같은 통합 역량 기록이 없습니다.
    하위 플로우를 구성하고 검증 작업 및 도구 통합을 위한 하위 플로우 이름을 사용하여 통합 역량 기록을 생성한 후 다시 시도하십시오.

    이 오류는 사용자 지정 도구 통합에 대해서만 발생합니다.

    1. 다음으로 이동 모두 > 프로세스 자동화 > Flow Designer.
    2. 플로우 디자이너 페이지에서 하위 플로우 탭을 선택합니다.
    3. 목록에서 DevOps 데모 확인 하위 플로우 기록을 엽니다.
    4. 작업 섹션에서 작업 디자이너에서 작업 열기(작업 디자이너에서 작업 열기 아이콘) 아이콘을 선택하여 DevOps 데모 확인 작업 기록을 엽니다.
    5. 추가 작업 메뉴 > 복사 작업을 선택합니다.복사 작업 대화 상자
    6. 작업의 새 이름을 입력하고 애플리케이션을 DevOps 통합으로 선택한 다음 복사를 선택합니다.
    7. 복사된 작업에서 입력 > REST 단계를 선택합니다.
    8. 요청 상세 정보 섹션에서 자원 경로 필드에 사용자 지정 도구의 자원 경로를 입력합니다.작업 확인 화면
    9. 쿼리 매개변수 필드에 사용자 지정 도구의 API 버전을 입력합니다.
    10. 변경 내용을 저장합니다.
    11. 게시를 선택하여 작업을 게시합니다.
    12. DevOps 데모 하위 플로우 확인 기록으로 다시 이동합니다.
    13. 하위 플로우 복사> 추가 작업 메뉴를 선택합니다.
    14. 하위 플로우의 새 이름을 입력하고 애플리케이션을 DevOps 통합으로 선택한 후 복사를 선택합니다.
    15. 복사한 하위 플로우에서 DevOps 데모 작업 확인 작업을 삭제하고 11단계에서 생성한 작업을 추가합니다.새 작업 기록 추가
      1. 작업 필드에서 11단계에서 생성한 작업을 선택합니다.
      2. aliasGR 필드의 데이터 > 조회 기록 섹션에서 연결 및 자격 증명 별칭 기록을 선택합니다.
      3. API 버전 필드의 데이터 > 하위 플로우 입력 섹션에서 API 버전을 선택합니다.
      4. 변경 내용을 저장합니다.
    16. 게시를 선택하여 하위 플로우 를 게시합니다.
    17. 다음으로 이동 DevOps > 통합 > 통합 기능 을 클릭하고 유효성 검사 작업을 사용하여 기록을 생성합니다.

      자세한 내용은 DevOps 도구 통합 생성을 참조하십시오.

      통합 역량 관련 탭
    18. 16단계에서 생성한 하위 플로우를 통합 역량 기록과 연결합니다.
    연결 문제로 인해 도구를 생성할 수 없습니다. <validate_subflow_name> 하위 플로우에서 자세한 내용을 확인하고 다시 시도하십시오.
    1. 다음으로 이동 모든 > 프로세스 자동화 > 플로우 디자이너 > 실행.
    2. 오류의 세부 정보를 알아보려면 하위 플로우의 최신 실행을 검사<validate_subflow_name>.
    도구 인증 자격 증명이 잘못되었습니다. 올바른 자격 증명을 입력하고 다시 시도하십시오. 도구의 올바른 사용자 이름/암호를 다시 입력합니다.
    서버에서 받은 응답이 없으므로 도구를 생성할 수 없습니다. 올바른 도구 URL을 입력하거나 서버가 실행 중인지 확인하고 다시 시도하십시오.
    1. 도구 URL을 다시 입력합니다.
    2. MID 서버를 확인합니다.
    연결 URL이 잘못되었습니다. 확인하십시오.

    URL을 입력하고 다시 시도하십시오.

    		 도구 URL을 다시 입력합니다.
    GitHub 앱 슬러그 이름이 잘못되었기 때문에 도구를 연결할 수 없습니다. 올바른 GitHub 앱 슬러그 이름을 입력하고 다시 시도하십시오. 앱의 설정 페이지에서 앱 슬러그 이름을 찾을 GitHub 수 있습니다GitHub. GitHub 앱 슬러그 이름은 URL 친화적인 앱 이름입니다GitHub. 예를 들어 Test App이라는 이름으로 앱을 만든 GitHub 경우 해당 URL 친화적인 GitHub 앱 슬러그 이름은 test-app이 됩니다. GitHub URL - "https://github.com/settings/apps/test-app"에서 "test-app"은 GitHub 앱 슬러그 이름입니다. 자세한 내용은 GitHub 설명서를 참조하십시오.
    암호 값이 너무 길어서 암호화 후 잘릴 수 있습니다. 암호 길이를 줄이거나 필드 크기를 늘려 주십시오. 2023년 1월 18일부터 Jira는 Atlassian 계정에 대한 API 토큰의 길이를 연장했습니다. 확장된 문자 길이를 수용하려면 discovery_credentials 테이블에서 최대 암호 값을 255를 초과하도록 늘려야 합니다. 자세한 내용은 KB1269878 kb 문서 및 Atlassian 문서를 참조하세요.
    원격 호스트에서 예기치 않은 동작: 'https://bitbucket.org/account/signin/?next=%2F...%2Frest%2Fapi%2F1.0%2Fusers'으로 순환 리디렉션됩니다. BitBucket 클라우드 인스턴스에 연결하려고 할 때 이 오류가 발생할 수 있습니다. BitBucket 클라우드는 지원되지 않습니다. ServiceNow DevOps에 연결하려면 BitBucket 서버 인스턴스를 사용해야 합니다. MID 서버를 통해 BitBucket 인스턴스에 연결합니다. 도구 인스턴스가 온프레미스에서 호스팅되는 경우 MID 서버가 필요합니다. MID 서버에 대한 자세한 내용은 MID 서버 선택을 참조하십시오.
    도구 URL의 불일치: ServiceNow에 입력한 도구 URL: https://<입력한 Jenkins 인스턴스의 URL입니다> Jenkins에 입력한 도구 URL: https://<Jenkins에 입력한 Jenkins 위치 URL입니다> Jenkins의 Jenkins > 시스템 관리에서 구성된 Jenkins URL이 여기에 입력한 도구 URL과 동일한지 확인합니다. 온보딩 오류 문제 해결 도구를 참조하십시오.

    이 오류는 입력한 DevOps URL이 인스턴스에 입력한 Jenkins URL과 다를 Jenkins 때 Jenkins 발생합니다.

    Jenkins 인스턴스에서 다음으로 이동합니다. Jenkins 관리 > 시스템 > Jenkins 위치. 여기에 입력한 Jenkins URL은 에 DevOps입력한 Jenkins 인스턴스의 URL과 일치해야 합니다.

    도구 권한

    이 섹션에는 작업 공간 플레이북을 사용하여 DevOps 도구를 생성할 때 도구 권한 오류를 해결하는 데 필요한 단계가 나열되어 있습니다. 도구 권한 검사 지침은 작업 공간에서 도구에 연결할 때 팝업에 표시됩니다.

    작업

    누락된 권한이 있는 경우 다음 단계를 수행합니다.

    • 외부 DevOps 도구에서 제공된 자격 증명에 대한 권한을 업데이트합니다. 팝업에서 새로 고침 을 선택하여 검사를 다시 수행합니다.
    • 팝업을 닫고 다른 자격 증명을 사용한 다음 연결을 다시 선택합니다. 새로 입력한 자격 증명의 결과와 함께 권한 점검 팝업이 나타납니다.
    • 영향도 열을 검토하고 영향이 사용 사례에 영향을 주지 않는 경우 계속 을 선택합니다.
    모든 권한 점검에 성공한 경우:
    • 플레이북의 다음 단계로 진행하려면 계속 을 선택합니다.
    • 결과에 오류가 표시되면 새로 고침을 선택하여 다시 시도합니다.
    • 오류가 지속되면 기록당 도구 권한 검사 시간 제한(밀리초) 속성을 업데이트하고 다시 시도하십시오.
    도구 권한 점검 시간 제한 속성

    도구 연결 프로세스 중에 시스템은 포그라운드에서 권한 확인을 수행하고 도구 연결 페이지를 제한합니다. 모든 권한 유효성 검사에 대해 외부 도구에 대한 REST API 호출이 수행되어 권한의 가용성을 평가합니다. REST API 응답시간은 네트워크 설정에 따라 다를 수 있습니다. 지연을 방지하기 위해 권한을 오류로 표시하기 전에 시스템이 외부 도구에서 응답을 받기 위해 대기해야 하는 시간을 지정할 수 있습니다. 기록당 도구 권한 검사 시간 초과(밀리초) 속성을 (sn_devops.permission_check_timeout)사용하여 이 시간을 지정할 수 있습니다 . 일부 권한 검사로 인해 오류가 발생한 경우 시간 제한 값을 늘리고 권한 팝업에서 새로 고침 을 선택합니다.

    도구 알림

    이 표에는 커밋 세부 정보, 파이프라인 실행 세부 정보, 끌어오기 요청 세부 정보, 테스트 요약 검색과 같은 시나리오에서 발생할 수 있는 오류를 해결하는 데 필요한 단계가 나열되어 있습니다.

    이유 작업
    인증 자격 증명이 잘못되었거나 필요한 최소 권한이 없습니다.
    • 외부 공급업체 도구 자격 증명에 필요한 범위가 있는지 확인합니다. 작업 공간 UI를 사용하는 경우 도구 기록으로 이동하여 추가 작업( 추가 작업 아이콘) > 자격 증명 사용 권한 확인 필요한 권한에 대해 알아봅니다.
    • 외부 공급업체 도구에 대해 올바른 사용자 이름/암호를 입력했는지 확인합니다. 작업 공간 UI를 사용 중이고 도구 자격 증명을 업데이트하려면 도구 기록으로 이동하여 추가 작업( 추가 작업 아이콘) > 자격 증명 사용 권한 확인. 자격 증명 업데이트에 대한 자세한 내용은 다음 문서를 참조하십시오 에서 외부 공급업체 도구 자격 증명 업데이트 DevOps 변경 속도.
    서버에서 응답이 없습니다. 서버 연결 상태를 확인하고 다시 시도하십시오.
    • DevOps 도구 서버에 연결할 수 있고 응답성이 있는지 확인합니다.
    • MID 서버가 구성된 경우 서버가 실행 중인지 확인합니다.
    요청을 처리할 수 없습니다. 웹후크와 연결된 최대 인스턴스 수를 초과했는지 확인합니다. GitHub에서 이 오류가 발생한 경우 웹후크에 20개 이상의 인스턴스를 연결했는지 확인합니다.
    권한 부여 자격 증명에 필요한 최소 권한이 없습니다. 외부 공급업체 도구 자격 증명에 필요한 범위가 있는지 확인합니다. 작업 공간 UI를 사용하는 경우 도구 기록으로 이동하여 추가 작업( 추가 작업 아이콘) > 자격 증명 사용 권한 확인 필요한 권한에 대해 알아봅니다.
    MID 서버 구성이 잘못되었습니다. 올바른 MID 서버를 구성하고 다시 시도하십시오. MID 서버가 실행 중이고 연결할 수 있는지 확인합니다.
    연결 URL이 잘못되었습니다. 올바른 URL을 입력하고 다시 시도하십시오.
    1. 다음으로 이동 모든 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭 필요한 연결 및 자격 증명 기록을 엽니다.
    2. 연결 관련 목록에서 관련 연결 양식을 엽니다.
    3. 연결 양식에서 외부 공급업체 도구의 연결 URL이 올바른지 확인합니다.
    요율 제한을 초과했습니다. {0} 후 다시 시도하십시오.

    속도 제한은 지정된 기간 내에 앱 또는 사용자가 수행할 수 있는 API 호출 수입니다. 속도 제한은 네트워크 트래픽을 제한하여 사용자가 시스템 자원을 소진하지 않도록 하는 기술입니다. 타사 도구에서 허용하는 최대 속도 제한을 초과하면 이 오류가 발생할 수 있습니다.
    자격 증명에 필요한 범위가 없습니다. 외부 공급업체 도구 자격 증명에 필요한 범위가 있는지 확인합니다. 작업 공간 UI를 사용하는 경우 도구 기록으로 이동하여 추가 작업( 추가 작업 아이콘) > 자격 증명 사용 권한 확인 필요한 권한에 대해 알아봅니다.

    변경 요청

    이 테이블에는 변경 요청을 만드는 동안 발생할 수 있는 오류를 해결하는 데 필요한 단계가 나열되어 있습니다.

    오류 작업
    유형 호환성 플래그가 비활성화되어 있으므로 변경 요청을 생성할 수 없습니다. 시스템 속성에서 유형 호환성 플래그를 활성화하거나, ServiceNow의 단계 기록에서 변경 모델을 구성하거나, 파이프라인에 적절한 변경 모델 시스템 ID를 입력합니다.
    • 모든 > 시스템 속성으로 이동하여 속성을 활성화 com.snc.change_management.change_model.type_compatibility 하거나,
    • 단계 양식에 변경 모델을 추가하거나 파이프라인의 속성을 변경합니다.
    파이프라인에 대해 변경 유형 또는 변경 모델이 구성되지 않아 변경 요청을 생성할 수 없습니다. 변경 모델을 추가하거나 단계 양식에 입력하거나 파이프라인의 속성을 변경합니다.

    일반 오류

    이 테이블에는 DevOps 변경 속도 애플리케이션을 사용하는 동안 발생할 수 있는 몇 가지 일반적인 오류를 해결하는 데 필요한 단계가 나열되어 있습니다.

    문제 작업
    임포트 요청이 진행되지 않음

    도구(예: Jenkins Jira또는 GitHub )에 대한 임포트를 수행하는 동안 임포트 요청이 요청됨 상태로 너무 오랫동안 유지되는 경우 임포트 요청을 삭제하고 다시 시도하십시오.

    주:
    기존 요청을 삭제하여 동일한 범위 임포트를 다시 시도하십시오.
    도구 연결 실패

    HTTP 연결 양식의 연결 URL 필드에서 후행 슬래시('/')를 제거하십시오.
    변경 통제 하에 있는 작업에 대해 변경 요청이 생성되지 않습니다.Jenkins 다음을 확인합니다.
    • 인스턴스의 도구 통합이 올바르게 설정되었는지 여부
    • 작업이 인스턴스에서 동기화되었습니다.
    • 인스턴스에 작업 및 앱 단계가 구성되어 있어야 합니다.
    작업이 변경 제어 하에 있는 경우 변경 요청 생성이 지원되지 않습니다.
    • 파이프라인의 일부가 아닙니다(예: 독립 실행형 작업).
    • 파이프라인의 첫 번째입니다.
    • 파이프라인 내에 있지만 사용자가 수동으로 트리거하거나 SCM이 변경 제어 중인 작업에 대해 직접 체크 아웃하므로 처음부터 파이프라인을 트리거하지 않습니다.
    Jenkins 변경 제어 중인 작업을 차단하지 않음(변경 요청 승인을 기다리지 않음)

    위치가 다음과 같이 Jenkins 구성되어 있는지 확인합니다.

    다음으로 이동 젠킨스 > Jenkins 관리 > 시스템 구성 을 클릭하고 위치 섹션에서 Jenkins URL 필드의 Jenkins 호스트 이름을 제공합니다.

    주:
    캐싱 문제를 방지하려면 양식을 처음 열 때 Jenkins URL 필드에 이미 값이 포함되어 있어도 저장을 클릭하십시오.
    페이로드 로그에서 연결되지 않음 상태로 발생한 이벤트
    수동 구성 모드를 사용하여 수동으로 연결을 변경하면 연결이 자동으로 끊어집니다.
    • 도구와 관련된 별칭
    • 도구 유형
    • 별칭에 추가된 동일한 도메인에 대한 새 활성 HTTP 연결
    • 동일한 도메인에 대한 기존 HTTP 연결이 활성화됨
    • HTTP 연결의 연결 URL
    • HTTP 연결의 자격 증명
    • HTTP 연결에서 설정 사용 MID 서버

    수동 구성 모드로 들어가 다시 연결합니다.
    REST API TimeoutException/FlowObjectAPIException으로 인해 실패하거나 오류가 발생한 인바운드 이벤트 재시도
    Retry Errored Inbound Events 예약된 작업을 업데이트하여 상태에 있는 Error 인바운드 이벤트 처리를 다시 시도합니다.
    • 오류 또는 예외 목록을 업데이트하여 이벤트 처리를 재시도할 예외를 지정합니다.
    • 기본 Maximum Retry 개수를 수정합니다.
    자세한 내용은 오류가 발생한 인바운드 이벤트 다시 시도 문서를 참조하십시오.

    SonarQube ServiceNow DevOps 도구가 없기 때문에 SonarQube 스캔이 발생하지 않으므로 파이프라인 실행이 진행되지 않고 무기한 대기합니다.

    소프트웨어 품질 인바운드 이벤트는 처리 상세 정보 필드에 다음 오류 메시지를 표시합니다. "각 SonarQube 도구가 성공적으로 생성되었는지 확인하십시오. 그렇지 않은 경우 SonarQube 도구를 만들고 인바운드 이벤트를 다시 시도합니다."

    코드 품질 검사의 모든 SonarQube 단계에 대해 사용자는 인스턴스에서 SonarQube 도구를 ServiceNow DevOps 만들어야 합니다.

    자세한 내용은 SonarQube 및 DevOps 변경 속도 통합 문서를 참조하십시오.
    파이프라인 UI는 스테이지 간의 끊어진 링크를 표시합니다. 작업 실행으로 이동하여 업스트림 실행 열에 적절한 업스트림 링크 참조가 있는지 확인합니다.