Knative Eventing, hizmetler arasındaki olayları yönlendirmek ve filtrelemek için Broker-Tetikleyici modelini kullanır. Bu eğitimde ACK üzerinde eksiksiz bir olay odaklı sistem dağıtacaksınız: Olayları alan bir Knative Service, bunları yönlendiren bir Broker, ikisini birbirine bağlayan bir Tetikleyici ve ilk olayı uçtan uca gönderen bir curl komutu.
Nasıl çalışır
Knative Eventing, olayları harici sistemlerden alır ve CloudEvents standardını kullanarak dahili olarak iletir. Merkezde Broker-Tetikleyici modeli yer alır: Broker, herhangi bir kaynaktan gelen olayları alır; her Tetikleyici ise bu Broker'a abone olur, isteğe bağlı bir filtre uygular ve eşleşen olayları aşağı akıştaki bir Service'e yönlendirir.
Mimari altı bileşenden oluşur:
Olay kaynağı — veritabanı güncellemesi veya cloud mesajlaşma hizmeti gibi olayların başladığı nokta.
Giriş (Ingress) — Harici olayları Knative kümesine kabul eder.
Kanal — Broker-Tetikleyici modeli içinde olayları iletir. Desteklenen kanallar arasında ApsaraMQ for Kafka, NATS Streaming ve InMemoryChannel bulunur. Varsayılan kanal InMemoryChannel'dir.
Broker — Yapılandırılmış Tetikleyicilere göre farklı kaynaklardan gelen olayları yönlendirir. NATS ve ApsaraMQ for Kafka gibi arka uçları destekler.
Tetikleyici — Olayların belirli bir Service'e nasıl yönlendirileceğini tanımlar. Her Tetikleyicide bir olay filtresi ve bir Service hedefi bulunur; yalnızca eşleşen olaylar iletilir.
Service — Bir Tetikleyiciden olay aldıktan sonra iş mantığını yürüten son işleyici.
Ön koşullar
Başlamadan önce şunlara sahip olduğunuzdan emin olun:
Knative Serving yüklü olmalıdır. Bkz. Knative Dağıtımı.
Knative Eventing yüklü olmalıdır. Bkz. Knative Eventing Dağıtımı.
Adım 1: Bir Knative Service Dağıtın
Olayları alan ve içeriklerini günlüklere yazdıran bir Knative Service olan event-display uygulamasını dağıtın. Bu adımdan sonra, olayları tüketmeye hazır çalışan bir Service'iniz olacaktır.
-
Aşağıdaki içeriğe sahip
event-display.yamladlı bir dosya oluşturun:apiVersion: serving.knative.dev/v1 kind: Service metadata: name: event-display namespace: default spec: template: spec: containers: - image: registry.cn-hangzhou.aliyuncs.com/knative-sample/event-display:v1028 -
Service'i dağıtın:
kubectl apply -f event-display.yaml -
Service'in hazır olduğunu doğrulayın:
kubectl get ksvcBeklenen çıktı şuna benzer:
NAME URL LATESTCREATED LATESTREADY READY REASON event-display http://event-display.default.example.com event-display-00001 event-display-00001 TrueREADYdeğerininTrueolması, Service'in çalıştığını ve olay almaya hazır olduğunu onaylar. ServiceReadydurumuna ulaşmazsa, sorun gidermek için aşağıdaki komutu çalıştırın:kubectl describe ksvc event-display
Adım 2: Broker ve Tetikleyici Oluşturun
default adlı bir Broker ve my-service-trigger adlı bir Tetikleyici oluşturun. Bu adımdan sonra, Broker'a gönderilen herhangi bir olay otomatik olarak event-display Service'ine yönlendirilir.
Broker Oluşturma
-
Aşağıdaki içeriğe sahip
broker.yamladlı bir dosya oluşturun:apiVersion: eventing.knative.dev/v1 kind: Broker metadata: name: default namespace: default -
Broker'ı dağıtın:
kubectl apply -f broker.yaml -
Broker'ın hazır olduğunu doğrulayın:
kubectl get brokerBeklenen çıktı şuna benzer:
NAME URL AGE READY REASON default http://broker-ingress.knative-eventing.svc.cluster.local/default/default 9s TrueURLalanı, olayların bu Broker'a nereye gönderileceğini gösterir.READYdeğerininTrueolması, Broker'ın doğru yapılandırıldığını onaylar. BrokerReadydurumuna ulaşmazsa, sorun gidermek için aşağıdaki komutu çalıştırın:kubectl describe broker default
Tetikleyici Oluşturma
-
Aşağıdaki içeriğe sahip
trigger.yamladlı bir dosya oluşturun:apiVersion: eventing.knative.dev/v1 kind: Trigger metadata: name: my-service-trigger spec: broker: default subscriber: ref: apiVersion: serving.knative.dev/v1 kind: Service name: event-displayBu Tetikleyicide
filteralanı bulunmadığından,defaultBroker'ına gönderilen tüm olaylarıevent-displayhizmetine iletir. Filtreyi atlamak, test ve hata ayıklama süreçlerinde faydalıdır. Üretim ortamında yalnızca belirli olay türlerini yönlendirmek için bir filtre ekleyin. -
Tetikleyiciyi dağıtın:
kubectl apply -f trigger.yaml -
Tetikleyicinin hazır olduğunu doğrulayın:
kubectl get triggerBeklenen çıktı şuna benzer:
NAME BROKER SUBSCRIBER_URI AGE READY REASON my-service-trigger default http://event-display.default.svc.cluster.local 22s TrueREADYdeğerininTrueolması, Tetikleyicinin Broker'a doğru şekilde abone olduğunu ve olaylarıevent-displayhizmetine ileteceğini onaylar. TetikleyiciReadydurumuna ulaşmazsa, sorun gidermek için aşağıdaki komutu çalıştırın:kubectl describe trigger my-service-trigger
Adım 3: Olay Gönderin ve Teslimatı Doğrulayın
Broker'a bir test olayı gönderin ve event-display hizmetinin bunu alıp günlüğe kaydettiğini onaylayın. Bu adım, Broker'ın dahili uç noktasını yerel makinenize açmak için kubectl port-forward kullanır ve ardından CloudEvents biçiminde bir HTTP POST isteği gönderir.
-
Broker giriş bağlantı noktasını yerel makinenize yönlendirin:
kubectl port-forward svc/broker-ingress -n knative-eventing 8080:80 -
Ayrı bir terminalde, Broker'a bir POST isteği gönderin:
curl -v "http://localhost:8080/default/default" \ -X POST \ -H "Ce-Id: 536808d3-88be-4077-9d7a-a3f162705f79" \ -H "Ce-Specversion: 1.0" \ -H "Ce-Type: dev.knative.samples.helloworld" \ -H "Ce-Source: dev.knative.samples/helloworldsource" \ -H "Content-Type: application/json" \ -d '{"msg":"Hello World from the curl pod."}'Beklenen yanıt şu şekilde sonlanır:
< HTTP/1.1 202 Accepted202 Acceptedyanıtı, Broker'ın isteği aldığını ve olayı işlemek üzere kabul ettiğini onaylar. -
event-displaypod'unun adını alın:kubectl get pods --namespace=default | grep event-displayBeklenen çıktı şuna benzer:
event-display-00001-deployment-766f7b9fd6-gfcz5 2/2 Running 0 3m43s -
Olayın teslim edildiğini onaylamak için pod günlüklerini görüntüleyin:
kubectl logs event-display-00001-deployment-766f7b9fd6-gfcz5Beklenen çıktı şuna benzer:
Defaulted container "user-container" out of: user-container, queue-proxy ☁️ cloudevents.Event Context Attributes, specversion: 1.0 type: dev.knative.samples.helloworld source: dev.knative.samples/helloworldsource id: 536808d3-88be-4077-9d7a-a3f162705f79 datacontenttype: application/json Extensions, knativearrivaltime: 2024-10-28T11:48:56.929517041Z Data, { "msg": "Hello World from the curl pod1." }Günlük,
event-displayhizmetinin Broker'dan CloudEvent'i aldığını ve CloudEvents başlıkları ile JSON yükü dahil tam içeriğini yazdırdığını onaylar.
Sırada ne var
Yalnızca belirli olay türlerini yönlendirmek için Tetikleyicinize bir filtre ekleyin. Bkz. Tetikleyici filtreleme.
Üretim düzeyinde olay kalıcılığı sağlamak için InMemoryChannel yerine ApsaraMQ for Kafka veya NATS Streaming kullanın.
Olayları birden fazla Service'e yaymak için ek Tetikleyiciler dağıtın.