에이전트 레지스트리에서 엔드포인트는 에이전트가 액세스하는 대상 URL(일반적으로 REST API)을 나타냅니다. 이러한 대상을 에이전트 레지스트리 내에서 관리형 에이전트 구성요소로 등록하면 에이전트 Fleet이 연결할 수 있는 외부 엔드포인트를 중앙에서 관리할 수 있습니다.
이 문서에서는 레지스트리에 외부 엔드포인트를 명시적으로 등록하는 방법을 설명합니다.
시작하기 전에
시작하기 전에 에이전트 레지스트리를 설정하세요. 이러한 작업을 수행하려면 프로젝트 ID가 필요합니다.
이 문서에서 Google Cloud CLI 명령어를 사용하려면 gcloud CLI 환경을 설정해야 합니다.
필요한 역할
에이전트 등록부에 엔드포인트를 등록하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 등록부 API 편집자 (roles/agentregistry.editor) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
엔드포인트 등록
엔드포인트는 맞춤 외부 대상이므로 수동 등록을 사용하여 에이전트 레지스트리에 추가합니다.
콘솔
Google Cloud 콘솔에서 Agent Registry로 이동합니다.
프로젝트 선택 도구에서 Google Cloud 에이전트 레지스트리를 설정한 프로젝트를 선택합니다.
엔드포인트 탭을 선택합니다.
엔드포인트 추가를 클릭합니다.
엔드포인트 세부정보 패널에 표시 이름, 설명, 지리적 리전, 도착 URL을 입력합니다.
선택적으로 이 패널에서 연결 테스트를 클릭하여 도착 URL에 대한 연결을 테스트할 수 있습니다.
저장을 클릭합니다.
gcloud
no-spec의 endpoint-spec-type을 사용하여 Service 리소스를 만듭니다.
엔드포인트를 등록하고 인터페이스 연결 세부정보를 정의합니다.
gcloud alpha agent-registry services create ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION \
--display-name="DISPLAY_NAME" \
--endpoint-spec-type=no-spec \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
다음을 바꿉니다.
ENDPOINT_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 리소스를 자동으로 생성합니다.