개요

Quality Gate로 Datadog에서 신호에 기반하여 워크플로의 통과를 제어할 수 있습니다. 규칙을 만들 때 규칙을 평가해야 하는 시점를 명시하는 규칙 범위를 정의할 수 있습니다.

특정 CI 파이프라인에 관해 평가되는 규칙을 필터링하려면, 규칙을 생성할 때 커스텀 범위를 추가합니다. 이 프로세스에서는 빌드 설정에서 datadog-ci gate evaluate 명령과 함께 --scope 옵션을 사용해야 합니다.

예시:

datadog-ci gate evaluate --scope team:backend --scope team:frontend

규칙 범위 정의하기

datadog-ci gate evaluate 명령이 호출되면 명령 컨텍스트와 매칭되는 범위의 규칙이 평가됩니다. backend 또는 frontend 팀 태그가 지정된 규칙을 기준으로 필터링할 수 있습니다.

각 범위(예: branch)에 대하여 포함 또는 제외되는 값을 선택할 수 있습니다.

• 포함된 값을 선택한 경우, 포함된 값 중 하나 이상이 명령 컨텍스트에 포함되어 있으면 규칙이 평가됩니다.
• 제외된 값을 선택한 경우, 제외된 값이 명령 컨텍스트의 일부라면 해당 규칙은 평가되지 않습니다.

example-repository 리포지토리의 main를 제외한 모든 브랜치에서 평가되는 규칙을 생성하려면, 다음 범위로 규칙을 생성할 수 있습니다.

1. Select when to evaluate를 클릭합니다.
2. Repository 필드에 example-repository를 입력하고 Include를 클릭합니다.
3. Add Filter를 클릭하고 Branch를 선택합니다.
4. Branch 필드에 main을 입력하고 Exclude를 클릭합니다.

규칙에 범위에 포함되지 않는 경우, 해당 범위의 모든 값을 평가합니다. 예를 들어, 규칙에 repository 범위가 포함되지 않으면 모든 리포지토리를 평가합니다.

커스텀 범위 추가하기

브랜치 및 리포지토리외에도 커스텀 범위를 정의하여 특정 CI 파이프라인을 평가하는 규칙을 필터링할 수 있습니다.

규칙 생성 시 커스텀 범위를 추가하려면 다음을 따릅니다.

1. +필터 추가를 클릭하고 **커스텀 범위 **를 선택합니다.
2. 범위 이름을 정의합니다(예: team).
3. 범위에 포함 또는 제외되는 값을 정의합니다.

branch 및 repository 범위와는 다르게 커스텀 범위는 반드시 --scope 옵션으로 datadog-ci gate evaluate 명령에 전달해야 합니다.

예를 들어 example-repository 리포지토리를 평가하는 규칙을 만들 수 있지만, 팀이 backend인 경우에만 만들 수 있습니다.

1. Select when to evaluate를 클릭합니다.

2. Repository 필드에 example-repository를 입력하고 Include를 클릭합니다.

3. Add Filter를 클릭하고 Custom scope를 선택합니다.

4. 태그 이름을 입력하고 Add Custom Scope를 클릭합니다.

5. team 필드에 backend를 입력하고 Include를 클릭합니다.

해당 규칙은 example-repository 리포지토리의 CI 파이프라인에서 다음 명령이 호출될 시 평가됩니다.

• datadog-ci gate evaluate --scope team:backend

다음 명령이 대신 호출되면 규칙이 평가되지 않습니다.

• 팀을 지정하지 않을 경우 datadog-ci gate evaluate입니다.
• backend 이외의 특정 팀을 지정하는 경우 datadog-ci gate evaluate --scope team:api --scope team:frontend입니다.

참고 자료

추가 유용한 문서, 링크 및 기사:

Quality Gate 게이트 설정 방법 알아보기설명서