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:
TLS'yi sonlandırır ve trafiğin şifresini çözer.
Şifresi çözülmüş gRPC trafiğini (HTTP/2 üzerinden) 50051 bağlantı noktasındaki arka plan pod'a iletir.
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
# ...
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.
-
Alan adınız için bir TLS sertifikası edinin:
Üretim: Güvenilir bir Sertifika Yetkilisinden (CA) sertifika satın alın. Alibaba Cloud sertifikaları için, sertifika dosyalarını indirin.
-
Sertifikayı ve özel anahtarı saklamak için
nginx-ingress-tlsadlı bir Secret oluşturun.Konsol
ACK konsoluna giriş yapın. Sol gezinme bölmesinde, Clusters seçeneğine tıklayın.
Clusters sayfasında, kümenizin adına tıklayın. Sol gezinme bölmesinde, seçeneğine tıklayın.
-
Secrets sayfasında,
defaultad 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.
Namenginx-ingress-tls
Type
Ingress TLS Certificate+ Add altında, sertifikayı ve özel anahtarı girin:
Certificates: Sertifika dosyasının tam içeriği (
.crtveya.pem).Key: Özel anahtar dosyasının tam içeriği (
.key).
kubectl
PUBLIC_CERTvePRIVATE_KEYdeğ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
ACK konsoluna giriş yapın ve küme adına tıklayın. Sol gezinme bölmesinde, Add-ons seçeneğini belirleyin.
-
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.
-
gRPC trafiğini arka plan hizmetine yönlendirmek için Ingress'i yapılandırın.
Konsol
Sol gezinme bölmesinde, seçeneğini belirleyin.
defaultad alanını seçin ve Create Ingress seçeneğine tıklayın.-
Ingress'i aşağıdaki gibi yapılandırın, ardından OK seçeneğine tıklayın:
Gateway TypeNginx Ingress
Namegrpc-ingress
Domain Namegrpc.example.comMappings altında şunları ayarlayın:
Mappings/
Match RulePrefix (Prefix-based match)
Servicegrpc-service
Port50051TLS settings altında seçeneği etkinleştirin ve şunları ayarlayın:
Domain Namegrpc.example.com
Secretsnginx-ingress-tlsAnnotations altında şunu ekleyin:
nginx.ingress.kubernetes.io/backend-protocolGRPC -
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
-
grpc-ingress.yamldosyası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 -
Ingress'i uygulayın:
kubectl apply -f grpc-ingress.yaml -
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
-
Ingress IP'sini
hostsdosyanıza ekleyin.ADDRESSdeğerini gerçek IP ile değiştirin:macOS/Linux:
sudo vi /etc/hostskomutuyla/etc/hostsdosyasını düzenleyinWindows: Not Defteri'ni yönetici olarak çalıştırarak
C:\Windows\System32\drivers\etc\hostsdosyasını açın
ADDRESS grpc.example.com -
grpcurl'u yükleyin, ardından
SayHelloyöntemini çağırın:grpcurl -d '{"name": "gRPC"}' grpc.example.com:443 helloworld.Greeter/SayHelloBeklenen 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"
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.