# redhat-emea-ssa-team/hetzner-ocp4 architecture

> Architecture diagram of the GitHub repository redhat-emea-ssa-team/hetzner-ocp4, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/redhat-emea-ssa-team/hetzner-ocp4
- Repository: https://github.com/redhat-emea-ssa-team/hetzner-ocp4

## Overview

This repository is an Ansible-based deployment and lifecycle toolkit for a self-hosted OpenShift 4 cluster, primarily on Hetzner bare-metal hosts. The intended workflow prepares the host, provisions virtual machines and networking, installs OpenShift, then configures public DNS, certificates, and optional add-ons; lifecycle playbooks also support stopping, starting, and destroying clusters. The README excerpt documents the overall workflow and provider choices, but no source excerpts were supplied, so implementation-level calls and ordering beyond those statements are not asserted.

Main entry points: [`ansible/roles/openshift-4-cluster/tasks/post-install-add-ons.yml`](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/post-install-add-ons.yml) (Cluster add-ons), [`ansible/roles/openshift-4-cluster/tasks/create.yml`](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/create.yml) (OpenShift cluster), [`ansible/00-provision-hetzner.yml`](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/00-provision-hetzner.yml) (Hetzner provisioning), [`ansible/02-create-cluster.yml`](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/02-create-cluster.yml) (Cluster lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Host preparation"]
  node_hostplay["Host setup"]
  node_hetzner["Hetzner provisioning"]
end

subgraph group_cluster["Cluster deployment"]
  node_clusterplay["Cluster lifecycle"]
  node_clusterrole["OpenShift cluster<br/>[create.yml]"]
  node_loadbalancer["Load balancer<br/>[create.yml]"]
  node_artifacts["OpenShift artifacts"]
  node_lifecycle["Cluster operations"]
end

subgraph group_access["DNS and certificates"]
  node_dnsplay["DNS records<br/>[create.yml]"]
  node_certrole["Certificate issuance<br/>[main.yml]"]
end

subgraph group_extensions["Cluster extensions"]
  node_addonplay["Add-on runner<br/>[run-add-ons.yml]"]
  node_addons["Cluster add-ons"]
  node_entitlement["RHEL entitlement<br/>[post-install.yaml]"]
  node_garbagecollection["Garbage collection<br/>[post-install.yml]"]
  node_ntp["NTP configuration<br/>[post-install.yml]"]
  node_webterminal["Web terminal<br/>[post-install.yml]"]
end

node_operator(("Operator"))
node_hetzner_service["Hetzner"]
node_dnsprovider["DNS provider"]

node_operator -.->|"prepares host"| node_hostplay
node_operator -.->|"provisions host"| node_hetzner
node_hetzner -.->|"provisions"| node_hetzner_service
node_operator -.->|"installs cluster"| node_clusterplay
node_clusterplay -.->|"creates cluster"| node_clusterrole
node_clusterrole -.->|"configures access"| node_loadbalancer
node_clusterrole -.->|"downloads"| node_artifacts
node_operator -->|"configures DNS"| node_dnsplay
node_dnsplay -.->|"updates records"| node_dnsprovider
node_operator -->|"sets up certificates"| node_certrole
node_operator -.->|"runs optional add-ons"| node_addonplay
node_addonplay -.->|"configures"| node_addons
node_addons -.->|"applies"| node_entitlement
node_addons -.->|"applies"| node_garbagecollection
node_addons -.->|"applies"| node_ntp
node_addons -.->|"applies"| node_webterminal
node_operator -.->|"stops cluster"| node_lifecycle

click node_hostplay "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/01-prepare-host.yml"
click node_hetzner "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/00-provision-hetzner.yml"
click node_clusterplay "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/02-create-cluster.yml"
click node_clusterrole "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/create.yml"
click node_loadbalancer "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-loadbalancer/tasks/create.yml"
click node_artifacts "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/download-openshift-artifacts.yml"
click node_dnsplay "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/public_dns/tasks/create.yml"
click node_certrole "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/letsencrypt/tasks/main.yml"
click node_addonplay "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/run-add-ons.yml"
click node_addons "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/post-install-add-ons.yml"
click node_entitlement "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/cluster-entitlement/tasks/post-install.yaml"
click node_garbagecollection "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/garbagecollection/tasks/post-install.yml"
click node_ntp "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/ntp/tasks/post-install.yml"
click node_webterminal "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/web-terminal/tasks/post-install.yml"
click node_lifecycle "https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/03-stop-cluster.yml"

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_hostplay,node_hetzner toneBlue
class node_clusterplay,node_clusterrole,node_loadbalancer,node_artifacts,node_lifecycle toneAmber
class node_dnsplay,node_certrole toneMint
class node_addonplay,node_addons,node_entitlement,node_garbagecollection,node_ntp,node_webterminal toneRose
class node_operator,node_hetzner_service,node_dnsprovider toneIndigo
```

## Components

### Host preparation

- [Host setup](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/01-prepare-host.yml): `ansible/01-prepare-host.yml`
- [Hetzner provisioning](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/00-provision-hetzner.yml): `ansible/00-provision-hetzner.yml`

### Cluster deployment

- [Cluster lifecycle](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/02-create-cluster.yml): `ansible/02-create-cluster.yml`
- [OpenShift cluster](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/create.yml): `ansible/roles/openshift-4-cluster/tasks/create.yml`
- [Load balancer](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-loadbalancer/tasks/create.yml): `ansible/roles/openshift-4-loadbalancer/tasks/create.yml`
- [OpenShift artifacts](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/download-openshift-artifacts.yml): `ansible/roles/openshift-4-cluster/tasks/download-openshift-artifacts.yml`
- [Cluster operations](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/03-stop-cluster.yml): `ansible/03-stop-cluster.yml`

### DNS and certificates

- [DNS records](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/public_dns/tasks/create.yml): `ansible/roles/public_dns/tasks/create.yml`
- [Certificate issuance](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/letsencrypt/tasks/main.yml): `ansible/roles/letsencrypt/tasks/main.yml`

### Cluster extensions

- [Add-on runner](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/run-add-ons.yml): `ansible/run-add-ons.yml`
- [Cluster add-ons](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/roles/openshift-4-cluster/tasks/post-install-add-ons.yml): `ansible/roles/openshift-4-cluster/tasks/post-install-add-ons.yml`
- [RHEL entitlement](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/cluster-entitlement/tasks/post-install.yaml): `ansible/add-on-roles/cluster-entitlement/tasks/post-install.yaml`
- [Garbage collection](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/garbagecollection/tasks/post-install.yml): `ansible/add-on-roles/garbagecollection/tasks/post-install.yml`
- [NTP configuration](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/ntp/tasks/post-install.yml): `ansible/add-on-roles/ntp/tasks/post-install.yml`
- [Web terminal](https://github.com/redhat-emea-ssa-team/hetzner-ocp4/blob/master/ansible/add-on-roles/web-terminal/tasks/post-install.yml): `ansible/add-on-roles/web-terminal/tasks/post-install.yml`

### Other components

- **Operator**
- **Hetzner**
- **DNS provider**

## Connections

- Operator → Host setup: prepares host
- Operator → Hetzner provisioning: provisions host
- Hetzner provisioning → Hetzner: provisions
- Operator → Cluster lifecycle: installs cluster
- Cluster lifecycle → OpenShift cluster: creates cluster
- OpenShift cluster → Load balancer: configures access
- OpenShift cluster → OpenShift artifacts: downloads
- Operator → DNS records: configures DNS (evidence: `README.md`)
- DNS records → DNS provider: updates records
- Operator → Certificate issuance: sets up certificates (evidence: `README.md`)
- Operator → Add-on runner: runs optional add-ons
- Add-on runner → Cluster add-ons: configures
- Cluster add-ons → RHEL entitlement: applies
- Cluster add-ons → Garbage collection: applies
- Cluster add-ons → NTP configuration: applies
- Cluster add-ons → Web terminal: applies
- Operator → Cluster operations: stops cluster
