GitLab Duo는 소프트웨어 개발 라이프사이클 전반에 걸쳐 도움을 주는 AI 네이티브 어시스턴트입니다.

GitLab Duo를 다음과 같이 사용하도록 구성할 수 있습니다:

• 클라우드 기반 AI Gateway(기본값): GitLab 호스팅 AI Gateway와 벤더 언어 모델.
• 자체 호스팅 모델: 데이터와 보안을 완전히 제어하기 위한 자체 AI Gateway 및 언어 모델.
• 하이브리드 구성: 일부 기능에는 자체 호스팅 모델을, 다른 기능에는 클라우드 기반 모델을 사용.

필수 요건#

• Silent Mode가 꺼져 있습니다.
• 인스턴스가 활성화 코드로 활성화되어 있습니다.
  • 라이선스 키는 사용할 수 없습니다.
  • 오프라인 라이선스로는 GitLab Duo를 사용할 수 없습니다. GitLab Duo Self-Hosted는 예외입니다.

GitLab 인스턴스에서 GitLab Duo로의 아웃바운드 연결 허용#

• GitLab 애플리케이션 노드는 HTTP/2를 통해 https://duo-workflow-svc.runway.gitlab.net에서 GitLab Duo Workflow에 연결할 수 있어야 합니다. 애플리케이션과 서비스는 gRPC로 통신합니다.
• GitLab Duo 에이전트 플랫폼 기능을 위해 방화벽 및 HTTP/S 프록시 서버는 https://를 사용하여 포트 443에서 duo-workflow-svc.runway.gitlab.net로의 아웃바운드 연결과 HTTP/2 트래픽 지원을 허용해야 합니다.

클라이언트에서 GitLab 인스턴스로의 인바운드 연결 허용#

GitLab 인스턴스는 IDE 클라이언트로부터의 인바운드 연결을 허용해야 합니다.

1. 다음 헤더를 포함한 WebSocket 프로토콜 업그레이드 요청을 허용합니다:
   • Connection: upgrade
   • Upgrade: websocket
   • HTTP/2 프로토콜 지원
   • 표준 WebSocket 보안 헤더: Sec-WebSocket-*
2. wss:// (WebSocket Secure) 프로토콜 지원을 활성화합니다.
3. 허용할 특정 엔드포인트를 추가합니다:
   • 기본 엔드포인트: wss://<customer-instance>/-/cable
   • HTTP/2 프로토콜이 HTTP/1.1로 다운그레이드되지 않도록 합니다.
   • 포트: 443 (HTTPS/WSS)

문제가 발생하는 경우:

• wss://gitlab.example.com/-/cable 및 기타 .com 도메인에 대한 WebSocket 트래픽 제한을 확인합니다.
• Apache와 같은 리버스 프록시를 사용하는 경우 로그에서 GitLab Duo Chat 연결 문제(예: WebSocket connection to .... failures)가 발생할 수 있습니다.

이 문제를 해결하려면 프록시 설정을 편집합니다:

# Enable WebSocket reverse Proxy
# Needs proxy_wstunnel enabled
  RewriteCond %{HTTP:Upgrade} websocket [NC]
  RewriteCond %{HTTP:Connection} upgrade [NC]
  RewriteRule ^/?(.*) "ws://127.0.0.1:8181/$1" [P,L]

러너로부터의 연결 허용#

플로우와 같이 러너를 사용하는 GitLab Duo 에이전트 플랫폼 기능의 경우, 러너가 GitLab 인스턴스에 연결할 수 있어야 합니다.

클라이언트에서 GitLab 인스턴스로의 인바운드 연결과 동일한 연결이 러너에서 GitLab 인스턴스로의 아웃바운드 연결로 허용되어야 합니다.

또한, 러너는 다음에 연결할 수 있어야 합니다:

조직에서 공개 npm 레지스트리 접근을 허용할 수 없는 경우, 필요한 종속성이 이미 설치된 사용자 정의 Docker 이미지를 사용할 수 있습니다.

GitLab과 사용 데이터 공유#

히스토리

• GitLab 18.9.1에서 도입됨.

서비스 품질 향상을 위해 GitLab Duo 에이전트 플랫폼 기능에 대한 사용 데이터를 GitLab과 공유할 수 있습니다.

데이터 수집을 켜면 GitLab이 GitLab Duo 기능 사용에 대한 정보를 기록합니다. 이 데이터는 서비스 개선 및 디버깅에만 사용되며 AI 모델 훈련에는 사용되지 않습니다.

수집되는 데이터에 대한 자세한 내용은 에이전트 플랫폼 사용 데이터를 참조하세요.

필수 요건:

• GitLab 18.9.1 이상이 있어야 합니다.

확장 로깅을 켜려면:

1. 오른쪽 상단 모서리에서 관리자를 선택합니다.
2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
3. 구성 변경을 선택합니다.
4. 사용 데이터 수집 체크박스를 선택합니다.
5. 변경 사항 저장을 선택합니다.

자체 호스팅 모델을 사용하는 데이터 사용#

자체 호스팅 AI 게이트웨이 및 자체 호스팅 모델을 사용하는 경우 자세한 로그가 인프라에 저장되며 GitLab과 공유되지 않습니다. GitLab과 데이터를 공유하려면 외부 관찰 가능성 서비스에 추적을 보내도록 자체 호스팅 AI Gateway를 구성해야 합니다.

Service Ping을 사용하여 사용 데이터를 GitLab에 보낼 수 있습니다. 이 데이터는 텔레메트리 데이터와 다릅니다.

GitLab Duo 헬스 체크 실행#

히스토리

• GitLab 17.3에서 도입됨.
• GitLab 17.5에서 헬스 체크 보고서 다운로드 추가됨.

인스턴스가 GitLab Duo 사용 요구 사항을 충족하는지 확인할 수 있습니다. 헬스 체크가 완료되면 통과 또는 실패 결과와 문제 유형이 표시됩니다. 헬스 체크가 테스트 중 하나라도 실패하면 사용자가 인스턴스에서 GitLab Duo 기능을 사용하지 못할 수 있습니다.

이것은 베타 기능입니다.

필수 요건:

• 관리자여야 합니다.

헬스 체크를 실행하려면:

1. 오른쪽 상단 모서리에서 관리자를 선택합니다.
2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
3. 오른쪽 상단 모서리에서 헬스 체크 실행을 선택합니다.
4. 선택 사항. GitLab 17.5 이상에서 헬스 체크가 완료된 후 보고서 다운로드를 선택하여 헬스 체크 결과의 자세한 보고서를 저장할 수 있습니다.

다음 테스트가 수행됩니다:

버전 17.10 이전의 GitLab 인스턴스에서 헬스 체크에 문제가 발생하는 경우 트러블슈팅 페이지를 참조하세요.

기타 호스팅 옵션#

기본적으로 GitLab Duo는 지원되는 AI 벤더 언어 모델을 사용하며 GitLab에서 호스팅하는 클라우드 기반 AI Gateway를 통해 데이터를 보냅니다.

자체 언어 모델 또는 AI Gateway를 호스팅하려는 경우:

• GitLab Duo Self-Hosted를 사용하여 AI Gateway를 호스팅하고 지원되는 자체 호스팅 모델을 사용할 수 있습니다. 이 옵션은 데이터와 보안을 완전히 제어합니다.
• 하이브리드 구성을 사용하여 일부 기능에는 자체 AI Gateway 및 모델을 호스팅하고 다른 기능은 GitLab AI Gateway 및 벤더 모델을 사용하도록 구성합니다.

관련 주제#

• GitLab Duo 기능 요약
• GitLab Duo 가용성 제어
• GitLab Duo 트러블슈팅