리전 엔드포인트를 사용하면 데이터 레지던시 및 데이터 주권 요구사항을 준수하는 방식으로 App Hub 워크로드를 실행할 수 있으며, 여기서 요청 트래픽은 엔드포인트에 지정된 리전으로 직접 라우팅됩니다.
리전 엔드포인트란 무엇인가요?
리전 엔드포인트는 영향을 받는 리소스가 엔드포인트에서 지정된 위치에 있는 경우에만 요청 처리를 허용하는 요청 엔드포인트입니다. 예를 들어 리소스 관리 요청에서 엔드포인트 https://apphub.us-central1.rep.googleapis.com을 사용하는 경우 애플리케이션 또는 등록된 구성요소가 us-central1에 있는 경우에만 요청이 진행됩니다.
리소스가 있는 곳과 다른 위치에서 요청을 처리할 수 있는 전역 엔드포인트와 달리 리전 엔드포인트는 엔드포인트에서 지정한 위치 내에서만 요청을 처리합니다. 리전 엔드포인트는 인터넷, 기타 Google Cloud 리소스(예: Compute Engine 가상 머신), VPN 또는 Interconnect를 사용하는 온프레미스 서비스 및 Virtual Private Cloud(VPC)에서 수신된 요청에 대해 엔드포인트에서 지정된 위치에서 TLS 세션을 종료합니다.
리전 엔드포인트는 애플리케이션의 메타데이터가 저장 및 전송 중에 지정된 리전 내에 유지되도록 하여 데이터 레지던시를 지원합니다.
제한사항
리전 엔드포인트를 사용하여 App Hub에서 전역 애플리케이션, 경계, 서비스 프로젝트 연결 (SPA), 경계와 같은 전역 리소스를 관리할 수 없습니다.
리전 엔드포인트를 사용하는 이러한 전역 리소스와 관련된 API 요청은 API 경로에 /global/ 위치가 포함되어 있으므로 실패합니다. 예를 들어 GET .../locations/global/applications/globalApp 요청은 거부됩니다.
전역 리소스를 관리하려면 표준 전역 엔드포인트인 https://apphub.googleapis.com를 사용합니다.
지원되는 위치
App Hub를 사용할 수 있는 모든 리전 위치에 리전 엔드포인트를 사용할 수 있습니다. 지원되는 리전 목록은 위치를 참조하세요.
리전 엔드포인트를 사용하기 위한 도구
Google Cloud CLI를 구성하거나 리전 엔드포인트를 사용하여 직접 REST 또는 RPC API 요청을 수행할 수 있습니다.
Google Cloud CLI
리전 엔드포인트에서 사용할 Google Cloud CLI를 구성하려면 다음 단계를 따르세요.
Google Cloud CLI 버전
402.0.0이상을 사용해야 합니다.api_endpoint_overrides/apphub속성을 사용할 리전 엔드포인트로 설정합니다.gcloud config set api_endpoint_overrides/apphub https://apphub.LOCATION.rep.googleapis.com/LOCATION을 지원되는 지역(예:us-central1)으로 바꿉니다.
또는 CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB 환경 변수를 엔드포인트로 설정합니다.
CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB=https://apphub.LOCATION.rep.googleapis.com/
gcloud apphub applications list
REST API
리전 엔드포인트에 요청을 수행하려면 다음 URI를 사용하고 LOCATION을 지원되는 지역으로 바꿉니다.
https://apphub.LOCATION.rep.googleapis.com
예를 들어 다음 엔드포인트를 사용하여 us-central1 리전의 App Hub에 액세스할 수 있습니다.
https://apphub.us-central1.rep.googleapis.com
Terraform
Terraform에서 리전 엔드포인트를 사용하려면 Google 제공업체 블록에서 App Hub 엔드포인트를 재정의해야 합니다.
리전 엔드포인트를 커스텀 엔드포인트로 설정하면 Terraform을 사용하여 google_apphub_service_project_attachment과 같은 전역 리소스를 관리할 수 없습니다.
provider "google" {
project = "project-id"
region = "us-central1"
# Override the App Hub API endpoint to use a regional endpoint
apphub_custom_endpoint = "https://apphub.us-central1.rep.googleapis.com/"
}
클라이언트 라이브러리
클라이언트 라이브러리와 함께 리전 엔드포인트를 사용하려면 클라이언트 옵션에서 api_endpoint 속성을 재정의해야 합니다.
다음 예시에서는 Python 클라이언트 라이브러리를 사용합니다.
from google.cloud import apphub_v1
from google.api_core import client_options
rep_endpoint = "apphub.us-central1.rep.googleapis.com"
options = client_options.ClientOptions(api_endpoint=rep_endpoint)
# Instantiate the client
client = apphub_v1.AppHubClient(client_options=options)
전역 API 엔드포인트 사용 제한
리전 엔드포인트 사용을 강제하기 위해 constraints/gcp.restrictEndpointUsage 조직 정책 제약조건을 사용하여 전역 API 엔드포인트에 대한 요청을 차단할 수 있습니다. 엔드포인트 사용 제한에 대한 자세한 내용은 엔드포인트 사용 제한을 참조하세요.