URL-Mapping verwenden

In dieser Anleitung erfahren Sie, wie Sie Trusted CloudURL-Zuordnungen konfigurieren. Eine URL-Zuordnung ist eine Reihe von Regeln zum Weiterleiten eingehender HTTP(S)-Anfragen an bestimmte Backend-Dienste. Eine minimale URL-Zuordnung deckt alle eingehenden Anfragepfade ab (/*).

Bevor Sie dieser Anleitung folgen, sollten Sie sich mit URL-Zuordnungskonzepten vertraut machen.

URL-Zuordnungen werden bei den folgenden Trusted Cloud Produkten verwendet:

URL-Zuordnungen, die mit regionalen externen Application Load Balancern und regionalen internen Application Load Balancern verwendet werden, unterstützen ebenfalls mehrere erweiterte Features zur Trafficverwaltung. Weitere Informationen finden Sie unter Konzepte der URL-Zuordnung: Erweiterte Trafficverwaltung.

Standardeinstellungen für URL-Zuordnungen

URL-Zuordnungen haben zwei Standardeinstellungen, wie in der folgenden Tabelle beschrieben.

Standardtyp Einstellung Bedeutung
Standardeinstellung für URL-Zuordnung gcloud compute url-maps create

--default-service

 Der angegebene Standard-Backend-Dienst wird verwendet, wenn keiner der Pfad-Matcher oder Hostregeln mit der eingehenden URL übereinstimmt.
Standardeinstellung für Pfad-Matcher gcloud compute url-maps add-path-matcher

--default-service

 Der angegebene Standard-Backend-Dienst wird verwendet, wenn der Pfad der URL mit einem Pfad-Matcher übereinstimmt, aber mit keinem der angegebenen --path-rules übereinstimmt.

Hostregeln

Eine Hostregel definiert eine Reihe von Hosts, die Anfragen abgleichen sollen.

In einer Hostregel muss der Hostname ein voll qualifizierter Domainname (FQDN) sein. Der Hostname darf keine IPv4- oder IPv6-Adresse sein. Beispiel:

  • Funktioniert: example.com
  • Funktioniert: web.example.com
  • Funktioniert: *.example.com
  • Funktioniert nicht: 35.244.221.250

URL-Zuordnungen konfigurieren

Eine URL-Zuordnung kann Traffic an Backend-Dienstenicht unterstützt.

Console

Führen Sie die folgenden Schritte aus, um mithilfe der Trusted Cloud Console eine URL-Zuordnung hinzuzufügen:

  1. Öffnen Sie die Seite Load-Balancing.

    Load-Balancing aufrufen

  2. Klicken Sie auf den Namen eines Load-Balancers.
  3. Klicken Sie auf der Seite Details zum Load-Balancer für den ausgewählten Load Balancer auf Bearbeiten .
  4. Wählen Sie Host- und Pfadregeln aus.
  5. Klicken Sie auf Host- und Pfadregel hinzufügen.

  6. Füllen Sie das Feld Host, das Feld Pfade oder beide aus und wählen Sie einen Backend-Dienstaus.

    1. Geben Sie einen vollqualifizierten Hostnamen ein, zum Beispiel web.example.com.
    2. Geben Sie den Pfad ein, z. B. /video.
    3. Wählen Sie auf der Seite Host- und Pfadregeln im Menü Backends einen verfügbaren Backend-Dienstaus.

  7. Prüfen Sie, ob das blaue Häkchen links neben Host- und Pfadregeln angezeigt wird, und klicken Sie auf die Schaltfläche Aktualisieren.

gcloud

Zum Hinzufügen einer URL-Zuordnung über die Google Cloud-CLI verwenden Sie den Befehl url-maps create:

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

Achten Sie bei regionalen externen Application Load Balancern und internen Application Load Balancern darauf, dass Sie beim Erstellen der URL-Zuordnung das Flag --region angeben.

Verwenden Sie den Befehl gcloud compute url-maps add-path-matcher, um einen Pfad-Matcher zu erstellen:

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

Für diesen Befehl ist ein Standard-Backend-Dienst erforderlich, an den nicht übereinstimmende Anfragen gesendet werden können. Das Flag --path-rules definiert Zuordnungen zwischen Anfragepfaden und Backend-Diensten. Im folgenden Beispiel werden die Anfragepfade /video/ und /video/* an den Back-End-Dienst video-service weitergeleitet:

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

Verwenden Sie den Befehl gcloud compute url-maps add-host-rule, um eine Hostregel zu erstellen:

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

Der folgende --hosts-Wert stimmt beispielsweise mit Anfragen gegen www.example.com und einer beliebigen Subdomain von altostrat.com überein:

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

Verwenden Sie zum Ändern des Standarddienstes einer URL-Zuordnung den url-maps set-default-service-Befehl:

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

Terraform

Verwenden Sie zum Erstellen einer regionalen URL-Zuordnung die 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
}

URL-Zuordnungen auflisten

Console

Sie können nicht alle URL-Zuordnungen in der Trusted Cloud Console auflisten.

gcloud

Verwenden Sie den Befehl url-maps list, um mithilfe der Google Cloud-CLI eine Liste von URL-Zuordnungen aufzurufen.

gcloud compute url-maps list

Informationen zu einer URL-Zuordnung abrufen

Console

Führen Sie folgende Schritte aus, um Informationen zu einer URL-Zuordnung abzurufen:

  1. Öffnen Sie die Seite Load-Balancing.

    Load-Balancing aufrufen

  2. Klicken Sie auf den Namen eines Load-Balancers.
  3. Klicken Sie auf der Seite Details zum Load-Balancer für den ausgewählten Load Balancer auf Bearbeiten .
  4. Sehen Sie sich die Host- und Pfadregeln an.

gcloud

Verwenden Sie den Befehl url-maps describe, um mithilfe der Google Cloud-CLI Informationen zu einer einzelnen URL-Zuordnung abzurufen.

gcloud compute url-maps describe URL_MAP_NAME

URL-Zuordnung löschen

Sie können eine URL-Zuordnung erst löschen, nachdem Sie alle Ziel-Proxys gelöscht haben, die darauf verweisen. Weitere Informationen finden Sie unter Ziel-Proxy löschen.

Console

Führen Sie folgende Schritte aus, um eine URL-Zuordnung zu löschen:

  1. Öffnen Sie die Seite Load-Balancing.

    Load-Balancing aufrufen

  2. Klicken Sie auf den Namen eines Load-Balancers.
  3. Klicken Sie auf der Seite Details zum Load-Balancer für den ausgewählten Load Balancer auf Bearbeiten .
  4. Sehen Sie sich auf der Seite Details zum Load-Balancer die Host- und Pfadregeln an.
  5. Klicken Sie auf das "X" rechts neben einer URL-Zuordnung, um sie zu löschen. Die URL-Zuordnung wird nicht mehr angezeigt.
  6. Prüfen Sie, ob das blaue Häkchen links neben Host- und Pfadregeln angezeigt wird, und klicken Sie auf die Schaltfläche Aktualisieren.

gcloud

Zum Löschen einer URL-Zuordnung mit der Google Cloud-CLI verwenden Sie den Befehl url-maps delete. Bevor Sie eine URL-Zuordnung löschen können, müssen zuerst alle Ziel-HTTP-Proxys, die auf die URL-Zuordnung verweisen, gelöscht werden:

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

Einen PathMatcher löschen

Console

Führen Sie folgende Schritte aus, um einen Pfad-Matcher zu löschen:

  1. Öffnen Sie die Seite Load-Balancing.

    Load-Balancing aufrufen

  2. Klicken Sie auf den Namen eines Load-Balancers.
  3. Klicken Sie auf der Seite Details zum Load-Balancer für den ausgewählten Load Balancer auf Bearbeiten .
  4. Wählen Sie Host- und Pfadregeln aus.
  5. Klicken Sie im Feld Pfade für eine vorhandene URL-Zuordnung auf das "x" im Pfad-Matcher-Namen.
  6. Prüfen Sie, ob das blaue Häkchen links neben Host- und Pfadregeln angezeigt wird, und klicken Sie auf die Schaltfläche Aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud compute url-maps remove-path-matcher, um einen Pfad-Matcher zu löschen.

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

Eine Hostregel löschen

Console

Führen Sie folgende Schritte aus, um eine Hostregel zu löschen:

  1. Wenn Sie sich noch nicht auf der Seite Host- und Pfadregeln befinden, rufen Sie die Seite Load-Balancing auf.

    Load-Balancing aufrufen

  2. Klicken Sie auf den Namen eines Load-Balancers.
  3. Klicken Sie auf der Seite Details zum Load-Balancer für den ausgewählten Load Balancer auf Bearbeiten .
  4. Wählen Sie Host- und Pfadregeln aus.
  5. Klicken Sie im Feld Hosts für eine vorhandene URL-Zuordnung auf das "x" im Hostnamen.
  6. Prüfen Sie, ob das blaue Häkchen links neben Host- und Pfadregeln angezeigt wird, und klicken Sie auf die Schaltfläche Aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud compute url-maps remove-host-rule, um eine Hostregel aus einer URL-Zuordnung zu löschen:

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

Wenn Sie beispielsweise eine Hostregel mit dem Host altostrat.com aus einer URL-Zuordnung mit dem Namen my-map entfernen möchten, führen Sie folgenden Befehl aus:

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

Leitfäden zur Trafficverwaltung

Nicht alle URL-Zuordnungs-Features sind für alle Produkte verfügbar. URL-Zuordnungen werden mit Load Balancern verwendet, um mehrere erweiterte Features zur Trafficverwaltung zu unterstützen.

In der folgenden Tabelle erfahren Sie mehr über die Features der URL-Zuordnung für die Trafficverwaltung.

Produkt Leitfaden für die Funktionen der URL-Zuordnung und der Trafficverwaltung
Regionaler externer Application Load Balancer Load-Balancing-Features: Routing und Trafficverwaltung

Trafficverwaltung – Übersicht

Trafficverwaltung einrichten

URL-Weiterleitung einrichten

HTTP-zu-HTTPS-Weiterleitung einrichten

Hostname und Pfad

Anfragen weiterleiten

Cookies
Interner Application Load Balancer Load-Balancing-Features: Routing und Trafficverwaltung

Trafficverwaltung – Übersicht

Trafficverwaltung einrichten

URL-Weiterleitungen einrichten

HTTP-zu-HTTPS-Weiterleitungen einrichten

Cookies

Hostname und Pfad

Referenz zu API und gcloud-CLI

Zusätzlich zur Trusted Cloud -Konsole können Sie die API und die gcloud CLI verwenden, um URL-Zuordnungen zu erstellen.

API

Eine Beschreibung der Attribute und Methoden, die Sie für URL-Zuordnungen über die REST API nutzen können, finden Sie unter:

Produkt API-Dokumentation
Externer Application Load Balancer urlMaps
Interner Application Load Balancer regionUrlMaps

gcloud-CLI

Informationen zur Google Cloud-CLI in der Google Cloud CLI finden Sie unter:

  • Regional: --region=[REGION]

Verwenden Sie für eine erweiterte Trafficverwaltung YAML-Dateien und importieren Sie sie mit dem Befehl gcloud compute url-maps import.

Nächste Schritte