Anthos Service Mesh と Traffic Director が統合され、Cloud Service Mesh になりました。詳細については、Cloud Service Mesh の概要をご覧ください。

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

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

リソースが多いお客様の場合は、サポートチケットを作成してサポートを利用します。
ルートの更新を手動でトリガーする

ルートの再インポート

gcloud network-services http-routes export my-route --location=global \
      --destination=export.yaml

gcloud network-services http-routes import my-route --location=global \
      --source=export.yaml

生成された NetworkServices クライアントをお客様が使用している場合は、適切な NetworkServices.Update*Route API を呼び出します。
記述を変更して Terraform 自動化をトリガーします。

次のステップ

サービスルーティングの仕組みについては、サービスルーティングの概要をご覧ください。
サービスルーティング API については、ネットワークサービス API のドキュメントをご覧ください。