코드 제안 개발 설정

코드 제안 개발 가이드라인

코드 제안 개발 설정

코드 제안을 로컬에서 개발하고 디버깅하기 위한 추천 설정은 다음 3가지 구성 요소가 모두 실행되는 것입니다:

IDE 확장 (예: VS Code용 GitLab Workflow 확장).
올바르게 구성된 주요 애플리케이션 (예: GDK).
AI Gateway.

이 설정을 통해 모든 사용자는 IDE에서 변경 사항이 주요 애플리케이션으로 전송되어 프롬프트로 변환되는 것을 로컬에서 볼 수 있습니다. 그런 다음 해당 모델로 전송됩니다.

설정 지침

VS Code용 GitLab Workflow 확장을 로컬에 설치하고 실행합니다:
1. 코드 제안 개발 구성에 "gitlab.debug": true 정보를 추가합니다:
  1. VS Code에서 확장 페이지로 가서 목록에서 “GitLab Workflow”를 찾습니다.
  2. 작은 기어 아이콘을 클릭하여 확장 설정을 열고 “Extension Settings” 옵션을 선택합니다.
  3. “GitLab: Debug” 체크박스를 확인합니다.
2. VS Code의 GitLab Workflow 확장에서 코드 제안이 작동하는지 테스트하려면, “Run and Debug” 명령을 실행할 때 나타나는 새 VS Code 창에서 GDK와 함께 개인 액세스 토큰을 설정하는 단계를 따릅니다.
  - 아래 단계를 완료한 후, 로컬 /code_suggestions/completions 엔드포인트에 도달하고 있는지 확인하려면 다음 단계를 따릅니다:
    1. 새 창의 내장 터미널에서 “Output” 탭을 선택한 다음 오른쪽 드롭 다운 메뉴에서 “GitLab Language Server”를 선택합니다.
    2. 이 VS Code 창 안에서 새 파일을 열고 입력을 시작하여 코드 제안 기능을 확인합니다.
    3. GDK의 Git 원격 URL과 일치하는 완료 요청 URL이 가져오는 것을 볼 수 있습니다.
주요 애플리케이션 (GDK):
1. GitLab Development Kit를 설치합니다.
2. 기능 플래그 ai_duo_code_suggestions_switch를 활성화합니다:
  1. 터미널에서 gitlab-development-kit > gitlab 디렉토리로 이동합니다.
  2. gdk rails console 또는 bundle exec rails c를 실행하여 Rails 콘솔을 시작합니다.
  3. 콘솔에서 Feature.enable(:ai_duo_code_suggestions_switch)를 호출하여 코드 제안 토큰 API의 기능 플래그를 활성화합니다.
3. AI Gateway 설정을 수행합니다.
4. GDK 서버가 실행되고 있지 않다면 gdk start로 실행합니다.

스테이징 AI Gateway 사용을 위한 설정 지침

AI Gateway와의 상호작용을 테스트할 때, 로컬 GDK를 배포된 스테이징 AI Gateway와 통합하고 싶을 수 있습니다. 이를 위해:

코드 제안 추가 기능이 포함된 클라우드 스테이징 라이센스가 필요합니다. 추가 기능은 스테이징에서 활성화됩니다. 이 지침을 따라 라이센스에 추가 기능을 추가합니다 (문제가 있는 경우 #s_fulfillment_engineering에 문의할 수 있습니다). 로컬 개발을 위한 라이센스를 요청하는 방법은 이 핸드북 페이지를 참조하세요.

고객 도메인을 스테이징으로, AI Gateway를 스테이징으로 가리키도록 환경 변수를 설정합니다:

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를 다시 시작합니다.
코드 제안 기능을 활성화하기 위한 필요한 단계를 따랐는지 확인합니다.
프로젝트의 웹 IDE를 열어 코드 제안 기능을 테스트합니다.

GDK와 코드 제안 애드온을 사용하기 위한 설정 지침

GitLab Ultimate Self-Managed 구독과 Duo Pro 구독 애드온을 GDK 인스턴스에 추가합니다.
1. Continue with GitLab.com account 버튼을 선택하여 스테이징 고객 포털에 로그인합니다.
  기존 계정이 없다면, 계정을 만들어야 합니다.
2. 기존 클라우드 활성화 코드가 없다면, 구독 구매 흐름 링크를 사용하여 Ultimate Self-Managed Subscription 페이지를 방문합니다.
3. 테스트 신용 카드를 사용하여 구독을 구매합니다.
4. 구독을 가진 후에는 구독 카드에서 점작 메뉴 … > Buy Duo Pro add-on을 선택합니다.
5. 이전에 저장한 신용 카드 정보를 사용하고, 구독과 동일한 수의 좌석을 입력합니다.
이 단계가 완료되면 _Duo Pro 애드온이 포함된 GitLab Ultimate Self-Managed 구독_에 대한 활성화 코드를 받게 됩니다.
활성화 지침을 따릅니다:
1. 환경 변수를 설정합니다.
```
export GITLAB_LICENSE_MODE=test
export CUSTOMER_PORTAL_URL=https://customers.staging.gitlab.com
export GITLAB_SIMULATE_SAAS=0
```
  비-GDK 인스턴스에서는 gitlab.rb 파일의 gitlab_rails['env']를 사용하여 변수를 설정할 수 있습니다:
```
gitlab_rails['env'] = {
  'GITLAB_LICENSE_MODE' => 'test',
  'CUSTOMER_PORTAL_URL' => 'https://customers.staging.gitlab.com',
  'AI_GATEWAY_URL' => 'https://cloud.staging.gitlab.com/ai'
}
```
2. GDK를 재시작합니다.
3. /admin/subscription으로 이동합니다.
4. 선택 사항. 활성 라이센스를 제거합니다.
5. 새로운 활성화 코드를 추가합니다.
GDK 내부에서 관리자 영역 > GitLab Duo Pro로 이동하여 /admin/code_suggestions로 이동합니다.
사용자를 필터링하여 root를 찾고 GitLab Duo Pro 애드온 좌석을 루트 사용자에게 할당하도록 토글을 클릭합니다.

스테이징 GitLab.com 계정과 함께 Duo Pro 애드온을 사용하기 위한 설정 지침

https://staging.gitlab.com에서 계정을 준비합니다.
새 그룹 생성 또는 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로 이동하여 그룹이 Duo Pro에 접근 가능한지 확인하고 좌석을 관리합니다.

코드 제안을 IDE에서 설치하고 사용하는 방법에 대한 비디오 시연

더 많은 안내를 보시려면 다음 비디오 시연을 참조하세요:

VS Code.
IntelliJ IDEA.