엔드포인트 등록

에이전트 레지스트리에서 엔드포인트는 에이전트가 액세스하는 대상 URL(일반적으로 REST API)을 나타냅니다. 이러한 대상을 관리형 리소스로 등록하면 에이전트 Fleet이 연결할 수 있는 외부 서비스를 중앙에서 관리할 수 있습니다.

이 문서에서는 레지스트리에 외부 엔드포인트를 명시적으로 등록하는 방법을 설명합니다.

시작하기 전에

시작하기 전에 에이전트 레지스트리를 설정합니다. 이러한 작업을 수행하려면 프로젝트 ID가 필요합니다.

이 문서의 gcloud CLI 명령어를 사용하려면 Google Cloud CLI 환경을 설정해야 합니다.

필요한 역할

에이전트 레지스트리에 엔드포인트를 등록하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 레지스트리 API 편집자 (roles/agentregistry.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

엔드포인트 등록

엔드포인트는 커스텀 외부 대상이므로 수동 등록을 사용하여 에이전트 레지스트리에 추가합니다.

콘솔

  1. 콘솔에서 에이전트 레지스트리로 이동합니다. Google Cloud

    에이전트 레지스트리로 이동

  2. 프로젝트 선택 도구에서 에이전트 레지스트리를 Google Cloud 설정한 프로젝트를 선택합니다.

  3. 엔드포인트 탭을 선택합니다.

  4. 엔드포인트 추가 를 클릭합니다.

  5. 엔드포인트 세부정보 패널에서 표시 이름, 설명, 지리적 리전, 도착 URL을 입력합니다. 이 패널에서 도착 URL에 대한 연결을 테스트할 수 있습니다.

  6. 저장 을 클릭합니다.

gcloud

endpoint-spec-type이 no-spec인 Service 리소스를 만듭니다.

엔드포인트를 등록하고 인터페이스 연결 세부정보를 정의합니다.

gcloud alpha agent-registry services create SERVICE_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --endpoint-spec-type=no-spec \
  --interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL

다음을 바꿉니다.

  • SERVICE_NAME: 리소스에 지정할 이름(예: my-external-api)
  • PROJECT_ID: 프로젝트 ID
  • REGION: 등록처 리전
  • DISPLAY_NAME: 사람이 읽을 수 있는 엔드포인트 이름
  • ENDPOINT_URL: 대상 URL(예: https://api.example.com/v1/data)
  • PROTOCOL: 인터페이스의 프로토콜 바인딩 유효한 값은 HTTP_JSON, GRPC 또는 JSONRPC입니다.

Service 리소스가 생성되면 에이전트 레지스트리는 에이전트와 오케스트레이터가 검색하고 사용할 수 있는 소비자 측의 읽기 전용 Endpoint 리소스를 자동으로 생성합니다.