러너 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에 연결하려면 두 개의 토큰이 필요합니다. Token Description 등록 토큰(레거시) 러너를 등록 하는 데 사용하는 토큰입니다. 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 도 지정할 수 있습니다. stale 은 offline 에 포함되므로 offline 러너를 요청하면 stale 러너도 함께 반환될 수 있습니다. paused boolean 아니요 새 job을 수락