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 der Konfiguration verweist die Mesh- oder Gateway-Ressource auf eine oder mehrere Route-Ressourcen.

Wenn Sie der Eigentümer einer Mesh- oder Gateway-Ressource sind, können Sie die Route auflisten Ressourcen, die an Mesh oder Gateway angehängt 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. 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 abzurufen:

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

Ein gängiger Workflow wäre die Auflistung der RouteViews für ein Mesh-Netzwerk oder Gateway anschließend werden die einzelnen Routen beschrieben, um einen vollständigen Überblick über die angehängten Routen zu erhalten.

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 Befehle „route-views“ keine RouteViews für Routen wie z. B. Listed 0 items. oder es werden nicht alle bekannten Routen aufgelistet:

  • Prüfen Sie, ob das in route-views list verwendete Mesh-Netzwerk oder Gateway auf die in den Feldern meshes oder gateways der Route verwiesen wird, wobei Folgendes verwendet wird:
    • 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.
  • Update für Ihre Route(n) 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