도구의 DevOps 이력 데이터 임포트

서비스 카탈로그를 사용하여 새 앱을 온보딩하고 해당 앱의 과거 DevOps 데이터를 임포트합니다. 폴링을 활성화하여 예약된 빈도로 연결된 계획, 리포지토리 및 파이프라인에 매핑된 데이터를 임포트합니다.

기존 도구의 이력 DevOps 데이터 임포트

앱 온보딩 카탈로그 양식을 사용하여 앱 온보딩 요청을 생성하고 이미 온보딩한 도구의 DevOps 기록 데이터를 임포트할 수 있습니다. 현재 현재 날짜로부터 지난 90일 동안의 기록 데이터를 임포트하고 다음 도구에 대해 예약된 빈도로 폴링을 활성화할 수 있습니다.

• Jira (예정)
• GitHub 및 GitHub Enterprise(코딩)
• Jenkins (오케스트레이션)

주:

• 데이터를 임포트할 도구를 생성, 연결, 검색했는지 확인하십시오.
• 계획 도구(Jira)에 대한 임포트 요청이 먼저 처리된 다음 리포지토리 및 파이프라인 임포트 요청이 처리됩니다.

워크플로우 임포트 및 재시도

셀프 서비스 카탈로그에서 카탈로그 요청을 성공적으로 제출하면 구성한 지정된 승인자 플로우에 따라 승인을 위해 요청이 전송됩니다. 요청이 승인되면 앱 온보딩 요청에 대한 인바운드 이벤트가 생성됩니다. 인바운드 이벤트 기록의 처리 상세 정보 필드에 임포트 요청 ID 및 상태가 표시됩니다. 단일 임포트 요청은 관련 목록에 표시되는 여러 하위 임포트 요청 페이지를 생성합니다. 임포트 요청 페이지는 지원되는 도구에 대한 다음 논리를 기반으로 생성됩니다.

• Jira: 15일 범위에 대해 페이지가 만들어집니다.
• GitHub : 커밋 100개마다 페이지가 만들어집니다.
• Jenkins: 페이지는 빌드별로 만들어집니다.

. 임포트 요청 처리가 완료되면 매핑한 연결된 작업 항목, 커밋, 분기, 태그, 파이프라인 실행, 테스트 요약이 생성되고 시스템에 유지됩니다.

임포트에 성공하면 임포트한 모든 커밋을 DevOps > 개발:

• 지점
• 커밋
• 커밋한 사람
• 태그
• 리포지토리
• 작업 항목

지정된 날짜 범위에 대한 성공적인 임포트를 확인하는 자세한 내용은 다음을 참조하십시오.

가져오기 요청을 처리하는 동안 페이지 오류가 발생하면 기본 제공 재시도 메커니즘이 설정된 횟수 동안 페이지 처리를 시도합니다. 모든 자동 재시도 후에도 페이지가 여전히 오류 상태인 경우 가져오기 요청의 후속 페이지 또는 나머지 페이지가 처리됩니다. 임포트 요청의 전반적인 상태가 오류 상태로 남아 있습니다.

예를 들어 계획 임포트 요청이 실패하면(모든 재시도 후) 리포지토리 및 파이프라인 임포트 처리를 진행합니다. 다음에서 임포트 요청에 대한 재시도를 구성할 수 있습니다. DevOps > 관리 > 속성 > 임포트하는 동안 페이지당 최대 재시도 횟수.

• 임포트 요청 페이지가 임포트하는 동안 페이지당 최대 재시도 필드에서 실패할 경우 자동 시도 횟수를 지정합니다. 모든 자동 재시도 후에도 페이지가 성공하지 못하면 가져오기 요청은 나머지 페이지를 처리합니다. 임포트 요청의 전체 상태는 오류로 반영됩니다.
• 실패한 임포트 요청 페이지에서 임포트 재시도 버튼을 클릭하여 실패한 임포트 시도를 수동으로 다시 시도할 수 있습니다.

폴링 일정 및 구성

폴링을 활성화하여 예약된 빈도의 데이터를 기록 데이터를 임포트한 앱으로 임포트 DevOps 하고 연결된 계획, 리포지토리 및 파이프라인에 매핑합니다.

앱을 온보딩하고 관련 DevOps 데이터를 임포트한 후에는 추적되고 앱에 연결된 계획, 리포지토리 및 파이프라인에 대한 임포트 요청이 생성되도록 기본 시스템 일정을 활성화할 수 있습니다. 가져오기 요청이 처리를 완료하면 연결된 데이터가 유지되고 앱에 대해 표시됩니다. 기본 시스템 DevOpsImportPolling 예약 작업이 기본적으로 활성 상태인 동안 예약된 작업을 실행하려면 속성에서 DevOps 폴링을 활성화해야 합니다.

폴링을 활성화하려면 다음으로 이동합니다. DevOps > 관리 > 속성 > 폴링 임포트 사용 을 클릭하고 확인란을 선택합니다.

이 속성 플래그를 켜면 기본 시스템 DevOpsImportPolling 예약 작업이 활성화됩니다. 폴링을 위한 예약된 작업은 활성 상태이고 파이프라인을 추적한 모든 앱에 대해 마지막으로 성공한 가져오기 또는 30일 중 더 늦은 날짜를 '시작 날짜'로, 현재 날짜의 날짜를 데이터 가져오기의 '종료 날짜'로 간주합니다. 이 작업은 마지막으로 성공한 임포트 시간을 조회하고 그에 따라 후속 임포트 요청을 생성합니다. 이 논리는 예약된 폴링 작업이 해당 앱에 대한 관련 DevOps 데이터의 델타를 마지막으로 성공한 임포트 종료 날짜에서 최대 30일까지 임포트하도록 합니다.

주:

폴링 빈도를 하루 또는 24시간 미만으로 구성하지 마십시오.

작업의 기본 빈도는 시스템 시간대를 사용하여 매일 자정에 실행되도록 설정됩니다. 예약된 작업의 빈도를 변경하려면 관리자(관리자) 역할이 ServiceNow Now Platform 필요합니다.

다음으로 이동 시스템 정의 > 예약된 작업 > DevOps임포트 폴링 을 클릭하고 필요에 따라 실행 빈도, 시간대 및 시간 필드 값을 수정합니다. 자세한 내용은 작업 예약을 참조하십시오

주:

• 예약된 작업은 활성 앱에만 적용됩니다. 폴링을 구성하려는 앱이 활성 상태이고 관련 파이프라인에 대해 추적 필드가 활성화되어 있는지 확인합니다.
• 일정 빈도를 수정할 때는 다음 사항을 고려하십시오.
  • JIRA의 경우 기본 시간대는 JIRA 서버 위치의 시간대를 기준으로 합니다.
  • 기본 시간대의 경우 Jenkins : UTC. 자세한 내용은 Jenkins 시스템 시간대 설명서를 참조하십시오.

데이터를 임포트 DevOps 하기 위해 폴링하는 작업 예약에는 임포트 및 임포트 요청과 관련된 다음 DevOps 속성의 기본값이 적용됩니다.

• 임포트하는 동안 페이지당 최대 재시도 횟수
• 임포트 요청에 대해 한 번에 처리할 최대 페이지 수
• 임포트 요청 페이지 기록에 페이로드를 첨부 파일로 저장하려면 "값" 필드를 "true"로 설정합니다. 다른 모든 것은 거짓으로 간주됩니다.

기존 Azure DevOps 파이프라인, 리포지토리 및 계획 임포트

와 통합 Azure DevOpsDevOps한 후에는 최대 90일 동안의 기존 Azure DevOps 파이프라인, 리포지토리 및 계획 데이터를 임포트할 수 있습니다. 그런 다음 대시보드를 사용하여 DevOps 데이터를 보고 관리할 Azure DevOps 수 있습니다.

시작하기 전에

필요한 역할: admin

이 태스크 정보

• 서비스 카탈로그의 데이터를 미리 정의된 카탈로그 항목으로 요청합니다.
• 임포트한 테스트 요약, 아티팩트 및 패키지는 단계 실행이 아닌 파이프라인 실행에 연결됩니다.
• SonarQube 스캔 결과는 가져오지 않습니다.
• Azure DevOps 는 다음과 같은 제한 사항을 적용합니다.
  • 15일마다 최대 20,000개의 작업 항목을 임포트할 수 있습니다.
  • 최대 200개의 실행 커밋을 모든 파이프라인 실행에 매핑할 수 있습니다.
  • 7일 이상 경과한 파이프라인 실행에 대한 테스트 결과는 반환되지 않습니다.

주:

가져오기 프로세스는 매우 큰 데이터 세트의 경우 다소 시간이 걸릴 수 있습니다.

프로시저

1. 다음으로 이동 모두 > 서비스 카탈로그 > 카탈로그 정의 > 내 카탈로그 을 클릭한 다음, DevOps 온보딩을 선택합니다.
2. 카탈로그 항목 관련 목록에서 DevOps 앱 온보딩을 선택합니다.
3. 카탈로그 항목 양식에서 시도 하기를 선택하여 데이터를 요청합니다.
   결과 DevOps 앱 온보딩 양식을 사용하면 주문할 카탈로그 항목을 지정할 수 있습니다. 이 경우 주문할 "앱"이 인스턴스입니다 Azure DevOps .

   

4. 앱 필드에서 목록에서 선택 아이콘( )을 선택한 다음 의 인스턴스를 Azure DevOps선택합니다.
   인스턴스를 지정했으니 이제 임포트할 데이터의 날짜 범위와 소스를 지정합니다.
5. 임포트하려는 각 파이프라인, 리포지토리 및 계획에 대해 다음 절차를 반복합니다.
   1. 해당 온보딩 필드에서 목록에서 선택 아이콘()을 선택하여 임포트할 항목을 선택합니다.
      여러 항목을 선택할 수 있습니다.
   2. 임포트 원본 및 임포트 대상 필드에서 데이터의 날짜 범위를 지정합니다.
6. 지금 주문을 선택합니다.
   요청이 주문 상태 페이지에 나타납니다.
7. 본인 또는 관리자 역할이 있는 다른 사용자가 요청을 승인할 수 있도록 요청 번호를 선택합니다.
   
8. 요청 승인: 요청 양식에서 승인 및 요청 상태를승인됨으로 설정합니다.
   임포트 프로세스는 승인 즉시 시작됩니다.

기존 GitLab 파이프라인 및 리포지토리 임포트

와 통합 GitLabDevOps한 후에는 최대 90일 동안의 기존 GitLab 파이프라인 및 리포지토리 데이터를 임포트할 수 있습니다. 그런 다음 대시보드를 사용하여 DevOps 데이터를 보고 관리할 GitLab 수 있습니다.

시작하기 전에

필요한 역할: admin

이 태스크 정보

• 서비스 카탈로그의 데이터를 미리 정의된 카탈로그 항목으로 요청합니다.
• 임포트한 테스트 요약은 단계 실행이 아닌 파이프라인 실행에 연결됩니다.
• artifacts 키워드를 사용하여 게시된 아티팩트만 임포트됩니다.
• 만료된 아티팩트에 대한 테스트 결과는 표시되지 않습니다. 파이프라인에서 expire_in 속성을 구성하여 아티팩트의 만료 날짜를 설정할 수 있습니다. 아티팩트 만료 정책에 대한 자세한 내용은 아티팩트 및 작업 메타 데이터 만료를 참조하세요.
• SonarQube 스캔 결과는 가져오지 않습니다.
• 한 번의 가져오기에서 분기당 6400개의 커밋만 가져올 수 있습니다.
• GitLab은 실행 커밋을 파이프라인 실행에 연결하는 동안 GitLab은 일부 시나리오에서 커밋 세부 정보의 시작 부분을 제공하지 않습니다. SHA 앞의 부분만 '00000000000000000'으로 제공합니다. 이러한 시나리오에서 최신 커밋은 실행 커밋으로 연결됩니다. 예를 들어 새 분기가 생성되거나 파이프라인이 수동으로 실행되는 경우입니다.
  주:

  가져오기 프로세스는 매우 큰 데이터 세트의 경우 다소 시간이 걸릴 수 있습니다.

프로시저

1. 다음으로 이동 모두 > 서비스 카탈로그 > 카탈로그 정의 > 내 카탈로그 을 클릭한 다음, DevOps 온보딩을 선택합니다.
2. 카탈로그 항목 관련 목록에서 DevOps 앱 온보딩을 선택합니다.
3. 카탈로그 항목 양식에서 시도 하기를 선택하여 데이터를 요청합니다.
   결과 DevOps 앱 온보딩 양식을 사용하면 주문할 카탈로그 항목을 지정할 수 있습니다. 이 경우 주문할 "앱"이 인스턴스입니다 GitLab .

   

4. 앱 필드에서 목록에서 선택 아이콘( )을 선택한 다음 의 인스턴스를 GitLab선택합니다.
   인스턴스를 지정했으니 이제 임포트할 데이터의 날짜 범위와 소스를 지정합니다.
5. 임포트할 각 리포지토리에 대해 다음 절차를 반복합니다.
   1. 온보딩 리포지토리 필드에서 목록에서 선택 아이콘()을 선택한 다음 임포트할 항목을 선택합니다.
      여러 항목을 선택할 수 있습니다.
   2. 임포트 원본 및 임포트 대상 필드에서 데이터의 날짜 범위를 지정합니다.
   주:

   온보딩 리포지토리 필드에서 리포지토리를 선택하면 리포지토리에 매핑된 파이프라인이 자동으로 선택됩니다. 파이프라인을 별도로 선택할 필요가 없습니다.
6. 지금 주문을 선택합니다.
   요청이 주문 상태 페이지에 나타납니다.
7. 본인 또는 관리자 역할이 있는 다른 사용자가 요청을 승인할 수 있도록 요청 번호를 선택합니다.
   
8. 요청 승인: 요청 양식에서 승인 및 요청 상태를승인됨으로 설정합니다.
   임포트 프로세스는 승인 즉시 시작됩니다.