Skip to content

Latest commit

 

History

History
44 lines (34 loc) · 2.29 KB

webhook_multiplexing.md

File metadata and controls

44 lines (34 loc) · 2.29 KB

GitHub Push events fanout/multiplexing

GitOps operators like ArgoCD can listen for GitHub webhooks to ensure short delays in their reconciliation loop.

But in some scenarios the number of needed webhooks endpoint exceed the maximum supported by GitHub(think 10 cluster each with in-cluster ArgoCD server and ArgoCD applicationSet controller). Additionally, configuring said webhooks manually is time consuming and error prone.

Telefonistka can forward these HTTP requests to multiple endpoint and can even filter or dynamically choose the endpoint URL based on the file changed in the Commit. Assuming Telefonistka is deployed as a GitHub Application, this also ease the setup process as the webhook setting(event types, URL, secret) is already a part of the application configuration.

This configuration example will forward github push events that include changes in workspace/ dir to the lab ArgoCD server and  applicationset controllers webhook servers and will forward event  that touches clusters/to URLs generated with regex, base of first 3 directory elements after clusters/

webhookEndpointRegexs:
  - expression: "^workspace/[^/]*/.*"
    replacements:
      - "https://kube-argocd-c1.service.lab.example.com/api/webhook"
      - "https://kube-argocd-applicationset-c1.service.lab.example.com/api/webhook"
      - "https://example.com"
  - expression: "^clusters/([^/]*)/([^/]*)/([^/]*)/.*"
    replacements:
      - "https://kube-argocd-${3}.${1}.service.{2}.example.com/api/webhook"
      - "https://kube-argocd-applicationset-${2}.service.${1}.example.com/api/webhook"

Telefonistka checks the regex per each file affected by a commit, but stops after the first expression match(per file).

So ordering of the webhookEndpointRegexs elements is significant.

This simpeller configuration will and push event to 7 hardcoded servers

webhookEndpointRegexs:
  - expression: "^.*$"
    replacements:
      - "https://argocd-server1.example.com/api/webhook"
      - "https://argocd-server2.example.com/api/webhook"
      - "https://argocd-server3.example.com/api/webhook"
      - "https://argocd-server4.example.com/api/webhook"
      - "https://argocd-server5.example.com/api/webhook"
      - "https://argocd-server6.example.com/api/webhook"
      - "https://argocd-server6.example.com/api/webhook"