에이전트 Fleet의 효과적인 관리를 위해서는 엔드포인트 네트워크를 정확하게 유지해야 합니다. 이 문서에서는 사용 가능한 엔드포인트를 검색하고, 연결 세부정보를 업데이트하거나, 더 이상 사용하지 않는 엔드포인트를 삭제하는 방법을 자세히 설명합니다.
시작하기 전에
엔드포인트를 관리하려면 먼저 Agent Registry에 엔드포인트를 등록해야 합니다. 이러한 작업을 수행하려면 프로젝트 ID 도 필요합니다.
이 문서에서 gcloud CLI 명령어를 사용하려면 Google Cloud CLI 환경을 설정해야 합니다.
필요한 역할
Agent Registry에서 엔드포인트를 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
엔드포인트 검색:
Agent Registry API 뷰어 (
roles/agentregistry.viewer) -
엔드포인트 업데이트 및 삭제:
Agent Registry API 편집자 (
roles/agentregistry.editor)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
엔드포인트 검색
환경에 등록된 대상 URL 및 REST API를 찾아보려면 사용 가능한 엔드포인트 리소스를 나열합니다.
모든 엔드포인트 나열
환경에 등록된 모든 엔드포인트를 나열합니다.
콘솔
콘솔에서 Agent Registry로 이동합니다. Google Cloud
엔드포인트 탭을 선택합니다.
이 페이지에는 등록된 모든 엔드포인트와 이름, 설명, 위치와 같은 세부정보가 표시됩니다.
엔드포인트의 전체 연결 세부정보를 보려면 엔드포인트 이름을 클릭합니다.
gcloud
특정 위치의 모든 엔드포인트를 나열하려면 endpoints list 명령어를 사용합니다.
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION
다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID입니다.REGION: 레지스트리 리전입니다.
등록된 엔드포인트 필터링
엔드포인트가 여러 개 있는 경우 엔드포인트의 메타데이터를 기준으로 목록을 필터링할 수 있습니다.
콘솔
콘솔에서 Agent Registry로 이동합니다. Google Cloud
엔드포인트 탭을 선택합니다.
이 페이지에는 등록된 모든 엔드포인트와 이름, 설명, 위치와 같은 세부정보가 표시됩니다.
위치별로 필터링하려면 위치 메뉴를 클릭하고 필터링할 위치를 선택한 후 적용 을 클릭합니다.
이 페이지에는 선택한 조건에 따라 등록된 엔드포인트의 필터링된 목록이 표시됩니다.
gcloud
--filter 플래그를 사용하여 특정 메타데이터와 일치하는 리소스만 반환하도록 목록을 필터링합니다.
gcloud alpha agent-registry endpoints list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
FILTER_EXPRESSION을 필터링할 엔드포인트의 필터 표현식으로 바꿉니다. 예를 들어 표시
이름으로 필터링하려면 displayName='DISPLAY_NAME'을 사용합니다.
엔드포인트에서 세부정보 보기
연결 세부정보 및 프로토콜 결합을 비롯한 특정 엔드포인트의 세부정보를 봅니다.
콘솔
콘솔에서 Agent Registry로 이동합니다. Google Cloud
엔드포인트 탭을 선택합니다.
이 페이지에는 등록된 모든 엔드포인트와 이름, 설명, 위치와 같은 세부정보가 표시됩니다.
보려는 엔드포인트의 이름을 클릭합니다.
개요 페이지에는 도착 URL 및 프로토콜 결합을 비롯한 엔드포인트의 이름, 설명, 위치, 연결 세부정보가 표시됩니다.
gcloud
전체 인터페이스 URL 및 프로토콜 결합을 비롯한 특정 엔드포인트에 대한 세부 메타데이터를 가져옵니다.
gcloud alpha agent-registry endpoints describe ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION
다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID입니다.REGION: 레지스트리 리전입니다.ENDPOINT_NAME: 엔드포인트의 이름입니다(예:my-external-api).
엔드포인트 업데이트
외부 대상 엔드포인트의 기본 URL이 변경되면 엔드포인트 인터페이스 세부정보를 업데이트할 수 있습니다.
엔드포인트를 업데이트하려면 다음 단계를 따르세요.
콘솔
콘솔에서 Agent Registry로 이동합니다. Google Cloud
엔드포인트 탭을 선택합니다.
이 페이지에는 등록된 모든 엔드포인트와 이름, 설명, 위치와 같은 세부정보가 표시됩니다.
업데이트할 엔드포인트의 이름을 클릭합니다.
개요 페이지에는 도착 URL 및 프로토콜 결합을 비롯한 엔드포인트의 이름, 설명, 위치, 연결 세부정보가 표시됩니다.
수정 을 클릭합니다.
서비스 수정 패널에서 표시 이름, 설명, 도착 URL과 같은 엔드포인트의 업데이트된 정보를 입력합니다. 이 패널에서 엔드포인트에 대한 연결을 테스트할 수 있습니다.
저장 을 클릭합니다.
gcloud
Agent Registry API의 경우 Endpoint 리소스가 검색에 사용됩니다. 따라서 등록된 Service 리소스를 직접 업데이트해야 합니다.
--interfaces 플래그를 사용하여 새 대상 URL을 지정합니다.
gcloud alpha agent-registry services update ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION \
--interfaces=url=ENDPOINT_URL,protocolBinding=PROTOCOL
다음을 바꿉니다.
ENDPOINT_NAME: 엔드포인트의 이름입니다(예:my-external-api).PROJECT_ID: 프로젝트 ID입니다.REGION: 레지스트리 리전입니다.ENDPOINT_URL: 새 대상 URL입니다(예:https://new-api.example.com/v1/data).PROTOCOL: 인터페이스의 프로토콜 결합입니다. 유효한 값은HTTP_JSON,GRPC또는JSONRPC입니다.
엔드포인트 삭제
레지스트리에서 엔드포인트를 삭제하려면 기본 Service 리소스를 삭제해야 합니다. 이 작업은 검색 결과에서 엔드포인트를 즉시 삭제합니다.
레지스트리에서 엔드포인트를 삭제하려면 다음 단계를 따르세요.
콘솔
콘솔에서 Agent Registry로 이동합니다. Google Cloud
엔드포인트 탭을 선택합니다.
이 페이지에는 등록된 모든 엔드포인트와 이름, 설명, 위치와 같은 세부정보가 표시됩니다.
삭제할 엔드포인트의 이름을 클릭합니다.
개요 페이지에는 도착 URL 및 프로토콜 결합을 비롯한 엔드포인트의 이름, 설명, 위치, 연결 세부정보가 표시됩니다.
삭제 를 클릭합니다.
엔드포인트 삭제 창에서 DELETE 를 입력하여 작업을 확인합니다.
삭제 를 클릭합니다.
gcloud
gcloud alpha agent-registry services delete ENDPOINT_NAME \
--project=PROJECT_ID \
--location=REGION