참고: 이 문서 모음은 Gemini Enterprise의 Standard, Plus, 종량제, Frontline 버전을 위한 것입니다. Business 에디션 문서는 Gemini Enterprise - Business 에디션 고객센터를 참고하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Google Antigravity용 엔터프라이즈 게이트웨이 구성

이 문서에서는 관리자와 보안 설계자가 Google Antigravity용 엔터프라이즈 게이트웨이를 배포하고 구성하는 방법을 보여줍니다.

규제 대상 업종의 기업 조직은 개발자 워크스테이션이 외부 서비스에 직접 인터넷 연결을 설정하거나 대화형 브라우저 기반 Google 로그인 완료를 방지하는 엄격한 네트워크 제어를 유지하는 경우가 많습니다.

Antigravity Enterprise Gateway를 사용하면 추론 요청을 Google에 전달하기 전에 조직에서 운영하는 엔터프라이즈 게이트웨이를 통해 Antigravity 트래픽을 라우팅할 수 있습니다. 이 아키텍처는 게이트웨이를 통해 모델 추론 요청을 라우팅하고 Gemini Enterprise 계약 결제 기여 분석을 유지하면서 대화형 로그인을 삭제합니다.

개요

Antigravity Enterprise Gateway를 구성하면 개발자 워크스테이션이 Google에 직접 연결하는 대신 엔터프라이즈 게이트웨이와 통신합니다. 개발자는 게이트웨이에서 발급하는 API 키를 사용하여 게이트웨이에 인증하므로 Antigravity는 개별 Google 계정 로그인을 요청하지 않습니다. 그러면 게이트웨이는 중앙 집중식Google Cloud 서비스 계정을 사용하여 Antigravity 요청을 인증하고 Google에 전달합니다.

Antigravity는 클라이언트 기여 분석 헤더를 자동으로 연결하여 개발자 채팅 프롬프트와 에이전트 워크플로를 식별합니다. 이 모델 사용량이 커밋되지 않은 원시 API 소비로 청구되는 대신 조직의 기존 Gemini Enterprise 계약에 따라 인식되고 청구되도록 하려면 게이트웨이에서 이러한 Antigravity 헤더를 보존하고 Google에 전달해야 합니다.

User-Agent: Antigravity는 식별 헤더를 자동으로 내보냅니다.
```
User-Agent: antigravity/VERSION (aidev_client; auth_method=gateway)
```
X-Goog-Api-Client: Google에서 라이선스가 부여된 엔터프라이즈 배포에 활동을 크레딧으로 제공할 수 있도록 Antigravity 클라이언트 런타임 및 SDK 원격 분석을 식별합니다.

지원되는 도구 및 버전

Antigravity Enterprise Gateway는 다음 AI 개발자 도구를 지원합니다.

도구	최소 버전	지원되는 플랫폼
Antigravity 앱	2.15.0 이상	macOS, Windows, Linux
Antigravity CLI (`agy`)	1.2.15 이상	macOS 및 Linux
IDE용 Antigravity	Visual Studio Code 및 Visual Studio: Antigravity CLI 1.2.15 이상(확장 프로그램에서 자동으로 다운로드 및 업데이트) JetBrains IDE 및 Zed (ACP 서버 사용): 1.3.0 이상	Visual Studio Code, Visual Studio, JetBrains IDE, Zed 자세한 내용은 Antigravity IDE 확장 프로그램을 참고하세요.

시작하기 전에

게이트웨이를 배포하기 전에 다음이 있는지 확인합니다.

Google Cloud 프로젝트: Gemini Enterprise Agent Platform (이전 명칭: Vertex AI)에 액세스할 수 있고 Gemini Enterprise Agent Platform API(aiplatform.googleapis.com)가 사용 설정된 Google Cloud 프로젝트입니다. 엔터프라이즈 게이트웨이를 배포하는 데 인보이스 결제 Cloud Billing 계정이 필요하지 않습니다. Gemini Enterprise Agent Platform에 액세스할 수 있는 사용자는 누구나 게이트웨이를 사용할 수 있습니다.
서비스 계정: roles/aiplatform.user IAM 역할이 부여된 프로젝트의 Google Cloud 서비스 계정입니다. 게이트웨이는 이 서비스 계정을 사용하여 Google Cloud에 대한 Antigravity 요청을 인증합니다.
데이터 액세스 감사 로그: Cloud Logging에서 결제 기여 분석을 확인하려면 Gemini Enterprise Agent Platform API에 데이터 액세스 감사 로그를 사용 설정합니다. 자세한 내용은 데이터 액세스 감사 로그 사용 설정을 참조하세요.
지원되는 클라이언트 버전: 개발자는 각 Antigravity 도구의 지원되는 버전을 사용해야 합니다. 자세한 내용은 지원되는 Antigravity 도구를 참조하세요.

엔터프라이즈 게이트웨이 배포

Cloud Run, Envoy, LiteLLM, Apigee와 같은 컨테이너화되거나 관리되는 플랫폼을 사용하여 엔터프라이즈 게이트웨이를 호스팅할 수 있습니다.

게이트웨이는 다음 세 가지 인프라 요구사항을 충족해야 합니다.

클라이언트 속성 헤더 유지: 수신 클라이언트 헤더를 변경 없이 Google로 전달합니다. 여기에는 User-Agent, X-Goog-Api-Client 및 gateway.customHeaders에 구성된 사용자 지정 헤더 (예: X-Cost-Center)가 포함됩니다.

Antigravity 클라이언트는 게이트웨이 모드에서 Google Cloud 프로젝트 정보를 전송하지 않습니다. 게이트웨이가 게이트웨이의 서비스 계정이 포함된 프로젝트가 아닌 다른 프로젝트로 요청을 전달하는 경우 결제 및 할당량 기여 분석을 위해 대상 프로젝트 ID가 있는 X-Goog-User-Project 헤더를 삽입하도록 게이트웨이를 구성합니다.
버퍼링되지 않은 스트리밍 지원: 스트리밍 요청 (:streamGenerateContent?alt=sse)을 처리할 때 서버 전송 이벤트(SSE) 청크를 즉시 플러시합니다. 게이트웨이 레이어에서 청크를 버퍼링하지 않습니다.
원격 분석 엔드포인트 확인: HTTP 200 OK ({})로 백그라운드 측정항목 호출 (POST /v1beta:*)에 응답하거나 보안 정보 및 이벤트 관리 (SIEM) 시스템으로 전달합니다.

필수 요청 경로

게이트웨이는 다음 추론 경로를 라우팅해야 합니다. 경로는 게이트웨이 URL을 기준으로 합니다. 예를 들어 https://gateway.cymbal.com에 대한 스트리밍 요청은 https://gateway.cymbal.com/v1beta/models/MODEL_ID:streamGenerateContent?alt=sse을 사용합니다.

스트리밍 추론: POST /v1beta/models/MODEL_ID:streamGenerateContent?alt=sse
단항 추론: POST /v1beta/models/MODEL_ID:generateContent

게이트웨이는 또한 이에 상응하는 전체 Gemini Enterprise Agent Platform 경로를 허용해야 합니다.

스트리밍 추론: POST /v1beta1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_ID:streamGenerateContent?alt=sse
단항 추론: POST /v1beta1/projects/PROJECT_ID/locations/REGION/publishers/google/models/MODEL_ID:generateContent

요청 본문은 표준 generateContent JSON 스키마 (contents, generationConfig, safetySettings, systemInstruction)를 사용합니다.

지원되는 유선 프로토콜

Antigravity Enterprise Gateway는 추론 요청에 대해 두 가지 유선 프로토콜을 지원합니다.

Gemini 프로토콜 (genai): 기본 유선 프로토콜입니다. Antigravity는 Google의 generateContent 스키마로 형식이 지정된 추론 요청을 이전에 설명한 POST /v1beta/models/... 엔드포인트로 전송합니다.
OpenAI 유선 프로토콜(openai): gateway.wireProtocol를 openai로 설정하거나 AGY_LLM_GATEWAY_WIRE_PROTOCOL=openai를 설정하면 Antigravity가 OpenAI Chat Completions 프로토콜에서 추론 요청 형식을 지정하고 POST /v1/chat/completions로 전송합니다.

게이트웨이에 대한 요청 인증

Antigravity는 게이트웨이에서 발급한 API 키를 사용하여 게이트웨이에 인증합니다. Antigravity는 gateway.apiKey (또는 AGY_LLM_GATEWAY_API_KEY 환경 변수)의 키를 Authorization 헤더의 Bearer 토큰으로 전송합니다.

Authorization: Bearer GATEWAY_API_KEY

Antigravity는 개발자를 대신하여 Google Cloud 사용자 인증 정보, OAuth 토큰 또는 클라이언트 인증서를 가져오지 않습니다. 게이트웨이는 모든 요청을 인증하고 유효한 키를 제공하지 않는 요청을 거부해야 합니다.

API 키는 개발자 워크스테이션에 저장되므로 네트워크 수준 제어와 결합합니다.

게이트웨이를 비공개로 유지: 워크스테이션이 Cloud VPN 또는 Cloud Interconnect를 통해 연결하는 내부 애플리케이션 부하 분산기를 통해 회사 네트워크에만 게이트웨이를 노출합니다. 게이트웨이에 공개 엔드포인트를 제공하지 않습니다.
연결할 수 있는 기기 제한: 예를 들어 방화벽 규칙, 제로 트러스트 네트워크 액세스 프록시 또는 기기 상황 점검을 사용하여 관리형 워크스테이션에서만 연결을 허용합니다.
키 보호 및 순환: Secret Manager에 키를 저장하고, 요청마다 키를 검증하고, 정기적으로 순환합니다. 개별 개발자에게 사용량을 할당하려면 각 개발자에게 별도의 키를 발급합니다.

자세한 내용은 보안 고려사항을 참조하세요.

게이트웨이를 Gemini Enterprise Agent Platform에 연결

게이트웨이는 Google Cloud 서비스 계정을 사용하여 Gemini Enterprise Agent Platform API를 호출합니다. Apigee와 같은 관리형 API 게이트웨이에 게이트웨이를 빌드하거나 자체 인프라에 Envoy 또는 LiteLLM과 같은 게이트웨이를 배포할 수 있습니다.

필요한 API를 사용 설정합니다.

gcloud services enable \
  aiplatform.googleapis.com \
  secretmanager.googleapis.com \
  --project=PROJECT_ID

PROJECT_ID를 Google Cloud 프로젝트 ID로 바꿉니다.

게이트웨이의 서비스 계정을 만들고 roles/aiplatform.user 역할을 부여합니다.

gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
  --project=PROJECT_ID \
  --display-name="Antigravity Enterprise Gateway"

gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"

SERVICE_ACCOUNT_NAME을 서비스 계정 이름(예: agy-gateway-sa)으로 바꿉니다.

게이트웨이 API 키를 생성하고 Secret Manager에 저장한 후 서비스 계정에서 읽을 수 있도록 합니다.

openssl rand -base64 32 | tr -d '\n' | gcloud secrets create SECRET_NAME \
  --project=PROJECT_ID \
  --data-file=-

gcloud secrets add-iam-policy-binding SECRET_NAME \
  --project=PROJECT_ID \
  --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/secretmanager.secretAccessor"

SECRET_NAME을 보안 비밀 이름(예: agy-gateway-api-key)으로 바꿉니다. 이 키를 admin_settings.json의 gateway.apiKey로 워크스테이션에 배포합니다.

다음을 수행하도록 게이트웨이를 구성합니다.
- 서비스 계정으로 Gemini Enterprise Agent Platform에 인증합니다.
- Secret Manager에서 API 키를 읽고 API 키를 제공하지 않는 요청을 거부합니다.
- 긴 스트리밍 응답이 끊어지지 않도록 요청을 최소 60분 동안 실행할 수 있도록 허용합니다.

워크스테이션을 구성하기 전에 게이트웨이가 작동하는지 확인하려면 게이트웨이 직접 테스트를 참조하세요.

MDM을 사용하여 설정 배포하기

개발자 워크스테이션을 중앙에서 구성하려면 Jamf, Microsoft Intune, Ansible, Google Workspace MDM과 같은 모바일 기기 관리(MDM) 시스템을 사용하여 admin_settings.json 구성 파일을 배포합니다.

Antigravity는 다음 운영체제 경로에서 admin_settings.json를 읽습니다.

macOS: /Library/Application Support/Antigravity/admin_settings.json
Linux: /etc/antigravity/admin_settings.json
Windows: %ProgramData%\Antigravity\admin_settings.json

설정 파일을 배포하려면 다음 단계를 따르세요.

게이트웨이 URL, API 키, 승인된 모델을 사용하여 admin_settings.json 파일을 만듭니다. 예시는 구성 예시를 참조하세요.

MDM 시스템에서 각 대상 운영체제의 경로에 파일을 복사하는 패키지, 정책 또는 스크립트를 만듭니다. 파일이 관리자 계정의 소유가 되고 개발자가 파일을 읽을 수 있지만 수정할 수 없도록 관리자 권한으로 실행합니다. 예를 들어 MDM 스크립트는 다음 명령어를 실행할 수 있습니다.

macOS

셸에서 다음 명령어를 관리자로 실행합니다.

sudo mkdir -p "/Library/Application Support/Antigravity"
sudo install -m 644 -o root -g wheel admin_settings.json \
"/Library/Application Support/Antigravity/admin_settings.json"

Linux

셸에서 다음 명령어를 관리자로 실행합니다.

sudo install -D -m 644 -o root -g root admin_settings.json \
/etc/antigravity/admin_settings.json

Windows

PowerShell에서 다음 명령어를 관리자로 실행합니다.

$dir = Join-Path $env:ProgramData "Antigravity"
# Remove any folder that a non-admin created first, so they can't keep ownership.
if (Test-Path $dir) { Remove-Item -Recurse -Force $dir }
New-Item -ItemType Directory -Path $dir | Out-Null
# Administrators own the folder; only admins and SYSTEM can write; users can read.
icacls $dir /setowner "*S-1-5-32-544"
icacls $dir /inheritance:r /grant:r "*S-1-5-32-544:(OI)(CI)F" "*S-1-5-18:(OI)(CI)F" "*S-1-5-32-545:(OI)(CI)RX"
Copy-Item admin_settings.json (Join-Path $dir "admin_settings.json")

이러한 명령어를 사용하면 모든 사용자가 폴더와 파일을 읽을 수 있고 관리자만 쓸 수 있습니다.

Antigravity를 사용하는 기기 또는 기기 그룹에 패키지 또는 정책을 할당합니다.
새 설정을 로드하도록 워크스테이션에서 Antigravity를 다시 시작합니다.
워크스테이션이 게이트웨이에 연결되는지 확인하려면 클라이언트 연결 확인을 참조하세요.

설정 우선순위

Antigravity는 세 가지 소스에서 게이트웨이 설정을 읽습니다. 동일한 설정이 두 개 이상의 소스에 정의된 경우 우선순위가 더 높은 소스가 적용됩니다.

관리자 설정 파일 (가장 높음): MDM 시스템에서 배포한 admin_settings.json
환경 변수: 워크스테이션에 설정된 AGY_LLM_GATEWAY_* 변수입니다. 자세한 내용은 엔터프라이즈 게이트웨이에 Antigravity 연결을 참조하세요.
사용자 설정 파일 (가장 낮음): 개발자의 홈 폴더에 있는 ~/.antigravity/settings.json

설정은 필드별로 병합됩니다. 예를 들어 admin_settings.json가 게이트웨이 URL을 설정하지만 API 키를 설정하지 않으면 Antigravity는 환경 변수의 API 키를 사용합니다. 관리자 설정 파일이 가장 높은 우선순위를 가지므로 개발자는 관리자가 설정한 값을 재정의할 수 없습니다.

구성 예시

다음 예시 admin_settings.json 파일은 Antigravity를 구성하여 https://gateway.cymbal.com에서 엔터프라이즈 게이트웨이를 통해 AI 트래픽을 라우팅하고, 회사 비용 센터 헤더를 연결하고, 모델 선택을 승인된 모델로 제한합니다.

{
  "gateway": {
    "enabled": true,
    "url": "https://gateway.cymbal.com",
    "apiKey": "GATEWAY_API_KEY",
    "wireProtocol": "genai",
    "customHeaders": {
      "X-Cost-Center": "Platform-Engineering",
      "X-Corporate-BU": "DevTools"
    }
  },
  "caCertPath": "/etc/ssl/certs/cymbal-root-ca.pem",
  "models": {
    "defaultModelId": "gemini-3.8-flash",
    "list": [
      { "modelId": "gemini-3.8-flash" },
      { "modelId": "gemini-3.7-flash" },
      { "modelId": "gemini-3.1-pro-preview" }
    ]
  }
}

이 예시 구성은 다음 설정을 정의합니다.

gateway.enabled: 게이트웨이 라우팅 모드를 사용 설정합니다. true로 설정하면 Antigravity는 모든 추론 요청을 Google에 직접 전송하는 대신 게이트웨이로 전송하며 개발자에게 Google 계정으로 로그인하라는 메시지를 표시하지 않습니다.
gateway.url: 엔터프라이즈 게이트웨이의 HTTPS 엔드포인트(https://gateway.cymbal.com)입니다.
gateway.apiKey: 게이트웨이가 요청을 승인하는 데 필요한 API 키 (GATEWAY_API_KEY)입니다. 이 키는 Google이 아닌 게이트웨이에서 발급합니다. Antigravity는 이를 Authorization 헤더에 Bearer 토큰으로 전송합니다.
gateway.wireProtocol: API 유선 프로토콜입니다. 지원되는 값은 다음과 같습니다.
- genai (기본값): Gemini API 프로토콜(POST /v1beta/models/...)을 사용합니다.
- openai: OpenAI Chat Completions 유선 프로토콜(POST /v1/chat/completions)을 사용합니다.
참고: JetBrains IDE 및 Zed는 genai 유선 프로토콜만 지원하는 ACP 서버를 사용합니다.
gateway.customHeaders: Antigravity가 각 요청에 추가하는 커스텀 HTTP 헤더 (X-Cost-Center 및 X-Corporate-BU)입니다. 이러한 헤더를 사용하여 게이트웨이 로그 또는 SIEM에서 팀 또는 비용 센터에 사용량을 할당합니다.
caCertPath: 회사 루트 인증 기관 (CA) 번들의 절대 경로입니다. 이 설정은 워크스테이션이 게이트웨이의 내부 TLS 인증서를 신뢰하도록 합니다.
models.defaultModelId: Antigravity가 기본적으로 선택하는 모델입니다 (예: gemini-3.8-flash).
models.list: 개발자가 Antigravity에서 선택할 수 있는 승인된 모델입니다. 각 항목에는 게이트웨이에서 제공하는 모델 서빙과 일치하는 modelId가 필요합니다. 지원되는 Google 모델 목록은 지원되는 모델을 참조하세요.

보안 고려사항

게이트웨이 인증 및 기여 분석을 계획할 때는 다음을 고려하세요.

클라이언트 제공 헤더는 신뢰할 수 없음: 개발자는 자체 워크스테이션을 제어하므로 환경 변수 (AGY_LLM_GATEWAY_HEADERS) 또는 사용자 설정 파일에 설정된 헤더를 변경할 수 있습니다. 보안이 중요한 감사 로깅 또는 결제 기여 분석에 이러한 헤더를 사용하지 마세요.
MDM을 사용하여 헤더 고정: 개발자가 기여 분석 또는 정책 헤더를 재정의하지 못하도록 하려면 admin_settings.json의 gateway.customHeaders에서 정의합니다. admin_settings.json의 값은 환경 변수 및 사용자 설정보다 우선 적용됩니다.
네트워크 또는 전송 계층에서 인증: 개발자 ID를 확인하거나 엄격한 비용 센터 기여 분석을 적용하려면 상호 TLS (mTLS), 프록시 수준 싱글 사인온 (SSO) 또는 네트워크 마이크로 세분화와 같이 네트워크 또는 전송 계층에서 트래픽을 인증합니다. API 키 또는 HTTP 헤더에만 의존하지 마세요.

배포를 확인합니다.

개발자 워크스테이션에 구성 파일을 배포하기 전에 엔터프라이즈 게이트웨이가 트래픽을 올바르게 라우팅하고 기여 분석 정보가 Cloud Logging에 도달하는지 확인합니다.

게이트웨이 직접 테스트

개발자 워크스테이션에서 테스트하기 전에 curl를 사용하여 엔터프라이즈 게이트웨이 엔드포인트를 직접 테스트합니다. 게이트웨이를 직접 테스트하면 네트워크 라우팅, TLS 인증서 검증, 인증, 버퍼링되지 않은 서버 전송 이벤트 (SSE) 스트리밍이 Antigravity와 독립적으로 작동하는지 확인할 수 있습니다.

다음 예시 curl 명령어는 스트리밍 요청을 게이트웨이 엔드포인트에 직접 전송합니다.

curl -N -X POST "https://gateway.cymbal.com/v1beta/models/MODEL_ID:streamGenerateContent?alt=sse" \
  -H "Authorization: Bearer GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "User-Agent: antigravity/1.2.15 (aidev_client; auth_method=gateway)" \
  -d '{"contents": [{"role": "user", "parts": [{"text": "Reply with PONG"}]}]}'

이 명령어에서

-N: 서버 전송 이벤트 (SSE)가 즉시 스트리밍되도록 curl에서 응답 버퍼링을 사용 중지합니다.
MODEL_ID: models.list에서 승인된 모델 (예: gemini-3.8-flash 또는 gemini-3.7-flash). 초기 검증을 위해 Flash 모델로 테스트하는 것이 좋습니다. 사용 가능한 모델 목록은 지원되는 모델을 참조하세요.
Authorization: 게이트웨이 API 키(GATEWAY_API_KEY)를 전송하여 게이트웨이로 요청을 인증합니다.
User-Agent: Google에서 사용량을 Gemini Enterprise 계약에 기여하는 데 사용하는 클라이언트 기여 분석 문자열을 전송합니다.
streamGenerateContent?alt=sse: 지정된 모델의 스트리밍 API 엔드포인트를 호출합니다.

게이트웨이가 응답 청크를 즉시 스트리밍하는지 확인합니다. 연결 오류, 인증서 경고 또는 응답 버퍼링 지연이 발생하면 문제 해결을 참조하세요.

클라이언트 연결 확인

구성된 워크스테이션에서 클라이언트 상태를 확인합니다.

Antigravity 앱: 하단 상태 표시줄에서 표시기에 Connected: Enterprise Gateway가 표시되는지 확인합니다. 계정 설정에서 엔터프라이즈 게이트웨이 모드 활성이 표시되는지 확인합니다.
Antigravity CLI: 테스트 프롬프트를 실행합니다.
```
agy -p "Explain binary search in Go"
```
이 명령어는 게이트웨이에 테스트 프롬프트를 전송합니다. 대화형 Google 로그인 프롬프트를 표시하지 않고 터미널에서 응답이 스트리밍되는지 확인합니다. 클라이언트가 연결에 실패하거나 Google 인증을 요청하는 경우 문제 해결을 참조하세요.

Cloud Logging에서 기여 분석 확인

Google Cloud 콘솔에서 기여 분석 헤더가 수신되었는지 확인합니다.

Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

로그 탐색기로 이동

다음 쿼리를 실행합니다.

resource.type="aiplatform.googleapis.com/Endpoint" OR
protoPayload.serviceName="aiplatform.googleapis.com"

로그 항목 메타데이터를 검사합니다. protoPayload.requestMetadata.callerSuppliedUserAgent에 antigravity/VERSION (aidev_client; auth_method=gateway)가 포함되어 있는지 확인합니다.

로그 항목이 표시되지 않으면 Gemini Enterprise Agent Platform API에 데이터 액세스 분석 감사 로그가 사용 설정되어 있는지 확인합니다.

개발자 온보딩

게이트웨이를 확인한 후 개발자가 Antigravity를 사용할 수 있도록 준비합니다.

관리형 워크스테이션: MDM 시스템을 사용하여 admin_settings.json를 배포하는 경우 개발자는 구성을 수행할 필요가 없습니다. Antigravity는 시작 시 게이트웨이에 자동으로 연결됩니다.
샌드박스 및 CI/CD 파이프라인: 컨테이너화된 실행기, 원격 SSH 호스트 또는 비관리형 개발 환경에서 작업하는 개발자의 경우 게이트웨이 URL, API 키, 루트 CA 경로를 제공합니다. 개발자를 Antigravity를 엔터프라이즈 게이트웨이에 연결로 안내합니다.

문제 해결

다음 표에는 일반적인 배포 문제와 해결 방법이 나와 있습니다.

증상	원인	해결 방법
`x509: certificate signed by unknown authority`	워크스테이션이 게이트웨이 TLS 인증서를 신뢰하지 않습니다.	`admin_settings.json`에서 `caCertPath`를 사용하여 회사 루트 CA 번들의 경로를 지정합니다.
`401 Unauthorized` 또는 `403 Forbidden`	API 키가 잘못되었거나 게이트웨이 서비스 계정에 액세스 권한이 없습니다.	`gateway.apiKey` 값을 확인하고 게이트웨이 서비스 계정에 대상 프로젝트에 대한 `roles/aiplatform.user` IAM 역할이 있는지 확인합니다.
`404 Not Found`	요청된 모델을 엔터프라이즈 게이트웨이에서 사용할 수 없거나 모델 ID를 잘못 입력했습니다.	`admin_settings.json`의 `models.list`에 구성된 각 모델 ID가 엔터프라이즈 게이트웨이에서 제공하는 모델 이름과 일치하는지 확인합니다.
`gateway.wireProtocol 'openai' is not supported by the ACP server`	`admin_settings.json` 또는 환경 변수가 ACP 서버에서 지원하지 않는 `openai` 유선 프로토콜을 지정합니다.	JetBrains IDE 및 Zed 워크스테이션의 경우 `wireProtocol`를 `genai`로 설정하거나 생략하여 기본값을 사용합니다.
스트리밍 응답 시간 초과	게이트웨이가 HTTP 응답을 버퍼링하고 있습니다.	서버 전송 이벤트 (`text/event-stream`)에 대한 응답 버퍼링을 사용 중지하도록 게이트웨이를 구성합니다.
Google 로그인에 대한 Antigravity 메시지	게이트웨이 모드가 사용 설정되지 않았거나 Antigravity에서 설정 파일을 찾을 수 없습니다.	`admin_settings.json`가 올바른 운영체제 경로에 배포되었고 `gateway` 섹션에 `"enabled": true` 및 `url`가 포함되어 있는지 확인합니다.

다음 단계

Developer Connect를 사용하여 개발자가 원격 샌드박스에서 연결하는 방법 알아보기: Antigravity를 Enterprise Gateway에 연결
Antigravity 기능 및 워크플로에 대해 자세히 알아보려면 Antigravity 문서를 참고하세요.
개발자 도구 측정항목 및 사용량 검토: AI 개발자 도구 측정항목 보기
프로젝트 보안 정책 구성: AI 개발자 도구 설정 구성