Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Use the Kourier gateway in Knative

Son Güncelleme:Oct 06, 2026

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:

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

  1. ACK konsolu üzerinde oturum açı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 Applications > Knative seçeneklerini seçin.

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

  1. Varsayılan düzenleyicinizde config-network ConfigMap dosyasını açmak için aşağıdaki komutu çalıştırın:

    kubectl -n knative-serving edit configmap config-network
  2. Düzenleyicide, data bölümü altındaki ingress.class anahtarını bulun ve değerini aşağıda gösterildiği gibi kourier.ingress.networking.knative.dev olarak 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
  3. 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ğeri internet şeklindedir. Dahili yönlü bir CLB'ye geçmek için bu değeri intranet olarak 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ğıdaki curl komutları, 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

  1. ACK konsolu üzerinde oturum açı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 Applications > Knative seçeneklerini seçin.

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

  4. Services sekmesinde, helloworld-go Hizmeti 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