tektoncd/pipeline

docs: document horizontal controller scaling via leader election buckets

Fermée

#9 670 ouverte le 26 mars 2026

Voir sur GitHubGuide contributeur
 (3 commentaires) (0 réaction) (1 personne assignée)Go (1 943 forks)auto 404
good first issuehelp wantedkind/documentation

Métriques du dépôt

Stars
 (9 013 étoiles)
Métriques de merge PR
 (Merge moyen 9j 3h) (137 PRs mergées en 30 j)

Description

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

Guide contributeur

Direction de recherche
Explorez la configuration de l'élection du leader du pipeline Tekton dans le ConfigMap config leader election controller et documentez comment configurer les buckets et la mise à l'échelle pour les contrôleurs, les webhooks et les événements. Incluez les ratios recommandés, l'impact sur la latence et les mises en garde concernant le rééquilibrage.
Stack technique
gokubernetes
Domaine
backendinfrastructure
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
KubernetesTekton
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
75