CSV 파일에서 이슈 가져오기

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

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

이름 필수 여부 설명
title 이슈 제목.
description 이슈 설명.
due_date 아니오 YYYY-MM-DD 형식의 이슈 마감일. GitLab 15.2에서 소개.
milestone 아니오 이슈 마일스톤의 제목. 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 파일이 특정 형식을 가져야 합니다:

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

특수 문자(예: , 또는 \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의 경우, 10MB로 설정됩니다.