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

このドキュメントは、サービス ルーティング 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

一般的なワークフローは、メッシュまたはゲートウェイの 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 自動化をトリガーします。

次のステップ