# kubernetes/test-infra architecture

> Architecture diagram of the GitHub repository kubernetes/test-infra, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kubernetes/test-infra
- Repository: https://github.com/kubernetes/test-infra

## Overview

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: [`gubernator/main.py`](https://github.com/kubernetes/test-infra/blob/master/gubernator/main.py) (Gubernator Web App), [`triage/main.go`](https://github.com/kubernetes/test-infra/blob/master/triage/main.go) (Triage), [`kettle`](https://github.com/kubernetes/test-infra/tree/master/kettle) (Result Extractor), [`config/jobs`](https://github.com/kubernetes/test-infra/tree/master/config/jobs) (Job Configs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ci["CI Management"]
  node_jobconfigs["Job Configs"]
  node_prowconfig["Prow Config<br/>[prow.go]"]
  node_prow["Prow"]
  node_boskos["Boskos<br/>[client.go]"]
end

subgraph group_dashboards["Results Dashboards"]
  node_testgrid["Testgrid"]
  node_triage["Triage<br/>[main.go]"]
  node_triage_summary["Failure Summarizer"]
  node_gubernator["Gubernator Web App<br/>[main.py]"]
  node_gubernator_build["Build Views<br/>[view_build.py]"]
  node_gubernator_logs["Log Views<br/>[view_logs.py]"]
  node_gubernator_pr["PR Views<br/>[view_pr.py]"]
  node_github_auth["GitHub Auth<br/>[github_auth.py]"]
  node_gcsweb["Artifact Viewer<br/>[gcsweb.go]"]
end

subgraph group_cluster["Cluster Testing"]
  node_kubetest["kubetest<br/>[main.go]"]
  node_aksengine["AKS Engine<br/>[aksengine.go]"]
end

subgraph group_analysis["Result Analysis"]
  node_kettle["Result Extractor"]
  node_bigquery["BigQuery Metrics<br/>[bigquery.py]"]
  node_gopherage["Coverage CLI<br/>[main.go]"]
  node_gopherage_commands["Coverage Operations"]
end

subgraph group_automation["Automation Tools"]
  node_coverage_robot["Coverage Robot<br/>[main.go]"]
  node_issue_robot["Issue Creator<br/>[main.go]"]
  node_pr_creator["PR Creator<br/>[main.go]"]
  node_commenter["Issue Commenter<br/>[main.go]"]
end

node_contributors(("Contributors"))
node_gcs[("Google Cloud Storage")]
node_github["GitHub"]

node_contributors -->|"edit jobs"| node_jobconfigs
node_jobconfigs -->|"configure CI"| node_prow
node_prowconfig -.->|"configure service"| node_prow
node_prow -->|"run cluster tests"| node_kubetest
node_prow -->|"lease projects"| node_boskos
node_prow -.->|"publish results"| node_testgrid
node_prow -.->|"supply job failures"| node_triage
node_triage -->|"dispatch summary"| node_triage_summary
node_triage -->|"show failure clusters"| node_contributors
node_contributors -->|"review history"| node_testgrid
node_contributors -->|"view job status"| node_gubernator
node_gubernator -->|"route builds"| node_gubernator_build
node_gubernator -->|"route logs"| node_gubernator_logs
node_gubernator -->|"route PRs"| node_gubernator_pr
node_gubernator -->|"route auth"| node_github_auth
node_gcsweb -->|"display artifacts"| node_gcs
node_prow -.->|"produce test results"| node_kettle
node_kettle -->|"extract results"| node_gcs
node_kettle -->|"load results"| node_bigquery
node_gopherage -->|"dispatch commands"| node_gopherage_commands
node_coverage_robot -->|"post coverage updates"| node_github
node_issue_robot -->|"create issues"| node_github
node_pr_creator -->|"create pull requests"| node_github
node_commenter -->|"comment on issues"| node_github

click node_jobconfigs "https://github.com/kubernetes/test-infra/tree/master/config/jobs"
click node_prowconfig "https://github.com/kubernetes/test-infra/blob/master/config/prow/prow.go"
click node_boskos "https://github.com/kubernetes/test-infra/blob/master/kubetest/boskos/client/client.go"
click node_kubetest "https://github.com/kubernetes/test-infra/blob/master/kubetest/main.go"
click node_aksengine "https://github.com/kubernetes/test-infra/blob/master/kubetest/aksengine.go"
click node_testgrid "https://github.com/kubernetes/test-infra/tree/master/testgrid"
click node_triage "https://github.com/kubernetes/test-infra/blob/master/triage/main.go"
click node_triage_summary "https://github.com/kubernetes/test-infra/tree/master/triage/summarize"
click node_gubernator "https://github.com/kubernetes/test-infra/blob/master/gubernator/main.py"
click node_gubernator_build "https://github.com/kubernetes/test-infra/blob/master/gubernator/view_build.py"
click node_gubernator_logs "https://github.com/kubernetes/test-infra/blob/master/gubernator/view_logs.py"
click node_gubernator_pr "https://github.com/kubernetes/test-infra/blob/master/gubernator/view_pr.py"
click node_github_auth "https://github.com/kubernetes/test-infra/blob/master/gubernator/github_auth.py"
click node_gcsweb "https://github.com/kubernetes/test-infra/blob/master/gcsweb/cmd/gcsweb/gcsweb.go"
click node_kettle "https://github.com/kubernetes/test-infra/tree/master/kettle"
click node_bigquery "https://github.com/kubernetes/test-infra/blob/master/metrics/bigquery.py"
click node_gopherage "https://github.com/kubernetes/test-infra/blob/master/gopherage/main.go"
click node_gopherage_commands "https://github.com/kubernetes/test-infra/tree/master/gopherage/cmd"
click node_coverage_robot "https://github.com/kubernetes/test-infra/blob/master/robots/coverage/main.go"
click node_issue_robot "https://github.com/kubernetes/test-infra/blob/master/robots/issue-creator/main.go"
click node_pr_creator "https://github.com/kubernetes/test-infra/blob/master/robots/pr-creator/main.go"
click node_commenter "https://github.com/kubernetes/test-infra/blob/master/robots/commenter/main.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_jobconfigs,node_prowconfig,node_prow,node_boskos toneBlue
class node_testgrid,node_triage,node_triage_summary,node_gubernator,node_gubernator_build,node_gubernator_logs,node_gubernator_pr,node_github_auth,node_gcsweb,node_gcs toneAmber
class node_kubetest,node_aksengine toneMint
class node_kettle,node_bigquery,node_gopherage,node_gopherage_commands toneRose
class node_coverage_robot,node_issue_robot,node_pr_creator,node_commenter,node_contributors,node_github toneIndigo
```

## Components

### CI Management

- [Job Configs](https://github.com/kubernetes/test-infra/tree/master/config/jobs): `config/jobs`
- [Prow Config](https://github.com/kubernetes/test-infra/blob/master/config/prow/prow.go): `config/prow/prow.go`
- **Prow**
- [Boskos](https://github.com/kubernetes/test-infra/blob/master/kubetest/boskos/client/client.go): `kubetest/boskos/client/client.go`

### Results Dashboards

- [Testgrid](https://github.com/kubernetes/test-infra/tree/master/testgrid): `testgrid`
- [Triage](https://github.com/kubernetes/test-infra/blob/master/triage/main.go): `triage/main.go`
- [Failure Summarizer](https://github.com/kubernetes/test-infra/tree/master/triage/summarize): `triage/summarize`
- [Gubernator Web App](https://github.com/kubernetes/test-infra/blob/master/gubernator/main.py): `gubernator/main.py`
- [Build Views](https://github.com/kubernetes/test-infra/blob/master/gubernator/view_build.py): `gubernator/view_build.py`
- [Log Views](https://github.com/kubernetes/test-infra/blob/master/gubernator/view_logs.py): `gubernator/view_logs.py`
- [PR Views](https://github.com/kubernetes/test-infra/blob/master/gubernator/view_pr.py): `gubernator/view_pr.py`
- [GitHub Auth](https://github.com/kubernetes/test-infra/blob/master/gubernator/github_auth.py): `gubernator/github_auth.py`
- [Artifact Viewer](https://github.com/kubernetes/test-infra/blob/master/gcsweb/cmd/gcsweb/gcsweb.go): `gcsweb/cmd/gcsweb/gcsweb.go`

### Cluster Testing

- [kubetest](https://github.com/kubernetes/test-infra/blob/master/kubetest/main.go): `kubetest/main.go`
- [AKS Engine](https://github.com/kubernetes/test-infra/blob/master/kubetest/aksengine.go): `kubetest/aksengine.go`

### Result Analysis

- [Result Extractor](https://github.com/kubernetes/test-infra/tree/master/kettle): `kettle`
- [BigQuery Metrics](https://github.com/kubernetes/test-infra/blob/master/metrics/bigquery.py): `metrics/bigquery.py`
- [Coverage CLI](https://github.com/kubernetes/test-infra/blob/master/gopherage/main.go): `gopherage/main.go`
- [Coverage Operations](https://github.com/kubernetes/test-infra/tree/master/gopherage/cmd): `gopherage/cmd`

### Automation Tools

- [Coverage Robot](https://github.com/kubernetes/test-infra/blob/master/robots/coverage/main.go): `robots/coverage/main.go`
- [Issue Creator](https://github.com/kubernetes/test-infra/blob/master/robots/issue-creator/main.go): `robots/issue-creator/main.go`
- [PR Creator](https://github.com/kubernetes/test-infra/blob/master/robots/pr-creator/main.go): `robots/pr-creator/main.go`
- [Issue Commenter](https://github.com/kubernetes/test-infra/blob/master/robots/commenter/main.go): `robots/commenter/main.go`

### Other components

- **Contributors**
- **Google Cloud Storage**
- **GitHub**

## Connections

- 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 (evidence: `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 (evidence: `gubernator/main.py`)
- Gubernator Web App → Log Views: route logs (evidence: `gubernator/main.py`)
- Gubernator Web App → PR Views: route PRs (evidence: `gubernator/main.py`)
- Gubernator Web App → GitHub Auth: route auth (evidence: `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 (evidence: `gopherage/main.go`)
- Coverage Robot → GitHub: post coverage updates (evidence: `robots/coverage/main.go`)
- Issue Creator → GitHub: create issues (evidence: `robots/issue-creator/main.go`)
- PR Creator → GitHub: create pull requests (evidence: `robots/pr-creator/main.go`)
- Issue Commenter → GitHub: comment on issues
