Referensi Cloud Service Mesh GKE API

Dokumen ini adalah referensi API untuk Cloud Service Mesh dengan Gateway Kubernetes Compute Engine API.

TDMesh

Kolom Deskripsi
apiVersion string
net.gke.io/v1alpha1
kind string
TDMesh
metadata Kubernetes ObjectMeta
spec MeshSpec
status MeshStatus

MeshSpec

Kolom Deskripsi
allowedRoutes gateway.networking.k8s.io/v1.AllowedRoutes
gatewayClassName string
gke-td

MeshStatus

Kolom Deskripsi
conditions Kolom kondisi menjelaskan kondisi Mesh saat ini.
Jenis kondisi yang diketahui:
  • Dijadwalkan
  • Siap
Untuk informasi selengkapnya, baca Kubernetes meta/v1.23Condition.

GatewayClass

Lihat dokumentasi referensi untuk GatewayClass.

TDGRPCRoute

TDGRPCRoute menentukan perilaku pemilihan rute permintaan gRPC dari TDMesh atau Pemroses Gateway ke objek API, misalnya, Service.

Kolom Deskripsi
apiVersion string
net.gke.io/v1alpha1
kind string
TDGRPCRoute
metadata metav1.23ObjectMeta
spec GRPCRouteSpec
Menentukan status yang disukai untuk `GRPCRoute.`
Status GRPCRouteStatus
Sama seperti HTTPRouteStatus.

GRPCRouteSpec

Spesifikasi TDGRPCRoute terdiri dari nilai-nilai berikut tabel:

Kolom Deskripsi
CommonRouteSpec CommonRouteSpec
Hostnames []Nama host
Nama host menentukan kumpulan nama host yang harus cocok dengan header Host gRPC untuk memilih GRPCRoute untuk memproses permintaan.

Hostname adalah nama domain {i>host<i} jaringan yang sepenuhnya memenuhi syarat, seperti yang didefinisikan oleh RFC 3986. Perhatikan penyimpangan berikut dari "host" dari URI seperti yang didefinisikan dalam RFC:
  • Alamat IP tidak diizinkan.
  • Pembatas `:` tidak dipatuhi karena port tidak diizinkan.
Permintaan masuk dicocokkan dengan nama host sebelum TDGRPCRoute aturan. Jika tidak ada nama host yang ditentukan, traffic akan dirutekan berdasarkan GRPCRouteRules.

Hostname dapat menjadi "tepat" yang merupakan nama domain tanpa awalan menghentikan

titik dari host jaringan (misalnya, butterfly.example.com) atau wildcard, yang merupakan nama domain yang diawali dengan satu karakter pengganti label, misalnya, `*.example.com`. Karakter pengganti `*` harus muncul dengan sendirinya sebagai label DNS pertama dan hanya cocok dengan satu label label. Anda tidak dapat memiliki label karakter pengganti sendiri (misalnya, Host == "*"). Permintaan dicocokkan dengan kolom `Host` di urutan berikut:
  • Jika Host tepat, permintaan akan cocok dengan aturan ini jika host gRPC header sama dengan Host.
  • Jika Host adalah karakter pengganti, permintaan akan cocok dengan aturan ini jika host gRPC header harus sama dengan akhiran (menghapus label pertama) karakter pengganti aturan.
Rules []GRPCRouteRule
Menentukan daftar matcher, filter, dan tindakan gRPC.

GRPCRouteRule

Aturan menentukan semantik untuk mencocokkan permintaan gRPC berdasarkan kondisi, dan secara opsional meneruskan permintaan ke objek API. Aturan terdiri dari berikut ini:

Kolom Deskripsi
Matches GRPCRouteMatch
Menentukan kondisi yang digunakan untuk mencocokkan permintaan gRPC. Setiap kecocokan bersifat independen. Dengan kata lain, aturan ini akan cocok jika ada satu kecocokan terpenuhi.
BackendRefs []GRPCBackendRef

Menentukan backend tempat permintaan yang cocok akan dikirim. Jika tidak ditentukan atau tidak valid (mengacu pada resource yang tidak ada atau Layanan tanpa endpoint), aturan tidak melakukan penerusan.

GRPCBackendRef sama dengan HTTPBackendRef.
GRPCRouteMatch

Aturan menentukan semantik untuk mencocokkan permintaan gRPC berdasarkan kondisi, dan secara opsional meneruskan permintaan ke objek API. Aturan didefinisikan sebagai berikut ini:


Kolom
Deskripsi
Metode GRPCMethodMatch

Menentukan metode gRPC yang akan dicocokkan.
Header []GRPCHeaderMatch
Menentukan matcher header permintaan gRPC. Beberapa nilai kecocokan digabungkan dengan operasi AND, artinya permintaan harus cocok dengan semua untuk memilih rute.
Catatan: Definisi GRPCHeaderMatch sama dengan `HTTPHeaderMatch`.
GRPCMethodMatch

GRPCMethodMatch terdiri dari hal berikut:

Kolom Deskripsi
Jenis MethodMatchType

Mendefinisikan jenis yang menetapkan cara mencocokkan nama. Jika tidak ditentukan, nilai default EXACT akan digunakan. Anda dapat pilih EXACT atau RegularExpression.
Layanan string

Menentukan nama layanan yang akan dicocokkan. Jika tidak ditentukan, akan cocok dengan semua layanan.
Metode string

Mendefinisikan metode yang akan dicocokkan. Jika tidak ditentukan, ID akan cocok semua metode.
GRPCHeaderMatch

GRPCHeaderMatch terdiri dari hal berikut:

Kolom Deskripsi
Jenis HeaderMatchType

Menentukan cara mencocokkan dengan nilai header.
Nama String

Name adalah nama header gRPC yang akan dicocokkan. Pencocokan nama harus tidak peka huruf besar/kecil. (Lihat https://tools.ietf.org/html/rfc7230#section-3.2).
Nilai String

Nilai adalah nilai header HTTP yang akan dicocokkan.
GRPCBackendRef
Kolom Deskripsi
BackendRef BackendRef

`BackendRef` adalah referensi ke backend untuk meneruskan permintaan yang cocok tempat mesin terhubung.

HTTPRoute

Lihat referensi Gateway API open source untuk HTTPRoute.

TCPRoute

Lihat referensi Gateway API open source untuk TCPRoute.