이 가이드는 다음 가이드 및 소스를 기반으로 작성되었으며, 테스트 및 평가 목적으로 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 & Duo with Amazon Q 라이선스 취득 및 활성화

Amazon Q에는 GitLab Duo with Amazon Q 구독이 필요합니다. Ultimate 구독만으로는 충분하지 않으며, GitLab Duo with Amazon Q는 애드온이 아닌 별도의 구독 유형입니다.

GitLab 팀원은 이 라이선스를 직접 생성할 수 없습니다. #s_fulfillment_engineering Slack 채널에서 요청하세요.

• (이메일 또는 Customers Portal을 통해) 활성화 코드를 받은 후, 앞서 생성한 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 활성화를 그대로 따릅니다.

• 이제 Amazon Q가 구성되었습니다. 문서화된 기능 중 어떤 것이든 사용하여 테스트할 수 있습니다.