• GitHub에서 리포지토리 가져오기
  • 그룹 액세스 토큰을 사용하여 API를 통해 공용 프로젝트 가져오기
  • GitHub 프로젝트 가져오기 취소
  • GitHub gists를 GitLab 스니펫으로 가져오기
• Bitbucket Server에서 저장소 가져오기
• Bitbucket Cloud에서 리포지토리 가져오기
• 관련 주제

Import API

GitHub 또는 Bitbucket Server에서 리포지토리를 가져오기 위해 Import API를 사용합니다.

GitHub에서 리포지토리 가져오기

• GitLab 15.8에서 도입. GitLab은 이제 target_namespace에 지정된 네임스페이스나 그룹 이름이 없는 경우 자동으로 네임스페이스나 그룹을 생성하지 않습니다. GitLab은 또한 네임스페이스 또는 그룹 이름이 사용 중이거나 target_namespace가 비어 있는 경우에는 사용자의 개인 네임스페이스를 대체로 사용하지 않습니다.
• GitLab 16.0에서 Maintainer 역할에서 Developer 역할로의 요구 사항이 도입되었으며, GitLab 15.11.1 및 GitLab 15.10.5로 백포트되었습니다.
• optional_stages의 collaborators_import 키가 GitLab 16.0에서 도입되었습니다.
• Feature flag github_import_extended_events가 GitLab 16.8에서 도입되었습니다. 기본적으로 비활성화됩니다. 이 플래그는 가져오기의 성능을 향상시키지만 single_endpoint_issue_events_import 선택사항 단계를 비활성화합니다.
• Feature flag github_import_extended_events가 GitLab 16.9에서 활성화됐습니다. GitLab.com 및 자체 관리에서 활성화됐습니다.
• 개선된 가져오기 성능이 GitLab 16.11에서 일반적으로 사용 가능해졌습니다. Feature flag github_import_extended_events가 제거되었습니다.

API를 사용하여 GitHub에서 프로젝트를 GitLab으로 가져옵니다.

전제 조건:

• GitHub 가져오기 사전 조건.
• target_namespace에 설정된 네임스페이스가 있어야 합니다.
• 네임스페이스는 사용자 네임스페이스이거나 적어도 Maintainer 역할을 가진 기존 그룹이어야 합니다.

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": {
      "single_endpoint_notes_import": true,
      "attachments_import": true,
      "collaborators_import": true
    }
}'

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

• single_endpoint_issue_events_import, issue 및 pull request 이벤트 가져오기용입니다. 이 선택사항 단계는 GitLab 16.9에서 제거되었습니다.
• single_endpoint_notes_import, 대체 및 철저한 코멘트 가져오기용입니다.
• attachments_import, Markdown 첨부 파일 가져오기용입니다.
• collaborators_import, 외부 공동 작업자가 아닌 직접 리포지토리 공동 작업자 가져오기용입니다.

자세한 정보는 가져오기할 추가 항목 선택을 참조하세요.

예시 응답:

{
    "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를 통해 공용 프로젝트 가져오기

• GitLab 15.7에서 도입. 프로젝트는 어떠한 경우에도 봇 사용자의 네임스페이스로 가져오지 않습니다. 봇 사용자의 네임스페이스로 가져온 프로젝트는 유효한 토큰이 있는 사용자에 의해 삭제될 수 없었으며, 이는 보안 위험을 나타냈습니다.

API를 통해 GitHub에서 GitLab으로 프로젝트를 가져올 때 그룹 액세스 토큰을 사용하면:

• GitLab 프로젝트는 원래 프로젝트의 가시성 설정을 상속합니다. 결과적으로 원래 프로젝트가 공개 상태인 경우 프로젝트는 공개적으로 접근 가능합니다.
• path 또는 target_namespace가 없는 경우 프로젝트 가져오기가 실패합니다.

GitHub 프로젝트 가져오기 취소

• GitLab 15.5에서 소개됨.

API를 사용하여 진행 중인 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 gists를 GitLab 스니펫으로 가져오기

• GitLab 15.8에서 github_import_gists란 이름의 플래그로 도입됨. 기본값은 비활성화되어 있으며 GitLab.com에서 활성화됨.
• GitLab 15.10에서 셀프 매니지드 환경에서 활성화됨.
• GitLab 15.11에서 일반 사용 가능하게 됨. 플래그 github_import_gists이 제거됨.

GitLab API를 사용하여 개인 GitHub gists(최대 10개의 파일 포함)을 개인 GitLab 스니펫으로 가져올 수 있습니다. 10개 이상의 파일을 포함한 GitHub gists는 건너뜁니다. 이러한 GitHub gists는 수동으로 마이그레이션해야 합니다.

가져오기에 실패한 gists가 있을 경우, 해당되는 gists 목록이 포함된 이메일이 전송됩니다.

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: gists 가져오기가 시작되었습니다.
• 401 Unauthorized: 사용자의 GitHub 개인 액세스 토큰이 잘못되었습니다.
• 422 Unprocessable Entity: gists 가져오기가 이미 진행 중입니다.
• 429 Too Many Requests: 사용자가 GitHub의 요청 속도 제한을 초과했습니다.

Bitbucket Server에서 저장소 가져오기

API를 사용하여 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에서 리포지토리 가져오기

• GitLab 17.0에서 도입되었습니다.

API를 사용하여 Bitbucket Cloud에서 프로젝트를 GitLab으로 가져옵니다.

전제 조건:

• Bitbucket Cloud 가져오기기를 위한 전제 조건.
• Bitbucket Cloud 앱 비밀번호가 있어야 합니다.

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_username": "bitbucket_username",
    "bitbucket_app_password": "bitbucket_app_password",
    "repo_path": "username/my_project",
    "target_namespace": "my_group/my_subgroup",
    "new_name": "new_project_name"
}'

관련 주제

• 직접 전송 API에 의한 그룹 이관.
• 그룹 가져오기 및 내보내기 API.
• 프로젝트 가져오기 및 내보내기 API.