히스토리

• GitLab 18.0에서 GitLab Duo Core 애드온 포함으로 변경.
• GitLab 18.3에서 UI의 GitLab Duo Chat(비 에이전틱)이 Core에 추가.
• GitLab 18.4에서 셀프 매니지드에서 시트 할당 이메일 비활성화 기능 추가.

GitLab Duo 애드온은 Premium 또는 Ultimate 구독을 AI 네이티브 기능으로 확장합니다. GitLab Duo를 사용하여 개발 워크플로우 가속화, 반복적인 코딩 작업 감소, 프로젝트 전반에 걸친 더 깊은 인사이트 확보를 지원합니다.

세 가지 애드온이 있습니다: GitLab Duo Core, Pro, Enterprise.

각 애드온은 GitLab Duo 기능 세트에 대한 접근을 제공합니다.

GitLab Duo Core#

다음과 같은 경우 GitLab Duo Core가 자동으로 포함됩니다:

• GitLab 18.0 이상.
• Premium 또는 Ultimate 구독.

GitLab 17.11 이하의 기존 고객인 경우 GitLab Duo Core 기능을 켜야 합니다.

GitLab 18.0 이상의 신규 고객인 경우 GitLab Duo Core 기능이 자동으로 켜져 있으며 추가 조치가 필요하지 않습니다.

GitLab Duo Core에 접근할 수 있는 역할을 보려면 GitLab Duo 그룹 권한을 참조하세요.

히스토리

• GitLab Duo Core 사용자의 GitLab Duo 비 에이전틱 Chat 접근이 GitLab 19.0의 일부로 2026년 5월 21일에 제거되었습니다. no_duo_classic_for_duo_core_users라는 기능 플래그로 관리됩니다. 기본적으로 활성화되어 있습니다.

GitLab Duo 셀프 호스팅#

오프라인 라이선스가 있는 경우 GitLab Duo Core는 GitLab AI 게이트웨이에 연결이 필요하므로 GitLab Duo 셀프 호스팅에서 사용할 수 없습니다.

온라인 라이선스가 있는 경우 GitLab Duo 셀프 호스팅과 함께 GitLab Duo Core를 사용할 수 있습니다. GitLab Duo Core를 사용하려면 인스턴스에 대한 Code Suggestions에 GitLab 관리 모델을 선택해야 합니다.

GitLab Duo Core 제한#

Premium 및 Ultimate 고객의 경우 GitLab Duo Core에는 Code Suggestions 및 GitLab 19.0 이상에서 GitLab Duo 에이전틱 Chat에 대한 접근이 포함됩니다.

이러한 기능에 대한 접근은 GitLab 서비스 약관 및 사용량 청구의 적용을 받습니다.

GitLab은 이 제한이 적용되기 30일 전에 사전 공지를 제공합니다. 그 때 조직 관리자는 소비를 모니터링하고 관리하는 도구를 갖게 되며 추가 용량을 구매할 수 있게 됩니다.

제한은 GitLab Duo Pro 또는 Enterprise에는 적용되지 않습니다.

GitLab Duo Core 기능 접근 변경 사항#

2026년 5월 21일부터 모든 GitLab 버전의 GitLab Duo Core 사용자는 GitLab Duo 비 에이전틱 Chat에 접근할 수 없습니다.

대신 GitLab Duo Core 사용자는 다음 GitLab Duo Agent Platform 기능을 사용하여 비 에이전틱 기능이 수행했던 질문에 답하고 작업을 완료할 수 있습니다:

• GitLab Duo 에이전틱 Chat.
• 기본, 사용자 정의 및 외부 에이전트.
• 기본 및 사용자 정의 흐름.
• GitLab Duo Code Suggestions.

이러한 기능을 사용하려면 GitLab Credits가 있어야 합니다.

Agent Platform 사용 방법에 대한 자세한 내용은 다음을 참조하세요:

• GitLab Duo Chat 프롬프트 예제
• 에이전트
• 흐름

GitLab Duo Pro 및 Enterprise#

GitLab Duo Pro 및 Enterprise는 시트를 구매하여 팀원에게 할당해야 합니다. 시트 기반 모델은 특정 팀 필요에 따라 기능 접근 및 비용 관리를 제어할 수 있게 합니다.

GitLab Duo Agent Platform 셀프 호스팅#

히스토리

• GitLab 18.8에서 도입

오프라인 라이선스를 가진 고객은 Agent Platform에서 셀프 호스팅 모델을 사용하기 위해 GitLab Duo Agent Platform 셀프 호스팅 애드온을 구매해야 합니다.

이 애드온을 가진 고객은 사용량 대신 시트를 기반으로 청구됩니다.

온라인 라이선스를 가진 고객은 애드온 없이 Agent Platform에서 셀프 호스팅 모델을 사용할 수 있으며 사용량을 기반으로 청구됩니다.

GitLab Duo Agent Platform 셀프 호스팅을 구매하려면 GitLab 영업팀에 문의하세요.

GitLab Duo 구매#

GitLab Duo Enterprise를 구매하려면 GitLab 영업팀에 문의하세요.

GitLab Duo Pro 시트를 구매하려면 Customers Portal을 사용하거나 GitLab 영업팀에 문의하세요.

포털을 사용하려면:

1. GitLab Customers Portal에 로그인하세요.
2. 구독 카드에서 수직 줄임표(⋮)를 선택하세요.
3. GitLab Duo Pro 구매를 선택하세요.
4. GitLab Duo의 시트 수를 입력하세요.
5. 구매 요약 섹션을 검토하세요.
6. 결제 방법 드롭다운 목록에서 결제 방법을 선택하세요.
7. 시트 구매를 선택하세요.

추가 GitLab Duo 시트 구매#

그룹 네임스페이스 또는 GitLab Self-Managed 인스턴스에 대한 추가 GitLab Duo Pro 또는 GitLab Duo Enterprise 시트를 구매할 수 있습니다. 구매를 완료하면 시트가 구독의 총 GitLab Duo 시트 수에 추가됩니다.

사전 요구 사항:

• GitLab Duo Pro 또는 GitLab Duo Enterprise 애드온을 구매해야 합니다.

GitLab.com의 경우#

사전 요구 사항:

• Owner 권한이 있어야 합니다.

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾으세요.
2. 왼쪽 사이드바에서 설정 > GitLab Duo를 선택하세요.
3. 시트 활용에서 시트 할당을 선택하세요.
4. 시트 구매를 선택하세요.
5. Customers Portal에서 추가 시트 필드에 시트 수를 입력하세요. 이 수는 그룹 네임스페이스와 연결된 구독의 시트 수보다 높을 수 없습니다.
6. 청구 정보 섹션에서 드롭다운 목록에서 결제 방법을 선택하세요.
7. 개인 정보 보호 정책 및 서비스 약관 체크박스를 선택하세요.
8. 시트 구매를 선택하세요.
9. GitLab SaaS 탭을 선택하고 페이지를 새로 고침하세요.

GitLab Self-Managed 및 GitLab Dedicated의 경우#

사전 요구 사항:

• 관리자여야 합니다.

1. GitLab Customers Portal에 로그인하세요.
2. 구독 카드의 GitLab Duo Pro 섹션에서 시트 추가를 선택하세요.
3. 시트 수를 입력하세요. 이 수는 구독의 시트 수보다 높을 수 없습니다.
4. 구매 요약 섹션을 검토하세요.
5. 결제 방법 드롭다운 목록에서 결제 방법을 선택하세요.
6. 시트 구매를 선택하세요.

GitLab Duo 시트 할당#

사전 요구 사항:

• GitLab Duo Pro 또는 Enterprise 애드온을 구매했거나 활성 GitLab Duo 트라이얼이 있어야 합니다.
• GitLab Self-Managed 및 GitLab Dedicated의 경우:
  • GitLab Duo Pro 애드온은 GitLab 16.8 이상에서 사용 가능합니다.
  • GitLab Duo Enterprise 애드온은 GitLab 17.3 이상에서만 사용 가능합니다.

GitLab Duo Pro 또는 Enterprise를 구매한 후 사용자에게 시트를 할당하여 애드온 접근 권한을 부여할 수 있습니다.

GitLab.com의 경우#

사전 요구 사항:

• Owner 권한이 있어야 합니다.

프로젝트 또는 그룹에서 GitLab Duo 기능을 사용하려면 최소 하나의 최상위 그룹에서 사용자에게 시트를 할당해야 합니다.

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾으세요.
2. 왼쪽 사이드바에서 설정 > GitLab Duo를 선택하세요.
3. 시트 활용에서 시트 할당을 선택하세요.
4. 사용자 오른쪽에서 토글을 켜서 GitLab Duo 시트를 할당하세요.

사용자에게 확인 이메일이 전송됩니다.

GitLab Self-Managed의 경우#

사전 요구 사항:

• 관리자여야 합니다.

1. 오른쪽 상단에서 관리자를 선택하세요.
2. 왼쪽 사이드바에서 GitLab Duo를 선택하세요.
   • GitLab Duo 메뉴 항목이 없으면 구매 후 구독을 동기화하세요:
     1. 왼쪽 사이드바에서 구독을 선택하세요.
     2. 구독 세부 정보에서 마지막 동기화 오른쪽에 있는 구독 동기화([retry])를 선택하세요.
3. 시트 활용에서 시트 할당을 선택하세요.
4. 사용자 오른쪽에서 토글을 켜서 GitLab Duo 시트를 할당하세요.

사용자에게 확인 이메일이 전송됩니다.

• 이 이메일을 비활성화하려면 sm_duo_seat_assignment_email 기능 플래그를 false로 설정하세요. 이 플래그는 기본적으로 활성화되어 있습니다.

시트를 할당한 후 GitLab Self-Managed 인스턴스에 GitLab Duo가 설정되어 있는지 확인하세요.

GitLab Duo 시트 일괄 할당 및 제거#

여러 사용자에게 시트를 일괄 할당하거나 제거할 수 있습니다.

SAML 그룹 동기화#

GitLab.com 그룹은 SAML 그룹 동기화를 사용하여 GitLab Duo 시트 할당을 관리할 수 있습니다.

GitLab.com의 경우#

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾으세요.
2. 왼쪽 사이드바에서 설정 > GitLab Duo를 선택하세요.
3. 오른쪽 하단에서 선택 가능한 사용자 수를 늘리기 위해 50 또는 100 항목을 표시하도록 페이지 표시를 조정할 수 있습니다.
4. 시트를 할당하거나 제거할 사용자를 선택하세요:
   • 여러 사용자를 선택하려면 각 사용자 왼쪽에서 체크박스를 선택하세요.
   • 모두 선택하려면 테이블 맨 위의 체크박스를 선택하세요.
5. 시트를 할당하거나 제거하세요:
   • 시트를 할당하려면 시트 할당을 선택한 다음 확인하려면 시트 할당을 선택하세요.
   • 시트에서 사용자를 제거하려면 시트 제거를 선택한 다음 확인하려면 시트 제거를 선택하세요.

GitLab Self-Managed의 경우#

사전 요구 사항:

• 관리자여야 합니다.
• GitLab 17.5 이상이어야 합니다.

1. 오른쪽 상단에서 관리자를 선택하세요.
2. 왼쪽 사이드바에서 GitLab Duo를 선택하세요.
3. 오른쪽 하단에서 선택 가능한 사용자 수를 늘리기 위해 50 또는 100 항목을 표시하도록 페이지 표시를 조정할 수 있습니다.
4. 시트를 할당하거나 제거할 사용자를 선택하세요:
   • 여러 사용자를 선택하려면 각 사용자 왼쪽에서 체크박스를 선택하세요.
   • 모두 선택하려면 테이블 맨 위의 체크박스를 선택하세요.
5. 시트를 할당하거나 제거하세요:
   • 시트를 할당하려면 시트 할당을 선택한 다음 확인하려면 시트 할당을 선택하세요.
   • 시트에서 사용자를 제거하려면 시트 제거를 선택한 다음 확인하려면 시트 제거를 선택하세요.
6. 사용자 오른쪽에서 토글을 켜서 GitLab Duo 시트를 할당하세요.

GitLab Self-Managed 인스턴스 관리자는 Rake 태스크를 사용하여 시트를 일괄 할당하거나 제거할 수도 있습니다.

LDAP 구성으로 GitLab Duo 시트 관리#

LDAP 그룹 멤버십을 기반으로 LDAP 활성화된 사용자에 대한 GitLab Duo 시트를 자동으로 할당하고 제거할 수 있습니다.

이 기능을 활성화하려면 LDAP 설정에서 duo_add_on_groups 속성을 구성해야 합니다.

duo_add_on_groups가 구성되면 LDAP 활성화된 사용자 간의 GitLab Duo 시트 관리의 단일 출처가 됩니다. 자세한 내용은 시트 할당 워크플로우를 참조하세요.

이 자동화 프로세스는 조직의 LDAP 그룹 구조를 기반으로 GitLab Duo 시트가 효율적으로 할당되도록 합니다. 자세한 내용은 LDAP를 사용한 GitLab Duo 애드온 시트 관리를 참조하세요.

할당된 GitLab Duo 사용자 보기#

히스토리

• 마지막 GitLab Duo 활동 필드가 GitLab 18.0에서 도입.

사전 요구 사항:

• GitLab Duo Pro 또는 Enterprise 애드온을 구매했거나 활성 GitLab Duo 트라이얼이 있어야 합니다.

GitLab Duo Pro 또는 Enterprise를 구매한 후 사용자에게 시트를 할당하여 애드온 접근 권한을 부여할 수 있습니다. 그런 다음 할당된 GitLab Duo 사용자의 세부 정보를 볼 수 있습니다.

GitLab Duo 시트 활용 페이지는 각 사용자에 대해 다음 정보를 표시합니다:

• 사용자의 전체 이름 및 사용자 이름
• 시트 할당 상태
• 공개 이메일 주소: 사용자의 공개 프로필에 표시되는 이메일.
• 마지막 GitLab 활동: 사용자가 GitLab에서 마지막으로 작업을 수행한 날짜.
• 마지막 GitLab Duo 활동: 사용자가 GitLab Duo 기능을 마지막으로 사용한 날짜. GitLab Duo 활동 시 새로 고침됩니다.

이 필드들은 GraphQL API의 AddOnUser 유형에서 데이터를 사용합니다.

GitLab.com의 경우#

사전 요구 사항:

• Owner 권한이 있어야 합니다.

1. 상단 표시줄에서 검색 또는 이동을 선택하고 그룹을 찾으세요.
2. 왼쪽 사이드바에서 설정 > GitLab Duo를 선택하세요.
3. 시트 활용에서 시트 할당을 선택하세요.
4. 필터 표시줄에서 할당된 시트와 예를 선택하세요.
5. 사용자 목록이 GitLab Duo 시트가 할당된 사용자만 표시되도록 필터링됩니다.

GitLab Self-Managed의 경우#

사전 요구 사항:

• 관리자여야 합니다.
• GitLab 17.5 이상이어야 합니다.

1. 오른쪽 상단에서 관리자를 선택하세요.
2. 왼쪽 사이드바에서 GitLab Duo를 선택하세요.
   • GitLab Duo 메뉴 항목이 없으면 구매 후 구독을 동기화하세요:
     1. 왼쪽 사이드바에서 구독을 선택하세요.
     2. 구독 세부 정보에서 마지막 동기화 오른쪽에 있는 구독 동기화([retry])를 선택하세요.
3. 시트 활용에서 시트 할당을 선택하세요.
4. GitLab Duo 시트가 할당된 사용자로 필터링하려면 사용자 필터 표시줄에서 할당된 시트를 선택한 다음 예를 선택하세요.
5. 사용자 목록이 GitLab Duo 시트가 할당된 사용자만 표시되도록 필터링됩니다.

자동 시트 제거#

GitLab Duo 애드온 시트는 적격 사용자만 접근할 수 있도록 자동으로 제거됩니다. 이는 다음과 같은 경우에 발생합니다:

• 시트 초과
• 차단, 금지 및 비활성화된 사용자

구독 만료 시#

GitLab Duo 애드온이 포함된 구독이 만료되면 시트 할당이 28일 동안 유지됩니다. 구독이 갱신되거나 이 28일 기간 내에 GitLab Duo가 포함된 새 구독을 구매하면 사용자가 자동으로 재할당됩니다. 그렇지 않으면 시트 할당이 제거되고 사용자를 다시 할당해야 합니다.

시트 초과의 경우#

구매한 GitLab Duo 애드온 시트 수가 줄면 구독에서 사용 가능한 시트 수와 일치하도록 시트 할당이 자동으로 제거됩니다.

예를 들어:

• 모든 시트가 할당된 50개 시트 GitLab Duo Pro 구독이 있습니다.
• 30개 시트로 구독을 갱신합니다. 구독을 초과한 20명의 사용자가 GitLab Duo Pro 시트 할당에서 자동으로 제거됩니다.
• 갱신 전에 20명의 사용자만 GitLab Duo Pro 시트가 할당된 경우에는 시트 제거가 발생하지 않습니다.

다음 기준에 따라 이 순서대로 제거할 시트가 선택됩니다:

1. Code Suggestions를 아직 사용하지 않은 사용자, 가장 최근에 할당된 순서.
2. Code Suggestions를 사용한 사용자, Code Suggestions를 가장 적게 사용한 순서.

차단, 금지 및 비활성화된 사용자의 경우#

하루에 한두 번 CronJob이 GitLab Duo 시트 할당을 검토합니다. GitLab Duo 시트가 할당된 사용자가 차단, 금지 또는 비활성화되면 GitLab Duo 기능에 대한 접근이 자동으로 제거됩니다.

시트가 제거된 후 사용 가능해지며 새 사용자에게 재할당할 수 있습니다.

트러블슈팅#

UI를 사용하여 사용자에게 시트를 할당할 수 없음#

사용량 할당량 페이지에서 다음 두 가지가 모두 발생하면 UI를 사용하여 사용자에게 시트를 할당할 수 없습니다:

• 시트 탭이 로드되지 않습니다.

• 다음 오류 메시지가 표시됩니다:

  An error occurred while loading billable members list.
  

해결 방법으로 이 스니펫의 GraphQL 쿼리를 사용하여 사용자에게 시트를 할당할 수 있습니다.