이 API를 사용하여 외부 소스에서 리포지터리를 가져옵니다.

GitHub에서 리포지터리 가져오기#

GitHub의 리포지터리를 GitLab으로 가져옵니다.

사전 요구 사항:

• GitHub 가져오기 도구의 사전 요구 사항을 충족해야 합니다.
• target_namespace에 지정한 네임스페이스가 존재해야 합니다.
• 네임스페이스는 사용자 네임스페이스이거나, Maintainer 또는 Owner 권한을 가진 기존 그룹이어야 합니다.

POST /import/github

curl --request POST \
  --url "https://gitlab.example.com/api/v4/import/github" \
  --header "content-type: application/json" \
  --header "Authorization: Bearer <your_access_token>" \
  --data '{
    "personal_access_token": "aBc123abC12aBc123abC12abC123+_A/c123",
    "repo_id": "12345",
    "target_namespace": "group/subgroup",
    "new_name": "NEW-NAME",
    "github_hostname": "https://github.example.com",
    "optional_stages": {
      "attachments_import": true,
      "collaborators_import": true
    }
}'

optional_stages에는 다음 키를 사용할 수 있습니다.

• attachments_import: Markdown 첨부 파일을 가져옵니다.
• collaborators_import: 외부 협업자가 아닌 직접 리포지터리 협업자를 가져옵니다.
• single_endpoint_notes_import: 댓글을 더 온전하게 가져오는 대체 방식이며, GitLab 19.3 이전에서는 선택 사항입니다. GitLab 19.4 이상에서는 새로 구성하는 가져오기에 이 방식이 필수입니다.

자세한 내용은 추가로 가져올 항목 선택을 참고합니다.

응답 예시:

{
    "id": 27,
    "name": "my-repo",
    "full_path": "/root/my-repo",
    "full_name": "Administrator / my-repo",
    "refs_url": "/root/my-repo/refs",
    "import_source": "my-github/repo",
    "import_status": "scheduled",
    "human_import_status_name": "scheduled",
    "provider_link": "/my-github/repo",
    "relation_type": null,
    "import_warning": null
}

그룹 액세스 토큰으로 API를 통해 공개 프로젝트 가져오기#

그룹 액세스 토큰으로 API를 통해 GitHub의 프로젝트를 GitLab으로 가져오면 다음과 같이 동작합니다.

• GitLab 프로젝트는 원본 프로젝트의 공개 범위 설정을 상속합니다. 따라서 원본 프로젝트가 공개이면 가져온 프로젝트도 공개 상태가 됩니다.
• path 또는 target_namespace가 존재하지 않으면 프로젝트 가져오기가 실패합니다.

GitHub 프로젝트 가져오기 취소#

진행 중인 GitHub 프로젝트 가져오기를 취소합니다.

POST /import/github/cancel

curl --request POST \
  --url "https://gitlab.example.com/api/v4/import/github/cancel" \
  --header "content-type: application/json" \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data '{
    "project_id": 12345
}'

응답 예시:

{
    "id": 160,
    "name": "my-repo",
    "full_path": "/root/my-repo",
    "full_name": "Administrator / my-repo",
    "import_source": "source/source-repo",
    "import_status": "canceled",
    "human_import_status_name": "canceled",
    "provider_link": "/source/source-repo"
}

다음 상태 코드를 반환합니다.

• 200 OK: 프로젝트 가져오기가 취소되는 중입니다.
• 400 Bad Request: 프로젝트 가져오기를 취소할 수 없습니다.
• 404 Not Found: project_id에 해당하는 프로젝트가 존재하지 않습니다.

GitHub Gist를 GitLab 스니펫으로 가져오기#

개인 GitHub Gist를 GitLab 스니펫으로 가져옵니다. 파일이 10개 이하인 Gist를 가져올 수 있습니다. 파일이 10개를 넘는 GitHub Gist는 건너뜁니다. 이러한 GitHub Gist는 직접 마이그레이션해야 합니다.

가져오지 못한 Gist가 있으면 가져오지 못한 Gist 목록이 담긴 이메일이 발송됩니다.

POST /import/github/gists

curl --request POST \
  --url "https://gitlab.example.com/api/v4/import/github/gists" \
  --header "content-type: application/json" \
  --header "PRIVATE-TOKEN: <your_gitlab_access_token>" \
  --data '{
    "personal_access_token": "<your_github_personal_access_token>"
}'

다음 상태 코드를 반환합니다.

• 202 Accepted: Gist 가져오기가 시작되는 중입니다.
• 401 Unauthorized: 사용자의 GitHub 개인 액세스 토큰이 유효하지 않습니다.
• 422 Unprocessable Entity: Gist 가져오기가 이미 진행 중입니다.
• 429 Too Many Requests: 사용자가 GitHub의 속도 제한을 초과했습니다.

Bitbucket Server에서 리포지터리 가져오기#

Bitbucket Server의 리포지터리를 GitLab으로 가져옵니다.

Bitbucket 프로젝트 키는 Bitbucket에서 리포지터리를 찾는 데만 사용됩니다. 리포지터리를 GitLab 그룹으로 가져오려면 target_namespace를 지정해야 합니다. target_namespace를 지정하지 않으면 프로젝트는 개인 사용자 네임스페이스로 가져옵니다.

사전 요구 사항:

• 자세한 내용은 Bitbucket Server 가져오기 도구의 사전 요구 사항을 참고합니다.

POST /import/bitbucket_server

curl --request POST \
  --url "https://gitlab.example.com/api/v4/import/bitbucket_server" \
  --header "content-type: application/json" \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data '{
    "bitbucket_server_url": "http://bitbucket.example.com",
    "bitbucket_server_username": "root",
    "personal_access_token": "Nzk4MDcxODY4MDAyOiP8y410zF3tGAyLnHRv/E0+3xYs",
    "bitbucket_server_project": "NEW",
    "bitbucket_server_repo": "my-repo",
    "new_name": "NEW-NAME"
}'

Bitbucket Cloud에서 리포지터리 가져오기#

Bitbucket Cloud의 리포지터리를 GitLab으로 가져옵니다.

사전 요구 사항:

• Bitbucket Cloud 가져오기 도구의 사전 요구 사항을 충족해야 합니다.
• 필요한 스코프를 가진 Bitbucket Cloud API 토큰이 있어야 합니다.

POST /import/bitbucket

curl --request POST \
  --url "https://gitlab.example.com/api/v4/import/bitbucket" \
  --header "content-type: application/json" \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data '{
    "bitbucket_email": "email@example.com",
    "bitbucket_api_token": "your_bitbucket_api_token",
    "repo_path": "username/my_project",
    "target_namespace": "my_group/my_subgroup",
    "new_name": "new_project_name"
}'

Bitbucket Cloud API 토큰 스코프#

Bitbucket Cloud API 토큰으로 인증한다면 해당 토큰에 다음 스코프가 있어야 합니다.

• read:repository:bitbucket
• read:pullrequest:bitbucket
• read:issue:bitbucket
• read:wiki:bitbucket

관련 주제#

• 직접 전송을 통한 그룹 마이그레이션 API.
• 그룹 가져오기 및 내보내기 API.
• 프로젝트 가져오기 및 내보내기 API.