Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Configure Nginx Ingress for gRPC

Son Güncelleme:Oct 09, 2026

ACK kümelerine dağıtılan gRPC uygulamaları için Nginx Ingress'i yapılandırın ve gRPC trafiğini yönlendirerek harici istemci erişimini etkinleştirmek üzere nginx.ingress.kubernetes.io/backend-protocol: "GRPC" ek açıklamasını (annotation) ekleyin.

Ön Koşullar

Aşağıdakilerin hazır olduğundan emin olun:

  • NGINX Ingress Controller yüklü bir ACK kümesi

  • kubectl kümeye bağlı.

  • gRPC trafiği için bir alan adı (örneğin, grpc.example.com)

  • Bu alan adı için bir TLS sertifikası (CA onaylı veya test amaçlı kendi imzaladığınız)

Nasıl Çalışır?

Bir istemci Ingress uç noktasına bir gRPC isteği gönderdiğinde NGINX şunları yapar:

  1. TLS'yi sonlandırır ve trafiğin şifresini çözer.

  2. Şifresi çözülmüş gRPC trafiğini (HTTP/2 üzerinden) 50051 bağlantı noktasındaki arka plan pod'a iletir.

  3. gRPC yanıtını istemciye döndürür.

backend-protocol: "GRPC" ek açıklaması, Ingress denetleyicisine trafiği HTTP yerine gRPC olarak proxy etmesini söyler:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: grpc-ingress
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: "GRPC"  # Proxy traffic as gRPC (HTTP/2)
spec:
  tls:
  - hosts:
    - grpc.example.com          # Replace with your domain
    secretName: nginx-ingress-tls
  rules:
  - host: grpc.example.com      # Replace with your domain
  # ...

1. Adım: Örnek bir gRPC uygulaması dağıtın

Konsol

  1. Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde, Workloads > Deployments seçeneğine tıklayın.

  2. Deployments sayfasında, Create from YAML seçeneğine tıklayın. Aşağıdaki YAML kodunu yapıştırın ve Create seçeneğine tıklayın.

    Örnek uygulama YAML dosyası

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: grpc-service
    spec:
      replicas: 1
      selector:
        matchLabels:
          run: grpc-service
      template:
        metadata:
          labels:
            run: grpc-service
        spec:
          containers:
          - image: registry.cn-hangzhou.aliyuncs.com/acs-sample/grpc-server:latest
            imagePullPolicy: Always
            name: grpc-service
            ports:
            - containerPort: 50051
              protocol: TCP
          restartPolicy: Always
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: grpc-service
    spec:
      ports:
      - port: 50051
        protocol: TCP
        targetPort: 50051
      selector:
        run: grpc-service
      sessionAffinity: None
      type: NodePort
  3. İletişim kutusunda, View seçeneğine tıklayın ve Pod'un durumunun Running olduğunu doğrulayın.

kubectl

  1. grpc.yaml dosyasını oluşturun:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: grpc-service
    spec:
      replicas: 1
      selector:
        matchLabels:
          run: grpc-service
      template:
        metadata:
          labels:
            run: grpc-service
        spec:
          containers:
          - image: registry.cn-hangzhou.aliyuncs.com/acs-sample/grpc-server:latest
            imagePullPolicy: Always
            name: grpc-service
            ports:
            - containerPort: 50051
              protocol: TCP
          restartPolicy: Always
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: grpc-service
    spec:
      ports:
      - port: 50051
        protocol: TCP
        targetPort: 50051
      selector:
        run: grpc-service
      type: NodePort
  2. Uygulamayı dağıtın:

    kubectl apply -f grpc.yaml

Örnek uygulama, tek bir tekil RPC olan SayHello ile bir Greeter hizmetini açığa çıkarır:

gRPC örnek uygulama arayüz tanımı

package helloworld;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

Bkz. gRPC hizmet örnekleri.

2. Adım: TLS Sertifikasını Secret Olarak Saklayın

Nginx Ingress, gRPC'nin bağımlı olduğu HTTP/2'yi etkinleştirmek için TLS gerektirir. Ingress denetleyicisinin kullanması için TLS sertifikanızı ve özel anahtarınızı bir Kubernetes Secret içinde saklayın.

  1. Alan adınız için bir TLS sertifikası edinin:

  2. Sertifikayı ve özel anahtarı saklamak için nginx-ingress-tls adlı bir Secret oluşturun.

    Konsol

    1. ACK konsoluna giriş yapın. Sol gezinme bölmesinde, Clusters seçeneğine tıklayın.

    2. Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde, Configurations > Secrets seçeneğine tıklayın.

    3. Secrets sayfasında, default ad alanını seçin ve Create seçeneğine tıklayın. Secret'ı yapılandırın ve OK seçeneğine tıklayın.


      Name


      nginx-ingress-tls


      Type


      Ingress TLS Certificate

      + Add altında, sertifikayı ve özel anahtarı girin:

      • Certificates: Sertifika dosyasının tam içeriği (.crt veya .pem).

      • Key: Özel anahtar dosyasının tam içeriği (.key).

    kubectl

    PUBLIC_CERT ve PRIVATE_KEY değerlerini sertifika ve anahtar dosya yollarınızla değiştirin:

    # --cert: certificate file (.crt or .pem)
    # --key:  private key file (.key)
    kubectl create secret tls nginx-ingress-tls --cert PUBLIC_CERT --key PRIVATE_KEY

3. Adım: Hizmeti Açığa Çıkarmak İçin Ingress'i Yapılandırın

  1. ACK konsoluna giriş yapın ve küme adına tıklayın. Sol gezinme bölmesinde, Add-ons seçeneğini belirleyin.

  2. NGINX Ingress Controller'ı arayın ve Install veya Upgrade seçeneğine tıklayın.

    Not: v1.2'den önceki sürümler artık bakılmamaktadır. En son sürüme yükseltin.
  3. gRPC trafiğini arka plan hizmetine yönlendirmek için Ingress'i yapılandırın.

    Konsol

    1. Sol gezinme bölmesinde, Network > Ingresses seçeneğini belirleyin. default ad alanını seçin ve Create Ingress seçeneğine tıklayın.

    2. Ingress'i aşağıdaki gibi yapılandırın, ardından OK seçeneğine tıklayın:


      Gateway Type


      Nginx Ingress


      Name


      grpc-ingress


      Domain Name


      grpc.example.com

      Mappings altında şunları ayarlayın:


      Mappings


      /


      Match Rule


      Prefix (Prefix-based match)


      Service


      grpc-service


      Port


      50051

      TLS settings altında seçeneği etkinleştirin ve şunları ayarlayın:


      Domain Name


      grpc.example.com


      Secrets


      nginx-ingress-tls

      Annotations altında şunu ekleyin:


      nginx.ingress.kubernetes.io/backend-protocol


      GRPC

    3. Ingresses sayfasında, yeni Ingress'in Endpoint adresini not edin.

      Ingress'in etkinleşmesi yaklaşık 10 saniye sürer. Yeniledikten sonra herhangi bir uç nokta görünmüyorsa, sorunları gidermek için Events sekmesini kontrol edin. troubleshoot issues .

    kubectl

    1. grpc-ingress.yaml dosyasını oluşturun:

      apiVersion: networking.k8s.io/v1
      kind: Ingress
      metadata:
        name: grpc-ingress
        annotations:
          # Proxy traffic as gRPC (HTTP/2) to the backend
          nginx.ingress.kubernetes.io/backend-protocol: "GRPC"
      spec:
        ingressClassName: nginx
        tls:
        - hosts:
          - grpc.example.com             # Replace with your domain
          secretName: nginx-ingress-tls  # The Secret created in the previous step
        rules:
        - host: grpc.example.com         # Replace with your domain
          http:
            paths:
            - path: /
              pathType: Prefix
              backend:
                service:
                  name: grpc-service
                  port:
                    number: 50051
    2. Ingress'i uygulayın:

      kubectl apply -f grpc-ingress.yaml
    3. Endpoint adresini alın. Herhangi bir adres döndürülmezse 10 saniye bekleyip tekrar deneyin:

      ADDRESS=$(kubectl get ingress grpc-ingress -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
      echo $ADDRESS

4. Adım: Kurulumu Doğrulayın

  1. Ingress IP'sini hosts dosyanıza ekleyin. ADDRESS değerini gerçek IP ile değiştirin:

    • macOS/Linux: sudo vi /etc/hosts komutuyla /etc/hosts dosyasını düzenleyin

    • Windows: Not Defteri'ni yönetici olarak çalıştırarak C:\Windows\System32\drivers\etc\hosts dosyasını açın

    ADDRESS grpc.example.com
  2. grpcurl'u yükleyin, ardından SayHello yöntemini çağırın:

    grpcurl -d '{"name": "gRPC"}' grpc.example.com:443 helloworld.Greeter/SayHello

    Beklenen yanıt:

    {
      "message": "Hello gRPC"
    }

Sınırlamalar

gRPC için ağırlık tabanlı yönlendirme desteklenmez. gRPC, Nginx Ingress service-weight ek açıklamasıyla uyumsuz olan uzun ömürlü bağlantılar kullanır.

SSS

Test için kendi imzaladığım bir sertifikayı nasıl oluşturabilirim?

365 gün geçerli olacak şekilde kendi imzaladığınız bir sertifika ve özel anahtar oluşturmak için openssl kullanın:

openssl req -x509 -newkey rsa:2048 -keyout grpc.key -out grpc.crt -days 365 -nodes \
  -subj "/CN=grpc.example.com" \
  -addext "subjectAltName=DNS:grpc.example.com"
Önemli

Kendi imzaladığınız sertifikalar varsayılan olarak tarayıcılar veya gRPC istemcileri tarafından güvenilir değildir. Bunları üretim ortamında kullanmayın.

SSL ve TLS arasındaki fark nedir?

Transport Layer Security (TLS), kullanımdan kaldırılmış Secure Sockets Layer (SSL) protokolünün modern halefidir. Pratikte "SSL sertifikası" ifadesi genellikle TLS sertifikası anlamında kullanılır.

Sonraki Adımlar