Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Send your first event with Knative Eventing

Son Güncelleme:Oct 06, 2026

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.

image

Mimari altı bileşenden oluşur:

  1. Olay kaynağı — veritabanı güncellemesi veya cloud mesajlaşma hizmeti gibi olayların başladığı nokta.

  2. Giriş (Ingress) — Harici olayları Knative kümesine kabul eder.

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

  4. Broker — Yapılandırılmış Tetikleyicilere göre farklı kaynaklardan gelen olayları yönlendirir. NATS ve ApsaraMQ for Kafka gibi arka uçları destekler.

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

  6. 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:

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.

  1. Aşağıdaki içeriğe sahip event-display.yaml adlı 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
  2. Service'i dağıtın:

    kubectl apply -f event-display.yaml
  3. Service'in hazır olduğunu doğrulayın:

    kubectl get ksvc

    Beklenen çıktı şuna benzer:

    NAME            URL                                        LATESTCREATED         LATESTREADY           READY   REASON
    event-display   http://event-display.default.example.com   event-display-00001   event-display-00001   True

    READY değerinin True olması, Service'in çalıştığını ve olay almaya hazır olduğunu onaylar. Service Ready durumuna 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

  1. Aşağıdaki içeriğe sahip broker.yaml adlı bir dosya oluşturun:

    apiVersion: eventing.knative.dev/v1
    kind: Broker
    metadata:
      name: default
      namespace: default
  2. Broker'ı dağıtın:

    kubectl apply -f broker.yaml
  3. Broker'ın hazır olduğunu doğrulayın:

    kubectl get broker

    Beklenen çıktı şuna benzer:

    NAME      URL                                                                        AGE   READY   REASON
    default   http://broker-ingress.knative-eventing.svc.cluster.local/default/default   9s    True

    URL alanı, olayların bu Broker'a nereye gönderileceğini gösterir. READY değerinin True olması, Broker'ın doğru yapılandırıldığını onaylar. Broker Ready durumuna ulaşmazsa, sorun gidermek için aşağıdaki komutu çalıştırın:

    kubectl describe broker default

Tetikleyici Oluşturma

  1. Aşağıdaki içeriğe sahip trigger.yaml adlı 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-display
    Bu Tetikleyicide filter alanı bulunmadığından, default Broker'ına gönderilen tüm olayları event-display hizmetine 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.
  2. Tetikleyiciyi dağıtın:

    kubectl apply -f trigger.yaml
  3. Tetikleyicinin hazır olduğunu doğrulayın:

    kubectl get trigger

    Beklenen çıktı şuna benzer:

    NAME                 BROKER    SUBSCRIBER_URI                                   AGE   READY   REASON
    my-service-trigger   default   http://event-display.default.svc.cluster.local   22s   True

    READY değerinin True olması, Tetikleyicinin Broker'a doğru şekilde abone olduğunu ve olayları event-display hizmetine ileteceğini onaylar. Tetikleyici Ready durumuna 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.

  1. Broker giriş bağlantı noktasını yerel makinenize yönlendirin:

    kubectl port-forward svc/broker-ingress -n knative-eventing 8080:80
  2. 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 Accepted

    202 Accepted yanıtı, Broker'ın isteği aldığını ve olayı işlemek üzere kabul ettiğini onaylar.

  3. event-display pod'unun adını alın:

    kubectl get pods --namespace=default | grep event-display

    Beklenen çıktı şuna benzer:

    event-display-00001-deployment-766f7b9fd6-gfcz5   2/2     Running   0          3m43s
  4. Olayın teslim edildiğini onaylamak için pod günlüklerini görüntüleyin:

    kubectl logs event-display-00001-deployment-766f7b9fd6-gfcz5

    Beklenen çı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-display hizmetinin 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.