이 가이드는 다음 가이드 및 소스를 기반으로 작성되었으며, 테스트 및 평가 목적으로 Amazon Q를 설정하는 방법을 설명합니다:

• GitLab Duo와 Amazon Q 설정하기

• code-suggestions 개발 가이드

이 가이드는 스테이징 AI Gateway를 사용하여 VM에서 실행 중인 GitLab Linux 패키지에 Amazon Q를 설정하는 방법을 설명합니다. GDK 대신 GitLab Linux 패키지 인스턴스가 필요한 이유는, GitLab 인스턴스가 Amazon Q에서 접근할 수 있는 HTTPS URL을 필요로 하기 때문입니다.

가상 머신에 GitLab Linux 패키지 설치 및 구성#

AWS에서 VM 생성

cloud sandbox에 접속하여 OKTA로 로그인합니다.

• "Create Individual Account"를 클릭하고 aws-***를 선택합니다(aws-services-*** 또는 aws-dedicated-***는 선택하지 않음). 이렇게 하면 AWS 샌드박스가 생성되고 로그인 자격 증명이 표시됩니다.

• EC2 머신 구성

몇 가지 주의 사항:

• 방화벽 설정에서 HTTP 및 HTTPS 트래픽을 모두 활성화해야 합니다.

• 생성된 VM 인스턴스의 외부 IP를 복사합니다.

GitLab 설치

GitLab Linux 패키지 설치 방법은 이 가이드를 따르세요. 외부 URL과 초기 비밀번호를 설정해야 합니다. 다음 명령어를 사용하여 GitLab을 설치합니다:

sudo GITLAB_ROOT_PASSWORD="your_password" EXTERNAL_URL="https://<vm-instance-external-ip>.nip.io" apt install gitlab-ee

이 명령어는 nip.io를 DNS 서비스로 사용하여 GitLab 인스턴스에 HTTPS를 통해 접근할 수 있게 합니다.

새로 설치된 GitLab 인스턴스 구성

VM에 SSH로 접속한 후, /etc/gitlab/gitlab.rb에 다음 구성을 추가합니다.

gitlab_rails['env'] = {
  "GITLAB_LICENSE_MODE" => "test",
  "CUSTOMER_PORTAL_URL" => "https://customers.staging.gitlab.com",
  "CLOUD_CONNECTOR_BASE_URL" => "https://cloud.staging.gitlab.com"
}

sudo gitlab-ctl reconfigure를 실행하여 구성 변경 사항을 적용합니다.

Self-managed Ultimate 라이선스 취득 및 활성화

스테이징 고객 포털로 이동하여 "Signin with GitLab.com account"를 선택합니다.

• "Buy new subscription"을 클릭하는 대신, 제품 페이지로 직접 이동합니다. 그 이유는 Buy subscription을 참고하세요.

• 테스트용 신용카드를 사용하여 구독을 구매합니다. 활성화 코드가 제공됩니다. duo-pro 애드온은 구매하지 마세요. 현재 duo-pro와 Q는 상호 배타적입니다.

• 앞서 생성한 GitLab 인스턴스(https://<vm-instance-external-ip>.nip.io)에 접속하여 root 계정으로 로그인합니다. 그런 다음 왼쪽 사이드바에서 Admin > Subscription으로 이동하여 활성화 코드를 입력합니다.

AWS 샌드박스 생성 및 구성#

아직 AWS 샌드박스가 없다면, 위에서 설명한 동일한 단계에 따라 AWS 샌드박스를 생성합니다.

새로 생성된 AWS 계정에 로그인하고, 다음 지침에 따라 약간의 수정을 거쳐 Identity Provider를 생성합니다:

Provider URL: https://glgo.staging.runway.gitlab.net/cc/oidc/<your_gitlab_instance_id>

• Audience: gitlab-cc-<your_gitlab_instance_id>

GitLab 인스턴스 ID는 <gitlab_url>/admin/ai/amazon_q_settings에서 확인할 수 있습니다.

Identity Provider를 사용하여 새 역할을 생성합니다. 이를 위해 이 섹션을 그대로 따릅니다.

GitLab에 Amazon Q 추가#

• GitLab에 ARN 입력 및 Amazon Q 활성화를 그대로 따릅니다.

• 이제 Q가 작동해야 합니다. 이 방법으로 테스트할 수 있습니다.