코드 리뷰 플로 문제 해결
GitLab v19.4요약
코드 리뷰 플로를 사용할 때 다음과 같은 문제가 발생할 수 있습니다. 다음과 같은 오류가 표시될 수 있습니다. 이 오류는 foundational 플로 또는 코드 리뷰 플로가 꺼져 있을 때 발생합니다. 관리자에게 최상위 그룹에서 코드 리뷰 플로를 켜도록 요청합니다.
코드 리뷰 플로를 사용할 때 다음과 같은 문제가 발생할 수 있습니다.
오류 DCR4000#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow is not enabled. Contact your group administrator to enable the foundational flow in the top-level group. Error code: DCR4000.
이 오류는 foundational 플로 또는 코드 리뷰 플로가 꺼져 있을 때 발생합니다.
관리자에게 최상위 그룹에서 코드 리뷰 플로를 켜도록 요청합니다.
오류 DCR4001#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow is enabled but the service account needs to be verified. Contact your administrator. Error code: DCR4001.
이 오류는 코드 리뷰 플로가 켜져 있지만 최상위 그룹의 서비스 계정이 존재하지 않거나 준비되지 않았을 때 발생합니다.
관리자에게 서비스 계정이 존재하는지 확인하고 문제를 해결하는 단계를 따르도록 요청합니다.
오류 DCR4002#
다음과 같은 오류가 표시될 수 있습니다.
No GitLab Credits remain for this billing period. To continue using Code Review Flow, contact your administrator. Error code: DCR4002.
이 오류는 현재 청구 기간에 할당된 GitLab Credits를 모두 사용했을 때 발생합니다.
관리자에게 추가 크레딧 구매를 요청하거나, 다음 청구 기간이 시작되어 크레딧이 초기화될 때까지 기다립니다.
오류 DCR4003#
다음과 같은 오류가 표시될 수 있습니다.
, you don't have permission to create a pipeline for Code Review Flow in this project. Contact your administrator to update your permissions. Error code: DCR4003.
이 오류는 코드 리뷰 플로가 CI/CD 파이프라인에서 실행되는데, 이 프로젝트에서 파이프라인을 생성할 권한이 없을 때 발생합니다.
관리자에게 파이프라인 실행에 필요한 권한을 부여하도록 요청합니다.
오류 DCR4004#
다음과 같은 오류가 표시될 수 있습니다.
, you need to set a default GitLab Duo namespace to use Code Review Flow in this project. Please set a default GitLab Duo namespace in your preferences. Error code: DCR4004.
이 오류는 GitLab Duo가 리뷰를 시작한 사용자의 기본 GitLab Duo 네임스페이스를 식별하지 못할 때 발생합니다.
기본 설정에서 기본 GitLab Duo 네임스페이스를 설정한 다음 리뷰를 다시 요청합니다.
오류 DCR4005#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow could not obtain the required authentication tokens to connect to the GitLab AI Gateway and the GitLab API. Please request a new review. If the issue persists, contact your administrator. Error code: DCR4005.
코드 리뷰 플로는 GitLab AI Gateway와 GitLab API에 연결하기 위해 인증 토큰이 필요합니다. 이 오류는 해당 토큰을 생성하지 못할 때 발생하며, 대개 GitLab Duo 설정이 잘못되었거나 일시적인 인프라 문제가 원인입니다.
Self-Managed 인스턴스에서는 관리자에게 GitLab Duo 구성을 확인하도록 요청합니다.
오류 DCR4006#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow could not add the service account to this project. Contact your administrator to verify that the service account has the required project access. Error code: DCR4006.
이 오류는 서비스 계정을 프로젝트 멤버로 추가하지 못할 때 발생합니다. 그룹 멤버십 잠금이 활성화되어 있거나 서비스 계정에 필요한 액세스 권한이 없으면 발생할 수 있습니다.
관리자에게 서비스 계정을 developer로 프로젝트에 추가할 수 있는지 확인하도록 요청합니다.
오류 DCR4007#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow is not available for this project. Contact your administrator to verify that the flow is enabled and the required configuration is in place. Error code: DCR4007.
이 오류는 플로가 비활성화되어 있거나 프로젝트에 필요한 구성이 빠져 있을 때 발생합니다.
관리자에게 해당 프로젝트에서 플로가 활성화되어 있는지 확인하도록 요청합니다.
오류 DCR4008#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow could not create the required CI/CD pipeline. Please request a new review. If the problem persists, contact your administrator. Error code: DCR4008.
이 오류는 러너 가용성 문제나 내부 구성 문제 때문에 코드 리뷰 플로가 리뷰를 실행할 CI/CD 파이프라인을 생성하거나 구성하지 못할 때 발생합니다.
리뷰를 다시 시작합니다. 오류가 계속되면 관리자에게 문의합니다.
오류 DCR4009#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow could not retrieve the source branch for this merge request. Please request a new review. Error code: DCR4009.
이 오류는 코드 리뷰 플로가 머지 리퀘스트의 소스 브랜치를 가져오지 못할 때 발생합니다.
리뷰를 다시 시작합니다.
오류 DCR5000#
다음과 같은 오류가 표시될 수 있습니다.
Something went wrong while starting Code Review Flow. Please try again later. Error code: DCR5000.
이 오류는 내부 오류 때문에 GitLab Duo Agent Platform 이 코드 리뷰 플로를 시작하지 못할 때 발생합니다.
리뷰를 다시 시작합니다. 오류가 계속되면 관리자에게 문의합니다.
오류 DCR5001#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow completed the review but could not post the review comments. Please request a new review to try again. Error code: DCR5001.
이 오류는 코드 리뷰 플로가 리뷰를 마쳤지만 여러 번 시도한 뒤에도 리뷰 코멘트를 게시하지 못할 때 발생합니다. 대개 일시적인 인프라 문제가 원인입니다.
새 리뷰를 요청합니다. 오류가 계속되면 관리자에게 문의합니다.
대규모 머지 리퀘스트 리뷰에서 컨텍스트 누락#
머지 리퀘스트에 변경된 대용량 파일이 많으면 코드 리뷰 플로가 컨텍스트를 놓칠 수 있습니다.
이는 사전 스캔 결과가 파일 및 컨텍스트 제한을 초과해 리뷰 전에 데이터가 잘릴 때 발생할 수 있습니다.
리뷰 품질을 높이려면 다음을 수행합니다.
- 머지 리퀘스트를 더 작은 머지 리퀘스트로 나눕니다.
- 리뷰와 관련이 없는 파일은 컨텍스트에서 제외 합니다.
- 그룹 Owner 또는 인스턴스 관리자에게 GitLab.com 또는 GitLab Self-Managed 및 GitLab Dedicated에서 다른 모델을 선택하도록 요청합니다.
구성 진단 스크립트#
문서에 정리된 오류 코드로 코드 리뷰 플로 문제의 원인을 파악할 수 없다면, 진단 스크립트를 실행해 GitLab Duo 구성을 확인할 수 있습니다.
이 스크립트는 모든 GitLab Duo Agent Platform 기능에 적용되는 검사를 포함해, 코드 리뷰 플로에 필요한 전체 구성 체인을 확인합니다.
자세한 내용은 구성 진단 스크립트 실행을 참고합니다.