코드 리뷰 플로우 문제 해결
GitLab v19.3요약
코드 리뷰 플로우를 사용할 때 다음과 같은 문제가 발생할 수 있습니다. 다음과 같은 오류가 표시될 수 있습니다. 이 오류는 기본 플로우 또는 코드 리뷰 플로우가 꺼져 있을 때 발생합니다. 관리자에게 문의하여 최상위 그룹에서 코드 리뷰 플로우를 켜도록 요청하세요.
코드 리뷰 플로우를 사용할 때 다음과 같은 문제가 발생할 수 있습니다.
오류 DCR4000#
다음과 같은 오류가 표시될 수 있습니다.
Code Review Flow is not enabled. Contact your group administrator to enable the foundational flow in the top-level group. Error code: DCR4000.
이 오류는 기본 플로우 또는 코드 리뷰 플로우가 꺼져 있을 때 발생합니다.
관리자에게 문의하여 최상위 그룹에서 코드 리뷰 플로우를 켜도록 요청하세요.
오류 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 설정 또는 일시적인 인프라 문제로 인해 이러한 토큰을 생성할 수 없을 때 발생합니다.
GitLab 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.
이 오류는 서비스 계정을 프로젝트의 멤버로 추가할 수 없을 때 발생합니다. 그룹 멤버십 잠금이 활성화되어 있거나 서비스 계정에 필요한 액세스 권한이 없을 때 발생할 수 있습니다.
관리자에게 문의하여 서비스 계정을 개발자로 프로젝트에 추가할 수 있는지 확인하도록 요청하세요.
오류 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.
이 오류는 코드 리뷰 플로우가 리뷰를 완료했지만 여러 번 시도한 후에도 리뷰 코멘트를 게시할 수 없을 때 발생합니다. 이는 대개 일시적인 인프라 문제로 인해 발생합니다.
새 리뷰를 요청하세요. 오류가 계속되면 관리자에게 문의하세요.
대규모 머지 리퀘스트 리뷰에서 컨텍스트 누락#
머지 리퀘스트에 변경된 대용량 파일이 많이 포함되어 있으면 코드 리뷰 플로우가 컨텍스트를 놓칠 수 있습니다.
이는 사전 스캔 결과가 파일 및 컨텍스트 제한을 초과하여 리뷰 전에 데이터가 잘릴 때 발생할 수 있습니다
리뷰를 개선하려면:
-
머지 리퀘스트를 더 작은 머지 리퀘스트로 분할합니다.
-
리뷰와 관련 없는 파일에 대해 컨텍스트를 제외합니다.
-
메인테이너 또는 오너에게 에이전틱 코드 리뷰(Agentic Code Review) 설정을 사용하여 다른 모델을 선택하도록 요청합니다.
구성 진단 스크립트#
문서화된 오류 코드로 코드 리뷰 플로우 문제의 원인을 파악할 수 없는 경우, 진단 스크립트를 실행하여 GitLab Duo 구성을 확인할 수 있습니다.
이 스크립트는 모든 GitLab Duo Agent Platform 기능에 적용되는 검사를 포함하여 코드 리뷰 플로우에 필요한 전체 구성 체인을 확인합니다.
자세한 내용은 구성 진단 스크립트 실행을 참조하세요.