test-infra

module

v0.0.0-...-8859403 Latest Latest Go to latest Published: Apr 24, 2024 License: Apache-2.0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/kubernetes/test-infra

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

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

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
greenhouse is a shared bazel cache we use to ensure faster build and test presubmit jobs
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
kubetest is how our CI creates and e2e tests kubernetes clusters
maintenance/migratestatus is used to migrate or retire GitHub status contexts on PRs across orgs and repos
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

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
aws-stockout
bumpmonitoring
ci-janitor ci-janitor cleans up dedicated projects in k8s prowjob configs	ci-janitor cleans up dedicated projects in k8s prowjob configs
cluster-upgrader
clustersecretbackup
clustersecretbackup/secretmanager
coverage
dummybenchmarks
dummybenchmarks/subpkg
gerrit-onboarder
logviewer/gcsreader
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/analyze
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.
prowjob-report
service-account-creator
slack-oncall-updater
update-hook
gcsweb
cmd/gcsweb
pkg/version
gencred
cmd/gencred
pkg/certificate
pkg/kubeconfig
pkg/secretmanager
pkg/serviceaccount
pkg/util
gopherage
cmd/aggregate
cmd/diff
cmd/filter
cmd/html
cmd/junit
cmd/merge
cmd/metadata
pkg/cov
pkg/cov/junit
pkg/cov/junit/calculation Package calculation calculates coverage through summarizing and filtering.	Package calculation calculates coverage through summarizing and filtering.
pkg/util
greenhouse greenhouse implements a bazel remote cache service [1] supporting arbitrarily many workspaces stored within the same top level directory.	greenhouse implements a bazel remote cache service [1] supporting arbitrarily many workspaces stored within the same top level directory.
diskcache Package diskcache implements disk backed cache storage for use in greenhouse	Package diskcache implements disk backed cache storage for use in greenhouse
diskutil Package diskutil implements disk related utilities for greenhouse	Package diskutil implements disk related utilities for greenhouse
hack
boilerplate/test
cluster-migration
gen-prow-documented
prowimagebuilder
ts-rollup
images
builder
kubetest 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().
boskos/client
boskos/common
boskos/storage
conformance Package conformance implements conformance test kubetest code.	Package conformance implements conformance test kubetest code.
e2e
kind
process
util
label_sync This is a label_sync tool, details in README.md	This is a label_sync tool, details in README.md
logexporter
cmd
pkg
benchmarkjunit
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
config-forker
config-rotator
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
coverage/cmd/diff
coverage/cmd/downloader
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
issue-creator
issue-creator/creator
issue-creator/sources
issue-creator/testowner
pr-creator
pr-creator/updater
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
cmd/configurator
pkg/configurator/configurator
pkg/configurator/options
pkg/configurator/prow
triage module

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL