README
¶
test-infra
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
- Add or update job configs
- Delete job configs
- Test job configs locally
- Trigger jobs on PRs using bot commands
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) - Gubernator's PR Dashboard shows which PRs need your review (
gubernator) - 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
boskosmanages pools of resources; our CI leases GCP projects from these poolsexperimentis a catchall directory for one-shot tools or scriptsgcswebis a UI we use to display test artifacts stored in public GCS bucketsghproxyis a GitHub-aware reverse proxy cache to help keep our GitHub API token usage within rate limitsgopherageis a tool for manipulating Go coverage filesgreenhouseis a shared bazel cache we use to ensure faster build and test presubmit jobslabel_synccreates, updates and migrates GitHub labels across orgs and repos based onlabels.yamlfilekettleextracts test results from GCS and puts them into bigquerykubetestis how our CI creates and e2e tests kubernetes clustersmaintenance/migratestatusis used to migrate or retire GitHub status contexts on PRs across orgs and reposmetricsruns queries against bigquery to generate metrics based on test resultsrobots/commenteris used by some of our jobs to comment on GitHub issues
Contributing
Please see CONTRIBUTING.MD
Directories
¶
| Path | Synopsis |
|---|---|
|
def
|
|
|
configmap
configmap will write a configmap to --output from --data=name=/path/to/source
|
configmap will write a configmap to --output from --data=name=/path/to/source |
|
experiment
|
|
|
ci-janitor
ci-janitor cleans up dedicated projects in k8s prowjob configs
|
ci-janitor cleans up dedicated projects in k8s prowjob configs |
|
manual-trigger
manual-trigger triggers jenkins jobs based a specified github pull request
|
manual-trigger triggers jenkins jobs based a specified github pull request |
|
ml/prowlog
Package main will process annotated builds listed in the tsv file.
|
Package main will process annotated builds listed in the tsv file. |
|
ml/prowlog/csv
Package main will create a CSV dataset by reading the specified zip file.
|
Package main will create a CSV dataset by reading the specified zip file. |
|
gcsweb
|
|
|
pkg/cov/junit/calculation
Package calculation calculates coverage through summarizing and filtering.
|
Package calculation calculates coverage through summarizing and filtering. |
|
hack
|
|
|
images
|
|
|
Package main / gke.go provides the Google Container Engine (GKE) kubetest deployer via newGKE().
|
Package main / gke.go provides the Google Container Engine (GKE) kubetest deployer via newGKE(). |
|
conformance
Package conformance implements conformance test kubetest code.
|
Package conformance implements conformance test kubetest code. |
|
This is a label_sync tool, details in README.md
|
This is a label_sync tool, details in README.md |
|
logexporter
|
|
|
pkg
|
|
|
flagutil
Package flagutil contains utilities and interfaces shared between several test-infra commands.
|
Package flagutil contains utilities and interfaces shared between several test-infra commands. |
|
genyaml
Package genyaml can generate an example YAML snippet from an initialized struct and decorate it with godoc comments parsed from the AST of a given file.
|
Package genyaml can generate an example YAML snippet from an initialized struct and decorate it with godoc comments parsed from the AST of a given file. |
|
ghclient
Package ghclient provides a github client that wraps go-github with retry logic, rate limiting, and depagination where necessary.
|
Package ghclient provides a github client that wraps go-github with retry logic, rate limiting, and depagination where necessary. |
|
releng
|
|
|
robots
|
|
|
commenter
Commenter provides a way to --query for issues and append a --comment to matches.
|
Commenter provides a way to --query for issues and append a --comment to matches. |
|
coverage/diff
Package diff calculates the difference of two coverage lists and produces a collection of individual coverage difference.
|
Package diff calculates the difference of two coverage lists and produces a collection of individual coverage difference. |
|
coverage/downloader
Package downloader finds and downloads the coverage profile file from the latest healthy build stored in given gcs directory
|
Package downloader finds and downloads the coverage profile file from the latest healthy build stored in given gcs directory |
|
pr-labeler
PR labeler provides a way to add a missing ok-to-test label on trusted PRs.
|
PR labeler provides a way to add a missing ok-to-test label on trusted PRs. |
|
testgrid
|
|
|
triage
module
|
Click to show internal directories.
Click to hide internal directories.