Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Deploy a gRPC Service in Knative

Son Güncelleme:Oct 06, 2026

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

  1. ACK konsolu oturumunu açın. Sol gezinme bölmesinde Clusters seçeneğine tıklayın.

  2. Clusters sayfasında, yönetmek istediğiniz kümenin adına tıklayın ve sol gezinme bölmesinden Applications > Knative yolunu izleyin.

  3. 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
  4. 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

  1. grpcbin adresini ziyaret edin ve işletim sisteminize uygun BloomRPC yükleyin.

  2. Aşağıdaki içeriği gRPC.proto dosyası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, Path alanını yukarıdaki yol biçimini kullanarak ayarlayarak gRPC paketlerini yönlendirecek şekilde yapılandırabilirsiniz. Örneğin, grpcbin paketindeki Index yöntemini çağırmak için yol grpcbin.GRPCBin/Index olur.

  3. 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.

    1. gRPC.proto dosyasını BloomRPC'ye aktarın.

    2. 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.

    3. 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.