히스토리

• GitLab 18.9에서 FF_USE_JOB_ROUTER 플래그와 함께 도입되었습니다. 기본적으로 비활성화.
• GitLab 18.10에서 last_used_at 필드가 추가되었습니다.

이 기능은 개발 중이며 프로덕션 환경에서 사용할 준비가 되지 않았습니다.

러너 컨트롤러 토큰은 러너 컨트롤러가 GitLab과 인증하는 데 사용됩니다.

전제 조건#

• 관리자 액세스 권한이 있어야 합니다.

러너 컨트롤러 토큰 목록 조회#

러너 컨트롤러의 인증 토큰 목록을 반환합니다.

GET /runner_controllers/:id/tokens

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/runner_controllers/1/tokens"

응답 예시:

[
  {
    "id": 1,
    "created_at": "2024-01-01T00:00:00.000Z",
    "last_used_at": "2024-01-01T00:00:00.000Z"
  }
]

단일 러너 컨트롤러 토큰 가져오기#

러너 컨트롤러의 단일 인증 토큰을 반환합니다.

GET /runner_controllers/:id/tokens/:token_id

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/runner_controllers/1/tokens/1"

응답 예시:

{
  "id": 1,
  "created_at": "2024-01-01T00:00:00.000Z",
  "last_used_at": "2024-01-01T00:00:00.000Z"
}

러너 컨트롤러 토큰 생성#

러너 컨트롤러의 새 인증 토큰을 생성합니다.

token 필드는 생성 직후에만 반환되며 이후에는 접근할 수 없습니다. 반드시 저장해 두어야 합니다.

POST /runner_controllers/:id/tokens

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/runner_controllers/1/tokens"

응답 예시:

{
  "id": 1,
  "token": "glrct-<token>",
  "created_at": "2024-01-01T00:00:00.000Z",
  "last_used_at": null
}

러너 컨트롤러 토큰 취소#

러너 컨트롤러의 인증 토큰을 취소합니다.

DELETE /runner_controllers/:id/tokens/:token_id

요청 예시:

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/runner_controllers/1/tokens/1"

성공하면 204 No Content 상태 코드가 반환됩니다.

러너 컨트롤러 토큰 교체#

러너 컨트롤러의 인증 토큰을 교체합니다. 이 작업은 현재 토큰을 취소하고 새 토큰을 반환합니다.

token 필드는 교체 직후에만 반환되며 이후에는 접근할 수 없습니다. 반드시 저장해 두어야 합니다.

POST /runner_controllers/:id/tokens/:token_id/rotate

요청 예시:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
  "https://gitlab.example.com/api/v4/runner_controllers/1/tokens/1/rotate"

응답 예시:

{
  "id": 2,
  "token": "glrct-<new_token>",
  "created_at": "2024-01-01T00:00:00.000Z",
  "last_used_at": null
}