CSV 파일에서 이슈 가져오기

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

다음 열을 포함하는 CSV 파일을 업로드하여 프로젝트로 이슈를 가져올 수 있습니다:

이름 필요? 설명
제목 예 이슈 제목
설명 예 이슈 설명
마감일 아니요 YYYY-MM-DD 형식의 이슈 마감일. GitLab 15.2에서 도입됨
마일스톤 아니요 이슈 마일스톤 제목. GitLab 16.7에서 도입됨

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

설명 필드를 사용하여 이슈에 다른 데이터를 추가하기 위해 빠른 조치를 삽입할 수 있습니다. 예를 들어, 라벨, 담당자 및 마일스톤을 추가할 수 있습니다.

또는 이슈를 이동할 수도 있습니다. 이동된 이슈는 더 많은 데이터를 보존합니다.

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

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

가져오기 준비

  • 몇 가지 이슈만 포함하는 테스트 파일을 가져오는 것을 고려하세요. 큰 가져오기를 원상 복구하는 방법은 GitLab API를 사용하지 않으면 없습니다.
  • CSV 파일이 파일 형식 요구 사항을 충족하는지 확인하세요.
  • CSV에 마일스톤 헤더가 포함되어 있으면, 파일의 모든 고유한 마일스톤 제목이 프로젝트나 해당 상위 그룹에 이미 존재하는지 확인하세요.

파일 가져오기

이슈를 가져오려면:

  1. 프로젝트의 이슈 페이지로 이동합니다.
  2. 프로젝트에 이슈가 있는 경우: 오른쪽 상단의 Bulk edit 옆에 있는 Actions () > Import CSV를 선택합니다.
    • 프로젝트에 이슈가 없는 경우: 페이지 중앙에서 Import CSV를 선택합니다.
  3. 가져오려는 파일을 선택한 후 이슈 가져오기를 선택합니다.

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

CSV 파일 형식

이슈를 가져오려면 GitLab은 CSV 파일이 특정 형식을 갖도록 합니다:

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

특수 문자(예: , 또는 \n)나 필드 내에서 여러 줄을 사용할 때(예: 빠른 조치 사용 시)는 이중 인용부호(")로 문자를 감싸야 합니다.

또한 빠른 조치 사용 시:

  • 각 작업은 개별 줄에 있어야 합니다.
  • /label 및 /milestone과 같은 빠른 조치의 경우 라벨 또는 마일스톤이 이미 프로젝트에 존재해야 합니다.
  • 이슈를 할당하는 사용자는 프로젝트의 구성원이어야 합니다.

샘플 CSV 데이터: 

title,description,due_date,milestone
내 이슈 제목,내 이슈 설명,2022-06-28
다른 제목,"쉼표가 있는 설명",
"하나 더 제목","하나 더 설명",
빠른 조치가 포함된 이슈,"프론트엔드를 변경할 수 있을까요?

/assign @sjones
/label ~frontend ~documentation",
마일스톤 있는 이슈,"내 마일스톤이 생성됨",,v1.0

파일 크기

제한은 GitLab 인스턴스의 구성값인 Max Attachment Size에 의해 설정됩니다:

  • Self-Managed: GitLab 인스턴스의 Max Attachment Size 구성 값에 의해 설정됩니다.
  • GitLab SaaS: GitLab.com에서 10MB로 설정됩니다.