Jobs
GitLab v19.1- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated 필드 browseArtifactsPath, canPlayJob, commitPath, createdByTag, exitCode, pipeline, playPath, queuedDuration, refPath, retryPath, scheduledAt가 GitLab...
Jobs#
-
Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
히스토리
-
GitLab 18.11에서 도입됨.
-
필드
browseArtifactsPath,canPlayJob,commitPath,createdByTag,exitCode,pipeline,playPath,queuedDuration,refPath,retryPath,scheduledAt가 GitLab 18.11에서 추가됨.Jobs는 정렬을 지원하지 않습니다.
허용 범위#
| 범위 | 설명 |
|---|---|
| project | 특정 프로젝트의 job을 조회합니다. |
자세한 내용은 범위를 참고하세요.
쿼리 필드#
| 필드 | 이름 | 연산자 |
|---|---|---|
| Kind | kind | = |
| Pipeline | pipeline | = |
| Status | status | = |
| With artifacts | withArtifacts | =, != |
Kind#
설명: job을 종류별로 필터링합니다.
허용 값 유형:
Enum,bridge또는build중 하나
참고:
-
bridgejob은 다운스트림 파이프라인을 시작하는 트리거 job입니다. -
buildjob은 일반 CI/CD job입니다.
Pipeline#
설명: 파이프라인 IID를 사용하여 job이 속한 파이프라인으로 job을 필터링합니다.
허용 값 유형: Number (파이프라인 IID)
Status#
설명: job을 CI/CD 상태별로 필터링합니다.
허용 값 유형:
Enum,canceled,canceling,created,failed,manual,pending,preparing,running,scheduled,skipped,success,waiting_for_callback, 또는waiting_for_resource중 하나
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 나열:
display: table
fields: name, status, stage
query: type = Job and project = "gitlab-org/gitlab" and withArtifacts = true