Mencantumkan resource `Route`

Dokumen ini ditujukan untuk administrator mesh yang menggunakan API pemilihan rute layanan untuk mengonfigurasi mesh layanan.

Dalam model API pemilihan rute 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 dilampirkan 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 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 di 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, bukan semua rute yang dilampirkan ke cakupan terkait.

Untuk menampilkan daftar resource RouteView, berikan 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, berikan 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 setiap rute untuk mendapatkan ringkasan lengkap tentang Rute yang terpasang.

Anda tidak dapat membuat, memperbarui, atau menghapus resource RouteView. Resource ini 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 di route-views list masing-masing direferensikan dalam kolom meshes atau gateways Rute menggunakan:
    • gcloud network-services [http-routes|grpc-routes|tcp-routes|tls-routes] describe \
    --location global ROUTE_ID
  • Untuk pelanggan yang memiliki 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 selanjutnya