Routenressourcen auflisten

Dieses Dokument richtet sich an Mesh-Administratoren, die Service-Meshes mithilfe der Service Routing APIs konfigurieren.

Im Dienstrouting-API-Modell sind Route-Ressourcen an Mesh- oder Gateway-Ressourcen angehängt. In der Konfiguration verweist die Mesh- oder Gateway-Ressource auf eine oder mehrere Route-Ressourcen.

Wenn Sie Inhaber einer Mesh- oder Gateway-Ressource sind, können Sie die Route-Ressourcen auflisten, die mit der Mesh- oder Gateway-Ressource verknüpft sind.

Jede Mesh- oder Gateway-Ressource hat eine synthetische untergeordnete Sammlung von RouteView-Ressourcen. Jedem RouteView entspricht ein einzelnes Route. RouteView-Objekte werden zusammen mit Route-Objekten erstellt.

Im folgenden Diagramm besteht die RouteView für Gateway A aus den TCPRoute-Ressourcen aus Projekt A. Die RouteView für Gateway B umfasst die HTTPRoute Ressourcen aus Projekt B und die GRPCRoute Ressourcen aus Projekt C.

Die Beziehungen zwischen den Ressourcen „Route“, „Routeview“ und „Gateway“.
Beziehungen zwischen den Ressourcen „Route“, „Routeview“ und „Gateway“ (zum Vergrößern anklicken)

Diese Funktion ist auf Mesh- oder Gateway-Ebene beschränkt. Eine RouteView für eine Gateway oder Mesh enthält nur die Routen, die mit dieser Gateway oder Mesh verknüpft sind, und nicht alle Routen, die mit dem zugehörigen Bereich verknüpft sind.

Führen Sie den folgenden Befehl aus, um die RouteView-Ressourcen aufzulisten:

gcloud alpha network-services route-views list \
    --location=global \
    --[mesh | gateway]=[ MESH_NAME | GATEWAY_NAME ]

Führen Sie den folgenden Befehl aus, um weitere Informationen zur Route selbst zu erhalten: 

gcloud alpha network-services route-views describe --route-view=ROUTEVIEW_FULLNAME

Ein gängiger Workflow besteht darin, die RouteViews für ein Mesh oder Gateway aufzulisten und dann jeweils eine Beschreibung für einen vollständigen Überblick über die angehängten Routen hinzuzufügen.

Sie können keine RouteView-Ressourcen erstellen, aktualisieren oder löschen. Sie werden erstellt, aktualisiert und gelöscht, wenn die entsprechenden Route-Ressourcen erstellt, aktualisiert und gelöscht werden.

Fehlerbehebung

Wenn die Routenansichten-Befehle keine Routenansichten für Routen wie Listed 0 items. auflisten oder nicht alle bekannten Routen auflisten:

  • Prüfen Sie, ob das in der route-views list verwendete Mesh oder Gateway in den Feldern meshes oder gateways der Route referenziert wird. Verwenden Sie dazu Folgendes:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Wenn du viele Ressourcen hast, erstelle ein Support-Ticket, um Hilfe zu erhalten.
  • Aktualisierung für Ihre Routen manuell auslösen
    • Route noch einmal importieren
      1. gcloud network-services http-routes export my-route --location=global \
      --destination=export.yaml
      2. gcloud network-services http-routes import my-route --location=global \
      --source=export.yaml
    • Kunden, die den generierten NetworkServices-Client verwenden, rufen die entsprechende NetworkServices.Update*Route API auf.
    • Ändern Sie die Beschreibung, um die Terraform-Automatisierung auszulösen.

Nächste Schritte