Configurer des points de terminaison régionaux

Les points de terminaison régionaux App Hub vous permettent d'acheminer le trafic directement vers une région spécifiée pour vous aider à répondre aux exigences de résidence des données. Vous pouvez configurer ces points de terminaison dans la Google Cloud CLI, les API REST, Terraform et les bibliothèques clientes, et limiter l'utilisation des points de terminaison globaux à l'aide de règles d'administration d'administration.

Que sont les points de terminaison régionaux ?

Les points de terminaison régionaux sont des points de terminaison de requêtes qui ne permettent de traiter les requêtes que si la ressource concernée existe dans l'emplacement spécifié par le point de terminaison. Par exemple, lorsque vous utilisez le point de terminaison https://apphub.us-central1.rep.googleapis.com dans une requête de gestion des ressources, la requête n'est exécutée que si l'application ou le composant enregistré se trouve dans us-central1.

Contrairement aux points de terminaison mondiaux, où les requêtes peuvent être traitées dans un emplacement différent de celui où se trouve la ressource, les points de terminaison régionaux ne traitent les requêtes que dans l'emplacement spécifié par le point de terminaison. Les points de terminaison régionaux interrompent les sessions TLS à l'emplacement spécifié par le point de terminaison pour les requêtes reçues d'Internet, d'autres ressources Google Cloud , telles que les machines virtuelles Compute Engine, de services sur site utilisant un VPN ou une interconnexion et des clouds privés virtuels (VPC, Virtual Private Cloud).

Les points de terminaison régionaux sont compatibles avec la résidence des données en s'assurant que les métadonnées de votre application restent dans la région spécifiée, à la fois au repos et en transit.

Limites

Vous ne pouvez pas utiliser de points de terminaison régionaux pour gérer des ressources globales ou multirégionales dans App Hub, telles que des applications globales, des applications multirégionales (us et eu), des rattachements de projets de service et des limites.

Les rattachements et les limites des projets de service n'existent que dans l'emplacement global, et les points de terminaison régionaux rejettent toute requête dont l'emplacement du chemin d'accès ne correspond pas à la région spécifiée dans le point de terminaison, y compris /locations/global/, /locations/us/, /locations/eu/ ou une autre région. Par exemple, l'envoi de GET .../locations/global/applications/globalApp à un point de terminaison régional est refusé.

Pour gérer des ressources mondiales ou multirégionales, utilisez le point de terminaison global https://apphub.googleapis.com.

Pays acceptés

Vous pouvez utiliser des points de terminaison régionaux pour tous les emplacements régionaux où App Hub est disponible. Pour obtenir la liste des régions prises en charge, consultez Locations.

Outils pour l'utilisation des points de terminaison régionaux

Vous pouvez configurer la Google Cloud CLI ou envoyer des requêtes API REST ou RPC directes à l'aide de points de terminaison régionaux.

Google Cloud CLI

Pour configurer la Google Cloud CLI afin de l'utiliser avec des points de terminaison régionaux, procédez comme suit :

  1. Assurez-vous d'utiliser la version 468.0.0 ou ultérieure de la Google Cloud CLI.

  2. Définissez la propriété api_endpoint_overrides/apphub sur le point de terminaison régional que vous souhaitez utiliser :

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

    Remplacez LOCATION par une région prise en charge, par exemple us-central1.

Vous pouvez également définir la variable d'environnement CLOUDSDK_API_ENDPOINT_OVERRIDES_APPHUB sur le point de terminaison :

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

API REST

Pour envoyer des requêtes à des points de terminaison régionaux, utilisez l'URI suivant en remplaçant LOCATION par une région prise en charge :

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

Par exemple, vous pouvez utiliser le point de terminaison suivant pour accéder à App Hub dans la région us-central1 :

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

Terraform

Pour utiliser des points de terminaison régionaux avec Terraform, vous devez remplacer le point de terminaison App Hub dans le bloc du fournisseur Google.

Lorsque vous définissez un point de terminaison régional comme point de terminaison personnalisé, vous ne pouvez pas utiliser Terraform pour gérer des ressources globales ou multirégionales, telles que google_apphub_service_project_attachment, google_apphub_boundary ou des applications dans global, us ou eu.

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/v1/"
}

Bibliothèques clientes

Pour utiliser des points de terminaison régionaux avec des bibliothèques clientes, vous devez remplacer la propriété api_endpoint dans les options du client.

L'exemple suivant utilise la bibliothèque cliente 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)

Restreindre l'utilisation des points de terminaison d'API mondiaux

Pour vous aider à imposer l'utilisation de points de terminaison régionaux, vous pouvez utiliser la contrainte de règle d'administration constraints/gcp.restrictEndpointUsage afin de bloquer les requêtes envoyées au point de terminaison d'API mondial. Pour en savoir plus sur la restriction de l'utilisation des points de terminaison, consultez Restreindre l'utilisation des points de terminaison.