파이프라인
GitLab v19.1- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated commit, commitPath, refPath, stages, user 필드가 GitLab 18.11에서 추가됨.
파이프라인#
-
Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
History
-
GitLab 18.11에서 도입됨.
-
commit,commitPath,refPath,stages,user필드가 GitLab 18.11에서 추가됨.파이프라인은 정렬을 지원하지 않습니다.
허용 범위#
| 범위 | 설명 |
|---|---|
| project | 특정 프로젝트의 파이프라인을 쿼리합니다. |
자세한 내용은 범위를 참조하세요.
쿼리 필드#
| 필드 | 이름 (및 별칭) | 연산자 |
|---|---|---|
| Author | author | = |
| Ref | ref | = |
| Scope | scope | = |
| SHA | sha | = |
| Source | source | = |
| Status | status | = |
| Updated at | updated, updatedAt | =, >, <, >=, <= |
Author#
설명: 파이프라인을 트리거한 사용자를 기준으로 파이프라인을 필터링합니다.
허용 값 유형:
-
String -
User(예:@username)
Ref#
설명: 파이프라인이 실행된 Git ref(브랜치 또는 태그 이름)를 기준으로 파이프라인을 필터링합니다.
허용 값 유형: String
Scope#
설명: 범위를 기준으로 파이프라인을 필터링합니다.
허용 값 유형:
Enum,branches,tags,finished,pending,running중 하나
SHA#
설명: 커밋 SHA를 기준으로 파이프라인을 필터링합니다.
허용 값 유형: String
Source#
설명: 파이프라인을 트리거한 원인을 기준으로 파이프라인을 필터링합니다.
허용 값 유형: String
Status#
설명: CI/CD 상태를 기준으로 파이프라인을 필터링합니다.
허용 값 유형:
Enum,canceled,canceling,created,failed,manual,pending,preparing,running,scheduled,skipped,success,waiting_for_callback,waiting_for_resource중 하나
Updated at#
설명: 파이프라인이 마지막으로 업데이트된 시간을 기준으로 파이프라인을 필터링합니다.
허용 값 유형:
-
AbsoluteDate(YYYY-MM-DD형식) -
RelativeDate(<부호><숫자><단위>형식, 부호는+,-, 또는 생략 가능, 숫자는 정수,단위는d(일),w(주),m(월),y(년) 중 하나)
참고 사항:
-
=연산자의 경우, 시간 범위는 사용자의 시간대에서 00:00부터 23:59까지로 간주됩니다. -
>=및<=연산자는 쿼리 대상 날짜를 포함하며,>및<연산자는 포함하지 않습니다.
표시 필드#
| 필드 | 이름 (및 별칭) | 설명 |
|---|---|---|
| Active | active | 파이프라인이 활성 상태인지 표시 |
| Cancelable | cancelable | 파이프라인을 취소할 수 있는지 표시 |
| Child | child | 자식 파이프라인 여부 표시 |
| Commit | commit | 커밋 세부 정보 표시 (ID, 짧은 ID, 제목, 작성자 이름, 웹 URL) |
| Commit path | commitPath | 파이프라인을 트리거한 커밋 경로 표시 |
| Committed at | committed, committedAt | 커밋 타임스탬프 표시 |
| Complete | complete | 파이프라인이 완료되었는지 표시 |
| Compute minutes | computeMinutes | 사용된 컴퓨트 시간(분) 표시 |
| Config source | configSource | 파이프라인 구성 소스 표시 |
| Coverage | coverage | 코드 커버리지 비율 표시 |
| Created at | created, createdAt | 파이프라인이 생성된 시간 표시 |
| Duration | duration | 파이프라인 실행 시간 표시 |
| Failed jobs count | failedJobsCount | 실패한 job 수 표시 |
| Failure reason | failureReason | 파이프라인 실패 이유 표시 |
| Finished at | finished, finishedAt | 파이프라인이 완료된 시간 표시 |
| ID | id | 파이프라인 ID 표시 |
| IID | iid | 파이프라인 내부 ID 표시 |
| Latest | latest | ref에 대한 최신 파이프라인 여부 표시 |
| Name | name | 파이프라인 이름 표시 |
| Path | path | 파이프라인 경로 표시 |
| Ref | ref | Git ref(브랜치 또는 태그) 표시 |
| Ref path | refPath | 파이프라인을 트리거한 ref 경로 표시 |
| Retryable | retryable | 파이프라인을 재시도할 수 있는지 표시 |
| SHA | sha | 커밋 SHA 표시 |
| Source | source | 파이프라인을 트리거한 원인 표시 |
| Stages | stages | 파이프라인 Stage 표시 (이름 및 상태) |
| Started at | started, startedAt | 파이프라인이 시작된 시간 표시 |
| Status | status | 파이프라인 상태 표시 |
| Stuck | stuck | 파이프라인이 멈춰 있는지 표시 |
| Total jobs | totalJobs | 전체 job 수 표시 |
| Updated at | updated, updatedAt | 파이프라인이 마지막으로 업데이트된 시간 표시 |
| User | user | 파이프라인을 트리거한 사용자 표시 |
| Warnings | warnings | 파이프라인 경고 표시 |
| YAML errors | yamlErrors | 파이프라인에 YAML 오류가 있는지 표시 |
| YAML error messages | yamlErrorMessages | YAML 오류 메시지 표시 |
알려진 문제#
- 날짜 범위가 넓은 쿼리는 타임아웃을 유발할 수 있습니다.
예시#
오늘 실패한 gitlab-org/gitlab 프로젝트의 모든 파이프라인 목록:
```glql
display: table
fields: id, ref, status, startedAt
query: type = Pipeline and project = "gitlab-org/gitlab" and status = failed and updated = today()
-
`gitlab-org/gitlab` 프로젝트의 모든 Duo 에이전트 파이프라인 목록:
display: table
fields: id, ref, status, source, startedAt
query: type = Pipeline and project = "gitlab-org/gitlab" and source = "duo_workflow"