`Route` 리소스 나열

이 문서는 서비스 라우팅 API를 사용하여 서비스 메시를 구성하는 메시 관리자를 대상으로 작성되었습니다.

서비스 라우팅 API 모델에서 Route 리소스는 Mesh 또는 Gateway 리소스에 연결됩니다. 해당 구성에서 Mesh 또는 Gateway 리소스는 하나 이상의 Route 리소스를 참조합니다.

Mesh 또는 Gateway 리소스 소유자는 Mesh 또는 Gateway에 연결된 Route 리소스를 나열할 수 있습니다.

각 Mesh 또는 Gateway 리소스에는 RouteView 리소스의 합성 하위 컬렉션이 있습니다. 각 RouteView는 단일 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에 사용된 메시 또는 게이트웨이가 경로의 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 자동화를 트리거하도록 설명을 수정합니다.

다음 단계