Code Suggestions 개발 가이드라인

Code Suggestions 개발 설정

로컬 개발 및 디버깅을 위한 Code Suggestions의 권장 설정은 다음과 같습니다.

  • IDE 확장 프로그램 (예: VS Code용 GitLab Workflow 확장).
  • 올바르게 구성된 주 애플리케이션 (예: GDK).
  • AI 게이트웨이.

이로써 모든 사용자가 로컬에서 IDE에서 수행된 변경 사항을 주 응용프로그램으로 보내고 해당 모델로 전송되는 프롬프트로 변환된 모든 변경 사항을 볼 수 있게 될 것입니다.

설정 지침

  1. VS Code용 GitLab Workflow 확장 프로그램을 설치하고 로컬로 실행합니다:
    1. Code Suggestions 개발 구성에 "gitlab.debug": true 정보를 추가합니다:
      1. VS Code에서 확장 프로그램 페이지로 이동하여 목록에서 “GitLab Workflow”를 찾습니다.
      2. 작은 톱니바퀴 아이콘을 클릭하여 확장 설정을 엽니다.
      3. “GitLab: Debug” 확인란을 선택합니다.
    2. VS Code에서 “실행 및 디버그” 명령을 실행할 때 나타나는 VS Code의 새 창 내에서 GDK와 함께 Code Suggestions가 작동하는지 테스트하려면 개인 액세스 토큰을 설정하는 단계를 따릅니다.
      • 아래 단계를 완료한 후 지역 /code_suggestions/completions 엔드포인트가 아닌 프로덕션에 도달하는지 테스트하려면 다음 단계를 따릅니다:
        1. 새 창 내에서 터미널을 열고 오른쪽의 드롭다운 메뉴에서 “GitLab Language Server”를 선택합니다.
        2. 이 VS Code 창 내에서 새 파일을 열고 동작 중인 Code Suggestions를 확인합니다.
        3. GDK의 Git 원격 URL과 일치하는 완료 요청 URL이 검색될 것입니다.
  2. 주 애플리케이션 (GDK):
    1. GitLab 개발 키트를 설치하고 실행합니다.
    2. ai_duo_code_suggestions_switch 기능 플래그를 활성화합니다:
      1. 터미널에서 gitlab-development-kit > gitlab 디렉터리로 이동합니다.
      2. Rails 콘솔을 시작하려면 gdk rails console 또는 bundle exec rails c를 실행합니다.
      3. 콘솔에서 Feature.enable(:ai_duo_code_suggestions_switch)를 호출하여 Code Suggestions 토큰 API의 기능 플래그를 활성화합니다.
  3. AI 게이트웨이 설정.
    1. GDK 서버가 실행 중이 아니라면 gdk start로 GDK 서버를 실행합니다.

스테이징 AI 게이트웨이 사용 설정 지침

AI 게이트웨이와 상호 작용을 테스트할 때 로컬 GDK를 배포된 스테이징 AI 게이트웨이와 통합할 수 있습니다. 다음 단계를 따라 진행하십시오:

  1. 스테이징에 추가 기능이 활성화된 클라우드 스테이징 라이선스가 필요합니다. 관련하여 문제가 있으면 #s_fulfillment_engineering에 문의하실 수 있습니다. 로컬 개발용 라이선스를 요청하는 방법에 대한 자세한 내용은 핸드북 페이지를 참조하십시오.
  2. 환경 변수를 설정하여 고객 사이트 점과 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
    
  3. GDK를 다시 시작합니다.
  4. Code Suggestions 기능을 활성화하는 데 필요한 단계를 따랐는지 확인합니다.
  5. 프로젝트의 웹 IDE를 열어 Code Suggestions 기능을 테스트합니다.

Code Suggestions Add-on을 사용한 GDK 설정 지침

  1. GitLab Ultimate Self-Managed 구독에 Duo Pro 구독 애드온을 추가합니다.

    1. 스테이징 고객 포털에 로그인하고 GitLab.com 계정으로 계속 버튼을 선택합니다. 기존 계정이 없는 경우 생성하도록 안내됩니다.
    2. Ultimate Self-Managed Subscription 페이지를 방문하여 구독 플로우 링크를 사용하여 클라우드 활성화 코드가 없는 경우 방문합니다.
    3. 테스트 신용카드를 사용하여 구독을 구매합니다.
    4. 구독이 완료되면, 구독 카드에서 메뉴를 선택하여 Duo Pro 애드온 구매를 선택합니다.
    5. 이전에 저장한 신용카드 정보와 구독에 있는 좌석 수와 동일하게 입력합니다.

    이 단계가 완료되면 _Duo Pro 애드온이 있는 GitLab Ultimate Self-Managed 구독_의 활성화 코드를 받게 될 것입니다.

  2. 활성화 지침을 따릅니다:

    1. 환경 변수를 설정합니다.

      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'
      }
      
    2. GDK를 다시 시작합니다.
    3. /admin/subscription으로 이동합니다.
    4. 선택 사항입니다. 활성 라이선스를 제거합니다.
    5. 새 활성화 코드를 추가합니다.
  3. GDK 내에서 관리 영역 > GitLab Duo Pro로 이동하여 /admin/code_suggestions로 이동합니다.
  4. root를 찾아 GitLab Duo Pro 애드온 좌석을 할당하는 토글을 클릭합니다.

Duo Pro 애드온을 사용하는 방법을 위한 설정 안내

  1. https://staging.gitlab.com에서 계정을 준비하세요.
  2. 새 그룹을 만들거나 기존 그룹을 사용하여 Duo Pro 액세스를 받을 네임스페이스로 지정하세요.
  3. 설정 > 요금제로 이동하세요.
  4. Ultimate 요금제로 업그레이드하려면 Ultimate로 업그레이드를 클릭하여 구매 프로세스를 시작합니다.
  5. https://customers.staging.gitlab.com으로 리디렉션된 후, 당사의 Gitlab.com 계정으로 계속을 클릭하세요.
  6. 테스트 신용카드를 사용하여 SaaS Ultimate 구독을 구매하세요.
  7. 새로 구매한 구독 카드를 찾아서, 세 개 점 메뉴에서 GitLab Duo Pro 구매 옵션을 선택하세요.
  8. 위 단계에서 사용한 테스트 신용카드로 GitLab Duo Pro 애드온을 구매하세요.
  9. 설정 > GitLab Duo로 이동하여 그룹이 Duo Pro에 액세스할 수 있는지 확인하세요.

IDE에서 코드 제안 설치 및 사용의 비디오 데모

더 많은 지침은 다음과 같은 비디오 데모에서 코드 제안의 설치 및 사용을 참조하세요: