Route-Ressourcen auflisten

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

Im Dienstrouting-API-Modell werden 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 an die Mesh- oder Gateway-Ressource angehängt sind.

Jede Mesh- oder Gateway-Ressource hat eine synthetische untergeordnete Sammlung von RouteView-Ressourcen. Jede RouteView entspricht einer einzelnen 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“.
Die Beziehungen zwischen den Ressourcen `Route`, `Routeview` und `Gateway` (zum Vergrößern klicken)

Diese Funktion ist auf die Ebene Mesh oder Gateway beschränkt. Eine RouteView für ein Gateway oder Mesh listet Routen auf, die an dieses Gateway oder Mesh angehängt sind, und nicht alle Routen, die an den zugehörigen Bereich angehängt sind.

Geben 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 ]

Geben 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 häufiger Workflow besteht darin, die RouteViews für ein Mesh oder Gateway aufzulisten und dann jede zu beschreiben, um einen vollständigen Überblick über die angehängten Routen zu erhalten.

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 mit den Befehlen für Routenansichten keine Routenansichten für Routen wie Listed 0 items. aufgelistet werden oder nicht alle bekannten Routen aufgeführt werden:

  • Prüfen Sie, ob das Mesh oder Gateway, das in der route-views list verwendet wird, in den Feldern meshes bzw. gateways der Route referenziert wird. Verwenden Sie dazu:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Wenn Sie viele Ressourcen haben, erstellen Sie ein Supportticket, um Unterstützung zu erhalten.
  • Update für Ihre Route(n) manuell auslösen
    • Route neu 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
    • Wenn Sie den generierten NetworkServices-Client verwenden, rufen Sie die entsprechende NetworkServices.Update*Route API auf.
    • Ändern Sie die Beschreibung, um die Terraform-Automatisierung auszulösen.

Nächste Schritte