test-infra

September 15, 2025 · View on GitHub

This repository contains tools and configuration files for the testing and automation needs of the Kubernetes project.

Our architecture diagram provides an (updated #13063) overview of how the different tools and services interact.

CI Job Management

Kubernetes uses a prow instance at prow.k8s.io to handle CI and automation for the entire project. Everyone can participate in a self-service PR-based workflow, where changes are automatically deployed after they have been reviewed. All job configs are located in config/jobs

Dashboards

Test Result Dashboards

Testgrid shows historical test results over time (testgrid)
Triage shows clusters of similar test failures across all jobs (triage)

Job and PR Dashboards

Deck shows what jobs are running or have recently run in prow (prow/cmd/deck)
PR Status shows what needs to be done to get PRs matching a GitHub Query to merge (prow/cmd/tide)
Tide History shows what actions tide has taken over time to trigger tests and merge PRs (prow/cmd/tide)
Tide Status shows what PRs are in tide pools to be tested and merged (prow/cmd/tide)

Other Tools

boskos manages pools of resources; our CI leases GCP projects from these pools
experiment is a catchall directory for one-shot tools or scripts
gcsweb is a UI we use to display test artifacts stored in public GCS buckets
ghproxy is a GitHub-aware reverse proxy cache to help keep our GitHub API token usage within rate limits
gopherage is a tool for manipulating Go coverage files
label_sync creates, updates and migrates GitHub labels across orgs and repos based on labels.yaml file
kettle extracts test results from GCS and puts them into bigquery
kubetest2 is how our CI creates and e2e tests kubernetes clusters
metrics runs queries against bigquery to generate metrics based on test results
robots/commenter is used by some of our jobs to comment on GitHub issues

Contributing

Please see CONTRIBUTING.MD