Traffic Director-Einrichtung für Compute Engine-VMs mit automatischer Envoy-Bereitstellung

Bevor Sie der Anleitung in diesem Leitfaden folgen, lesen Sie die Informationen unter Traffic Director-Einrichtung vorbereiten und vergewissern Sie sich, dass Sie die in diesem Dokument beschriebenen erforderlichen Aufgaben ausgeführt haben.

In diesem Leitfaden erfahren Sie, wie Sie eine aus Envoy-Sidecar-Proxys bestehende Datenebene automatisch bereitstellen, diese mit Traffic Director konfigurieren und die Einrichtung prüfen, damit sie ordnungsgemäß funktioniert. Dazu sind folgende Schritte erforderlich:

  1. Testdienst erstellen
  2. Einfache Datenebene in Compute Engine mit Envoy-Proxys bereitstellen
  3. Traffic Director mit Compute Engine APIs einrichten, mit denen Traffic Director Ihre Envoy-Sidecar-Proxys konfigurieren kann
  4. Bei einer VM anmelden, auf der ein Envoy-Proxy ausgeführt wird, und durch einen Envoy-Proxy eine Anfrage an ein Back-End mit Load-Balancing senden

Die Konfigurationsbeispiele in diesem Dokument dienen Demonstrationszwecken. In einer Produktionsumgebung müssen Sie möglicherweise je nach Umgebung und Anforderungen zusätzliche Komponenten bereitstellen.

Hello World-Testdienst erstellen

In diesem Abschnitt erfahren Sie, wie Sie einen einfachen Testdienst erstellen, der den Hostnamen der VM zurückgibt, die die Anfrage vom Client bereitgestellt hat. Der Testdienst ist unkompliziert. Es ist ein Webserver, der über eine von Compute Engine verwaltete Instanzgruppe bereitgestellt wird.

Instanzvorlage für den Hello World-Testdienst erstellen

In der von Ihnen erstellten Instanzvorlage wird ein Beispiel für den apache2-Webserver mit dem Parameter startup-script konfiguriert.

Console

  1. Rufen Sie in der Cloud Console die Seite "Instanzvorlagen" auf.

    Zur Seite "Instanzvorlagen"

  2. Klicken Sie auf Instanzvorlage erstellen.
  3. Geben Sie in den Feldern die folgenden Informationen ein:
    • Name: td-demo-hello-world-template
    • Bootlaufwerk: Debian GNU/Linux 10 (Buster)
    • Dienstkonto: Standarddienstkonto für Compute Engine
    • Zugriffsbereiche: Erlauben Sie vollen Zugriff auf alle Cloud APIs
  4. Klicken Sie auf Verwaltung, Sicherheit, Laufwerke, Netzwerke, einzelne Mandanten. 1 Fügen Sie auf dem Tab Netzwerk im Feld Netzwerk-Tags das Tag td-http-server hinzu.
  5. Kopieren Sie auf dem Tab Verwaltung das folgende Skript in das Feld Startskript.

    #!/bin/bash
    sudo apt-get update -y
    sudo apt-get install apache2 -y
    sudo service apache2 restart
    echo '<!doctype html><html><body><h1>'\`/bin/hostname\`'</h1></body></html>' | sudo tee /var/www/html/index.html
    
  6. Klicken Sie auf Erstellen.

gcloud

So erstellen Sie die Instanzvorlage:

gcloud compute instance-templates create td-demo-hello-world-template \
  --machine-type=n1-standard-1 \
  --boot-disk-size=20GB \
  --image-family=debian-10 \
  --image-project=debian-cloud \
  --scopes=https://www.googleapis.com/auth/cloud-platform \
  --tags=td-http-server \
  --metadata=startup-script="#! /bin/bash
sudo apt-get update -y
sudo apt-get install apache2 -y
sudo service apache2 restart
sudo mkdir -p /var/www/html/
echo '<!doctype html><html><body><h1>'\`/bin/hostname\`'</h1></body></html>' | sudo tee /var/www/html/index.html"

Verwaltete Instanzgruppe für den Dienst Hello World erstellen

In diesem Abschnitt geben Sie an, dass die verwaltete Instanzgruppe immer zwei Instanzen des Testdienstes enthält. Dies ist zu Demonstrationszwecken. Traffic Director unterstützt automatisch skalierte verwaltete Instanzgruppen.

Console

  1. Rufen Sie in der Cloud Console die Seite "Instanzgruppen" auf.

    Zur Seite "Instanzgruppen"

  2. Klicken Sie auf Instanzgruppe erstellen.
  3. Achten Sie darauf, dass Neue verwaltete Instanzgruppe ausgewählt ist.
  4. Geben Sie td-demo-hello-world-mig als Name für die verwaltete Instanzgruppe ein und wählen Sie die Zone us-central1-a aus.
  5. Wählen Sie unter "Instanzvorlage" die Option td-demo-hello-world-template aus. Dies ist die von Ihnen erstellte Instanzvorlage.
  6. Wählen Sie unter Autoscaling-Modus die Option Kein Autoscaling aus.
  7. Geben Sie unter Anzahl der Instanzen mindestens zwei als Anzahl der Instanzen an, die Sie in der Gruppe erstellen möchten.
  8. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie das gcloud-Befehlszeilentool, um eine verwaltete Instanzgruppe mit der zuvor erstellten Instanzvorlage zu erstellen.

gcloud compute instance-groups managed create td-demo-hello-world-mig \
  --zone us-central1-a \
  --size=2 \
  --template=td-demo-hello-world-template

Instanzvorlage und verwaltete Instanzgruppe erstellen, in der Envoy bereitgestellt wird

Folgen Sie den Anleitungen in diesem Abschnitt, um eine Instanzvorlage und eine verwaltete Instanzgruppe für Traffic Director mit automatisch bereitgestellten Envoy-Proxys zu erstellen. Verwaltete Instanzgruppen erstellen neue Back-End-VMs mithilfe von Autoscaling.

Auf den VMs ausgeführte Softwarekomponenten

Die folgenden Komponenten werden auf Ihren VMs installiert, wenn Sie eine Instanzvorlage mit --service-proxy=enabled erstellen.

  • Der von Traffic Director konfigurierte Envoy-Proxy wird aus einem dedizierten Cloud Storage-Bucket heruntergeladen. Der Bucket enthält Envoy-Proxy-Binärdateien aus offiziellen Istio-Releases.
  • Der Dienst-Proxy-Agent, der den Envoy-Proxy und die Komponenten des Proxys initialisiert. Der Dienst-Proxy-Agent richtet das Abfangen von Traffic ein und überwacht den Status des Envoy-Proxys, wenn eine VM ausgeführt wird. Der Dienst-Proxy-Agent wird ebenfalls aus einem Cloud Storage-Bucket heruntergeladen.

Instanzvorlage erstellen

Eine Instanzvorlage gibt die Konfiguration der VM-Instanzen an, die in einer verwalteten Instanzgruppe erstellt werden. Die Flags, die Sie an die Instanzvorlage übergeben, installieren Envoy und konfigurieren Ihre VM-Instanzen zur Vorbereitung auf Traffic Director.

So erstellen Sie eine solche Instanzvorlage:

  gcloud beta compute instance-templates create td-vm-template-auto \
    --service-proxy=enabled
 

Informationen zum Anpassen Ihrer Envoy-Bereitstellung finden Sie unter Referenzleitfaden für die automatisierte Envoy-Bereitstellung.

Verwaltete Instanzgruppe erstellen

Console

  1. Rufen Sie in der Cloud Console die Seite "Instanzgruppen" auf.

    Zur Seite "Instanzgruppen"

  2. Klicken Sie auf Instanzgruppe erstellen.
  3. Geben Sie td-vm-mig-us-central1 als Name für die verwaltete Instanzgruppe ein und wählen Sie die Zone us-central1-a aus.
  4. Wählen Sie unter Gruppentyp die Option Verwaltete Instanzgruppe aus.
  5. Wählen Sie unter Instanzvorlage die erstellte Vorlage td-vm-template-auto aus.
  6. Geben Sie 2 als Anzahl der Instanzen an, die Sie in der Gruppe erstellen möchten.
  7. Klicken Sie auf Erstellen, um die neue Gruppe anzulegen.

gcloud

Verwenden Sie das gcloud-Befehlszeilentool, um eine verwaltete Instanzgruppe mit der zuvor erstellten Instanzvorlage zu erstellen.

 gcloud compute instance-groups managed create td-vm-mig-us-central1 \
    --zone us-central1-a --size=2 --template=td-vm-template-auto

Traffic Director mit Google Cloud Load Balancing-Komponenten konfigurieren

Die Anleitungen in diesem Abschnitt zeigen, wie Sie Traffic Director so konfigurieren, dass Ihre Envoy-Proxys das Load-Balancing für ausgehenden Traffic zwischen zwei Back-End-Instanzen durchführen. Sie konfigurieren die folgenden Komponenten:

Systemdiagnose erstellen

Führen Sie zum Erstellen einer Systemdiagnose die folgenden Schritte aus. Weitere Informationen finden Sie unter Systemdiagnosen erstellen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite "Systemdiagnosen" auf.
    Zur Seite "Systemdiagnosen"
  2. Klicken Sie auf Systemdiagnose erstellen.
  3. Geben Sie als Name td-vm-health-check ein.
  4. Wählen Sie als Protokoll HTTP aus.
  5. Klicken Sie auf Erstellen.

gcloud

  1. Erstellen Sie die Systemdiagnose.

    gcloud compute health-checks create http td-vm-health-check
    
  2. Erstellen Sie die Firewallregel für die Systemdiagnose.

    gcloud compute firewall-rules create fw-allow-health-checks \
      --action ALLOW \
      --direction INGRESS \
      --source-ranges 35.191.0.0/16,130.211.0.0/22 \
      --target-tags td-http-server \
      --rules tcp:80
    

Back-End-Dienst erstellen

Erstellen Sie den Back-End-Dienst. Wenn Sie das gcloud-Befehlszeilentool verwenden, müssen Sie es als globalen Back-End-Dienst mit dem Load-Balancing-Schema INTERNAL_SELF_MANAGED festlegen. Fügen Sie dem Back-End-Dienst die Systemdiagnose und eine verwaltete oder nicht verwaltete Instanzgruppe hinzu. In diesem Beispiel wird die verwaltete Instanzgruppe mit der Compute Engine-VM-Vorlage verwendet, die den Beispiel-HTTP-Dienst ausführt, der unter Verwaltete Instanzgruppe erstellen erstellt wurde.

Console

  1. Rufen Sie in der Cloud Console die Seite "Traffic Director" auf.

    Zur Seite "Traffic Director"

  2. Klicken Sie auf dem Tab Dienste auf Dienst erstellen.

  3. Klicken Sie auf Weiter.

  4. Geben Sie als Dienstname td-vm-service ein.

  5. Wählen Sie das richtige VPC-Netzwerk aus.

  6. Achten Sie darauf, dass der Back-End-Typ Instanzgruppen ist.

  7. Wählen Sie td-demo-hello-world-mig aus. Dies ist die von Ihnen erstellte verwaltete Instanzgruppe, die die Back-Ends für den Testdienst Hello World enthält.

  8. Geben Sie die richtigen Portnummern ein.

  9. Wählen Sie Auslastung oder Rate als Balancing-Modus aus. Der Standardwert ist Rate.

  10. Klicken Sie auf Fertig.

  11. Wählen Sie die erstellte Systemdiagnose aus oder klicken Sie auf Weitere Systemdiagnose erstellen und wählen Sie als Protokoll HTTP aus.

  12. Legen Sie unter Zeitlimit für Verbindungsausgleich den Wert auf mindestens 30 Sekunden fest.

  13. Klicken Sie auf Weiter.

  14. Klicken Sie auf Erstellen.

gcloud

  1. Erstellen Sie den Back-End-Dienst.

    gcloud compute backend-services create td-vm-service \
     --global \
     --load-balancing-scheme=INTERNAL_SELF_MANAGED \
     --connection-draining-timeout=30s \
     --health-checks td-vm-health-check
    
  2. Fügen Sie dem Back-End-Dienst die Back-Ends hinzu.

    gcloud compute backend-services add-backend td-vm-service \
      --instance-group td-demo-hello-world-mig \
      --instance-group-zone us-central1-a \
      --global
    

Routingregelzuordnung erstellen

Die Routingregelzuordnung definiert, wie Traffic Director den Traffic in Ihrem Mesh-Netzwerk weiterleitet. Im Rahmen der Routingregelzuordnung konfigurieren Sie eine virtuelle IP-Adresse (VIP) und eine Reihe zugehöriger Trafficverwaltungsregeln, z. B. hostbasiertes Routing. Wenn eine Anwendung eine Anfrage an die VIP sendet, führt der Envoy-Proxy folgende Schritte aus:

  1. Fängt die Anfrage ab
  2. Bewertet die Anfrage in Übereinstimmung mit den Trafficverwaltungsregeln in der URL-Zuordnung
  3. Wählt einen Back-End-Dienst anhand des Hostnamens in der Anfrage aus
  4. Wählt ein Back-End oder einen Endpunkt aus, der dem ausgewählten Back-End-Dienst zugeordnet ist
  5. Sendet Traffic an dieses Back-End oder den Endpunkt

Weitere Informationen zur Trafficverwaltung finden Sie unter Erweiterte Trafficverwaltung.

Console

In der Cloud Console wird das Erstellen des Zielproxys mit dem Erstellen von Weiterleitungsregeln kombiniert. Wenn Sie die Weiterleitungsregel erstellen, erstellt Google Cloud automatisch einen Ziel-HTTP-Proxy und verknüpft ihn mit der URL-Zuordnung.

  1. Rufen Sie in der Cloud Console die Seite "Traffic Director" auf.

    Zur Seite "Traffic Director"

  2. Klicken Sie auf dem Tab Routingregelzuordnungen auf Routingregelzuordnung erstellen.

  3. Geben Sie einen Namen ein.

  4. Klicken Sie auf Weiterleitungsregel hinzufügen.

  5. Geben Sie als Name für die Weiterleitungsregel td-vm-forwarding-rule ein.

  6. Wählen Sie das Netzwerk aus.

  7. Wählen Sie Ihre Interne IP-Adresse aus. Der an diese IP-Adresse gesendete Traffic wird vom Envoy-Proxy abgefangen und gemäß den Host- und Pfadregeln an den entsprechenden Dienst gesendet.

    Die Weiterleitungsregel wird als globale Weiterleitungsregel erstellt, wobei load-balancing-scheme auf INTERNAL_SELF_MANAGED gesetzt ist.

  8. Geben Sie im Feld Benutzerdefinierte IP den Wert 10.0.0.1 ein. Wenn Ihre VM Traffic an diese IP-Adresse sendet, wird er vom Envoy-Proxy abgefangen und an den Endpunkt des entsprechenden Back-End-Dienstes gesendet, der in den Trafficverwaltungsregeln der URL-Zuordnung definiert ist.

    Jede Weiterleitungsregel in einem VPC-Netzwerk muss eine eindeutige IP-Adresse und einen eindeutigen Port pro VPC-Netzwerk haben. Wenn Sie mehrere Weiterleitungsregeln mit derselben IP-Adresse und demselben Port in einem bestimmten VPC-Netzwerk erstellen, ist nur die erste Weiterleitungsregel gültig. Andere werden ignoriert. Wenn 10.0.0.1 in Ihrem Netzwerk nicht verfügbar ist, wählen Sie eine andere IP-Adresse aus.

  9. Achten Sie darauf, dass der Port auf 80 festgelegt ist.

  10. Klicken Sie auf Speichern.

  11. Wählen Sie im Abschnitt Routingregeln die Option Einfache Host- und Pfadregel aus.

  12. Wählen Sie im Abschnitt "Host- und Pfadregeln" td-vm-service als Dienst aus.

  13. Klicken Sie auf "Host- und Pfadregel hinzufügen".

  14. Geben Sie im Feld Hosts den Wert hello-world ein.

  15. Wählen Sie unter Dienst die Option td-vm-service aus.

  16. Klicken Sie auf Speichern.

gcloud

  1. Erstellen Sie eine URL-Zuordnung, die den Back-End-Dienst td-vm-service als Standard verwendet.

    gcloud compute url-maps create td-vm-url-map \
       --default-service td-vm-service
    
  2. Erstellen Sie ein Tool zur Abgleichung von Pfaden und eine Hostregel, um den Traffic für Ihren Dienst auf Grundlage des Hostnamens und Pfads weiterzuleiten. In diesem Beispiel werden td-vm-service als Dienstname und ein Standardtool zur Abgleichung von Pfaden verwendet, das mit allen Pfadanfragen für diesen Host (/*) übereinstimmt.

    gcloud compute url-maps add-path-matcher td-vm-url-map \
       --default-service td-vm-service \
       --path-matcher-name td-vm-path-matcher
    
    gcloud compute url-maps add-host-rule td-vm-url-map \
       --path-matcher-name=td-vm-path-matcher \
       --hosts=hello-world
    
  3. Erstellen Sie den Ziel-HTTP-Proxy.

    gcloud compute target-http-proxies create td-vm-proxy \
       --url-map=td-vm-url-map
    
  4. Erstellen Sie die Weiterleitungsregel.

    Die Weiterleitungsregel muss global sein und mit dem Wert load-balancing-scheme auf INTERNAL_SELF_MANAGED erstellt werden.

    gcloud compute forwarding-rules create td-vm-forwarding-rule \
       --global \
       --load-balancing-scheme=INTERNAL_SELF_MANAGED \
       --address=10.0.0.1 \
       --target-http-proxy=td-vm-proxy \
       --ports=80 \
       --network=default
    

Zu diesem Zeitpunkt ist Traffic Director so konfiguriert, dass das Load-Balancing des Traffics für die in der URL-Zuordnung angegebenen Dienste über Back-Ends in der verwalteten Instanzgruppe erfolgt.

Konfiguration prüfen

In diesem letzten Teil des Leitfadens zur Einrichtung von Traffic Director für Compute Engine-VMs testen Sie, dass der von der Client-VM an die Weiterleitungsregel-VIP gesendete Traffic abgefangen und an den Envoy-Proxy weitergeleitet wird, der Ihre Anfrage dann an die VMs weiterleitet, die den Hello World-Dienst hosten.

Dazu melden Sie sich bei der Client-VM an, die so konfiguriert ist, dass sie Traffic abfängt und an Envoy weiterleitet. Sie senden eine curl-Anfrage an die VIP, die mit Ihrer Routingregelzuordnung verknüpft ist. Envoy prüft die curl-Anfrage, bestimmt, zu welchem Dienst sie aufgelöst werden soll, und sendet die Anfrage an ein Back-End, das mit diesem Dienst verknüpft ist.

  1. Rufen Sie in der Cloud Console die Seite "Instanzgruppen" auf.

    Zur Seite "Instanzgruppen"

  2. Wählen Sie die Instanzgruppe td-vm-mig-us-central1 aus.
  3. Klicken Sie im Abschnitt für die VM-Zusammenfassung unter Verbinden auf SSH.
  4. Nachdem Sie sich bei der Client-VM angemeldet haben, senden Sie mit dem curl-Tool eine Anfrage an den Dienst Hello World über Envoy:
curl -H "Host: hello-world" http://10.0.0.1/

Wenn Sie diesen Befehl wiederholt ausführen, werden in der verwalteten Instanzgruppe Hello World unterschiedliche HTML-Antworten mit den Hostnamen der Back-Ends angezeigt. Dies liegt daran, dass Envoy beim Senden von Traffic an die Back-Ends des Dienstes Hello World den Standard-Load-Balancing-Algorithmus "Round Robin" verwendet.

Weitere Informationen

Je nachdem, wie Ihre Mikrodienste in Ihrem Netzwerk verteilt sind, müssen Sie möglicherweise weitere Weiterleitungsregeln oder weitere Host- und Pfadregeln zur URL-Zuordnung hinzufügen. Weitere Informationen zu Weiterleitungsregeln und URL-Zuordnungen finden Sie in den folgenden Dokumenten: