CSV에서 이슈 가져오기

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

프로젝트에 이슈를 가져오려면 다음 열이 포함된 CSV 파일을 업로드해야 합니다:

Name Required? Description
title Yes 이슈 제목.
description Yes 이슈 설명.
due_date No 이슈 마감일은 YYYY-MM-DD 형식입니다. 도입됨 GitLab 15.2에서.
milestone No 이슈 마일스톤 제목. 도입됨 GitLab 16.7에서.

다른 열의 데이터는 가져오지 않습니다.

description 필드를 사용하여 퀵 액션을 삽입하여 이슈에 다른 데이터를 추가할 수 있습니다.
예를 들어, 레이블, 담당자 및 마일스톤.

또는 이슈 이동하기를 사용할 수 있습니다. 이슈를 이동하면 더 많은 데이터가 보존됩니다.

CSV 파일을 업로드하는 사용자는 가져온 이슈의 작성자로 설정됩니다.

이슈를 가져오려면 프로젝트에서 최소한 Developer 역할이 있어야 합니다.

가져오기를 위한 준비

  • 몇 개의 이슈만 포함된 테스트 파일을 가져오는 것을 고려하세요. GitLab API를 사용하지 않고는 대량 가져오기를 실행 취소할 수 있는 방법이 없습니다.
  • CSV 파일이 파일 형식 요구 사항을 충족하는지 확인하세요.
  • CSV에 마일스톤 헤더가 포함되어 있으면 파일의 모든 고유 마일스톤 제목이 프로젝트 또는 상위 그룹에 이미 존재하는지 확인하세요.

파일 가져오기

이슈를 가져오려면:

  1. 프로젝트의 이슈 페이지로 이동합니다.
  2. 프로젝트에 이슈가 있는지 여부에 따라 가져오기 기능을 엽니다:
    • 프로젝트에 기존 이슈가 있는 경우: 오른쪽 상단 모서리에서 Bulk edit 옆에 있는 Actions ( ) > Import CSV를 선택합니다.
    • 프로젝트에 이슈가 없는 경우: 페이지 중간에서 Import CSV를 선택합니다.
  3. 가져올 파일을 선택한 후 Import issues를 선택합니다.

파일은 백그라운드에서 처리되며, 오류가 감지되거나 가져오기가 완료되면 알림 이메일이 발송됩니다.

CSV 파일 형식

이슈를 가져오려면 GitLab에서 CSV 파일이 특정 형식을 가져야 합니다:

Element Format
header row CSV 파일은 title 및 description 헤더를 포함해야 합니다. 헤더의 대소문자는 중요하지 않습니다.
columns title, description, due_date, 및 milestone 외부의 열에서 데이터는 가져오지 않습니다.
separators 열 구분자는 헤더 행에서 감지됩니다. 지원되는 구분자 문자는 쉼표(,), 세미콜론(;), 및 탭(\t)입니다. 행 구분자는 CRLF 또는 LF일 수 있습니다.
double-quote character 이중 인용 부호(") 문자는 필드를 인용하는 데 사용되어 필드 내에서 열 구분자를 사용할 수 있게 합니다 (아래 샘플 CSV 데이터의 세 번째 줄 참조). 인용된 필드에 이중 인용 부호(")를 삽입하려면 연속하여 두 개의 이중 인용 부호 문자를 사용합니다("").
data rows 헤더 행 뒤에 오는 행은 동일한 열 순서를 사용해야 합니다. 이슈 제목은 필수이며, 설명은 선택 사항입니다.

특수 문자(예: , 또는 \n)가 포함되거나 필드에 여러 줄이 있는 경우(예: 퀵 액션 사용시) 문자를 이중 인용 부호(")로 둘러싸세요.

또한 퀵 액션을 사용할 때:

  • 각 액션은 별도의 줄에 있어야 합니다.
  • /label 및 /milestone과 같은 퀵 액션의 경우 레이블 또는 마일스톤은 이미 프로젝트에 존재해야 합니다.
  • 이슈를 할당할 사용자는 프로젝트의 구성원이 해야 합니다.

샘플 CSV 데이터:

title,description,due_date,milestone
My Issue Title,My Issue Description,2022-06-28
Another Title,"A description, with a comma",
"One More Title","One More Description",
An Issue with Quick Actions,"Hey can we change the frontend?

/assign @sjones
/label ~frontend ~documentation",
An issue with milestone,"My milestone is created",,v1.0

파일 크기

제한은 GitLab 인스턴스가 호스팅되는 방법에 따라 다릅니다:

  • Self-managed: GitLab 인스턴스의 Max Attachment Size 설정 값에 의해 결정됩니다.

  • GitLab SaaS: GitLab.com에서는 10 MB로 설정됩니다.