외부 파이프라인 유효성 검사

Tier: Free, Premium, Ultimate Offering: Self-managed

파이프라인이 생성되기 전에 외부 서비스를 사용하여 파이프라인을 유효성 검사할 수 있습니다.

GitLab은 파이프라인 데이터를 페이로드로 사용하여 외부 서비스 URL로 POST 요청을 보냅니다. 외부 서비스의 응답 코드에 따라 GitLab이 파이프라인을 수락할지 여부가 결정됩니다. 응답이 다음과 같은 경우:

  • 200이면 파이프라인이 수락됩니다.
  • 406이면 파이프라인이 거부됩니다.
  • 기타 코드인 경우 파이프라인이 수락되고 로그가 기록됩니다.

오류가 발생하거나 요청 시간이 초과되면 파이프라인이 수락됩니다.

외부 유효성 검사 서비스에 의해 거부된 파이프라인은 생성되지 않으며 GitLab UI 또는 API의 파이프라인 목록에 나타나지 않습니다. 거부된 파이프라인을 UI에서 생성하면 파이프라인을 실행할 수 없습니다. 외부 유효성 검사 실패가 표시됩니다.

외부 파이프라인 유효성 검사 구성

외부 파이프라인 유효성 검사를 구성하려면 EXTERNAL_VALIDATION_SERVICE_URL 환경 변수를 추가하여 외부 서비스 URL로 설정하십시오.

기본적으로, 외부 서비스로의 요청은 5초 후에 시간 초과됩니다. 기본 설정을 재정의하려면 EXTERNAL_VALIDATION_SERVICE_TIMEOUT 환경 변수를 필요한 초 단위로 설정하십시오.

페이로드 스키마

{
  "type": "object",
  "required" : [
    "project",
    "user",
    "credit_card",
    "pipeline",
    "builds",
    "total_builds_count",
    "namespace"
  ],
  "properties" : {
    ...
  }
}

namespace 필드는 GitLab 프리미엄 및 얼티밋에서만 사용할 수 있습니다.