Mencantumkan resource `Route`

Dokumen ini ditujukan bagi administrator mesh yang menggunakan API perutean layanan untuk mengonfigurasi mesh layanan.

Dalam model API perutean layanan, resource Route dilampirkan ke resource Mesh atau Gateway. Dalam konfigurasinya, resource Mesh atau Gateway merujuk satu atau beberapa resource Route.

Jika Anda adalah pemilik resource Mesh atau Gateway, Anda dapat mencantumkan resource Route yang terlampir ke Mesh atau Gateway.

Setiap resource Mesh atau Gateway memiliki kumpulan turunan sintetis dari resource RouteView. Setiap RouteView sesuai dengan satu Route. Objek RouteView dibuat bersama dengan objek Route.

Dalam diagram berikut, RouteView untuk Gateway A terdiri dari resource TCPRoute dari Project A. RouteView untuk Gateway B terdiri dari resource HTTPRoute dari Project B dan resource GRPCRoute dari Project C.

Hubungan antara resource `Route`, `Routeview`, dan `Gateway`.
Hubungan antara resource `Route`, `Routeview`, dan `Gateway`.(klik untuk memperbesar)

Fitur ini dicakup ke tingkat Mesh atau Gateway. RouteView untuk Gateway atau Mesh mencantumkan rute yang dilampirkan ke Gateway atau Mesh tersebut, dan bukan semua rute yang dilampirkan ke cakupan terkait.

Untuk mencantumkan resource RouteView, jalankan perintah berikut:

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

Untuk mendapatkan informasi selengkapnya tentang Rute itu sendiri, jalankan perintah berikut: 

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

Alur kerja umum adalah mencantumkan RouteViews untuk Mesh atau Gateway, lalu mendeskripsikan masing-masing untuk mendapatkan ringkasan lengkap tentang Rute yang terlampir.

Anda tidak dapat membuat, memperbarui, atau menghapus resource RouteView. Objek tersebut dibuat, diperbarui, dan dihapus saat resource Route yang sesuai dibuat, diperbarui, dan dihapus.

Pemecahan masalah

Jika perintah route-views gagal mencantumkan RouteViews untuk rute seperti Listed 0 items. atau tidak mencantumkan semua rute yang diketahui:

  • Pastikan Mesh atau Gateway yang digunakan dalam route-views list dirujuk dalam kolom meshes atau gateways Rute, masing-masing menggunakan:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Untuk pelanggan dengan banyak resource, buat tiket dukungan untuk mendapatkan bantuan.
  • Memicu Pembaruan secara Manual untuk Rute Anda
    • Mengimpor ulang rute
      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
    • Untuk pelanggan yang menggunakan klien NetworkServices yang dihasilkan, panggil NetworkServices.Update*Route API yang sesuai.
    • Ubah deskripsi untuk memicu otomatisasi Terraform.

Langkah berikutnya