GitLab AI Gateway 설치

Docker, Helm 차트, NGINX 등 다양한 방법으로 GitLab AI Gateway를 설치하고 구성하는 방법을 설명합니다.

AI Gateway 는 AI 네이티브 GitLab Duo 기능에 대한 액세스를 제공하는 두 가지 서비스의 조합입니다: AI Gateway 서비스 GitLab Duo Agent Platform 서비스 인증 및 JSON 웹 토큰(JWT) # GitLab Duo 기능에 액세스하기 위해 AI Gateway는 JWT를 사용하여 요청이 GitLab 인스턴스의 인증된 사용자로부터 오는지 확인합니다. GitLab 인스턴스가 토큰을 요청하면 서비스는 요청을 승인하는 단기 서명 토큰을 발급합니다. 자체 AI Gateway를 호스팅하는 경우 서명 키 쌍을 생성하고 이 키를 환경 변수로 서비스에 전달해야 합니다. 각 서비스는 자체 키 쌍을 사용합니다: AI Gateway는 GitLab Duo Code Suggestions 및 GitLab Duo Chat과 같은 기능에 AIGW_SELF_SIGNED_JWT__SIGNING_KEY 와 AIGW_SELF_SIGNED_JWT__VALIDATION_KEY 를 사용합니다. GitLab Duo Agent Platform 서비스는 DUO_WORKFLOW_SELF_SIGNED_JWT__SIGNING_KEY 와 DUO_WORKFLOW_SELF_SIGNED_JWT__VALIDATION_KEY 를 사용합니다. 각 쌍은 다음과 같은 역할을 제공합니다: 서명 키는 서비스가 발급하는 토큰에 서명합니다. 유효성 검사 키는 키 교체 중 토큰을 검증하여, 이전 키로 서명된 토큰이 만료될 때까지 계속 유효하도록 합니다. 쌍의 두 키 모두 PEM 형식의 RSA 2048비트 개인 키여야 합니다. 이 키가 없으면 서비스가 토큰에 서명할 수 없어 요청이 토큰 생성 오류와 함께 실패합니다. Docker를 사용하여 설치 # GitLab AI Gateway Docker 이미지는 단일 컨테이너에 필요한 모든 코드와 의존성을 포함합니다. 사전 요구 사항: Docker 와 같은 Docker 컨테이너 엔진을 설치하세요. 네트워크에서 접근 가능한 유효한 호스트명을 사용하세요. localhost 는 사용하지 마세요. linux/amd64 아키텍처에서 약 340 MB(압축 기준)의 공간과 최소 512 MB의 RAM이 필요합니다. ai_gateway 및 duo-workflow-service 서비스를 위해 컨테이너가 최소 2개의 CPU에 접근할 수 있어야 합니다. JWT 서명 키를 생성하세요: GitLab Duo Agent Platform의 경우: openssl genrsa -out duo_workflow_jwt.key 2048 openssl genrsa -out duo_workflow_validation.key 2048 AI Gateway의 경우 (Duo Chat 등의 기능에 필요): openssl genrsa -out aigw_signing.key 2048 openssl genrsa -out aigw_validation.key 2048 생성된 모든 키 파일을 안전하게 보관하고 공개적으로 공유하지 마세요. 이 키들은 JWT 서명에 사용되며 민감한 자격 증명으로 취급해야