GitLab Orbit
GitLab v19.6Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 최상위 그룹에 아직 Orbit 라이선스가 없으면 무료 체험판을 시작할 수 있습니다. 무료 체험판을 시작하려면 다음을 수행합니다. 체험판을 시작하면 그룹에서 Orbit가 켜지고 그룹과 그 하위 그룹, 프로젝트를 인덱싱합니다.
무료 체험판 시작#
히스토리
- GitLab 19.5에서
orbit_trial이라는 기능 플래그 뒤에 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.6에서 GitLab.com에 활성화되었습니다. 기능 플래그
orbit_trial이 기본적으로 활성화되어 있습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
최상위 그룹에 아직 Orbit 라이선스가 없으면 무료 체험판을 시작할 수 있습니다. 체험판은 그룹에 Orbit용 무료 GitLab 크레딧을 제공합니다. 체험판 기준을 충족하지 않는 그룹에는 대신 Contact sales 옵션이 표시됩니다.
사전 요구 사항:
- 최상위 그룹의 Owner 권한이 있어야 합니다.
- 그룹이 체험판 기준을 충족해야 합니다.
무료 체험판을 시작하려면 다음을 수행합니다.
- 왼쪽 사이드바에서 Search or go to를 선택하고 그룹을 찾습니다.
- Settings > GitLab Orbit를 선택합니다.
- Turn on GitLab Orbit 토글을 켭니다.
- 확인 대화 상자에서 Turn on GitLab Orbit를 선택합니다.
체험판을 시작하면 그룹에서 Orbit가 켜지고 그룹과 그 하위 그룹, 프로젝트를 인덱싱합니다. 인덱싱에는 최대 몇 시간이 걸릴 수 있습니다.
체험판은 해당 그룹 하나에만 적용됩니다. 체험판 크레딧은 Orbit만 사용할 수 있습니다. 체험판이 끝나거나 크레딧이 소진되면 Orbit가 일시 중지됩니다. Orbit를 계속 사용하려면 영업팀에 문의합니다.
인스턴스 무료 체험판 시작#
히스토리
- GitLab 19.6에서
orbit_trial,orbit_promo_access_gate라는 기능 플래그 뒤에 도입되었습니다. 기본적으로 비활성화되어 있습니다. - GitLab 19.4.4, 19.5.2, 19.6에서 GitLab Self-Managed와 GitLab Dedicated에 활성화되었습니다. 기능 플래그
orbit_trial과orbit_promo_access_gate가 기본적으로 활성화되어 있습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.
인스턴스가 Orbit 베타에 참여하지 않고 Orbit를 구매하지도 않았다면 관리자가 인스턴스의 무료 체험판을 시작할 수 있습니다. 체험판은 인스턴스에 Orbit용 무료 GitLab 크레딧을 제공하며, 모든 최상위 그룹이 이를 공유합니다.
사전 요구 사항:
- 관리자 접근 권한이 있어야 합니다.
- 인스턴스에 온라인 클라우드 라이선스가 있어야 합니다.
- 인스턴스가 체험판 기준을 충족해야 합니다.
인스턴스의 무료 체험판을 시작하려면 다음을 수행합니다.
- 왼쪽 사이드바 하단에서 Admin을 선택합니다.
- GitLab Orbit를 선택합니다.
- Start trial을 선택합니다.
- 확인 대화 상자에서 Start trial을 선택합니다.
Orbit 대시보드의 Overview 탭에서도 체험판을 시작할 수 있습니다. 지도 위의 카드에서 Go to GitLab Orbit settings를 선택한 다음 Admin Orbit 페이지의 단계를 따릅니다.
사용자와 최상위 그룹의 Owner는 체험판 전과 체험판 중에 그룹에서 Orbit를 켤 수 있습니다. 체험판 크레딧은 Orbit 쿼리 비용에 사용됩니다.
체험판이 끝나거나 크레딧이 소진되면 Orbit는 그룹 인덱싱을 계속하지만 Orbit 쿼리는 중지됩니다. Orbit 쿼리를 다시 실행하려면 영업팀에 문의합니다.
그룹의 Orbit 켜기 또는 끄기#
히스토리
- GitLab 19.4에서 도입되었습니다.
Status 탭에는 최상위 그룹이 Orbit 상태 및 인덱스 상태와 함께 나열됩니다. Orbit가 인덱싱 중인 그룹은 정보 아이콘([information-o])을 선택하면 각 영역의 인덱스 상태를 볼 수 있습니다.
사전 요구 사항:
- Orbit를 켜거나 끄려면 최상위 그룹의 Owner 권한이 있어야 합니다.
그룹의 Orbit를 켜거나 끄려면 다음을 수행합니다.
- 왼쪽 사이드바에서 Your work를 선택합니다.
- GitLab Orbit를 선택합니다.
- Status 탭을 선택합니다.
- 그룹을 선택합니다.
- Actions > Turn on GitLab Orbit 또는 Actions > Turn off GitLab Orbit를 선택합니다.
- 확인 대화 상자에서 Turn on GitLab Orbit 또는 Turn off GitLab Orbit를 선택합니다.
GitLab.com에서는 대상 그룹에서 Orbit를 켜면 해당 그룹의 무료 체험판이 시작됩니다. 확인 대화 상자에는 각 그룹이 받는 체험판이 표시됩니다. GitLab Self-Managed와 GitLab Dedicated에서 인스턴스의 무료 체험판 기간 중에는 확인 대화 상자에 체험판 종료일이 표시됩니다.
GitLab Self-Managed와 GitLab Dedicated에서는 무료 체험판이나 구매 없이도 그룹에서 Orbit를 켤 수 있습니다.
Orbit가 그룹을 인덱싱하며 Status 탭에 인덱스 상태가 표시됩니다.
orbit_promo_access_gate 기능 플래그가 활성화되어 있으면 Orbit 쿼리를 실행하려면 인스턴스에
무료 체험판이나 구매가 필요합니다. 그때까지 Overview 탭에는 그룹의 항목 수가 표시되고,
지도 위의 카드에는 인스턴스가 Orbit 쿼리를 사용하는 방법이 안내됩니다. 무료 체험판을
시작할 수 있는 인스턴스의 관리자에게는 카드에 Go to GitLab Orbit settings가 표시됩니다.
Query editor 탭에는 Orbit 쿼리를 사용하는 방법이 안내됩니다. 인스턴스의 무료 체험판이
끝난 뒤에도 더 많은 그룹에서 Orbit를 켤 수 있습니다.
GitLab Duo의 Orbit 기본값#
히스토리
- GitLab 19.5에서 도입되었습니다.
GitLab Duo의 Orbit는 기본적으로 켜져 있습니다. 사용자는 환경설정에서 Orbit 기반 기능 중 사용할 기능을 선택합니다.
GitLab.com에서는 Orbit가 켜진 최상위 그룹의 구성원에게 GitLab Duo의 Orbit가 켜집니다. GitLab Self-Managed와 GitLab Dedicated에서는 관리자가 인스턴스 전체 스위치를 설정하며, 인스턴스에 Orbit 기능이 포함된 라이선스가 있어야 합니다.
Orbit 사용 가능 여부, 라이선스, 네임스페이스 등록 요구 사항은 계속 적용됩니다.
인스턴스의 GitLab Duo Orbit 끄기#
사전 요구 사항:
- 관리자 접근 권한이 있어야 합니다.
- 인스턴스에 Orbit 기능이 포함된 라이선스가 있어야 합니다.
인스턴스의 모든 사용자에 대해 GitLab Duo의 Orbit를 끄려면 다음을 수행합니다.
- 왼쪽 사이드바 하단에서 Admin을 선택합니다.
- GitLab Orbit를 선택합니다.
- Turn on GitLab Orbit in GitLab Duo 토글을 끕니다.
설정은 토글을 변경할 때 저장됩니다.
최상위 그룹 네임스페이스 자동 인덱싱#
히스토리
- GitLab 19.4에서 도입되었습니다.
사전 요구 사항:
- 관리자 접근 권한이 있어야 합니다.
- 인스턴스에 Orbit 기능이 포함된 라이선스가 있어야 합니다.
기존 및 새 최상위 그룹 네임스페이스를 자동으로 인덱싱하려면 다음을 수행합니다.
- 왼쪽 사이드바 하단에서 Admin을 선택합니다.
- GitLab Orbit를 선택합니다.
- Turn on GitLab Orbit for all top-level groups automatically 토글을 켭니다.
- Turn on for all top-level groups를 선택합니다.
이 설정을 켜면 GitLab이 백그라운드 작업을 큐에 넣습니다. 이 작업은 아직 등록되지 않았거나 관리자가 제외하지 않은 최상위 그룹 네임스페이스를 등록합니다. 등록은 즉시가 아니라 잠시 뒤에 이루어집니다. 매시간 실행되는 백그라운드 작업도 새로 만든 최상위 그룹을 등록하고 제외된 그룹의 등록을 제거합니다. 매시간 실행되는 작업은 데이터베이스를 직접 변경한 뒤의 안전망 역할을 합니다. 이러한 변경은 반영되는 데 최대 한 시간이 걸릴 수 있습니다. 개인 네임스페이스는 등록되지 않습니다.
이 작업은 무료 체험판이나 구매 없이 그룹을 등록합니다.
orbit_promo_access_gate 기능 플래그가 활성화되어 있고 인스턴스의 무료 체험판이
끝난 경우, 이 작업은 인스턴스가 Orbit를 구매했을 때만 그룹을 등록합니다.
Turn on GitLab Orbit for all top-level groups automatically를 끄면 제외되지 않은 기존 등록은 유지됩니다. 설정을 다시 켤 때까지 백그라운드 작업은 새 최상위 그룹을 등록하지 않습니다.
자동 인덱싱에서 최상위 그룹 제외#
관리자는 자동 인덱싱이 활성화되어 있는지와 관계없이 제외 항목을 관리할 수 있습니다.
- 왼쪽 사이드바 하단에서 Admin을 선택합니다.
- GitLab Orbit를 선택합니다.
- Top-level groups에서 제외할 그룹을 선택합니다.
- Actions > Exclude from automatic indexing을 선택합니다.
- 선택한 그룹에서 Orbit가 켜져 있으면 Exclude를 선택해 확인합니다.
제외된 그룹은 자동으로 등록되지 않습니다. 제외된 그룹이 이미 인덱싱되어 있으면 매시간 실행되는 백그라운드 작업이 해당 그룹의 등록과 인덱스를 제거합니다. 자동 등록을 다시 허용하려면 그룹을 선택한 다음 Actions > Remove exclusion을 선택합니다. 제외된 그룹에서 Orbit를 켜려면 먼저 제외를 해제해야 합니다.
이 설정은 GitLab.com에는 영향을 주지 않습니다.
Orbit 속도 제한 구성#
히스토리
- GitLab 19.6에서 도입되었습니다.
Orbit는 각 사용자가 1분 동안 보낼 수 있는 요청 수를 제한합니다.
사용자가 제한을 초과하면 GitLab이 요청을 거부합니다.
REST API는 429 Too Many Requests 오류를 반환합니다.
| 제한 | 기본값 | 적용 대상 |
|---|---|---|
| Queries | 60 | REST API와 MCP의 Orbit 쿼리, 컨텍스트, grep, 스킬 요청과 query_graph 명령. |
| Indexing status | 30 | UI와 GraphQL API의 Orbit 인덱싱 상태 요청. |
| Item counts | 30 | UI와 GraphQL API의 Orbit 항목 수 요청. |
사전 요구 사항:
- 관리자 접근 권한이 있어야 합니다.
Orbit 속도 제한을 구성하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 을 선택합니다.
- 왼쪽 사이드바에서 > 를 선택합니다.
- 를 확장합니다.
- 필드를 입력합니다. 제한을 끄려면
0으로 설정합니다. - 선택 사항. 에 Orbit 속도 제한을 적용하지 않을 사용자 이름을 입력합니다. 예를 들어 쿼리를 많이 보내는 봇 사용자입니다. 사용자 이름은 최대 100개까지 입력할 수 있습니다.
- 를 선택합니다.
애플리케이션 설정 API로도 이 제한을 설정할 수 있습니다.
Orbit grep 요청은 검색 속도 제한에도 포함됩니다. 해당 제한에서도 사용자를 제외하려면 > > 의 에 사용자를 추가합니다.
Orbit 상태 확인#
Orbit 구성과 인덱싱 상태를 확인하려면 다음을 실행합니다.
sudo gitlab-rake gitlab:orbit:info