풀 리퀘스트 리뷰
대부분의 인시던트는 변경에서 시작됩니다. Polylane은 연결된 리포지토리의 모든 풀 리퀘스트를 배포 대상 프로덕션 리소스에 대해 리뷰하고, pass 또는 fail을 알리는 댓글 하나를 남깁니다.
하는 일
에이전트가 diff와 함께 리포지토리가 배포하는 리소스의 라이브 메트릭, 로그, 열린 이슈를 읽은 뒤, 변경이 프로덕션에 해를 끼칠 수 있는지 판단합니다. 풀 리퀘스트에 댓글 하나, 선택적인 Polylane production impact 검사, 그리고 전체 분석이 담긴 콘솔 스레드를 받습니다.
동작 방식
- 기본 브랜치를 대상으로 풀 리퀘스트를 열거나, 푸시하거나, 리뷰 준비 완료로 표시하면 해당 head 커밋의 리뷰가 시작됩니다. 초안은 리뷰하지 않습니다.
- 이후의 푸시는 진행 중인 리뷰를 대체하므로, 최신 커밋만 판정됩니다.
- 문서, 테스트, CI 파일만 건드리는 변경은 조사 없이 통과합니다.
- Polylane은 리포지토리의 배포 엣지를 따라 프로덕션 리소스로 가고, 엣지가 없으면 워크스페이스의 클라우드 계정 전체에 대해 리뷰합니다.
- 에이전트가 스레드에서 조사하고
pass또는fail판정을 기록합니다. - 풀 리퀘스트당 댓글 하나가 리뷰마다 편집됩니다. fail은 영향 수준과 발견 사항과 함께 Hold this merge라고 표시되고, pass는 Production impact unlikely라고 표시되거나 감지된 이슈에 대한 수정이 해결할 것으로 예상되는지 알려 줍니다. 이후의 푸시가 우려를 해소하면 댓글이 다시 pass로 바뀌고 그 사실을 밝힙니다.
에이전트는 관측성 개선도 제안할 수 있으며, 제안 댓글을 묶은 리뷰 하나 또는 스택된 풀 리퀘스트로 제공합니다. 이 제안은 판정에 영향을 주지 않습니다.
리뷰에 대응하기
풀 리퀘스트의 댓글에서 @polylane을 멘션하면 Polylane이 같은 대화에서 답합니다. 멤버가 아닌 사람은 대신 접근 권한에 대한 안내를 받습니다.
| 요청 | 일어나는 일 |
|---|---|
| 질문 | 에이전트가 증거를 앞에 두고 리뷰 스레드에서 답합니다. |
| 다시 살펴보기 | 에이전트가 최신 푸시를 다시 리뷰하고 판정을 재고합니다. |
| 수정 | Polylane이 수정 실행을 시작하고 풀 리퀘스트의 브랜치를 대상으로 스택된 풀 리퀘스트를 열며, 댓글에서 링크합니다. |
콘솔에서 리포지토리의 Changes 탭에 모든 리뷰가 나열됩니다. fail에는 같은 수정 실행을 시작하는 Fix with Polylane과, 우려가 해당하지 않을 때를 위한 Dismiss가 있습니다: 풀 리퀘스트는 계속 리뷰되지만 Restore하기 전까지 댓글을 더 받지 않습니다.
| 상태 | 설명 |
|---|---|
| In review | Polylane이 최신 푸시를 리뷰하는 중입니다. |
| Flagged | 리뷰가 프로덕션 우려를 발견했습니다. |
| Passed | 프로덕션 우려가 발견되지 않았습니다. |
| Resolved | 이후의 푸시가 우려를 해소했습니다. |
| Dismissed | 멤버가 리뷰를 기각했습니다. 풀 리퀘스트는 댓글을 더 받지 않습니다. |
설정
리뷰는 연결된 모든 리포지토리에서 켜져 있습니다. Settings > Pull request reviews에서 워크스페이스 전체를 끄고, 리뷰 스레드를 풀 리퀘스트 열람자와 공유할지 설정합니다. Settings > Repositories 아래 리포지토리의 Settings 탭에는 세 가지 필드가 더 있습니다.
| 필드 | 설명 |
|---|---|
| Review pull requests for production impact | 이 리포지토리에서만 리뷰를 끕니다. |
| Pull request review instructions | 에이전트가 리뷰마다 읽는 자유 텍스트: 배포에 중요한 경로, 또는 다른 게이트가 이미 처리하는 우려. |
| Block merging on production concerns | 리뷰된 모든 풀 리퀘스트에 Polylane production impact 검사를 게시하며, 우려가 있으면 실패합니다. 기본으로 켜져 있습니다. 병합을 막으려면 브랜치 보호에서 필수로 지정하세요. |
풀 리퀘스트는 대기열에 들어가기 전에 리뷰되었으므로, 검사는 머지 큐 커밋에서도 완료됩니다. fail 판정은 Production Concern Found 이메일을 보낼 수 있으며, Notifications에서 기본으로 꺼져 있습니다.
플랜 참고 사항
각 플랜에는 월간 풀 리퀘스트 리뷰 횟수가 포함됩니다. Free 플랜의 허용량은 결제와 사용량에 나와 있으며, 허용량이 줄어들면 멤버에게 이메일이 발송됩니다. 허용량을 넘기면 콘솔은 풀 리퀘스트를 Production impact not verified로 기록하고 GitHub에는 아무것도 게시하지 않습니다.
관련 문서
- 리포지토리를 연결하고 리소스를 연결하려면 Repositories를 참고하세요.
- 리뷰 스레드가 판정에 도달하는 방식은 수정 실행을 참고하세요.
- 수정 실행이 여는 풀 리퀘스트는 Autofix를 참고하세요.
- 실패한 리뷰가 보낼 수 있는 이메일은 Notifications를 참고하세요.