도구에 대한 DevOps 이력 데이터 임포트

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

    • 서비스 카탈로그를 사용하여 새 앱을 온보딩하고 해당 앱의 기록 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시간 미만으로 구성하지 마십시오.
    작업의 기본 빈도는 시스템 시간대를 사용하여 매일 자정에 실행되도록 설정됩니다. 예약된 작업의 빈도를 변경하려면 관리자(admin) 역할이 필요합니다 ServiceNow ServiceNow AI Platform .
    다음으로 이동 시스템 정의 > 예약된 작업 > DevOpsImportPolling 을 클릭하고 필요에 따라 실행 빈도, 시간대 및 시간 필드 값을 수정합니다. 자세한 내용은 예약된 작업을 참조하십시오
    주:
    • 예약된 작업은 활성 앱에만 적용됩니다. 폴링을 구성 중인 앱이 활성 상태이고 관련 파이프라인에 대해 추적 필드가 활성화되어 있는지 확인합니다.
    • 일정 빈도를 수정할 때는 다음 사항을 고려하십시오.
    데이터를 임포트 DevOps 하기 위해 폴링하는 예약 작업은 임포트 및 임포트 요청과 관련된 다음 DevOps 속성의 기본값을 적용합니다.
    • 임포트하는 동안 페이지당 최대 재시도 횟수
    • 임포트 요청에 대해 한 번에 처리할 최대 페이지 수
    • 임포트 요청 페이지 기록에 페이로드를 첨부 파일로 저장하려면 "값" 필드를 "true"로 설정합니다. 다른 모든 것은 거짓으로 간주됩니다.

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

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

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    • 서비스 카탈로그의 데이터를 미리 정의된 카탈로그 항목으로 요청합니다.
    • 임포트한 테스트 요약, 아티팩트 및 패키지는 단계 실행이 아닌 파이프라인 실행에 연결됩니다.
    • 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 파이프라인 및 리포지토리 임포트

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

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

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

    프로시저

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

      온보딩 양식에서 인스턴스 지정

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