Cloud Connector: 유닛 프리미티브 및 구성

Cloud Connector: 유닛 프리미티브 및 구성에 대해 설명합니다.

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 파일이 있습니다. 이 유닛 프리미티브가 애드온 및 라이선스 유형과 함께 번들되는 방법과 기타 메타데이터에 대한 정보를 포함합니다. 각 유닛 프리미티브의 구성은 다음 스키마를 따릅니다. 필수 필드 # 필드 유형 설명 name string snake_case 형식의 유닛 프리미티브 이름(소문자, 숫자, 밑줄). $VERB_$NOUN 패턴을 따라야 합니다(예: explain_vulnerability ). description string 유닛 프리미티브의 목적 및 기능 설명. group string 유닛 프리미티브를 소유하는 엔지니어링 그룹(예: group::duo chat ). feature_category string 기능 카테고리 분류( 카테고리 참조). documentation_url string 유닛 프리미티브 문서의 URL. 선택적 필드 # 필드 유형 설명 milestone string 유닛 프리미티브를 도입한 GitLab 마일스톤. introduced_by_url string 유닛 프리미티브를 도입한 머지 리퀘