Knative Hizmetiniz dağıtık bir sistem veya mikro hizmetler mimarisi kullanıyorsa, istemci ile sunucu arasındaki iletişim verimliliğini artırmak için gRPC protokolünü kullanabilirsiniz. ACK Knative hem HTTP hem de HTTP/2 protokollerini (gRPC dahil) destekler.
Ön Koşullar
Knative kümenizde dağıtılmıştır. Daha fazla bilgi için bkz. Knative bileşenlerini dağıtma ve yönetme.
1. Adım: gRPC Hizmetini Dağıtın
ACK konsolu oturumunu açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.
Clusters sayfasında, yönetmek istediğiniz kümenin adına tıklayın ve sol gezinme bölmesinden yolunu izleyin.
-
Knative sayfasında Services sekmesine tıklayın. Namespace değerini default olarak ayarlayın, Create from Template seçeneğine tıklayın ve ardından Sample Template açılır listesinden Custom seçeneğini belirleyin. Aşağıdaki içeriği şablon düzenleyicisine kopyalayın ve helloworld-grpc adlı bir Knative Hizmeti oluşturmak için Create seçeneğine tıklayın.
apiVersion: serving.knative.dev/v1 kind: Service metadata: name: helloworld-grpc spec: template: metadata: annotations: autoscaling.knative.dev/class: mpa.autoscaling.knative.dev spec: containers: - image: docker.io/moul/grpcbin # The image contains a tool that is used to test gRPC by providing a gRPC Service to respond to requests. env: - name: TARGET value: "Knative" ports: - containerPort: 9000 name: h2c # Set the name of the gRPC Service in the Knative port section to h2c. protocol: TCP -
Hosts dosyasına bir eşleme ekleyin. Hizmetler sekmesindeki Gateway sütunundaki ağ geçidi adresini, Default Domain sütunundaki varsayılan alan adı ile eşleştirin.
Makinenizdeki Hosts dosyasını bulun ve dosyaya bir eşleme ekleyin. Eşleme Ağ geçidi adresi + Boşluk karakteri + Varsayılan alan adı biçiminde olmalıdır. Ardından gRPC hizmetine erişmek için varsayılan alan adını kullanın.
Örnek:
121.xx.xxx.xx helloworld-grpc.default.example.com
2. Adım: gRPC Hizmetinin Kullanılabilirliğini Doğrulayın
grpcbin adresini ziyaret edin ve işletim sisteminize uygun BloomRPC yükleyin.
-
Aşağıdaki içeriği
gRPC.protodosyasına kopyalayın ve dosyayı yerel makinenize kaydedin:syntax = "proto3"; package grpcbin; service GRPCBin { rpc Index(EmptyMessage) returns (IndexReply) {} // Define an RPC method that takes an empty message as the input and returns an empty message as the output. rpc Empty(EmptyMessage) returns (EmptyMessage) {} // Define an RPC method that takes a dummy message as the input and returns a dummy message as the output. rpc DummyUnary(DummyMessage) returns (DummyMessage) {} // Define an RPC method that takes a dummy message as the input and returns a stream of dummy messages (10 messages) as the output. rpc DummyServerStream(DummyMessage) returns (stream DummyMessage) {} // Define an RPC method that takes a stream of dummy messages (10 messages) as the input and returns a dummy message as the output. rpc DummyClientStream(stream DummyMessage) returns (DummyMessage) {} // Define an RPC method that takes a stream of dummy messages as the input and returns a stream of dummy messages as the output. rpc DummyBidirectionalStreamStream(stream DummyMessage) returns (stream DummyMessage) {} // Define an RPC method that returns a message of the specified gRPC error. rpc SpecificError(SpecificErrorRequest) returns (EmptyMessage) {} // Define an RPC method that returns a message of a random error. rpc RandomError(EmptyMessage) returns (EmptyMessage) {} // Define an RPC method that returns a header. rpc HeadersUnary(EmptyMessage) returns (HeadersMessage) {} // Define an RPC method that does not return any messages. rpc NoResponseUnary(EmptyMessage) returns (EmptyMessage) {} } message HeadersMessage { message Values { repeated string values = 1; } map<string, Values> Metadata = 1; } message SpecificErrorRequest { uint32 code = 1; string reason = 2; } message EmptyMessage {} message DummyMessage { message Sub { string f_string = 1; } enum Enum { ENUM_0 = 0; ENUM_1 = 1; ENUM_2 = 2; } string f_string = 1; repeated string f_strings = 2; int32 f_int32 = 3; repeated int32 f_int32s = 4; Enum f_enum = 5; repeated Enum f_enums = 6; Sub f_sub = 7; repeated Sub f_subs = 8; bool f_bool = 9; repeated bool f_bools = 10; int64 f_int64 = 11; repeated int64 f_int64s= 12; bytes f_bytes = 13; repeated bytes f_bytess = 14; float f_float = 15; repeated float f_floats = 16; } message IndexReply { message Endpoint { string path = 1; string description = 2; } string description = 1; repeated Endpoint endpoints = 2; }gRPC hizmeti HTTP/2 kullanır. gRPC hizmetinin yolu
{Paket adı}.{Hizmet adı}/{Yöntem adı}şeklindedir. Knative ağ geçidini,Pathalanını yukarıdaki yol biçimini kullanarak ayarlayarak gRPC paketlerini yönlendirecek şekilde yapılandırabilirsiniz. Örneğin,grpcbinpaketindekiIndexyöntemini çağırmak için yolgrpcbin.GRPCBin/Indexolur. -
gRPC hizmetinin kullanılabilirliğini doğrulamak için BloomRPC aracını kullanın. Sunucu yanıtları normal şekilde döndürüyorsa gRPC hizmeti kullanılabilir durumdadır.
gRPC.protodosyasını BloomRPC'ye aktarın.Sol gezinme bölmesinde DummyUnary yöntemine tıklayın ve sayfanın üst kısmındaki
Alan adı:Bağlantı noktasıbölümünü belirtin. Örnek:helloworld-grpc.default.example.com:80.Yeşil düğmeye tıklayın ve sunucudan dönen yanıtların normal olup olmadığını kontrol edin.
İlgili Başlıklar
Özel bir alan adı üzerinden HTTPS kullanarak hizmetlere erişmek için sertifika yapılandırabilirsiniz. Daha fazla bilgi için bkz. HTTPS erişimini yapılandırma.