Routenressourcen auflisten

Dieses Dokument richtet sich an Mesh-Administratoren, die die Dienstrouting-APIs verwenden Service Meshes konfigurieren.

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

Wenn Sie der 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. Jede RouteView entspricht einem einzelnen Route. RouteView Objekte werden zusammen mit Route-Objekten erstellt.

Im folgenden Diagramm besteht die RouteView für Gateway A aus dem 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. Ein RouteView für ein Gateway oder Mesh listet Routen auf, die an Gateway oder Mesh angehängt sind, und nicht alle Routen, die mit dem verknüpften 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 anzugeben.

Sie können RouteView Ressourcen nicht 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
  • Für Kunden mit vielen Ressourcen erstellen Sie ein Support-Ticket.
  • 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