Utiliser des mappages d'URL

Ce guide vous explique comment configurer des mappages d'URL Trusted Cloud. Un mappage d'URL est un ensemble de règles permettant de diriger les requêtes HTTP(S) entrantes vers des services de backend. Un mappage d'URL minimal fait correspondre tous les chemins de requêtes entrantes (/*).

Avant de suivre ce guide, familiarisez-vous avec les concepts de mappage d'URL.

Les mappages d'URL sont utilisés avec les produits Trusted Cloud suivants :

Les mappages d'URL utilisés avec les équilibreurs de charge d'application externes régionaux et les équilibreurs de charge d'application internes régionaux sont également compatibles avec plusieurs fonctionnalités avancées de gestion du trafic. Pour en savoir plus, consultez la page Concepts de mappage d'URL : Gestion avancée du trafic.

Valeurs par défaut du mappage d'URL

Les mappages d'URL possèdent deux valeurs par défaut, comme décrit dans le tableau suivant.

Type par défaut Paramètre Signification
Mappage d'URL par défaut gcloud compute url-maps create

--default-service

 Le service de backend spécifié par défaut est utilisé si aucune des mises en correspondance de chemins d'accès ou des règles d'hôte ne correspond à l'URL entrante.
Valeur par défaut de l'outil de mise en correspondance des chemins d'accès gcloud compute url-maps add-path-matcher

--default-service

 Le service de backend spécifié par défaut est utilisé si le chemin de l'URL correspond à un outil de mise en correspondance des chemins d'accès, mais qu'aucune des règles --path-rules ne correspond.

Règles d'hôte

Une règle d'hôte définit un ensemble d'hôtes pour mettre en correspondance les requêtes.

Dans une règle d'hôte, le nom d'hôte doit être un nom de domaine complet. Le nom d'hôte ne peut pas être une adresse IPv4 ou IPv6. Par exemple :

  • Fonctionne : example.com
  • Fonctionne : web.example.com
  • Fonctionne : *.example.com
  • Ne fonctionne pas : 35.244.221.250

Configurer des mappages d'URL

Un mappage d'URL peut envoyer du trafic vers des services de backend.

Console

Pour ajouter un mappage d'URL à l'aide de la console Trusted Cloud , procédez comme suit :

  1. Accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le Nom d'un équilibreur de charge.
  3. Sur l'écran Détails de l'équilibreur de charge, cliquez sur  Modifier pour l'équilibreur de charge sélectionné.
  4. Sélectionnez Règles d'hôte et de chemin d'accès.
  5. Cliquez sur Ajouter une règle d'hôte et de chemin d'accès.

  6. Renseignez le champ Hôte, le champ Chemins d'accès ou les deux, puis sélectionnez un service de backend.

    1. Saisissez un nom d'hôte complet, par exemple web.example.com.
    2. Saisissez le chemin d'accès, par exemple, /video.
    3. Sur la page Règles d'hôte et de chemin d'accès, dans le menu Backends, sélectionnez un service de backenddisponible.

  7. Cherchez la coche bleue à gauche des règles d'hôte et de chemin d'accès, puis cliquez sur le bouton Mettre à jour.

gcloud

Pour ajouter un mappage d'URL à l'aide de Google Cloud CLI, exécutez la commande url-maps create :

gcloud compute url-maps create URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   [--description DESCRIPTION] \
   [--region=REGION]

Pour les équilibreurs de charge d'application externes régionaux et les équilibreurs de charge d'application internes, veillez à inclure l'option --region lorsque vous créez le mappage d'URL.

Pour supprimer une mise en correspondance de chemins d'accès, exécutez la commande gcloud compute url-maps add-path-matcher :

gcloud compute url-maps add-path-matcher URL_MAP_NAME \
   (--default-service=DEFAULT_SERVICE) \
   --path-matcher-name PATH_MATCHER \
   [--path-rules="PATH=SERVICE"]

Cette commande nécessite un service de backend par défaut auquel elle peut envoyer des requêtes sans correspondance. L'option --path-rules définit les mappages entre les chemins d'accès des requêtes et les servicesbackend. L'exemple de chemin d'accès suivant dirige les requêtes /video/ et /video/* vers le service de backend video-service :

--path-rules="/video=video-service,/video/*=video-service"

Pour créer une règle d'hôte, utilisez la commande gcloud compute url-maps add-host-rule :

gcloud compute url-maps add-host-rule URL_MAP_NAME \
    --hosts=[HOSTS] --path-matcher-name=PATH_MATCHER

Par exemple, la valeur --hosts suivante met en correspondance les requêtes pour www.example.com et n'importe quel sous-domaine de altostrat.com :

--hosts=[*.altostrat.com,www.example.com]

Pour modifier le service par défaut d'un mappage d'URL, exécutez la commande url-maps set-default-service :

gcloud compute url-maps set-default-service URL_MAP_NAME
  (--default-service=DEFAULT_SERVICE)[GCLOUD_WIDE_FLAG ...]

Terraform

Pour créer un mappage d'URL régional, utilisez la ressource google_compute_region_url_map. 

resource "google_compute_region_url_map" "default" {
  name            = "regional-l7-xlb-map"
  region          = "us-west1"
  default_service = google_compute_region_backend_service.default.id
}

Obtenir la liste des mappages d'URL

Console

Vous ne pouvez pas répertorier tous vos mappages d'URL dans la console Trusted Cloud .

gcloud

Pour afficher une liste de mappages d'URL à l'aide de Google Cloud CLI, exécutez la commande url-maps list.

gcloud compute url-maps list

Obtenir des informations sur un mappage d'URL

Console

Pour obtenir des informations sur un mappage d'URL, procédez comme suit :

  1. Accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le Nom d'un équilibreur de charge.
  3. Sur l'écran Détails de l'équilibreur de charge, cliquez sur  Modifier pour l'équilibreur de charge sélectionné.
  4. Affichez les règles d'hôte et de chemin d'accès.

gcloud

Pour obtenir des informations sur un seul mappage d'URL à l'aide de Google Cloud CLI, exécutez la commande url-maps describe.

gcloud compute url-maps describe URL_MAP_NAME

Supprimer un mappage d'URL

Vous ne pouvez supprimer un mappage d'URL qu'après avoir supprimé tous les proxys cibles qui y font référence. Pour en savoir plus, consultez la section Supprimer un proxy cible.

Console

Pour supprimer un mappage d'URL, procédez comme suit :

  1. Accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le Nom d'un équilibreur de charge.
  3. Sur l'écran Détails de l'équilibreur de charge, cliquez sur  Modifier pour l'équilibreur de charge sélectionné.
  4. Sur l'écran Détails de l'équilibreur de charge, affichez les règles d'hôte et de chemin d'accès.
  5. Cliquez sur le "X" à droite d'un mappage d'URL pour le supprimer. Le mappage d'URL disparaît.
  6. Cherchez la coche bleue à gauche des règles d'hôte et de chemin d'accès, puis cliquez sur le bouton Mettre à jour.

gcloud

Pour supprimer un mappage d'URL à l'aide de Google Cloud CLI, exécutez la commande url-maps delete. Avant de pouvoir supprimer un mappage d'URL, tout proxy HTTP cible faisant référence au mappage d'URL doit d'abord être supprimé.

gcloud compute url-maps delete URL_MAP_NAME [--quiet]

Supprimer une mise en correspondance de chemin d'accès

Console

Pour supprimer une mise en correspondance de chemin d'accès, procédez comme suit :

  1. Accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le Nom d'un équilibreur de charge.
  3. Sur l'écran Détails de l'équilibreur de charge, cliquez sur  Modifier pour l'équilibreur de charge sélectionné.
  4. Sélectionnez Règles d'hôte et de chemin d'accès.
  5. Dans le champ Chemins d'accès d'un mappage d'URL existant, cliquez sur le "x" dans le nom de la mise en correspondance de chemin d'accès.
  6. Cherchez la coche bleue à gauche des règles d'hôte et de chemin d'accès, puis cliquez sur le bouton Mettre à jour.

gcloud

Pour supprimer une mise en correspondance de chemins d'accès, exécutez la commande gcloud compute url-maps remove-path-matcher :

gcloud compute url-maps remove-path-matcher URL_MAP_NAME \
   [--path-matcher-name PATH_MATCHER]

Supprimer une règle d'hôte

Console

Pour supprimer une règle d'hôte, procédez comme suit :

  1. Si vous n'êtes pas déjà sur l'écran Règles d'hôte et de chemin d'accès, accédez à la page Équilibrage de charge.

    Accéder à la page "Équilibrage de charge"

  2. Cliquez sur le Nom d'un équilibreur de charge.
  3. Sur l'écran Détails de l'équilibreur de charge, cliquez sur  Modifier pour l'équilibreur de charge sélectionné.
  4. Sélectionnez Règles d'hôte et de chemin d'accès.
  5. Dans le champ Hôtes d'un mappage d'URL existant, cliquez sur le "x" "dans le nom de l'hôte.
  6. Cherchez la coche bleue à gauche des règles d'hôte et de chemin d'accès, puis cliquez sur le bouton Mettre à jour.

gcloud

Pour supprimer une règle d'hôte de votre mappage d'URL, exécutez la commande gcloud compute url-maps remove-host-rule :

gcloud compute url-maps remove-host-rule URL_MAP_NAME --host=HOST

Par exemple, pour supprimer une règle d'hôte qui contient l'hôte altostrat.com à partir d'un mappage d'URL nommé my-map, exécutez la commande suivante :

gcloud compute url-maps remove-host-rule my-map --host altostrat.com

Guides de gestion du trafic

Les fonctionnalités de mappage d'URL ne sont pas toutes disponibles pour l'ensemble des produits. Les mappages d'URL sont utilisés avec les équilibreurs de charge pour prendre en charge plusieurs fonctionnalités de gestion avancée du trafic.

Utilisez le tableau suivant pour en savoir plus sur les fonctionnalités de mappage d'URL dans le cadre de la gestion.

Produit Fonctionnalités de mappage d'URL et guides de gestion du trafic
Équilibreur de charge d'application externe régional Fonctionnalités de l'équilibreur de charge : routage et gestion du trafic

Présentation de la gestion du trafic

Configurer la gestion du trafic

Configurer une redirection d'URL

Configurer la redirection HTTP vers HTTPS

Nom d'hôte et chemin d'accès

Router des requêtes

Cookies
Équilibreur de charge d'application interne Fonctionnalités de l'équilibreur de charge : routage et gestion du trafic

Présentation de la gestion du trafic

Configurer la gestion du trafic

Configurer des redirections d'URL

Configurer des redirections HTTP vers HTTPS

Cookies

Nom d'hôte et chemin d'accès

Documentation de référence sur l'API et la CLI gcloud

En plus de la console Trusted Cloud , vous pouvez utiliser l'API et gcloud CLI pour créer des mappages d'URL.

API

Pour une description des propriétés et des méthodes disponibles lorsque vous utilisez des mappages d'URL via l'API REST, consultez les pages suivantes :

Produit Documentation de l'API
Équilibreur de charge d'application externe urlMaps
Équilibreur de charge d'application interne regionUrlMaps

gcloud CLI

Pour Google Cloud CLI, consultez les ressources suivantes :

  • Champ d'application régional : --region=[REGION]

Pour une gestion avancée du trafic, utilisez des fichiers YAML et importez-les à l'aide de la commande gcloud compute url-maps import.

Étape suivante