Jobs
GitLab v19.4Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
query 매개변수에 다음 필드를 사용하여 결과를 필터링합니다. 설명: job을 종류에 따라 필터링합니다. 설명: 파이프라인 IID를 사용하여 job이 속한 파이프라인에 따라 필터링합니다. 허용되는 값 유형: Number(파이프라인 IID)
히스토리
- GitLab 18.11에서 도입됨.
- GitLab 18.11에서
browseArtifactsPath,canPlayJob,commitPath,createdByTag,exitCode,pipeline,
job은 정렬을 지원하지 않습니다.
허용 범위#
| 범위 | 설명 |
|---|---|
project |
특정 프로젝트의 job을 조회합니다. |
자세한 내용은 범위를 참고합니다.
쿼리 필드#
query 매개변수에 다음 필드를 사용하여 결과를 필터링합니다.
| 필드 | 이름 | 연산자 |
|---|---|---|
| 종류 | kind |
= |
| 파이프라인 | pipeline |
= |
| 상태 | status |
= |
| 아티팩트 보유 여부 | withArtifacts |
=, != |
종류 {#job-kind}#
설명: job을 종류에 따라 필터링합니다.
허용되는 값 유형:
Enum,bridge또는build중 하나
참고 사항:
bridgejob은 다운스트림 파이프라인을 시작하는 트리거 job입니다.buildjob은 일반 CI/CD job입니다.
파이프라인 {#job-pipeline}#
설명: 파이프라인 IID를 사용하여 job이 속한 파이프라인에 따라 필터링합니다.
허용되는 값 유형: Number(파이프라인 IID)
상태 {#job-status}#
설명: job을 CI/CD 상태에 따라 필터링합니다.
허용되는 값 유형:
Enum,canceled,canceling,created,failed,manual,pending,preparing,running,scheduled,skipped,success,waiting_for_callback,waiting_for_resource중 하나
아티팩트 보유 여부 {#job-with-artifacts}#
설명: 아티팩트 보유 여부에 따라 job을 필터링합니다.
허용되는 값 유형: Boolean(true 또는 false)
표시 필드#
| 필드 | 이름(및 별칭) | 설명 |
|---|---|---|
| Active | active |
job이 활성 상태인지 표시 |
| Allow failure | allowFailure |
job 실패가 허용되는지 표시 |
| Browse artifacts path | browseArtifactsPath |
job의 아티팩트 아카이브 탐색 URL 표시 |
| Can play job | canPlayJob |
현재 사용자가 job을 실행할 수 있는지 표시 |
| Cancelable | cancelable |
job을 취소할 수 있는지 표시 |
| Commit path | commitPath |
job을 트리거한 커밋의 경로 표시 |
| Coverage | coverage |
코드 커버리지 백분율 표시 |
| Created at | created, createdAt |
job이 생성된 시점 표시 |
| Created by tag | createdByTag |
job이 태그에 의해 생성되었는지 표시 |
| Duration | duration |
job 소요 시간 표시 |
| Erased at | erased, erasedAt |
job 아티팩트가 삭제된 시점 표시 |
| Exit code | exitCode |
job의 종료 코드 표시 |
| Failure message | failureMessage |
실패 메시지 표시 |
| Finished at | finished, finishedAt |
job이 완료된 시점 표시 |
| ID | id |
job ID 표시 |
| Kind | kind |
job 종류 표시(bridge 또는 build) |
| Manual job | manualJob |
수동 job 여부 표시 |
| Name | name |
job 이름 표시 |
| Pipeline | pipeline |
job이 속한 파이프라인 표시 |
| Play path | playPath |
job을 실행하는 경로 표시 |
| Playable | playable |
job을 실행할 수 있는지 표시 |
| Queued at | queued, queuedAt |
job이 대기열에 추가된 시점 표시 |
| Queued duration | queuedDuration |
job이 시작되기 전 대기한 시간 표시 |
| Ref name | refName |
Git ref 이름 표시 |
| Ref path | refPath |
job을 트리거한 ref의 경로 표시 |
| Retried | retried |
job이 재시도되었는지 표시 |
| Retry path | retryPath |
job을 재시도하는 경로 표시 |
| Retryable | retryable |
job을 재시도할 수 있는지 표시 |
| Scheduled | scheduled |
job이 예약되었는지 표시 |
| Scheduled at | scheduledAt |
job이 실행되도록 예약된 시점 표시 |
| Scheduling type | schedulingType |
스케줄링 유형 표시 |
| Short SHA | shortSha |
짧은 커밋 SHA 표시 |
| Source | source |
job 소스 표시 |
| Stage | stage |
job이 속한 파이프라인 Stage 표시 |
| Started at | started, startedAt |
job 시작 시각 표시 |
| Status | status |
job 상태 표시 |
| Stuck | stuck |
job 중단 여부 표시 |
| Tags | tags |
러너 태그 표시 |
| Triggered | triggered |
job 트리거 여부 표시 |
| Web path | webPath |
job의 웹 경로 표시 |
예시#
-
gitlab-org/gitlab프로젝트에서 실패한 모든 job을 나열합니다.```glql display: table fields: name, status, stage, startedAt query: type = Job and project = "gitlab-org/gitlab" and status = failed ``` -
gitlab-org/gitlab프로젝트에서 아티팩트가 있는 모든 job을 나열합니다.```glql display: table fields: name, status, stage query: type = Job and project = "gitlab-org/gitlab" and withArtifacts = true ```