문서

품질 정책 및 검증 기준

수행해야 할 작업을 정의하고 프로젝트에 연결한 뒤 안전하게 변경하세요.

“정책”이란정책은 명명되고 버전이 관리되는 품질 게이트 집합입니다. 정책은 프로젝트에 연결되는 항목이며, 실제로 적용되는 것은 게이트입니다.

개념에 대해 알아보려면 — 차단형과 권고형의 차이, 게이트가 실행 과정에서 어떤 위치에 있는지 — 먼저품질 게이트를 확인하세요. 이 페이지에서는 이를 관리하는 방법을 설명합니다.

해당 항목은 “품질 → 정책.

정책 생성하기

정책이란 검사 항목들의 집합이며, 각 항목별로 실패 시 차단할지 아니면 권고만 할지를 지정합니다.

대부분의 조직에서는 프로젝트별로 하나씩 두는 대신 두세 가지 정책만 필요합니다.

  • 엄격한정책은 운영 환경의 서비스에 적용됩니다.
  • 표준정책은 일반적인 작업에 사용됩니다.
  • 간혹 “완화된정책은 내부 도구와 프로토타입에 적용됩니다.

그보다 더 많은 정책을 둘 경우, 어떤 프로젝트에 어떤 정책이 적용되는지 아무도 기억하지 못하게 됩니다.

프로젝트에 정책 연결하기

각 프로젝트는 하나의 정책을 적용받습니다. 프로젝트의 품질 설정에서 이를 변경할 수 있습니다.

명시적인 정책이 지정되지 않은 프로젝트는 조직의 기본 정책을 따릅니다. 이 기본 정책은표준정책으로 설정하되, 가장 엄격한 정책은 의도적으로 선택해야 합니다.

안전하게 배포하기

게이트의 문제는 너무 약해서가 아니라, 선의에서 비롯된 차단형 게이트가 조직 내 모든 작업을 한꺼번에 중단시키는 것입니다.

안전한 절차는 다음과 같습니다:

  1. 게이트를 “권고형.
  2. 실제 작업에서 일주일에서 이주일 정도 실행시킨 뒤, 어떤 항목이 감지되는지 확인하세요.
  3. 확인된 결과를 바탕으로 게이트를 조정하세요.
  4. 그런 다음 “차단형으로 전환하세요. 단, 하나의 프로젝트에 한해서 적용합니다.
  5. 정상적으로 작동하는 것이 확인되면 더 넓은 범위에 적용하세요.

버전 관리 및 롤백

정책은 버전이 관리됩니다. 새 버전을 게시하면 이전 버전으로 쉽게 롤백할 수 있습니다.

롤백 기능 덕분에 게시 결정을 신중하게 내릴 수 있습니다. 새 게이트가 잘못 설정되더라도 되돌리는 것은 단 한 번의 작업으로 가능하며, 복잡한 복구 과정을 거칠 필요가 없습니다.

재정의

권한이 있는 사용자는 차단형 게이트를 재정의할 수 있습니다. 이때 누가, 언제, 무엇에 대해 재정의했는지는 반드시 기록됩니다.

재정의 비율을 주의 깊게 모니터링하세요. 게이트가 발동될 때마다 대부분 재정의된다면, 그 게이트는 더 이상 제약력을 발휘하지 못하고 오히려 불필요한 마찰과 문서 작업만 발생시킵니다. 이 경우 게이트를 수정하거나 삭제해야 합니다.