러너 API

러너 API에 대해 설명합니다.

이 API를 사용하여 인스턴스에 등록된 러너 를 관리합니다. 새로운 인스턴스, 그룹 또는 프로젝트 러너를 만들려면 POST /user/runners 엔드포인트를 사용하세요. 이 API를 사용하여 기존 러너를 관리합니다. 다음 API 엔드포인트에서 페이지네이션 을 사용할 수 있습니다(기본적으로 20개 항목 반환): GET /runners GET /runners/all GET /runners/:id/jobs GET /projects/:id/runners GET /groups/:id/runners 등록 및 인증 토큰 # 러너를 GitLab에 연결하려면 두 개의 토큰이 필요합니다. 토큰 설명 등록 토큰 (레거시) 러너를 등록 하는 데 사용되는 토큰입니다. GitLab을 통해 얻을 수 있습니다 . 인증 토큰 GitLab 인스턴스로 러너를 인증하는 데 사용되는 토큰입니다. 러너를 등록 하거나, 러너 API에서 러너를 만들거나 인증 토큰을 재설정 할 때 자동으로 토큰을 얻습니다. POST /user/runners 엔드포인트를 사용하여 토큰을 얻을 수도 있습니다. 러너 등록에 토큰을 사용하는 방법의 예시: 등록 토큰과 함께 GitLab API를 사용하여 러너를 등록하면 인증 토큰이 반환됩니다. 인증 토큰을 러너의 구성 파일 에 추가합니다: [[runners]] token = "<authentication_token>" 그런 다음 GitLab과 러너가 연결됩니다. 사용 가능한 모든 러너 목록 # 사용자가 사용 가능한 모든 러너를 나열합니다. 사전 요구 사항: 그룹 러너의 경우, 소유자 네임스페이스에서 Owner 권한이 있어야 합니다. 프로젝트 러너의 경우, 러너에 할당된 프로젝트에서 Security Manager, Maintainer 또는 Owner 권한이 있어야 합니다. GET /runners GET /runners?scope=active GET /runners?type=project_type GET /runners?status=online GET /runners?paused=true GET /runners?tag_list=tag1,tag2 속성 유형 필수 여부 설명 scope string 아니요 사용 중단됨: 대신 type 또는 status 를 사용하세요. 반환할 러너의 범위로, active , paused , online , offline 중 하나; 아무것도 제공되지 않으면 모든 러너를 표시합니다 type string 아니요 반환할 러너의 유형으로, instance_type , group_type , project_type 중 하나 status string 아니요 반환할 러너의 상태로, online , offline , stale , 또는 never_contacted 중 하나. 다른 가능한 값은 사용 중단된 active 및 paused 입니다. offline 러너를 요청하면 stale 이 offline 에 포함되어 있으므로 stale 러너도 반환될 수 있습니다. paused boolean 아니요 새 job을 수락하거나 무시하는 러너만 포함