Kourier, Knative topluluğu tarafından sunulan, Envoy tabanlı hafif ve açık kaynaklı bir Knative yerel giriş ağ geçididir. HTTP ve HTTPS trafiğini Knative revizyonları arasında yönlendirmek, gRPC hizmetlerini yapılandırmak, zaman aşımları ve yeniden denemeleri ayarlamak, Transport Layer Security (TLS) sertifikalarını yönetmek ve harici yetkilendirme hizmetlerini entegre etmek için bu ağ geçidini dağıtın.
Ön koşullar
Başlamadan önce aşağıdaki gereksinimlere sahip olduğunuzdan emin olun:
ACK kümenizde Knative dağıtılmış olmalıdır. Bkz. Knative'i Dağıtma ve Yönetme.
Kourier ağ geçidini dağıtma
Kourier'i ilk Knative kurulumu sırasında (ACK konsolunu kullanarak) veya dağıtımdan sonra (kubectl kullanarak) dağıtabilirsiniz.
Yeni bir Knative kurulumu için
ACK konsolu üzerinde oturum açı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 Applications > Knative seçeneklerini seçin.
Components sekmesinde, Add-on Component bölümünde Kourier öğesini bulun ve Actions sütununda Deploy seçeneğine tıklayın. Açılan iletişim kutusunda Confirm seçeneğine tıklayın. Kourier için Status sütunu Deployed olarak değişir.
Mevcut bir Knative kurulumu için
-
Varsayılan düzenleyicinizde
config-networkConfigMap dosyasını açmak için aşağıdaki komutu çalıştırın:kubectl -n knative-serving edit configmap config-network -
Düzenleyicide,
databölümü altındakiingress.classanahtarını bulun ve değerini aşağıda gösterildiği gibikourier.ingress.networking.knative.devolarak değiştirin:apiVersion: v1 data: ... ingress.class: kourier.ingress.networking.knative.dev # Use the Kourier gateway ... kind: ConfigMap metadata: name: config-network namespace: knative-serving Dosyayı kaydedip kapatın. Kubernetes değişikliği otomatik olarak uygular.
(İsteğe bağlı) Dahili yönlü bir CLB yapılandırma
Varsayılan olarak Kourier, İnternet'e bakan bir Classic Load Balancer (CLB) oluşturur. Bunun yerine dahili yönlü bir CLB kullanmak için Kourier Service manifest dosyasına service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: "intranet" ek açıklamasını (annotation) ekleyin:
apiVersion: v1
kind: Service
metadata:
name: kourier
namespace: knative-serving
annotations:
service.beta.kubernetes.io/alibaba-cloud-loadbalancer-address-type: "intranet"
...
spec:
ports:
- name: http2
port: 80
protocol: TCP
targetPort: 8080
- name: https
port: 443
protocol: TCP
targetPort: 8443
selector:
app: 3scale-kourier-gateway
type: LoadBalancer
Varsayılan ek açıklama değeriinternetşeklindedir. Dahili yönlü bir CLB'ye geçmek için bu değeriintranetolarak ayarlayın.
Kourier ağ geçidi üzerinden bir Knative Hizmetine erişme
Aşağıdaki adımlarda, HTTP ve HTTPS erişimini göstermek amacıyla helloworld-go adlı örnek bir Knative Hizmeti kullanılmaktadır. Önce Hizmeti dağıtın, ardından ihtiyacınız olan protokolü seçin.
Aşağıdakicurlkomutları, DNS varsayılan olarak yapılandırılmadığı için alan adınıHostüst bilgisinde iletir. Ağ geçidi için DNS yapılandırırsanız-H "Host:"bayrağını atlayabilirsiniz.
Örnek hizmeti dağıtma
ACK konsolu üzerinde oturum açı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 Applications > Knative seçeneklerini seçin.
-
Services sekmesinde Namespace değerini default olarak ayarlayın, Create from Template seçeneğine tıklayın, aşağıdaki YAML kodunu düzenleyiciye yapıştırın ve Create seçeneğine tıklayın.
apiVersion: serving.knative.dev/v1 kind: Service metadata: name: helloworld-go spec: template: spec: containers: - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/helloworld-go:73fbdd56 env: - name: TARGET value: "Knative"Status alanında Created göründüğünde Hizmet hazır durumdadır.
Services sekmesinde,
helloworld-goHizmeti için Default Domain sütunundaki alan adını ve Gateway sütunundaki ağ geçidi IP adresini not edin. Bu değerlere sonraki adımlarda ihtiyacınız olacaktır.
HTTP üzerinden erişim
Ağ geçidi IP adresini ve alan adını not ettiğiniz değerlerle değiştirerek aşağıdaki komutu çalıştırın:
curl -H "Host: helloworld-go.default.example.com" http://8.141.XX.XX
Beklenen çıktı:
Hello Knative!
HTTPS üzerinden erişim
Adım 1: Bir TLS sertifikası oluşturun.
Kendinden imzalı bir sertifika oluşturmak için aşağıdaki komutları çalıştırın:
openssl genrsa -out tls.key 4096
openssl req -subj "/CN=*.example.com/L=*.example.com" -sha256 -new -key tls.key -out tls.csr
echo subjectAltName = DNS:helloworld-go.default.example.com,DNS:helloworld-go.default.example.cn > extfile.cnf
openssl x509 -req -days 3650 -sha256 -in tls.csr -signkey tls.key -out tls.crt -extfile extfile.cnf
Bu işlem, 4096 bitlik bir RSA anahtarı ve helloworld-go.default.example.com ile helloworld-go.default.example.cn için Konu Alternatif Adları içeren, 3650 gün geçerli bir sertifika oluşturur.
Adım 2: Sertifikadan bir Secret oluşturun.
kubectl -n knative-serving create secret tls kourier-cert --key tls.key --cert tls.crt
Adım 3: net-kourier-controller Dağıtımının var olduğunu doğrulayın.
kubectl get deployments -n knative-serving
Adım 4: Denetleyicideki sertifikayı yapılandırın.
kubectl -n knative-serving edit deployment net-kourier-controller
spec.containers[].env altına aşağıdaki iki ortam değişkenini ekleyin:
...
spec:
containers:
- env:
- name: CERTS_SECRET_NAMESPACE
value: knative-serving
- name: CERTS_SECRET_NAME
value: kourier-cert
...
| Parametre | Açıklama |
|---|---|
CERTS_SECRET_NAMESPACE |
Secret'ın oluşturulduğu ad alanı (knative-serving) |
CERTS_SECRET_NAME |
Secret'ın adı (kourier-cert) |
Adım 5: Denetleyici podunun çalıştığını doğrulayın.
kubectl -n knative-serving get po
Beklenen çıktı:
NAME READY STATUS RESTARTS AGE
net-kourier-controller-****** 1/1 Running 0 10s
Adım 6: HTTPS üzerinden Hizmete erişin.
curl -H "Host: helloworld-go.default.example.com" -k --cert tls.crt --key tls.key https://8.141.XX.XX
Beklenen çıktı:
Hello Knative!
(İsteğe bağlı) Knative izleme panosunu görüntüleme
Knative yerleşik izleme özelliği içerir. Knative sayfasında Hizmetleriniz için ölçümleri görüntülemek üzere Monitoring Dashboards sekmesine tıklayın. Kurulum talimatları için bkz. Knative İzleme Panosunu Görüntüleme.
Sonraki adımlar
Özel alan adlarını ve yolları kullanma — Knative Hizmetleri için özel alan adlarını yapılandırın.
HTTPS üzerinden Hizmetlere erişmek için sertifika yapılandırma — üretim düzeyinde TLS sertifikaları kurun.
Knative'de gRPC hizmetlerini dağıtma — gRPC ile ağ verimliliğini artırın.
Knative'de bağlantı noktası yoklamasını yapılandırma — Knative Hizmetlerinin sağlık durumunu ve kullanılabilirliğini izleyin.
Bir Knative Hizmetinin çalıştığı esnek konteyner örneğiyle bir EIP ilişkilendirme — Esnek bir konteyner örneğini esnek bir IP adresi (EIP) kullanarak İnternet'e bağlayın.