GitLab Duo는 기본적으로 켜져 있습니다. GitLab Duo에는 여러 기능이 포함되어 있습니다.

GitLab Duo는 다음 범위에서 켜거나 끌 수 있습니다.

• GitLab.com: 최상위 그룹, 그 밖의 그룹이나 하위 그룹, 프로젝트.
• GitLab Self-Managed: 인스턴스, 그룹이나 하위 그룹, 프로젝트.
• GitLab Dedicated: 관리자는 특정 하위 그룹을 Always off로 잠가 해당 하위 그룹에서 Owner 권한 사용자가 GitLab Duo를 활성화하지 못하게 할 수도 있습니다.

GitLab Duo 켜짐으로 잠금#

히스토리

• GitLab 19.1에서 도입되었습니다.

그룹이나 프로젝트 설정과 관계없이 모든 사용자에 대해 GitLab Duo를 켭니다.

GitLab Duo 사용 가능 여부를 Always on으로 설정해도 실험 및 베타 기능은 자동으로 켜지지 않습니다. 실험 및 베타 기능을 사용하려면 별도로 켜야 합니다.

선택한 하위 그룹에서 GitLab Duo 꺼짐으로 잠금#

히스토리

• GitLab 19.2에서 도입되었습니다.

GitLab Dedicated 관리자는 특정 하위 그룹에서 GitLab Duo와 GitLab Duo Agent Platform을 Always off로 잠글 수 있습니다. 해당 하위 그룹의 Owner 권한 사용자는 GitLab Duo를 활성화할 수 없으며, 다른 하위 그룹은 소유자의 제어 아래에 그대로 유지됩니다.

이 잠금은 해당 하위 그룹과 그 하위의 모든 그룹 및 프로젝트에 적용됩니다. 해당 하위 그룹이나 그 하위 항목에 대한 Owner 권한 사용자는 이 설정을 변경할 수 없습니다. 영향을 받는 소유자에게는 상위 그룹이 GitLab Duo를 잠갔다는 메시지가 표시됩니다.

상위 그룹과 하위 그룹으로 이어지는 하나의 계통에는 잠금이 하나만 존재할 수 있습니다. 하위 그룹을 잠글 때 동작은 다음과 같습니다.

• 상위 그룹에 이미 잠금이 있으면 잠금이 적용되지 않습니다. 먼저 상위 그룹에서 잠금을 해제해야 합니다.
• 하나 이상의 하위 그룹에 이미 관리자 잠금이 있으면 확인 메시지가 표시됩니다. 확인하면 해당 하위 그룹의 잠금이 해제되고, 선택한 하위 그룹에 잠금이 적용됩니다.

하위 그룹 잠금#

사전 요구 사항:

• GitLab Dedicated 인스턴스에 대한 관리자 액세스 권한.

하위 그룹에서 GitLab Duo를 꺼짐으로 잠그려면 다음 단계를 수행합니다.

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
3. GitLab Duo Core 섹션에서 Change configuration을 선택합니다.
4. Group Duo availability 섹션에서 Show groups를 선택한 다음 하위 그룹을 찾습니다.
5. 해당 하위 그룹 행의 GitLab Duo availability에서 Always off를 선택합니다.

하위 그룹의 잠금 해제#

사전 요구 사항:

• GitLab Dedicated 인스턴스에 대한 관리자 액세스 권한.

하위 그룹의 관리자 잠금을 해제하려면 다음 단계를 수행합니다.

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
3. GitLab Duo Core 섹션에서 Change configuration을 선택합니다.
4. Group Duo availability 섹션에서 하위 그룹을 찾습니다.
5. 해당 하위 그룹 행에서 Reset override를 선택합니다.

해당 하위 그룹은 인스턴스 기본값으로 돌아갑니다. 이제 그 하위 그룹에 대한 Owner 권한 사용자가 GitLab Duo 사용 가능 여부를 제어할 수 있습니다.

GitLab Duo 켜기 또는 끄기#

GitLab.com에서 GitLab Duo 시트는 이를 할당한 그룹이 아니라 시트를 할당받은 사용자에게 귀속됩니다. 그룹에서 GitLab Duo를 끄면 멤버가 그 그룹의 프로젝트에서 GitLab Duo 기능을 사용할 수 없게 되지만, 시트가 회수되지는 않습니다. 멤버는 GitLab Duo가 켜져 있는 다른 그룹의 프로젝트에서는 계속 GitLab Duo를 사용할 수 있습니다.

IDE의 코드 제안에서는 리포지터리를 GitLab 프로젝트로 확인할 수 없는 경우, GitLab 이 GitLab Duo를 위해 사용자의 기본 네임스페이스를 대신 사용합니다. 해당 네임스페이스에서 GitLab Duo가 꺼져 있으면 코드 제안을 사용할 수 없습니다.

GitLab.com#

최상위 그룹#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한.

최상위 그룹의 GitLab Duo 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
2. Settings > GitLab Duo를 선택합니다.
3. Change configuration을 선택합니다.
4. GitLab Duo availability에서 옵션을 선택합니다.
5. Save changes를 선택합니다.

모든 하위 그룹과 프로젝트의 GitLab Duo 사용 가능 여부가 변경됩니다.

그룹 또는 하위 그룹#

사전 요구 사항:

• 그룹 또는 하위 그룹에 대한 Owner 권한.

그룹이나 하위 그룹의 GitLab Duo 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹이나 하위 그룹을 찾습니다.
2. Settings > General을 선택합니다.
3. GitLab Duo features를 확장합니다.
4. GitLab Duo availability에서 옵션을 선택합니다.
5. Save changes를 선택합니다.

모든 하위 그룹과 프로젝트의 GitLab Duo 사용 가능 여부가 변경됩니다.

프로젝트#

사전 요구 사항:

• 프로젝트에 대한 Maintainer 또는 Owner 권한.

프로젝트의 GitLab Duo 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. GitLab Duo를 확장합니다.
4. GitLab Duo 토글을 켜거나 끕니다.
5. Save changes를 선택합니다.

GitLab Self-Managed#

인스턴스#

사전 요구 사항:

• 관리자 액세스 권한.
• 다음 중 하나를 갖춘 인스턴스:
  • 유료 라이선스가 있는 활성 GitLab Duo Pro, Enterprise, Self-Hosted 애드온.
  • 활성 GitLab Credits.

인스턴스의 GitLab Duo 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
3. Change configuration을 선택합니다.
4. GitLab Duo availability에서 옵션을 선택합니다.
5. Save changes를 선택합니다.

그룹 또는 하위 그룹#

사전 요구 사항:

• 그룹 또는 하위 그룹에 대한 Owner 권한.

그룹이나 하위 그룹의 GitLab Duo 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹이나 하위 그룹을 찾습니다.
2. Settings > General을 선택합니다.
3. GitLab Duo features를 확장합니다.
4. GitLab Duo availability에서 옵션을 선택합니다.
5. Save changes를 선택합니다.

모든 하위 그룹과 프로젝트의 GitLab Duo 사용 가능 여부가 변경됩니다.

프로젝트#

사전 요구 사항:

• 프로젝트에 대한 Maintainer 또는 Owner 권한.

프로젝트의 GitLab Duo 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. GitLab Duo를 확장합니다.
4. GitLab Duo 토글을 켜거나 끕니다.
5. Save changes를 선택합니다.

이전 GitLab 버전#

이전 GitLab 버전에서 GitLab Duo를 켜거나 끄는 방법은 이전 GitLab 버전의 GitLab Duo 사용 가능 여부 제어를 참고합니다.

GitLab Duo Core 켜기 또는 끄기#

히스토리

• GitLab 18.0에서 도입되었습니다.
• GitLab 18.2에서 GitLab Duo 사용 가능 여부 설정과 그룹·하위 그룹·프로젝트 제어가 추가되었습니다.
• GitLab 18.3에서 GitLab Duo Non-Agentic Chat 이 GitLab Duo Core에 추가되었습니다.

GitLab Duo Core는 Premium 및 Ultimate 구독에 포함되어 있습니다.

• GitLab 17.11 이전부터 사용해 온 기존 고객이라면 GitLab Duo Core 기능을 직접 켜야 합니다.
• GitLab 18.0 이상에서 시작한 신규 고객이라면 GitLab Duo Core가 자동으로 켜져 있으므로 추가 조치가 필요하지 않습니다.

2025년 5월 15일 이전에 Premium 또는 Ultimate 구독을 사용하던 기존 고객이라면, GitLab 18.0 이상으로 업그레이드한 뒤 GitLab Duo Core를 사용하려면 직접 켜야 합니다.

GitLab.com#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한.

최상위 그룹의 GitLab Duo Core 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 최상위 그룹을 찾습니다.
2. Settings > GitLab Duo를 선택합니다.
3. Change configuration을 선택합니다.
4. GitLab Duo availability에서 옵션을 선택합니다.
5. GitLab Duo Core에서 Turn on features for GitLab Duo Core 체크박스를 선택하거나 해제합니다. GitLab Duo availability에서 Always off를 선택했다면 이 설정에 접근할 수 없습니다.
6. Save changes를 선택합니다.

변경 사항이 적용되기까지 최대 10분이 걸릴 수 있습니다.

GitLab Self-Managed#

사전 요구 사항:

• 관리자 액세스 권한.
• 다음 중 하나를 갖춘 인스턴스:
  • 유료 라이선스가 있는 활성 GitLab Duo Pro, Enterprise, Self-Hosted 애드온.
  • 활성 GitLab Credits.

인스턴스의 GitLab Duo Core 사용 가능 여부를 변경하려면 다음 단계를 수행합니다.

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
3. Change configuration을 선택합니다.
4. GitLab Duo availability에서 옵션을 선택합니다.
5. GitLab Duo Core에서 Turn on features for GitLab Duo Core 체크박스를 선택하거나 해제합니다. GitLab Duo availability에서 Always off를 선택했다면 이 설정에 접근할 수 없습니다.
6. Save changes를 선택합니다.

베타 및 실험 기능 켜기#

실험 및 베타 단계인 GitLab Duo 기능은 기본적으로 꺼져 있습니다. 이러한 기능에는 테스트 계약이 적용됩니다.

GitLab.com#

사전 요구 사항:

• 최상위 그룹에 대한 Owner 권한.

최상위 그룹에서 GitLab Duo 실험 및 베타 기능을 켜려면 다음 단계를 수행합니다.

1. 상단 표시줄에서 Search or go to를 선택하고 그룹을 찾습니다.
2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
3. Change configuration을 선택합니다.
4. Feature preview에서 Turn on experiment and beta GitLab Duo features를 선택합니다.
5. Save changes를 선택합니다.

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

GitLab Self-Managed#