• 전제 조건
• 셀프 관리 인스턴스에서 GitLab Duo 구성
  • GitLab 인스턴스에서 외부 연결 허용
  • 클라이언트에서 GitLab 인스턴스로의 인바운드 연결 허용
• GitLab Duo의 상태 점검 실행
  • 상태 점검 테스트
    • 온라인 환경의 경우
    • 오프라인 환경의 경우
• GitLab Duo 기능 끄기
  • 그룹에서 끄기
  • 프로젝트에서 끄기
  • 인스턴스에서 끄기
• 베타 및 실험적 기능 활성화
  • GitLab.com에서
  • Self-managed
• 문제 해결
  • self-managed에서 GitLab Duo 기능이 작동하지 않음
  • GitLab Duo 기능이 사용자에게 제공되지 않는 경우

GitLab Duo 가용성 제어

• GitLab 16.10에 도입된 AI 기능 끄기 위한 설정.
• GitLab 16.11에 UI에 추가된 AI 기능 끄기 위한 설정.

일반적으로 사용 가능한 GitLab Duo 기능은 접근 권한이 있는 모든 사용자에게 자동으로 활성화됩니다.

전제 조건

• 셀프 관리 GitLab이 있는 경우:

  • 연결 허용해야 합니다.

  • 정적 모드는 비활성화되어 있어야 합니다.

  • 활성화 코드로 인스턴스를 활성화해야 합니다.

  • GitLab Duo는 최고의 사용자 경험과 결과를 위해 GitLab 17.2 이상이 필요합니다. 이전 버전도 계속 작동할 수 있으나, 경험이 저하될 수 있습니다.

• GitLab 전용이 있는 경우, GitLab Duo Pro 또는 Enterprise가 있어야 합니다.

• 코드 제안과 같은 일부 일반적으로 사용 가능한 기능의 경우,

  사용자에게 접근을 허용하기 위해 좌석을 할당해야 합니다.

실험적 또는 베타인 GitLab Duo 기능은 기본적으로 비활성화되어 있으며

활성화해야 합니다.

셀프 관리 인스턴스에서 GitLab Duo 구성

셀프 관리 인스턴스에서 GitLab Duo를 사용하려면, 외부 및 내부 연결이 모두 존재하는지 확인해야 합니다.

예를 들어, 네트워크 방화벽이 지연을 초래할 수 있습니다. 외부 및 내부 설정을 모두 확인하세요:

GitLab 인스턴스에서 외부 연결 허용

• 귀하의 방화벽과 HTTP/S 프록시 서버는 포트 443에서 cloud.gitlab.com 및 customers.gitlab.com에 대한 외부 연결을 허용해야 하며, 둘 다 https://를 사용해야 합니다. 이러한 호스트는 Cloudflare에 의해 보호됩니다. 귀하의 방화벽 설정을 업데이트하여 Cloudflare가 게시한 IP 범위 목록의 모든 IP 주소로 트래픽을 허용하세요.

• HTTP/S 프록시를 사용하려면, gitLab_workhorse와 gitLab_rails 모두 필요한

  웹 프록시 환경 변수를 설정해야 합니다.

• 다중 노드 GitLab 설치에서는 모든 Rails 및 Sidekiq 노드에서 HTTP/S 프록시를 구성해야 합니다.

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

• GitLab 인스턴스는 Duo 클라이언트(IDEs, 코드 편집기 및 GitLab 웹 프론트엔드)에서 포트 443의 https:// 및 wss://를 통한 인바운드 연결을 허용해야 합니다.

• HTTP2와 'upgrade' 헤더를 모두 허용해야 합니다, 왜냐하면 GitLab Duo는 REST와 웹소켓을 모두 사용하기 때문입니다.

• wss://gitlab.example.com/-/cable 및 기타 .com 도메인에 대한 WebSocket (wss://) 트래픽에 대한 제한 사항을 확인해주세요. wss:// 트래픽에 대한 네트워크 정책 제한은 일부 GitLab Duo 채팅 서비스에 문제를 일으킬 수 있습니다. 이러한 서비스를 허용하기 위해 정책 업데이트를 고려하세요.

• Apache와 같은 리버스 프록시를 사용하는 경우, 로그에서 … 실패에 대한 웹소켓 연결과 같은 GitLab Duo 채팅 연결 문제를 볼 수 있습니다.

이 문제를 해결하려면 Apache 프록시 설정을 편집해 보세요:

# 웹소켓 리버스 프록시 활성화
# proxy_wstunnel이 활성화되어야 함
  RewriteCond %{HTTP:Upgrade} websocket [NC]
  RewriteCond %{HTTP:Connection} upgrade [NC]
  RewriteRule ^/?(.*) "ws://127.0.0.1:8181/$1" [P,L]

GitLab Duo의 상태 점검 실행

• GitLab 17.3에서 도입됨.

GitLab Duo를 사용하기 위한 요구 사항을 충족하는지 확인하기 위해 상태 점검을 실행합니다.
상태 점검이 완료되면 통과 또는 실패 결과와 문제 유형이 표시됩니다.
상태 점검이 테스트 중 하나라도 실패하면, 사용자들은 귀하의 인스턴스에서 GitLab Duo 기능을 사용할 수 없을 수도 있습니다.

이것은 베타 기능입니다.

사전 요구 사항:

• 관리자여야 합니다.

상태 점검을 실행하려면:

1. 왼쪽 사이드바에서 하단의 Admin를 선택합니다.
2. GitLab Duo를 선택합니다.
3. 오른쪽 상단에서 Run health check를 선택합니다.

상태 점검 테스트

귀하의 인스턴스가 GitLab Duo를 사용하기 위한 요구 사항을 충족하는지 확인하기 위해 상태 점검은 온라인 및 오프라인 환경에 대한 테스트를 수행합니다.

온라인 환경의 경우

오프라인 환경의 경우

GitLab Duo 기능 끄기

그룹, 프로젝트 또는 인스턴스에 대해 GitLab Duo를 끌 수 있습니다.

그룹, 프로젝트 또는 인스턴스에서 GitLab Duo가 꺼지면:

• 코드, 문제 및 취약성과 같은 리소스에 접근하는 GitLab Duo 기능이 제공되지 않습니다.
• 코드 제안은 사용할 수 없습니다.

그러나 GitLab Duo Chat은 다르게 작동합니다. GitLab Duo를 끌 때:

• 그룹 또는 프로젝트의 경우:
  • GitLab Duo Chat에 질문을 여전히 할 수 있습니다. 이러한 질문은 GitLab에 관한 것 또는 코드에 대한 일반 질문과 같은 일반적이어야 합니다. GitLab Duo Chat은 그룹 또는 프로젝트 리소스에 접근하지 않으며, 이에 대한 질문을 거부합니다.
• 인스턴스의 경우:
  • UI의 어느 곳에서도 GitLab Duo Chat 버튼이 제공되지 않습니다.

그룹에서 끄기

프로젝트에서 끄기

인스턴스에서 끄기

베타 및 실험적 기능 활성화

GitLab Duo의 실험적 및 베타 기능은 기본적으로 꺼져 있습니다.
이 기능은 테스트 계약서의 적용을 받습니다.

GitLab.com에서

이 설정은 해당 그룹에 속한 모든 프로젝트에 전파됩니다.

Self-managed

문제 해결

self-managed에서 GitLab Duo 기능이 작동하지 않음

GitLab Duo 기능 활성화 외에도 다음을 수행할 수 있습니다.

1. 관리자로서 GitLab Duo의 상태 점검을 실행합니다.

2. GitLab 인스턴스가 필요한 GitLab.com 엔드포인트에 접근할 수 있는지 확인합니다.
   명령행 도구인 curl을 사용하여 연결 상태를 확인할 수 있습니다.

    curl --verbose "https://cloud.gitlab.com"  
   
    curl --verbose "https://customers.gitlab.com"  
   

   GitLab 인스턴스에 대해 HTTP/S 프록시가 구성된 경우, curl 명령에 proxy 매개변수를 포함합니다.

    # curl에 대한 https 프록시  
    curl --verbose --proxy "http://USERNAME:PASSWORD@example.com:8080" "https://cloud.gitlab.com"  
    curl --verbose --proxy "http://USERNAME:PASSWORD@example.com:8080" "https://customers.gitlab.com"  
   

3. 구독 데이터 수동 동기화를 수행합니다.
   • GitLab 인스턴스가 GitLab과 구독 데이터를 동기화하는지 확인합니다.

GitLab Duo 기능이 사용자에게 제공되지 않는 경우

GitLab Duo 기능을 켜는 방법 외에도 다음을 수행할 수 있습니다:

1. 구독 좌석이 구매되었는지 확인하세요.
2. 좌석이 사용자에게 할당되었는지 확인하세요.
3. GitLab Duo 확장을 사용하는 IDE 사용자에 대해:
   • 확장이 최신인지 확인하세요.
   • 확장 설정 상태 검사를 실행하고 인증을 테스트하세요.