tektoncd/pipeline

docs: document horizontal controller scaling via leader election buckets

Chiusa

#9670 aperta il 26 mar 2026

 (3 commenti) (0 reazioni) (1 assegnatario)Go (1943 fork)auto 404
good first issuehelp wantedkind/documentation

Metriche repository

Star
 (9013 stelle)
Metriche merge PR
 (Metriche PR in attesa)

Descrizione

Description

Tekton controllers support horizontal scaling via Knative's bucket-based leader election, but this is not documented anywhere in docs/.

The mechanism is configured in config-leader-election-controller ConfigMap:

data:
  buckets: "10"  # partition key space into 10 buckets

Then scale the deployment:

kubectl -n tekton-pipelines scale deployment tekton-pipelines-controller --replicas=5

With M buckets and N replicas, replicas compete for buckets. Each bucket owner reconciles keys in its partition.

Areas to Document

  • How to configure buckets in config-leader-election-controller
  • Recommended bucket/replica ratios
  • Impact on reconciliation latency and throughput
  • Same mechanism available for config-leader-election-webhook and config-leader-election-events
  • Any caveats (e.g., rebalancing behavior when replicas change)

Context

Closes the long-standing request from #3404 (25 comments, opened 2020). The feature has been available for years but users don't know about it.

/kind documentation

Guida contributor