GitLab Rails 인스턴스는 Cloud Connector 서비스 액세스 토큰을 사용하여 백엔드 서비스에 접근합니다:

• 이 토큰은 CustomersDot에서 GitLab 인스턴스로 매일 동기화되어 인스턴스의 로컬 데이터베이스에 저장됩니다.
• GitLab.com의 경우 이 단계가 필요하지 않습니다. 대신 각 요청에 대해 단기 토큰을 발급합니다.

Cloud Connector JWT에는 사용자 정의 클레임이 포함되어 있으며, 이는 이 토큰이 유효한 기능 또는 유닛 프리미티브를 정의하는 접근 범위 목록을 나타냅니다.

유닛 프리미티브 및 구성#

아키텍처 결정 기록(ADR) PROV-001에 따라 이 유닛 프리미티브 구성은 gitlab-cloud-connector 라이브러리에서 유지 관리됩니다. 이 라이브러리는 모든 Cloud Connector 구성에 대한 단일 소스(SSoT)로 사용되며 Ruby 젬과 Python 패키지 모두로 사용 가능합니다.

카탈로그 탐색#

Cloud Connector Catalog는 유닛 프리미티브, 기능 구성, 애드온 및 라이선스 유형을 탐색하고 필터링하는 인터랙티브 인터페이스를 제공합니다. 이 카탈로그를 다음에 사용합니다:

• 사용 가능한 유닛 프리미티브 및 구성 탐색
• 기능 자격 및 라이선스 요구 사항 이해
• 애드온, 라이선스 유형 및 백엔드 서비스별 필터링

구성 형식 및 구조#

gitlab-cloud-connector의 구성은 다음 구조를 따릅니다:

config
  ├─ unit_primitives/
  │  ├─ duo_chat.yml
  │  └─ ...
  ├─ backend_services/
  │  ├─ ai_gateway.yml
  │  └─ ...
  ├─ add_ons/
  │  ├─ duo_pro.yml
  │  └─ ...
  ├─ services/
  │  ├─ duo_chat.yml
  │  └─ ...
  └─ license_types/
     ├─ premium.yml
     └─ ...

유닛 프리미티브 구성#

유닛 프리미티브당 하나의 YAML 파일이 있습니다. 이 유닛 프리미티브가 애드온 및 라이선스 유형과 함께 번들되는 방법과 기타 메타데이터에 대한 정보를 포함합니다. 각 유닛 프리미티브의 구성은 다음 스키마를 따릅니다.

필수 필드#

선택적 필드#

접근 제어 필드#

유닛 프리미티브 구성 예시:

# config/unit_primitives/new_feature.yml
---
name: new_feature
description: Description of the new feature
cut_off_date: 2024-10-17T00:00:00+00:00  # 선택 사항; 유료 기능의 경우 항상 설정
min_gitlab_version: '16.9'
min_gitlab_version_for_free_access: '16.8'
group: group::your_group
feature_category: your_category
documentation_url: https://docs.gitlab.com/path/to/docs
backend_services:
  - ai_gateway
add_ons:
  - duo_pro
  - duo_enterprise
license_types:
  - premium
  - ultimate

이 정의에 따르면 기능:

• "Your Group"이 소유한 "New Feature"를 설명합니다.
• GitLab 16.8 이상에서 베타(무료)로 사용 가능합니다.
• GitLab 16.9 이상에서는 유료 애드온을 통해서만 사용 가능합니다.
• 2024년 10월 17일 UTC 자정에 무료 접근에서 유료 접근으로 전환됩니다. 이 시점 이후에는 GitLab Duo Pro 또는 GitLab Duo Enterprise와 Premium 또는 Ultimate 구독이 있어야 합니다.
• 위에 나열된 조건이 충족되면 Cloud Connector 토큰이 scopes 클레임에 이 기능을 포함하여 백엔드 서비스가 그에 따라 접근을 검증할 수 있습니다.
• 이 기능은 AI Gateway에 대한 요청에만 관련이 있습니다. 해당 scopes 항목이 다른 백엔드 서비스에 보내는 요청에 첨부된 토큰의 scopes에 있을 필요는 없습니다.

관련 구성#

백엔드 서비스#

각 백엔드 서비스에는 config/backend_services 하위에 자체 YAML 구성이 있어야 합니다. 예를 들어:

# config/backend_services/ai_gateway.yml
---
name: ai_gateway
project_url: https://gitlab.com/gitlab-org/modelops/applied-ml/code-suggestions/ai-assist
group: group::ai framework
jwt_aud: gitlab-ai-gateway

애드온#

각 애드온에는 config/add_ons 하위에 자체 YAML 구성이 있어야 합니다. 예를 들어:

# config/add_ons/duo_pro.yml
---
name: duo_pro

라이선스 유형#

각 라이선스 유형에는 config/license_types 하위에 자체 YAML 구성이 있어야 합니다. 예를 들어:

# config/license_types/premium.yml
---
name: premium

이전 버전 호환성#

이전 GitLab 버전을 실행하는 고객과 기존 레거시 구조에 대한 이전 버전 호환성을 지원하기 위해 새 형식에서 기존 형식으로의 매핑과 곧 deprecated될 "서비스" 추상화를 제공합니다.

서비스 구성#

새 서비스 매핑 구성 예시:

# config/services/duo_chat.yml
---
name: duo_chat
basic_unit_primitive: duo_chat
gitlab_realm:
  - gitlab-com
  - self-managed
unit_primitives:
  - ask_build
  - ask_commit
  - ask_epic
  - ask_issue
  - ask_merge_request
  - documentation_search
  - duo_chat
  - explain_code
  - fix_code
  - include_dependency_context
  - include_file_context
  - include_issue_context
  - include_local_git_context
  - include_merge_request_context
  - include_snippet_context
  - include_terminal_context
  - include_repository_context
  - refactor_code
  - write_tests

레거시 구조#

유료 기능이 GitLab 티어 및 애드온에 번들되는 방법에 대한 정보는 YAML 파일에 구성 및 저장됩니다:

services:
  code_suggestions:
    backend: 'gitlab-ai-gateway'
    cut_off_date: 2024-02-15 00:00:00 UTC
    min_gitlab_version: '16.8'
    bundled_with:
      duo_pro:
        unit_primitives:
          - code_suggestions
  duo_chat:
    backend: 'gitlab-ai-gateway'
    min_gitlab_version_for_beta: '16.8'
    min_gitlab_version: '16.9'
    bundled_with:
      duo_pro:
        unit_primitives:
          - duo_chat
          - documentation_search