Code Suggestions 개발 가이드라인
Code Suggestions 개발 설정
로컬 개발 및 디버깅을 위한 Code Suggestions의 권장 설정은 다음과 같습니다.
- IDE 확장 프로그램 (예: VS Code용 GitLab Workflow 확장).
- 올바르게 구성된 주 애플리케이션 (예: GDK).
- AI 게이트웨이.
이로써 모든 사용자가 로컬에서 IDE에서 수행된 변경 사항을 주 응용프로그램으로 보내고 해당 모델로 전송되는 프롬프트로 변환된 모든 변경 사항을 볼 수 있게 될 것입니다.
설정 지침
-
VS Code용 GitLab Workflow 확장 프로그램을 설치하고 로컬로 실행합니다:
- Code Suggestions 개발 구성에
"gitlab.debug": true
정보를 추가합니다:- VS Code에서 확장 프로그램 페이지로 이동하여 목록에서 “GitLab Workflow”를 찾습니다.
- 작은 톱니바퀴 아이콘을 클릭하여 확장 설정을 엽니다.
- “GitLab: Debug” 확인란을 선택합니다.
- VS Code에서 “실행 및 디버그” 명령을 실행할 때 나타나는 VS Code의 새 창 내에서 GDK와 함께 Code Suggestions가 작동하는지 테스트하려면 개인 액세스 토큰을 설정하는 단계를 따릅니다.
- 아래 단계를 완료한 후 지역
/code_suggestions/completions
엔드포인트가 아닌 프로덕션에 도달하는지 테스트하려면 다음 단계를 따릅니다:- 새 창 내에서 터미널을 열고 오른쪽의 드롭다운 메뉴에서 “GitLab Language Server”를 선택합니다.
- 이 VS Code 창 내에서 새 파일을 열고 동작 중인 Code Suggestions를 확인합니다.
- GDK의 Git 원격 URL과 일치하는 완료 요청 URL이 검색될 것입니다.
- 아래 단계를 완료한 후 지역
- Code Suggestions 개발 구성에
- 주 애플리케이션 (GDK):
- GitLab 개발 키트를 설치하고 실행합니다.
-
ai_duo_code_suggestions_switch
기능 플래그를 활성화합니다:- 터미널에서
gitlab-development-kit
>gitlab
디렉터리로 이동합니다. - Rails 콘솔을 시작하려면
gdk rails console
또는bundle exec rails c
를 실행합니다. - 콘솔에서
Feature.enable(:ai_duo_code_suggestions_switch)
를 호출하여 Code Suggestions 토큰 API의 기능 플래그를 활성화합니다.
- 터미널에서
-
AI 게이트웨이 설정.
- GDK 서버가 실행 중이 아니라면
gdk start
로 GDK 서버를 실행합니다.
- GDK 서버가 실행 중이 아니라면
스테이징 AI 게이트웨이 사용 설정 지침
AI 게이트웨이와 상호 작용을 테스트할 때 로컬 GDK를 배포된 스테이징 AI 게이트웨이와 통합할 수 있습니다. 다음 단계를 따라 진행하십시오:
- 스테이징에 추가 기능이 활성화된 클라우드 스테이징 라이선스가 필요합니다. 관련하여 문제가 있으면
#s_fulfillment_engineering
에 문의하실 수 있습니다. 로컬 개발용 라이선스를 요청하는 방법에 대한 자세한 내용은 핸드북 페이지를 참조하십시오. -
환경 변수를 설정하여 고객 사이트 점과 AI 게이트웨이를 스테이징으로 지정합니다:
export GITLAB_LICENSE_MODE=test export CUSTOMER_PORTAL_URL=https://customers.staging.gitlab.com export AI_GATEWAY_URL=https://cloud.staging.gitlab.com/ai
- GDK를 다시 시작합니다.
- Code Suggestions 기능을 활성화하는 데 필요한 단계를 따랐는지 확인합니다.
- 프로젝트의 웹 IDE를 열어 Code Suggestions 기능을 테스트합니다.
Code Suggestions Add-on을 사용한 GDK 설정 지침
-
GitLab Ultimate Self-Managed 구독에 Duo Pro 구독 애드온을 추가합니다.
- 스테이징 고객 포털에 로그인하고 GitLab.com 계정으로 계속 버튼을 선택합니다. 기존 계정이 없는 경우 생성하도록 안내됩니다.
- Ultimate Self-Managed Subscription 페이지를 방문하여 구독 플로우 링크를 사용하여 클라우드 활성화 코드가 없는 경우 방문합니다.
- 테스트 신용카드를 사용하여 구독을 구매합니다.
- 구독이 완료되면, 구독 카드에서 … 메뉴를 선택하여 Duo Pro 애드온 구매를 선택합니다.
- 이전에 저장한 신용카드 정보와 구독에 있는 좌석 수와 동일하게 입력합니다.
이 단계가 완료되면 _Duo Pro 애드온이 있는 GitLab Ultimate Self-Managed 구독_의 활성화 코드를 받게 될 것입니다.
-
활성화 지침을 따릅니다:
-
환경 변수를 설정합니다.
export GITLAB_LICENSE_MODE=test export CUSTOMER_PORTAL_URL=https://customers.staging.gitlab.com export GITLAB_SIMULATE_SAAS=0
GDK 이외의 인스턴스에서는
gitlab_rails['env']
를 사용하여gitlab.rb
파일에서 변수를 설정할 수 있습니다:gitlab_rails['env'] = { 'GITLAB_LICENSE_MODE' => 'test', 'CUSTOMER_PORTAL_URL' => 'https://customers.staging.gitlab.com', 'AI_GATEWAY_URL' => 'https://cloud.staging.gitlab.com/ai' }
- GDK를 다시 시작합니다.
-
/admin/subscription
으로 이동합니다. - 선택 사항입니다. 활성 라이선스를 제거합니다.
- 새 활성화 코드를 추가합니다.
-
- GDK 내에서 관리 영역 > GitLab Duo Pro로 이동하여
/admin/code_suggestions
로 이동합니다. -
root
를 찾아 GitLab Duo Pro 애드온 좌석을 할당하는 토글을 클릭합니다.
Duo Pro 애드온을 사용하는 방법을 위한 설정 안내
- https://staging.gitlab.com에서 계정을 준비하세요.
- 새 그룹을 만들거나 기존 그룹을 사용하여 Duo Pro 액세스를 받을 네임스페이스로 지정하세요.
-
설정 > 요금제
로 이동하세요. -
Ultimate
요금제로 업그레이드하려면Ultimate로 업그레이드
를 클릭하여 구매 프로세스를 시작합니다. -
https://customers.staging.gitlab.com으로 리디렉션된 후,
당사의 Gitlab.com 계정으로 계속
을 클릭하세요. - 테스트 신용카드를 사용하여 SaaS Ultimate 구독을 구매하세요.
- 새로 구매한 구독 카드를 찾아서, 세 개 점 메뉴에서
GitLab Duo Pro 구매
옵션을 선택하세요. - 위 단계에서 사용한 테스트 신용카드로 GitLab Duo Pro 애드온을 구매하세요.
-
설정 > GitLab Duo
로 이동하여 그룹이 Duo Pro에 액세스할 수 있는지 확인하세요.
IDE에서 코드 제안 설치 및 사용의 비디오 데모
더 많은 지침은 다음과 같은 비디오 데모에서 코드 제안의 설치 및 사용을 참조하세요: