Internen Load Balancer registrieren

Auf dieser Seite finden Sie Informationen zum Konfigurieren eines internen Passthrough-Network Load Balancers oder eines internen Application Load Balancers (Vorschau), damit er automatisch in Service Directory registriert wird.

Wenn Sie den Load Balancer erstellen, können Sie ihn als Endpunkt in einem vorhandenen Service Directory-Namespace und -Dienst Ihrer Wahl registrieren. Clientanwendungen können dann Service Directory (mit HTTP oder gRPC) und/oder DNS verwenden (wenn Sie eine Service Directory-DNS-Zone erstellt haben), um die Adresse des internen Load-Balancer-Dienstes aufzulösen und direkt eine Verbindung herzustellen.

Beschränkungen

Die Service Directory-Integration in das interne Load-Balancing unterliegt den folgenden Einschränkungen:

• Die automatische Registrierung gilt nur für interne und Network Load Balancer. Sie können Google Kubernetes Engine-Load-Balancing-Dienste über die GKE-Integration registrieren. Sie können globale Load Balancer sowie Ingresses und Gateways von Google Kubernetes Engine registrieren, indem Sie die Service Directory API aufrufen.
• Sie können die automatische Registrierung nur beim Erstellen einer Weiterleitungsregel verwenden. Die automatische Registrierung über die Google Cloud CLI-Aktualisierung für eine bereits vorhandene Weiterleitungsregel ist nicht verfügbar.
• Sie können interne Load Balancer in den Host- oder Dienstprojekten einer Einrichtung mit freigegebenem VPC-Netzwerk bei Service Directory registrieren. Alle Load-Balancing-Komponenten und Back-Ends müssen sich jedoch im selben Projekt befinden. Weitere Informationen finden Sie unter Einschränkungen beim internen Load-Balancing.
• Service Directory bietet keine Konnektivität. Das bedeutet, dass die virtuelle IP-Adresse des internen Load-Balancers zwar in Service Directory gespeichert wird, das Nachschlagen des internen Load-Balancers in Service Directory aber nicht garantiert, dass Sie eine Verbindung zur virtuellen IP-Adresse herstellen können.

Hinweise

Für diese Anleitung ist Folgendes erforderlich:

• Sie müssen bereits einen Service Directory-Namespace und -Dienst eingerichtet haben. Falls nicht, erstellen Sie einen Namespace und einen Dienst gemäß der Anleitung unter Service Directory konfigurieren.

  Der Service Directory-Namespace und ‑Dienst müssen sich im selben Projekt und in derselben Region wie die interne Weiterleitungsregel des Load-Balancers befinden, die Sie erstellen.

• Sie müssen die erforderlichen Ressourcen bereits eingerichtet haben, um eine Weiterleitungsregel für einen internen Load-Balancer zu erstellen.

  • Informationen zum Erstellen eines internen Passthrough-Network Load Balancers finden Sie unter Internen Passthrough-Network Load Balancer einrichten.
  • Informationen zum Erstellen eines internen Application Load Balancers finden Sie unter Internen Application Load Balancer einrichten.

Weiterleitungsregeln einrichten, um einen internen Load-Balancer in Service Directory zu registrieren

Sie müssen eine Weiterleitungsregel einrichten, um den internen Load-Balancer in Service Directory zu registrieren. Informationen zum Registrieren eines internen Passthrough-Network-Load-Balancers oder eines internen Application Load Balancers finden Sie in den folgenden Abschnitten.

Internen Passthrough-Network Load Balancer registrieren

Führen Sie zum Registrieren eines internen Passthrough-Network-Load-Balancers den Befehl gcloud compute forwarding-rules create aus und legen Sie das Flag service-directory-registration fest:

gcloud compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=INTERNAL \
    --network=NETWORK_NAME \
    --subnet=SUBNET_NAME \
    --address=RESERVED_IP_ADDRESS \
    --ip-protocol=PROTOCOL_TYPE \
    --ports=PORT_NUMBER \
    --backend-service=BACKEND_SERVICE_NAME \
    --backend-service-region=REGION \
    --service-directory-registration=SD_SERVICE_NAME

Ersetzen Sie Folgendes:

• FORWARDING_RULE_NAME: ein Name für die Weiterleitungsregel, die Sie erstellen möchten
• REGION: ist die Region, in der die Weiterleitungsregel erstellt werden soll.
• NETWORK_NAME: das Netzwerk, für das diese Weiterleitungsregel gilt.
• SUBNET_NAME: ist das Teilnetz, für das diese Weiterleitungsregel gilt.
• RESERVED_IP_ADDRESS: ist die IP-Adresse, für die die Weiterleitungsregel gilt.
• PROTOCOL_TYPE: ist das IP-Protokoll, das von der Regel bereitgestellt wird.
• PORT_NUMBER: ist eine Liste durch Kommas getrennter Ports.
• BACKEND_SERVICE_NAME: ist der Ziel-Back-End-Dienst, der den Traffic empfängt.
• SD_SERVICE_NAME: der vollständig qualifizierte Name des Service Directory-Dienstes, in dem Sie den Endpunkt registrieren möchten. Sie muss sich in demselben Projekt und in derselben Region befinden wie die erstellte Weiterleitungsregel. Beispiel: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Internen Application Load Balancer registrieren

Führen Sie den Befehl gcloud compute forwarding-rules create aus und legen Sie das Flag service-directory-registration fest, um einen regionalen internen Application Load Balancer zu registrieren:

gcloud beta compute forwarding-rules create FORWARDING_RULE_NAME \
    --region=REGION \
    --load-balancing-scheme=INTERNAL_MANAGED \
    --network=NETWORK_NAME \
    --address=RESERVED_IP_ADDRESS \
    --target-https-proxy=PROXY_NAME \
    --target-https-proxy-region=PROXY_REGION \
    --ports=PORT_NUMBER \
    --service-directory-registration=SD_SERVICE_NAME

Ersetzen Sie Folgendes:

• FORWARDING_RULE_NAME: ein Name für die Weiterleitungsregel, die Sie erstellen möchten
• REGION: ist die Region, in der die Weiterleitungsregel erstellt werden soll.
• NETWORK_NAME: ist das Netzwerk, für das diese Weiterleitungsregel gilt.
• RESERVED_IP_ADDRESS: ist die IP-Adresse, für die die Weiterleitungsregel gilt.
• PROXY_NAME: der Zielproxy, der den Traffic empfängt.
• PROXY_REGION: die Region des Proxys, in der der Vorgang ausgeführt werden soll.
• PORT_NUMBER: ist eine Liste durch Kommas getrennter Ports.
• SD_SERVICE_NAME: der vollständig qualifizierte Name des Service Directory-Dienstes, in dem Sie den Endpunkt registrieren möchten. Dieser Dienst muss sich im selben Projekt und in derselben Region wie die zu erstellende Weiterleitungsregel befinden. Beispiel: projects/PROJECT/locations/REGION/namespaces/NAMESPACE_NAME/services/SERVICE_NAME.

Endpunkt prüfen

Ein oder mehrere Service Directory-Endpunkte, die beim Registrieren eines internen Load-Balancers erstellt werden, haben die folgenden Eigenschaften:

• Der Endpunkt hat denselben Namen wie die Weiterleitungsregel mit der angegebenen Portnummer (<forwarding rule name>-<port>). Wenn Sie beispielsweise eine Weiterleitungsregel RULE mit --port=8080 erstellen, erhalten Sie einen Endpunkt namens RULE-8080. Wenn Sie für dieselbe Regel zwei Ports (--port=8080, 8081) angegeben haben, erhalten Sie zwei Endpunkte: RULE-8080 und RULE-8081. Wenn Sie --port=ALL angeben, wird der Service Directory-Endpunkt mit Port 0 registriert. Wenn Sie der Inhaber des internen Load-Balancers sind, müssen Sie dafür sorgen, dass der API-Aufrufer weiß, mit welchem Port er sich verbinden muss.
• Sie können den Endpunkt nicht mit der öffentlichen Service Directory API ändern oder löschen. Der Endpunkt wird nur automatisch gelöscht, wenn Sie die Weiterleitungsregel löschen. Das bedeutet, dass Sie den Dienst und den Namespace, in dem sich der Endpunkt befindet, nicht löschen können, solange die Weiterleitungsregel vorhanden ist.
• Der Endpunkt selbst wird nicht in Rechnung gestellt. Für API-Aufrufe an den Endpunkt gelten jedoch die normalen Preisdetails.

Um zu bestätigen, dass der Endpunkt erstellt wurde, lösen Sie den Dienst in Service Directory auf. Es sollte ein Endpunkt mit demselben Namen wie der Name der Weiterleitungsregel mit der angegebenen Portnummer angezeigt werden.

So lösen Sie den Dienst in Service Directory auf:

gcloud service-directory services resolve SD_SERVICE_NAME \
    --namespace=SD_NAMESPACE_NAME \
    --location=REGION

Optional: Service Directory-Zone mit Cloud DNS erstellen

Sie können Service Directory-Endpunkte, die über diese Integration registriert wurden, wie jeden anderen Service Directory-Endpunkt über DNS auflösen. Informationen zum Erstellen einer Service Directory-Zone mit Cloud DNS finden Sie unter Service Directory-Zone konfigurieren.

Sie können eine DNS-Abfrage Ihrer Service Directory-Zone ausführen, um zu prüfen, ob Ihre Zone richtig eingerichtet ist. Eine Anleitung zum Abfragen mit DNS finden Sie unter Abfragen mit DNS. Wenn Ihre Zone richtig konfiguriert ist, sollte in der Befehlsausgabe die IP-Adresse Ihres internen Load Balancers angezeigt werden.

Bereinigen

So löschen Sie die von Ihnen erstellten Ressourcen:

Nächste Schritte

• Eine Übersicht über Service Directory finden Sie in der Übersicht zu Service Directory.
• Informationen zu Lösungen für häufige Probleme, die bei der Verwendung von Service Directory auftreten können, finden Sie unter Fehlerbehebung.