CSV 파일에서 이슈 가져오기

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

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

이름 필요 여부 설명
제목 이슈 제목.
설명 이슈 설명.
마감일 아니요 YYYY-MM-DD 형식으로 된 이슈 마감일. GitLab 15.2에서 소개됨
마일스톤 아니요 이슈 마일스톤의 제목. GitLab 16.7에서 소개됨

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

이슈에 다른 데이터를 추가하려면 설명 필드에 빠른 조치를 삽입할 수 있습니다. 예를 들어, 라벨, 담당자, 그리고 마일스톤과 같은 것들입니다.

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

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

이슈를 가져오려면 프로젝트에 대한 적어도 개발자 역할이 있어야 합니다.

가져오기 준비

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

파일 가져오기

이슈를 가져오려면 다음을 수행합니다:

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

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

CSV 파일 형식

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

요소 형식
헤더 행 CSV 파일에는 다음 헤더가 포함되어 있어야 합니다: titledescription. 헤더의 대소문자는 중요하지 않습니다.
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 인스턴스를 호스팅하는 방식에 따라 다릅니다:

  • Self-managed: GitLab 인스턴스의 최대 첨부 파일 크기 구성 값을 설정합니다.
  • GitLab SaaS: GitLab.com의 경우, 10MB로 설정됩니다.