GitLab AI Gateway 설치

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

AI Gateway 는 AI 네이티브 GitLab Duo 기능에 대한 액세스를 제공하는 두 가지 서비스의 조합입니다: AI Gateway 서비스 GitLab Duo Agent Platform 서비스 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 서명에 사용되며 민감한 자격 증명으로 취급해야 합니다. 특히 사용량이 많은 경우 더 나은 성능을 위해 최소 요구 사항보다 더 많은 디스크 공간, 메모리 및 리소스를 할당하는 것을 고려하세요. 더 높은 RAM과 디스크 용량은 최고 부하 시 AI Gateway의 효율을 높일 수 있습니다. GitLab AI Gateway에는 GPU가 필요하지 않습니다. AI Gateway 이미지 # 표준 이미지 # 표준 AI Gateway 이미지는 다음 위치에서 제공됩니다: 컨테이너 레지스트리: Stable DockerHub: Stable GitLab 버전이 vX.Y.*-ee 인 경우, 가장 최신의 self-hosted-vX.Y.*-ee 태그가 있는 AI Gateway 이미지를 사용하세요. 예를 들어: GitLab 버전이 v18.2.1-ee 이고 AI Gateway 이미지에 self-hosted-v18.2.0-ee , self-hosted-v18.2.1-ee , self-hosted-v18.2.2-ee 버전이 있으면 self-hosted-v18.2.2-ee 를 사용하세요. GitLab 버전이 v18.2.1-ee 이고 AI Gateway 이미지에 self-hosted-v18.2.0-ee 버전만 있으면 self-hosted-v18.2.0-ee 를 사용하세요. 자세한 내용은 셀프 호스팅 AI Gateway의 릴리스 프로세스 를 참조하세요. Nightly 빌드는 하위 호환성이 보장되지 않습니다. 항상 명시적인 버전 태그로 안정 릴리스를 사용하세요. FIP