Configura extremos regionales

Los extremos regionales te permiten ejecutar tus cargas de trabajo de App Hub de una manera que cumpla con los requisitos de residencia de datos y soberanía de los datos, en los que el tráfico de solicitudes se enruta directamente a la región especificada en el extremo.

¿Qué son los extremos regionales?

Los extremos regionales son extremos de solicitud que solo permiten que las solicitudes continúen si el recurso afectado existe en la ubicación especificada por el extremo. Por ejemplo, cuando usas el extremo https://apphub.us-central1.rep.googleapis.com en una solicitud para administrar recursos, la solicitud solo continúa si la aplicación o el componente registrado se encuentran en us-central1.

A diferencia de los extremos globales, en los que las solicitudes se pueden procesar en una ubicación diferente desde donde reside el recurso, los extremos regionales solo procesan las solicitudes dentro de la ubicación que especifica el extremo. Los extremos regionales finalizan las sesiones de TLS en la ubicación que especifica el extremo para solicitudes recibidas de Internet, otros recursos de Google Cloud , como máquinas virtuales de Compute Engine, servicios locales con VPN o Interconnect y nubes privadas virtuales (VPC).

Los extremos regionales admiten la residencia de datos, ya que garantizan que los metadatos de tu aplicación permanezcan dentro de la región especificada, tanto en reposo como en tránsito.

Limitaciones

No puedes usar extremos regionales para administrar recursos globales en App Hub, como aplicaciones globales, perímetros, adjuntos de proyectos de servicio (SPA) y límites.

Las solicitudes a la API relacionadas con estos recursos globales que usan un extremo regional fallarán porque estas solicitudes incluyen la ubicación /global/ en la ruta de la API. Por ejemplo, se rechazará la solicitud GET .../locations/global/applications/globalApp.

Para administrar recursos globales, usa el extremo global estándar, https://apphub.googleapis.com.

Ubicaciones admitidas

Puedes usar extremos regionales para todas las ubicaciones regionales en las que App Hub esté disponible. Para obtener una lista de las regiones admitidas, consulta Ubicaciones.

Herramientas para usar extremos regionales

Puedes configurar Google Cloud CLI o realizar solicitudes directas a la API de REST o RPC con extremos regionales.

Google Cloud CLI

Si deseas configurar Google Cloud CLI para usarla con extremos regionales, sigue estos pasos:

  1. Asegúrate de usar la versión 402.0.0 o una posterior de Google Cloud CLI.

  2. Configura la propiedad api_endpoint_overrides/apphub en el extremo regional que deseas usar:

    gcloud config set api_endpoint_overrides/apphub https://apphub.LOCATION.rep.googleapis.com/

    Reemplaza LOCATION por una región admitida, como us-central1.

Como alternativa, establece la variable de entorno CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB como el extremo:

CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB=https://apphub.LOCATION.rep.googleapis.com/
gcloud apphub applications list

API de REST

Para realizar solicitudes a extremos regionales, usa el siguiente URI y reemplaza LOCATION por una región admitida:

https://apphub.LOCATION.rep.googleapis.com

Por ejemplo, puedes usar el siguiente extremo para acceder a App Hub en la región us-central1:

https://apphub.us-central1.rep.googleapis.com

Terraform

Para usar extremos regionales con Terraform, debes anular el extremo de App Hub en el bloque del proveedor de Google.

Cuando configuras un extremo regional como el extremo personalizado, no puedes usar Terraform para administrar recursos globales, como 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/"
}

Bibliotecas cliente

Para usar extremos regionales con bibliotecas cliente, debes anular la propiedad api_endpoint en las opciones del cliente.

En el siguiente ejemplo, se usa la biblioteca cliente de 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)

Restringe el uso del extremo de API global

Para ayudar a aplicar de manera forzosa el uso de extremos regionales, puedes usar la restricción de políticas de la organización constraints/gcp.restrictEndpointUsage y bloquear las solicitudes al extremo de API global. Para obtener más información sobre cómo restringir el uso de extremos, consulta Restringe el uso de extremos.