Route-Ressourcen auflisten

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

Im API-Modell für das Dienstrouting werden Route-Ressourcen an Mesh- oder Gateway-Ressourcen angehängt. In der Konfiguration der Mesh- oder Gateway-Ressource wird auf eine oder mehrere Route-Ressourcen verwiesen.

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. Jeder RouteView entspricht einem 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 enthält die Routen, die diesem Gateway oder Mesh zugeordnet sind, und nicht alle Routen, die dem zugehörigen Bereich zugeordnet 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 zu erhalten: 

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

Ein gängiger Workflow wäre, die RouteViews für ein Mesh oder Gateway aufzulisten und dann jede für einen vollständigen Überblick über die angehängten Routen zu beschreiben.

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

  • Prüfen Sie, ob das im route-views list verwendete Mesh oder Gateway in den Feldern meshes oder 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 Support-Ticket, 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
    • 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