의 일반 오류 DevOps 변경 속도

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

공구 연결

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

메시지	작업
도구 이름을 입력하지 않았기 때문에 도구를 생성할 수 없습니다. 도구 이름을 입력하고 다시 시도하십시오.	도구 이름을 다시 입력합니다.
도구 통합이 선택되지 않았기 때문에 도구를 생성할 수 없습니다. 올바른 도구 통합 값을 선택하고 다시 시도하십시오.	올바른 도구 통합 값을 선택합니다.
도구 URL이 유효하지 않거나 잘못되었기 때문에 도구를 생성할 수 없습니다. 도구 URL을 다시 입력하고 다시 시도하십시오.	도구 URL을 다시 입력합니다.
플랫폼 버전을 확인할 수 없으므로 도구를 생성할 수 없습니다. glide.buildtag.last sys 속성을 생성하고 다시 시도하십시오.	DevOps > 관리 > 속성으로 이동합니다. 속성이 glide.buildtag.last sys 있는지 확인합니다. 그렇지 않은 경우 속성을 만듭니다 glide.buildtag.last sys .
연결된 CreateDevOps 도구 연결이 잘못되어 도구를 생성할 수 없습니다. 올바른 연결 별칭을 만들고 다시 시도하십시오.	모든 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭으로 이동하여 CreateDevOpsTool 기록을 엽니다. 연결 관련 목록에서 기록을 생성하고 연결의 이름을 입력합니다. 연결 양식에서 자격 증명 필드 조회 목록을 선택한 다음, 새로 만들기 를 선택하여 관리자 자격 증명을 만듭니다. 기본 인증 자격 증명을 선택하고 이름을 입력합니다. 관리자 사용자 이름 및 암호를 입력합니다(DevOps 환경의 도구에 액세스하는 데 필요). connection_admin 역할을 가진 사용자는 HTTP 연결을 구성할 수 있습니다. 연결 양식에서 연결 URL에 https://<instance name>.service-now.com/ 을 입력합니다.
CreateDevOpsTool 별칭 자격 증명이 잘못되었기 때문에 도구를 생성할 수 없습니다. 자격 증명 기록을 업데이트하고 다시 시도하십시오.	메시지에서 자격 증명 기록 링크를 선택합니다. 작업 영역 UI에서 도구에 연결하는 경우 자격 증명 레코드 링크를 마우스 오른쪽 단추로 클릭하고 새 탭에서 열기를 선택합니다. 자격 증명 기록 페이지의 Username(사용자 이름 ) 및 Password(암호 ) 필드에 올바른 자격 증명을 입력합니다. 변경 내용을 저장하고 도구에 다시 연결해 보십시오.
CreateDevOpsTool 별칭의 연결 URL이 잘못되어 도구를 생성할 수 없습니다. https://<instancename>.service-now.com URL을 사용하여 다시 시도하십시오.	모든 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭으로 이동하여 CreateDevOpsTool 기록을 엽니다. 연결 양식에서 연결 URL에 https://<instance name>.service-now.com/ 을 입력합니다.
연결 별칭을 만들려면 connection_admin 역할이 필요합니다. 시스템 관리자에게 문의하십시오.	이 오류는 도구 기록에 대한 연결 별칭 필드가 비어 있는 경우에 발생합니다. 도구 연결을 생성하려면 연결 별칭이 필요합니다. 해당 역할이 있는 사용자만 연결 별칭을connection_admin 만들 수 있습니다. 관리자와 같은 이 역할을 가진 사용자에게 연락하여 연결 별칭을 생성해야 합니다.
<toolname> 도구 이름이 이미 있기 때문에 도구를 생성할 수 없습니다. 다른 이름을 입력하고 다시 시도하십시오.	도구에 다른 이름을 사용합니다.
<toolname>에 유효한 MID 서버 구성이 없으므로 도구를 생성할 수 없습니다. 올바른 MID 서버를 구성하고 다시 시도하십시오.	작업 공간을 사용하는 경우 MID 서버가 실행 중이고 연결할 수 있는지 확인합니다. 카탈로그 및 기록 생성자를 사용하는 경우 MID 서버가 실행 중이고 애플리케이션이 DevOps이고 역량이 REST인 상태에서 연결할 수 있는지 확인합니다.
DevOps Data Model 범위에 사용할 수 있는 연결 및 자격 증명 별칭이 없기 때문에 도구를 생성할 수 없습니다. 새 연결 및 자격 증명 별칭을 생성하고 다시 시도하십시오.	이 오류는 OAuth 인증에 발생합니다. 모든 > 연결 및 자격 증명 > 연결 및 자격 증명 별칭으로 이동합니다. 애플리케이션을 DevOps Data Model로 사용하여 새 별칭을 생성합니다.
자격 증명 기록을 만드는 동안 기술적인 문제로 인해 도구를 만들 수 없습니다.	모든 > 프로세스 자동화 > Flow Designer > 실행으로 이동합니다. 오류의 세부 정보를 확인하려면 sn_devops.devops_create_credentials 하위 플로우의 최신 실행을 확인합니다.
활성 기록에 대한 자격 증명 및 도메인 조합이 이미 있으므로 도구를 만들 수 없습니다.	이 오류는 OAuth 인증에 발생합니다. 다른 자격 증명을 사용합니다. 기존 자격 증명이 활성 연결에서 사용되는지 확인합니다.
연결 기록을 생성하는 동안 기술적인 문제로 인해 도구를 생성할 수 없습니다.	모든 > 프로세스 자동화 > Flow Designer > 실행으로 이동합니다. 오류의 세부 정보를 확인하려면 작업의 최신 실행 sn_devops.create_connection_for_tool 을 확인합니다.
다음 이유로 인해 도구를 생성할 수 없습니다. 유효성 검사 하위 플로우가 구성되지 않았으며 연관된 도구 통합에 대해 하위 플로우 이름이 동일한 통합 역량 기록이 없습니다. 하위 플로우를 구성하고 검증 작업과 도구 통합을 위한 하위 플로우 이름을 사용하여 통합 역량 기록을 생성하고 다시 시도하십시오.	이 오류는 사용자 지정 도구 통합에 대해서만 발생합니다. 모두 > 프로세스 자동화 > Flow Designer로 이동합니다. 플로우 디자이너 페이지에서 하위 플로우 탭을 선택합니다. 목록에서 DevOps 데모 확인 하위 플로우 기록을 엽니다. 작업 섹션에서 작업 디자이너에서 열기 작업() 아이콘을 선택하여 DevOps 데모 확인 작업 기록을 엽니다. 복사 작업> 추가 작업 메뉴를 선택합니다. 작업의 새 이름을 입력하고 애플리케이션을 DevOps 통합으로 선택한 다음 복사를 선택합니다. 복사된 작업에서 REST 단계> 입력을 선택합니다. 요청 상세 정보 섹션에서, 자원 경로 필드에 사용자 지정 도구의 자원 경로를 입력합니다. Query Parameters(쿼리 매개변수) 필드에 사용자 지정 도구의 API 버전을 입력합니다. 변경 사항을 저장합니다. 게시를 선택하여 작업을 게시합니다. DevOps 데모 하위 플로우 확인 기록으로 다시 이동합니다. 하위 플로우 복사> 추가 작업 메뉴를 선택합니다. 하위 플로우의 새 이름을 입력하고 애플리케이션을 DevOps 통합으로 선택한 다음 복사를 선택합니다. 복사한 하위 플로우에서 DevOps 데모 확인 작업 작업을 삭제하고 11단계에서 생성한 작업을 추가합니다. 작업 필드에서 11단계에서 만든 작업을 선택합니다. aliasGR 필드의 데이터 > 조회 기록 섹션에서 연결 및 자격 증명 별칭 기록을 선택합니다. apiversion 필드의 데이터 > 하위 플로우 입력 섹션에서 API 버전을 선택합니다. 변경 사항을 저장합니다. 게시를 선택하여 하위 플로우를 게시합니다. DevOps > 통합 > 통합 기능으로 이동하고 확인 작업으로 기록을 생성합니다. 자세한 내용은 DevOps 도구 통합 생성을 참조하세요. 16단계에서 생성한 하위 플로우를 통합 역량 기록과 연결합니다.
연결 문제로 인해 도구를 생성할 수 없습니다. <validate_subflow_name> 하위 플로우에서 자세한 내용을 확인하고 다시 시도하십시오.	모든 > 프로세스 자동화 > Flow Designer > 실행으로 이동합니다. 오류의 세부 정보를 확인하려면 하위 플로우<validate_subflow_name> 최근 실행을 확인합니다.
도구 인증 자격 증명이 잘못되었습니다. 올바른 자격 증명을 입력하고 다시 시도하십시오.	도구에 대한 올바른 사용자 이름/암호를 다시 입력합니다.
서버에서 받은 응답이 없으므로 도구를 생성할 수 없습니다. 올바른 도구 URL을 입력하거나 서버가 실행 중인지 확인하고 다시 시도하십시오.	도구 URL을 다시 입력합니다. 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 Cloud 인스턴스에 연결하려고 하면 이 오류가 발생할 수 있습니다. BitBucket Cloud는 지원되지 않습니다. ServiceNow DevOps에 연결하려면 BitBucket Server 인스턴스를 사용해야 합니다. MID 서버를 통해 BitBucket 인스턴스에 연결합니다. 도구 인스턴스가 온프레미스에서 호스팅되는 경우 MID 서버가 필요합니다. MID 서버에 대한 자세한 내용은 MID 서버 선택을 참조하십시오.
Mismatch in tool URL: Tool URL entered in ServiceNow below: https://<URL of the Jenkins instance you entered> Tool URL entered in Jenkins: https://<Jenkins location URL entered in Jenkins> In Jenkins, under Manage Jenkins > System, check that your configured Jenkins URL is the same as the Tool URL entered here. See the troubleshooting tool on-boarding errors.	이 오류는 입력한 DevOps URL이 인스턴스에 입력한 Jenkins URL과 다를 Jenkins 때 Jenkins 발생합니다. Jenkins 인스턴스에서 Jenkins 관리 > 시스템 > Jenkins 위치. 여기에 입력한 Jenkins URL 은 에 입력한 Jenkins 인스턴스의 URL과DevOps일치해야 합니다.

도구 권한

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

작업

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

• 외부 DevOps 도구에서 제공된 자격 증명에 대한 권한을 업데이트합니다. 팝업에서 새로 고침 을 선택하여 검사를 다시 수행합니다.
• 팝업을 닫고, 다른 자격 증명을 사용하고, 연결을 다시 선택합니다. 새로 입력한 자격 증명의 결과와 함께 권한 점검 팝업이 나타납니다.
• 영향 열을 검토하고 영향이 사용 사례에 영향을 미치지 않으면 계속 진행 을 선택합니다.

모든 권한 검사가 성공한 경우:

• 계속을 선택하여 플레이북의 다음 단계로 진행합니다.
• 결과에 오류가 표시되면 새로 고침을 선택하여 다시 시도하십시오.
• 오류가 지속되면 기록당 도구 권한 검사 시간 제한(밀리초) 속성을 업데이트하고 다시 시도하십시오.

도구 권한 검사 시간 제한 속성

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

도구 알림

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

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

변경 요청

다음 표에는 변경 요청 생성 중에 발생할 수 있는 오류를 해결하는 데 필요한 단계가 나열되어 있습니다.

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

일반 오류

이 표에는 DevOps Change Velocity 애플리케이션으로 작업하는 동안 발생할 수 있는 몇 가지 일반적인 오류를 해결하는 데 필요한 단계가 나열되어 있습니다.

문제	작업
임포트 요청이 진행되지 않음	도구(예: Jenkins Jira또는 GitHub )에 대한 임포트를 수행하는 동안 임포트 요청이 너무 오랫동안 요청됨 상태로 유지되면 임포트 요청을 삭제하고 다시 시도하십시오. 주: 기존 요청을 삭제하여 동일한 범위의 임포트를 다시 시도합니다.
도구 연결 실패	HTTP 연결 양식의 연결 URL 필드에서 후행 슬래시("/")를 제거합니다.
변경 통제 중인 작업에 대한 Jenkins 변경 요청이 생성되지 않음	다음 사항을 확인합니다. 인스턴스의 도구 통합이 올바르게 설정되었습니다. 작업이 인스턴스에서 동기화되었습니다. 작업 및 앱 단계가 인스턴스에 구성되었습니다. 작업이 변경 통제 하에 있는 경우 변경 요청 생성이 지원되지 않습니다. 파이프라인의 일부가 아닙니다(예: 독립 실행형 작업). 파이프라인의 첫 번째입니다. 파이프라인 내에 있지만 사용자가 변경 제어 중인 작업에서 직접 SCM 체크 아웃을 수동으로 트리거하거나 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 도구가 없기 때문에 SonarQube 스캔이 수행되지 않으므로 의 ServiceNow DevOps 파이프라인 실행이 진행되지 않고 무기한 대기합니다. 소프트웨어 품질 인바운드 이벤트는 처리 상세 정보 필드에 다음 오류 메시지를 표시합니다. "각 SonarQube 도구가 성공적으로 생성되었는지 확인하십시오. 그렇지 않은 경우 SonarQube 도구를 만들고 인바운드 이벤트를 다시 시도하십시오."	코드 품질 스캔의 모든 SonarQube 단계에서 사용자는 인스턴스에 SonarQube 도구를 ServiceNow DevOps 생성해야 합니다. 자세한 내용은 SonarQube 및 DevOps 변경 속도 통합 문서를 참조하십시오.
파이프라인 UI에 스테이지 간 끊어진 링크가 표시됩니다.	작업 실행으로 이동하여 업스트림 실행 열에 적절한 업스트림 링크 참조가 있는지 확인합니다.