InfoGrab DocsInfoGrab Docs

로컬 개발을 위한 GitLab Duo 라이선스

요약

GitLab Duo 기능을 사용하려면 다음이 필요합니다. GitLab 엔터프라이즈 에디션 사용 Premium 또는 Ultimate 구독 라이선스 플랜 중 하나 보유 라이선스 플랜 외에 GitLab Duo 애드온 중 하나 보유 (GitLab Duo Core, GitLab Duo Pro, 또는 GitLab Duo Enterprise)

GitLab Duo 기능을 사용하려면 다음이 필요합니다.

  • GitLab 엔터프라이즈 에디션 사용

  • 온라인 클라우드 라이선스 보유

  • Premium 또는 Ultimate 구독 라이선스 플랜 중 하나 보유

  • 라이선스 플랜 외에 GitLab Duo 애드온 중 하나 보유 (GitLab Duo Core, GitLab Duo Pro, 또는 GitLab Duo Enterprise)

이 문서에서는 GDK에서 이러한 요구 사항을 충족하는 방법을 안내합니다.

GDK용 GitLab 팀원 라이선스 설정#

이유: 클라우드 라이선스는 GitLab Self-Managed 및 Dedicated 고객을 위한 클라우드 연결 GitLab Duo 기능에 필수입니다. "레거시" GitLab 라이선스와 달리, 클라우드 라이선스는 customers.gitlab.com(CustomersDot)과의 유효성 검사를 위해 인터넷 연결이 필요합니다. GitLab은 주기적으로 라이선스 유효성을 확인하며, CustomersDot을 통해 구독 변경 사항을 자동으로 업데이트합니다.

GitLab Duo는 Premium 및 Ultimate 고객에게만 제공됩니다. GDK에는 Ultimate 라이선스를 사용하는 것이 좋습니다. Ultimate는 모든 GitLab Duo 기능에 접근할 수 있으며, Premium은 GitLab Duo 기능의 일부 서브셋에만 접근할 수 있습니다.

방법:

로컬 인스턴스에 대한 Ultimate 라이선스 취득 프로세스를 따르세요. GitLab Self-Managed Ultimate 라이선스부터 시작합니다. GitLab Self-Managed 라이선스를 구성한 후에는 언제든지 SaaS 인스턴스를 시뮬레이션하고 관리자 패널에서 개별 그룹에 Premium 및 Ultimate 라이선스를 할당할 수 있습니다.

라이선스 활성화 코드 업로드

GDK에서 환경 변수 설정:

export GITLAB_LICENSE_MODE=test
export CUSTOMER_PORTAL_URL=https://customers.staging.gitlab.com
export CLOUD_CONNECTOR_SELF_SIGN_TOKENS=1

(대안) 스테이징 AI Gateway에 연결#

개발자는 로컬 GitLab 인스턴스를 스테이징 AI Gateway 인스턴스에 연결하도록 선택할 수도 있습니다.

스테이징 AI Gateway에 연결하려면:

  • DEVELOPMENT_AI_GATEWAY_URL 환경 변수를 https://cloud.staging.gitlab.com으로 설정합니다.

  • AI_GATEWAY_URL이 설정되지 않고 Ai::Setting.instance.ai_gateway_url이 nil인지 확인합니다.

  • GDK를 재시작합니다.

트러블슈팅#

GitLab Duo 라이선스 설정에 문제가 있는 경우:

  • GitLab Duo 상태 점검을 실행하여 구체적인 문제를 파악합니다. 로컬에서 설정 스크립트로 생성된 GitLab Duo 라이선스가 있는 경우 "Cloud Connector access token is missing"이 표시될 수 있지만 이는 정상입니다.

  • Admin Area에서 라이선스가 활성화되어 있는지 확인합니다.

  • 사용자에게 GitLab Duo 시트가 할당되어 있는지 확인합니다. GDK 설정 스크립트는 root 사용자에게만 GitLab Duo 시트를 할당합니다. 다른 사용자로 테스트하려면 시트를 할당해야 합니다.

  • root 사용자가 GitLab Duo Chat과 같은 기능에 접근할 수 없는 이유를 더 깊이 디버깅하려면 GlobalPolicy.new(User.first, User.first).debug(:access_duo_entry_point)를 실행할 수 있습니다. 이 Declarative Policy 디버그 출력은 보다 세분화된 디버깅을 위해 특정 접근 로직을 파악하는 데 도움이 됩니다.

  • admin/subscriptions 아래에 라이선스가 하나만 있는지, 그리고 해당 라이선스가 온라인 라이선스인지 확인합니다. 또는 GitLab 프로젝트에서 rails c를 실행하여 rails 콘솔을 열고 License.current를 실행합니다.

  • 여러 개의 라이선스가 있는 경우 rails 콘솔을 엽니다. 다른 라이선스의 모든 ID를 가져온 후 License.find(:id).destroy를 실행합니다(ID는 삭제하려는 라이선스의 ID). 레거시 라이선스는 기능 접근에 문제를 일으키는 것으로 알려져 있습니다.

  • 인증 또는 라이선스 유효성 검사 오류에 대한 로그를 확인합니다.

  • 클라우드 라이선스 문제의 경우 Slack에서 #s_fulfillment_engineering에 문의하세요.

  • AI Gateway 연결 문제의 경우 Slack에서 #g_ai_framework에 문의하세요.

모범 사례#

  • 두 환경 모두에서 테스트: 철저한 테스트를 위해 멀티테넌트 설정과 싱글테넌트 설정을 번갈아 가며 기능이 두 환경 모두에서 잘 작동하는지 확인하세요.

  • 도메인 문서 참고: 특정 기능 문서를 검토하여 고려해야 할 환경별 동작이 있는지 이해하세요.

  • 최종 사용자 맥락 고려: GitLab.com 사용자와 Self-managed/Dedicated 고객 모두에게 기능이 잘 작동해야 한다는 점을 기억하세요.

추가 리소스#

스테이징 GitLab.com 사용자 계정을 위한 GitLab Duo 설정#

스테이징 환경에서 작업할 때는 staging.gitlab.com 계정에 GitLab Duo 애드온을 설정해야 할 수 있습니다.

GitLab Duo Pro#

  • https://staging.gitlab.com에 계정을 준비합니다.

  • GitLab Duo Pro 접근 권한을 받을 네임스페이스로 새 그룹을 생성하거나 기존 그룹을 사용합니다.

  • Settings > Billing으로 이동합니다.

  • Upgrade to Ultimate를 클릭하여 Ultimate 플랜 구매 프로세스를 시작합니다.

  • https://customers.staging.gitlab.com으로 리다이렉트된 후 Continue with your Gitlab.com account를 클릭합니다.

  • 테스트 신용 카드를 사용하여 SaaS Ultimate 구독을 구매합니다.

  • 새로 구매한 구독 카드를 찾아 세 점 메뉴에서 Buy GitLab Duo Pro 옵션을 선택합니다.

  • 위 단계에서 사용한 동일한 테스트 신용 카드로 GitLab Duo Pro 애드온을 구매합니다.

  • https://staging.gitlab.com으로 돌아가 Settings > GitLab Duo로 이동하고 시트를 관리하여 그룹이 GitLab Duo Pro에 접근할 수 있는지 확인합니다.

GitLab Duo Enterprise#

내부 사용 전용: GitLab Duo Enterprise 라이선스 구매는 셀프 서비스가 불가능합니다. 스테이징 계정에 GitLab Duo Enterprise 라이선스를 부여하려면 Slack의 #g_provision 채널에 요청을 게시하세요.

로컬 개발을 위한 GitLab Duo 라이선스

GitLab v19.1
원문 보기
요약

GitLab Duo 기능을 사용하려면 다음이 필요합니다. GitLab 엔터프라이즈 에디션 사용 Premium 또는 Ultimate 구독 라이선스 플랜 중 하나 보유 라이선스 플랜 외에 GitLab Duo 애드온 중 하나 보유 (GitLab Duo Core, GitLab Duo Pro, 또는 GitLab Duo Enterprise)

GitLab Duo 기능을 사용하려면 다음이 필요합니다.

  • GitLab 엔터프라이즈 에디션 사용

  • 온라인 클라우드 라이선스 보유

  • Premium 또는 Ultimate 구독 라이선스 플랜 중 하나 보유

  • 라이선스 플랜 외에 GitLab Duo 애드온 중 하나 보유 (GitLab Duo Core, GitLab Duo Pro, 또는 GitLab Duo Enterprise)

이 문서에서는 GDK에서 이러한 요구 사항을 충족하는 방법을 안내합니다.

GDK용 GitLab 팀원 라이선스 설정#

이유: 클라우드 라이선스는 GitLab Self-Managed 및 Dedicated 고객을 위한 클라우드 연결 GitLab Duo 기능에 필수입니다. "레거시" GitLab 라이선스와 달리, 클라우드 라이선스는 customers.gitlab.com(CustomersDot)과의 유효성 검사를 위해 인터넷 연결이 필요합니다. GitLab은 주기적으로 라이선스 유효성을 확인하며, CustomersDot을 통해 구독 변경 사항을 자동으로 업데이트합니다.

GitLab Duo는 Premium 및 Ultimate 고객에게만 제공됩니다. GDK에는 Ultimate 라이선스를 사용하는 것이 좋습니다. Ultimate는 모든 GitLab Duo 기능에 접근할 수 있으며, Premium은 GitLab Duo 기능의 일부 서브셋에만 접근할 수 있습니다.

방법:

로컬 인스턴스에 대한 Ultimate 라이선스 취득 프로세스를 따르세요. GitLab Self-Managed Ultimate 라이선스부터 시작합니다. GitLab Self-Managed 라이선스를 구성한 후에는 언제든지 SaaS 인스턴스를 시뮬레이션하고 관리자 패널에서 개별 그룹에 Premium 및 Ultimate 라이선스를 할당할 수 있습니다.

라이선스 활성화 코드 업로드

GDK에서 환경 변수 설정:

export GITLAB_LICENSE_MODE=test
export CUSTOMER_PORTAL_URL=https://customers.staging.gitlab.com
export CLOUD_CONNECTOR_SELF_SIGN_TOKENS=1

(대안) 스테이징 AI Gateway에 연결#

개발자는 로컬 GitLab 인스턴스를 스테이징 AI Gateway 인스턴스에 연결하도록 선택할 수도 있습니다.

스테이징 AI Gateway에 연결하려면:

  • DEVELOPMENT_AI_GATEWAY_URL 환경 변수를 https://cloud.staging.gitlab.com으로 설정합니다.

  • AI_GATEWAY_URL이 설정되지 않고 Ai::Setting.instance.ai_gateway_url이 nil인지 확인합니다.

  • GDK를 재시작합니다.

트러블슈팅#

GitLab Duo 라이선스 설정에 문제가 있는 경우:

  • GitLab Duo 상태 점검을 실행하여 구체적인 문제를 파악합니다. 로컬에서 설정 스크립트로 생성된 GitLab Duo 라이선스가 있는 경우 "Cloud Connector access token is missing"이 표시될 수 있지만 이는 정상입니다.

  • Admin Area에서 라이선스가 활성화되어 있는지 확인합니다.

  • 사용자에게 GitLab Duo 시트가 할당되어 있는지 확인합니다. GDK 설정 스크립트는 root 사용자에게만 GitLab Duo 시트를 할당합니다. 다른 사용자로 테스트하려면 시트를 할당해야 합니다.

  • root 사용자가 GitLab Duo Chat과 같은 기능에 접근할 수 없는 이유를 더 깊이 디버깅하려면 GlobalPolicy.new(User.first, User.first).debug(:access_duo_entry_point)를 실행할 수 있습니다. 이 Declarative Policy 디버그 출력은 보다 세분화된 디버깅을 위해 특정 접근 로직을 파악하는 데 도움이 됩니다.

  • admin/subscriptions 아래에 라이선스가 하나만 있는지, 그리고 해당 라이선스가 온라인 라이선스인지 확인합니다. 또는 GitLab 프로젝트에서 rails c를 실행하여 rails 콘솔을 열고 License.current를 실행합니다.

  • 여러 개의 라이선스가 있는 경우 rails 콘솔을 엽니다. 다른 라이선스의 모든 ID를 가져온 후 License.find(:id).destroy를 실행합니다(ID는 삭제하려는 라이선스의 ID). 레거시 라이선스는 기능 접근에 문제를 일으키는 것으로 알려져 있습니다.

  • 인증 또는 라이선스 유효성 검사 오류에 대한 로그를 확인합니다.

  • 클라우드 라이선스 문제의 경우 Slack에서 #s_fulfillment_engineering에 문의하세요.

  • AI Gateway 연결 문제의 경우 Slack에서 #g_ai_framework에 문의하세요.

모범 사례#

  • 두 환경 모두에서 테스트: 철저한 테스트를 위해 멀티테넌트 설정과 싱글테넌트 설정을 번갈아 가며 기능이 두 환경 모두에서 잘 작동하는지 확인하세요.

  • 도메인 문서 참고: 특정 기능 문서를 검토하여 고려해야 할 환경별 동작이 있는지 이해하세요.

  • 최종 사용자 맥락 고려: GitLab.com 사용자와 Self-managed/Dedicated 고객 모두에게 기능이 잘 작동해야 한다는 점을 기억하세요.

추가 리소스#

스테이징 GitLab.com 사용자 계정을 위한 GitLab Duo 설정#

스테이징 환경에서 작업할 때는 staging.gitlab.com 계정에 GitLab Duo 애드온을 설정해야 할 수 있습니다.

GitLab Duo Pro#

  • https://staging.gitlab.com에 계정을 준비합니다.

  • GitLab Duo Pro 접근 권한을 받을 네임스페이스로 새 그룹을 생성하거나 기존 그룹을 사용합니다.

  • Settings > Billing으로 이동합니다.

  • Upgrade to Ultimate를 클릭하여 Ultimate 플랜 구매 프로세스를 시작합니다.

  • https://customers.staging.gitlab.com으로 리다이렉트된 후 Continue with your Gitlab.com account를 클릭합니다.

  • 테스트 신용 카드를 사용하여 SaaS Ultimate 구독을 구매합니다.

  • 새로 구매한 구독 카드를 찾아 세 점 메뉴에서 Buy GitLab Duo Pro 옵션을 선택합니다.

  • 위 단계에서 사용한 동일한 테스트 신용 카드로 GitLab Duo Pro 애드온을 구매합니다.

  • https://staging.gitlab.com으로 돌아가 Settings > GitLab Duo로 이동하고 시트를 관리하여 그룹이 GitLab Duo Pro에 접근할 수 있는지 확인합니다.

GitLab Duo Enterprise#

내부 사용 전용: GitLab Duo Enterprise 라이선스 구매는 셀프 서비스가 불가능합니다. 스테이징 계정에 GitLab Duo Enterprise 라이선스를 부여하려면 Slack의 #g_provision 채널에 요청을 게시하세요.