# openshift/origin architecture

> Architecture diagram of the GitHub repository openshift/origin, 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/openshift/origin
- Repository: https://github.com/openshift/origin

## Overview

Origin’s maintained product is the `openshift-tests` binary: it selects and runs OpenShift test suites, while monitor components collect cluster behavior and produce recorded test results. The repository also provides disruption monitoring, e2e/risk analysis, and result-parsing utilities. Edges reflect only calls or references visible in the supplied excerpts, SOURCE INDEX, or README; unsampled command wiring and subsystem internals are intentionally not inferred.

Main entry points: [`cmd/openshift-tests/openshift-tests.go`](https://github.com/openshift/origin/blob/main/cmd/openshift-tests/openshift-tests.go) (openshift-tests), [`pkg/monitor/monitorapi/construction.go`](https://github.com/openshift/origin/blob/main/pkg/monitor/monitorapi/construction.go) (Monitor intervals), [`pkg/monitor/monitor.go`](https://github.com/openshift/origin/blob/main/pkg/monitor/monitor.go) (Monitor runtime), [`pkg/monitor/backenddisruption/disruption_backend_sampler.go`](https://github.com/openshift/origin/blob/main/pkg/monitor/backenddisruption/disruption_backend_sampler.go) (Backend sampling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Test CLI"]
  node_cli["openshift-tests<br/>[openshift-tests.go]"]
  node_run["Run tests<br/>[command.go]"]
  node_suites["Suite selection<br/>[standard_suites.go]"]
  node_disruption["Disruption commands"]
end

subgraph group_monitoring["Cluster Monitoring"]
  node_endpoint["Endpoint watcher"]
  node_poll["Service poller"]
  node_backend["Backend sampling"]
  node_monitordata["Monitor intervals<br/>[construction.go]"]
  node_monitor["Monitor runtime<br/>[monitor.go]"]
  node_framework["Monitor test framework<br/>[impl.go]"]
  node_cluster["Cluster discovery<br/>[cluster.go]"]
end

subgraph group_analysis["Analysis"]
  node_alertchecks["Alert analysis<br/>[basic_alert.go]"]
  node_eventpatterns["Event pattern analysis"]
  node_e2eanalysis["E2E analysis<br/>[e2e_analysis.go]"]
  node_risk["Risk analysis<br/>[cmd.go]"]
end

subgraph group_reporting["Test Reporting"]
  node_junit["JUnit parsing<br/>[parser.go]"]
end

node_user(("Test operator"))

node_user -->|"invokes"| node_cli
node_cli -->|"registers command"| node_run
node_cli -->|"registers command"| node_disruption
node_cli -.->|"includes suite commands"| node_suites
node_run -.->|"selects suites"| node_suites
node_disruption -.->|"uses watcher"| node_endpoint
node_endpoint -->|"starts sampling"| node_backend
node_poll -->|"starts sampling"| node_backend
node_backend -->|"records intervals"| node_monitordata
node_monitor -->|"uses framework"| node_framework
node_monitor -->|"uses monitor API"| node_monitordata
node_monitor -->|"invokes analysis"| node_risk
node_cluster -.->|"discovers target cluster"| node_user
node_alertchecks -->|"analyzes intervals"| node_monitordata
node_eventpatterns -->|"examines events"| node_monitordata
node_e2eanalysis -.->|"analyzes test results"| node_junit
node_risk -.->|"requests risk service"| node_user
node_junit -.->|"produces report data"| node_user

click node_cli "https://github.com/openshift/origin/blob/main/cmd/openshift-tests/openshift-tests.go"
click node_run "https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/run/command.go"
click node_suites "https://github.com/openshift/origin/blob/main/pkg/testsuites/standard_suites.go"
click node_disruption "https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/disruption/disruption_command.go"
click node_endpoint "https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/disruption/watch-endpointslice/endpointslice_controller.go"
click node_poll "https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/disruption/poll-service/service_controller.go"
click node_backend "https://github.com/openshift/origin/blob/main/pkg/monitor/backenddisruption/disruption_backend_sampler.go"
click node_monitordata "https://github.com/openshift/origin/blob/main/pkg/monitor/monitorapi/construction.go"
click node_monitor "https://github.com/openshift/origin/blob/main/pkg/monitor/monitor.go"
click node_framework "https://github.com/openshift/origin/blob/main/pkg/monitortestframework/impl.go"
click node_cluster "https://github.com/openshift/origin/blob/main/pkg/clioptions/clusterdiscovery/cluster.go"
click node_alertchecks "https://github.com/openshift/origin/blob/main/pkg/monitortestlibrary/allowedalerts/basic_alert.go"
click node_eventpatterns "https://github.com/openshift/origin/blob/main/pkg/monitortestlibrary/pathologicaleventlibrary/duplicated_event_patterns.go"
click node_e2eanalysis "https://github.com/openshift/origin/blob/main/pkg/e2eanalysis/e2e_analysis.go"
click node_risk "https://github.com/openshift/origin/blob/main/pkg/riskanalysis/cmd.go"
click node_junit "https://github.com/openshift/origin/blob/main/tools/junitreport/pkg/parser/gotest/parser.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_cli,node_run,node_suites,node_disruption toneBlue
class node_endpoint,node_poll,node_backend,node_monitordata,node_monitor,node_framework,node_cluster toneAmber
class node_alertchecks,node_eventpatterns,node_e2eanalysis,node_risk toneMint
class node_junit toneRose
class node_user toneIndigo
```

## Components

### Test CLI

- [openshift-tests](https://github.com/openshift/origin/blob/main/cmd/openshift-tests/openshift-tests.go): `cmd/openshift-tests/openshift-tests.go`
- [Run tests](https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/run/command.go): `pkg/cmd/openshift-tests/run/command.go`
- [Suite selection](https://github.com/openshift/origin/blob/main/pkg/testsuites/standard_suites.go): `pkg/testsuites/standard_suites.go`
- [Disruption commands](https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/disruption/disruption_command.go): `pkg/cmd/openshift-tests/disruption/disruption_command.go`

### Cluster Monitoring

- [Endpoint watcher](https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/disruption/watch-endpointslice/endpointslice_controller.go): `pkg/cmd/openshift-tests/disruption/watch-endpointslice/endpointslice_controller.go`
- [Service poller](https://github.com/openshift/origin/blob/main/pkg/cmd/openshift-tests/disruption/poll-service/service_controller.go): `pkg/cmd/openshift-tests/disruption/poll-service/service_controller.go`
- [Backend sampling](https://github.com/openshift/origin/blob/main/pkg/monitor/backenddisruption/disruption_backend_sampler.go): `pkg/monitor/backenddisruption/disruption_backend_sampler.go`
- [Monitor intervals](https://github.com/openshift/origin/blob/main/pkg/monitor/monitorapi/construction.go): `pkg/monitor/monitorapi/construction.go`
- [Monitor runtime](https://github.com/openshift/origin/blob/main/pkg/monitor/monitor.go): `pkg/monitor/monitor.go`
- [Monitor test framework](https://github.com/openshift/origin/blob/main/pkg/monitortestframework/impl.go): `pkg/monitortestframework/impl.go`
- [Cluster discovery](https://github.com/openshift/origin/blob/main/pkg/clioptions/clusterdiscovery/cluster.go): `pkg/clioptions/clusterdiscovery/cluster.go`

### Analysis

- [Alert analysis](https://github.com/openshift/origin/blob/main/pkg/monitortestlibrary/allowedalerts/basic_alert.go): `pkg/monitortestlibrary/allowedalerts/basic_alert.go`
- [Event pattern analysis](https://github.com/openshift/origin/blob/main/pkg/monitortestlibrary/pathologicaleventlibrary/duplicated_event_patterns.go): `pkg/monitortestlibrary/pathologicaleventlibrary/duplicated_event_patterns.go`
- [E2E analysis](https://github.com/openshift/origin/blob/main/pkg/e2eanalysis/e2e_analysis.go): `pkg/e2eanalysis/e2e_analysis.go`
- [Risk analysis](https://github.com/openshift/origin/blob/main/pkg/riskanalysis/cmd.go): `pkg/riskanalysis/cmd.go`

### Test Reporting

- [JUnit parsing](https://github.com/openshift/origin/blob/main/tools/junitreport/pkg/parser/gotest/parser.go): `tools/junitreport/pkg/parser/gotest/parser.go`

### Other components

- **Test operator**

## Connections

- Test operator → openshift-tests: invokes
- openshift-tests → Run tests: registers command (evidence: `cmd/openshift-tests/openshift-tests.go`)
- openshift-tests → Disruption commands: registers command (evidence: `cmd/openshift-tests/openshift-tests.go`)
- openshift-tests → Suite selection: includes suite commands (evidence: `pkg/testsuites/standard_suites.go`)
- Run tests → Suite selection: selects suites
- Disruption commands → Endpoint watcher: uses watcher
- Endpoint watcher → Backend sampling: starts sampling (evidence: `pkg/cmd/openshift-tests/disruption/watch-endpointslice/endpointslice_controller.go`)
- Service poller → Backend sampling: starts sampling (evidence: `pkg/cmd/openshift-tests/disruption/poll-service/service_controller.go`)
- Backend sampling → Monitor intervals: records intervals (evidence: `pkg/monitor/backenddisruption/disruption_backend_sampler.go`)
- Monitor runtime → Monitor test framework: uses framework (evidence: `pkg/monitor/monitor.go`)
- Monitor runtime → Monitor intervals: uses monitor API (evidence: `pkg/monitor/monitor.go`)
- Monitor runtime → Risk analysis: invokes analysis (evidence: `pkg/monitor/monitor.go`)
- Cluster discovery → Test operator: discovers target cluster
- Alert analysis → Monitor intervals: analyzes intervals (evidence: `pkg/monitortestlibrary/allowedalerts/basic_alert.go`)
- Event pattern analysis → Monitor intervals: examines events (evidence: `pkg/monitortestlibrary/pathologicaleventlibrary/duplicated_event_patterns.go`)
- E2E analysis → JUnit parsing: analyzes test results
- Risk analysis → Test operator: requests risk service (evidence: `pkg/riskanalysis/cmd.go`)
- JUnit parsing → Test operator: produces report data
