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 파일을 업로드하는 사용자가 가져온 이슈의 작성자로 설정됩니다.

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

가져오기 준비

  • 몇 가지 이슈만 포함하는 테스트 파일을 가져오는 것을 고려해보세요. 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로 설정됩니다.