이 API를 사용하여 프로젝트 풀 미러링을 관리합니다.

프로젝트 풀 미러 세부 정보 조회#

지정된 프로젝트의 풀 미러 세부 정보를 조회합니다.

GET /projects/:id/mirror/pull

지원되는 속성:

성공하면 200 OK와 다음 응답 속성을 반환합니다:

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/:id/mirror/pull"

응답 예시:

{
  "id": 101486,
  "last_error": null,
  "last_successful_update_at": "2020-01-06T17:32:02.823Z",
  "last_update_at": "2020-01-06T17:32:02.823Z",
  "last_update_started_at": "2020-01-06T17:31:55.864Z",
  "update_status": "finished",
  "url": "https://*****:*****@gitlab.com/gitlab-org/security/gitlab.git",
  "enabled": true,
  "mirror_trigger_builds": true,
  "only_mirror_protected_branches": null,
  "mirror_overwrites_diverged_branches": false,
  "mirror_branch_regex": null
}

프로젝트 풀 미러링 설정 업데이트#

프로젝트의 풀 미러링 설정을 업데이트합니다.

PUT /projects/:id/mirror/pull

지원되는 속성:

성공하면 200 OK와 업데이트된 풀 미러 구성을 반환합니다.

풀 미러링 추가 요청 예시:

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "enabled": true,
    "url": "https://gitlab.example.com/group/project.git",
    "auth_user": "user",
    "auth_password": "password"
  }' \
  --url "https://gitlab.example.com/api/v4/projects/:id/mirror/pull"

풀 미러링 제거 요청 예시:

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "enabled=false" \
  --url "https://gitlab.example.com/api/v4/projects/:id/mirror/pull"

응답 예시:

{
  "id": 101486,
  "last_error": null,
  "last_successful_update_at": "2020-01-06T17:32:02.823Z",
  "last_update_at": "2020-01-06T17:32:02.823Z",
  "last_update_started_at": "2020-01-06T17:31:55.864Z",
  "update_status": "finished",
  "url": "https://gitlab.example.com/group/project.git",
  "enabled": true,
  "mirror_trigger_builds": false,
  "only_mirror_protected_branches": null,
  "mirror_overwrites_diverged_branches": false,
  "mirror_branch_regex": null
}

프로젝트의 풀 미러링 업데이트 (지원 중단)#

원격 리포지터리가 공개적으로 접근 가능하거나 username:token 인증을 사용하는 경우 프로젝트를 생성 또는 업데이트할 때 API를 사용하여 풀 미러링을 구성합니다.

HTTP 리포지터리가 공개적으로 접근 가능하지 않은 경우 URL에 인증 정보를 추가할 수 있습니다. 예를 들어 https://username:token@gitlab.company.com/group/project.git(여기서 token은 api 범위가 활성화된 개인 접근 토큰).

지원되는 속성:

풀 미러링으로 프로젝트를 생성하는 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "new_project",
    "namespace_id": "1",
    "mirror": true,
    "import_url": "https://username:token@gitlab.example.com/group/project.git"
  }' \
  --url "https://gitlab.example.com/api/v4/projects/"

풀 미러링 추가 예시:

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "mirror=true&import_url=https://username:token@gitlab.example.com/group/project.git" \
  --url "https://gitlab.example.com/api/v4/projects/:id"

풀 미러링 제거 예시:

curl --request PUT \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "mirror=false" \
  --url "https://gitlab.example.com/api/v4/projects/:id"

프로젝트의 풀 미러링 프로세스 시작#

프로젝트의 풀 미러링 프로세스를 시작합니다.

POST /projects/:id/mirror/pull

지원되는 속성:

성공하면 200 OK를 반환합니다.

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/:id/mirror/pull"

하드 실패한 미러를 복구하려면 force를 true로 설정합니다. 자세한 내용은 미러링 시 하드 실패 수정을 참조하세요.

요청 예시:

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --data "force=true" \
  --url "https://gitlab.example.com/api/v4/projects/:id/mirror/pull"