How kubernetes/test-infra works
test-infra is a collection of Kubernetes testing and automation tools, not a single runtime service. Its central documented workflow is PR-managed job configuration used by Prow to run CI; kubetest creates and tests clusters, while Testgrid, Triage, and dashboards expose results. Separate branches provide artifact viewing, result extraction and metrics, coverage manipulation, and automation robots. The sampled sources confirm selected command dispatch and Gubernator routes; many documented subsystem connections rely on README statements, and unsampled implementation details are not inferred.
Main entry points: main.py Gubernator Web App · main.go Triage · kettle Result Extractor · jobs Job Configs
Components 26
CI Management
- Job Configs
config/jobs - Prow Config
config/prow/prow.go - Prow
- Boskos
kubetest/boskos/client/client.go
Results Dashboards
- Testgrid
testgrid - Triage
triage/main.go - Failure Summarizer
triage/summarize - Gubernator Web App
gubernator/main.py - Build Views
gubernator/view_build.py - Log Views
gubernator/view_logs.py - PR Views
gubernator/view_pr.py - GitHub Auth
gubernator/github_auth.py - Artifact Viewer
gcsweb/cmd/gcsweb/gcsweb.go
Cluster Testing
- kubetest
kubetest/main.go - AKS Engine
kubetest/aksengine.go
Result Analysis
- Result Extractor
kettle - BigQuery Metrics
metrics/bigquery.py - Coverage CLI
gopherage/main.go - Coverage Operations
gopherage/cmd
Automation Tools
- Coverage Robot
robots/coverage/main.go - Issue Creator
robots/issue-creator/main.go - PR Creator
robots/pr-creator/main.go - Issue Commenter
robots/commenter/main.go
Other components
- Contributors
- Google Cloud Storage
- GitHub
Connections 24
- Contributors → Job Configs: edit jobs
- Job Configs → Prow: configure CI
- Prow Config → Prow: configure service
- Prow → kubetest: run cluster tests
- Prow → Boskos: lease projects
- Prow → Testgrid: publish results
- Prow → Triage: supply job failures
- Triage → Failure Summarizer: dispatch summary
triage/main.go - Triage → Contributors: show failure clusters
- Contributors → Testgrid: review history
- Contributors → Gubernator Web App: view job status
- Gubernator Web App → Build Views: route builds
gubernator/main.py - Gubernator Web App → Log Views: route logs
gubernator/main.py - Gubernator Web App → PR Views: route PRs
gubernator/main.py - Gubernator Web App → GitHub Auth: route auth
gubernator/main.py - Artifact Viewer → Google Cloud Storage: display artifacts
- Prow → Result Extractor: produce test results
- Result Extractor → Google Cloud Storage: extract results
- Result Extractor → BigQuery Metrics: load results
- Coverage CLI → Coverage Operations: dispatch commands
gopherage/main.go - Coverage Robot → GitHub: post coverage updates
robots/coverage/main.go - Issue Creator → GitHub: create issues
robots/issue-creator/main.go - PR Creator → GitHub: create pull requests
robots/pr-creator/main.go - Issue Commenter → GitHub: comment on issues