「Route」リソースを一覧表示する

このドキュメントは、サービス ルーティング API を使用してサービス メッシュを構成するメッシュ管理者を対象としています。

サービス ルーティング API モデルでは、Route リソースは Mesh リソースまたは Gateway リソースに接続されます。その構成で、Mesh リソースまたは Gateway リソースは 1 つ以上の Route リソースを参照します。

Mesh リソースまたは Gateway リソースのオーナーの場合は、Mesh または Gateway に接続されている Route リソースを一覧表示できます。

各 Mesh または Gateway リソースには、RouteView リソースの合成子コレクションがあります。各 RouteView は 1 つの Route に対応します。RouteView オブジェクトは Route オブジェクトとともに作成されます。

次の図では、Gateway A の RouteView は、プロジェクト A の TCPRoute リソースで構成されています。Gateway B の RouteView は、プロジェクト B の HTTPRoute リソースとプロジェクト C の GRPCRoute リソースで構成されます。

「Route」、「Routeview」、「Gateway」リソース間の関係。
「Route」、「Routeview」、「Gateway」リソース間の関係（クリックして拡大）

この機能のスコープは Mesh レベルまたは Gateway レベルです。Gateway または Mesh の RouteView は、その Gateway または Mesh に接続されているルートの一覧を表示します。関連付けられたスコープに接続されているすべてのルートは表示されません。

RouteView リソースを一覧表示するには、次のコマンドを実行します。

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

ルート自体の詳細情報を取得するには、次のコマンドを実行します。

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

一般的なワークフローとしては、Mesh または Gateway の RouteViews を一覧表示し、それぞれに接続されたルートの概要を確認できます。

RouteView リソースを作成、更新、削除することはできません。対応する Route リソースが作成、更新、削除されると、それらのリソースも作成、更新、削除されます。

トラブルシューティング

route-views コマンドで Listed 0 items. などのルートの RouteViews が一覧表示されない、または既知のルートのすべてが一覧表示されない場合は、次のことを確認します。

  • route-views list で使用される Mesh または Gateway がそれぞれ、Route の meshes フィールドまたは gateways フィールドで参照されていることを確認します。
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • リソースが多いお客様の場合は、サポート チケットを作成してサポートを利用します。
  • ルートの更新を手動でトリガーする
    • ルートの再インポート
      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
    • 生成された NetworkServices クライアントを使用している場合は、適切な NetworkServices.Update*Route API を呼び出します。
    • Terraform 自動化をトリガーするように説明を変更しました。

次のステップ