# betelabs/enterprise-k8s-platform architecture

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

- Interactive diagram: https://gitdiagram.com/betelabs/enterprise-k8s-platform
- Repository: https://github.com/betelabs/enterprise-k8s-platform

## Overview

This repository presents an enterprise Kubernetes platform. The documented user workflow is a developer push that triggers CI and image/chart updates, followed by ArgoCD delivery to a cloud cluster; the platform then provides mesh, policy, observability, and cost capabilities. The checked-in files cover Terraform, installation configuration, a policy constraint, and alert-related configuration. Most major components are documented in the README but are not present in the supplied file tree, so their paths are null and their relationships reflect documentation, not inspected implementation.

Main entry points: [`slo-burn-rate.yaml`](https://github.com/betelabs/enterprise-k8s-platform/blob/main/slo-burn-rate.yaml) (Prometheus Alerting), [`main.tf`](https://github.com/betelabs/enterprise-k8s-platform/blob/main/main.tf) (Cloud Provisioning), [`platform-install.sh`](https://github.com/betelabs/enterprise-k8s-platform/blob/main/platform-install.sh) (Platform Installer), [`platform.yaml`](https://github.com/betelabs/enterprise-k8s-platform/blob/main/platform.yaml) (Platform Configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provision["Provisioning"]
  node_terraform["Cloud Provisioning<br/>[main.tf]"]
  node_clouds["EKS AKS GKE"]
  node_installer["Platform Installer"]
  node_platform_config["Platform Configuration<br/>[platform.yaml]"]
end

subgraph group_delivery["GitOps Delivery"]
  node_ci["GitHub Actions CI"]
  node_image["Image Build"]
  node_chart["Helm Chart Update"]
  node_argocd["ArgoCD"]
end

subgraph group_runtime["Cluster Runtime"]
  node_cluster["Kubernetes Cluster"]
  node_istio["Istio Service Mesh"]
  node_opa["OPA Gatekeeper"]
  node_resource_limits["Resource Limit Policy"]
  node_vault["Vault Secrets"]
  node_trivy["Trivy Scanning"]
  node_falco["Falco Detection"]
end

subgraph group_operations["Operations"]
  node_prometheus["Prometheus Alerting<br/>[slo-burn-rate.yaml]"]
  node_grafana["Grafana Dashboards"]
  node_elk["ELK Logging"]
  node_jaeger["Jaeger Tracing"]
  node_kubecost["Kubecost FinOps"]
end

node_developer(("Developer"))

node_developer -->|"pushes changes"| node_ci
node_ci -->|"builds image"| node_image
node_image -->|"updates chart"| node_chart
node_chart -->|"syncs from Git"| node_argocd
node_terraform -->|"provisions"| node_clouds
node_installer -->|"bootstraps"| node_cluster
node_platform_config -.->|"configures"| node_cluster
node_argocd -->|"deploys workloads"| node_cluster
node_clouds -->|"hosts"| node_cluster
node_cluster -->|"uses mesh"| node_istio
node_cluster -->|"enforces policies"| node_opa
node_opa -.->|"applies constraint"| node_resource_limits
node_cluster -->|"exports metrics"| node_prometheus
node_prometheus -->|"supplies dashboards"| node_grafana
node_cluster -->|"sends logs"| node_elk
node_cluster -->|"sends traces"| node_jaeger
node_cluster -->|"supplies cost data"| node_kubecost
node_cluster -->|"uses secrets"| node_vault
node_image -.->|"scans image"| node_trivy
node_cluster -->|"monitors runtime"| node_falco

click node_terraform "https://github.com/betelabs/enterprise-k8s-platform/blob/main/main.tf"
click node_installer "https://github.com/betelabs/enterprise-k8s-platform/blob/main/platform-install.sh"
click node_platform_config "https://github.com/betelabs/enterprise-k8s-platform/blob/main/platform.yaml"
click node_resource_limits "https://github.com/betelabs/enterprise-k8s-platform/blob/main/require-resource-limits.yaml"
click node_prometheus "https://github.com/betelabs/enterprise-k8s-platform/blob/main/slo-burn-rate.yaml"

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_terraform,node_clouds,node_installer,node_platform_config toneBlue
class node_ci,node_image,node_chart,node_argocd toneAmber
class node_cluster,node_istio,node_opa,node_resource_limits,node_vault,node_trivy,node_falco toneMint
class node_prometheus,node_grafana,node_elk,node_jaeger,node_kubecost toneRose
class node_developer toneIndigo
```

## Components

### Provisioning

- [Cloud Provisioning](https://github.com/betelabs/enterprise-k8s-platform/blob/main/main.tf): `main.tf`
- **EKS AKS GKE**
- [Platform Installer](https://github.com/betelabs/enterprise-k8s-platform/blob/main/platform-install.sh): `platform-install.sh`
- [Platform Configuration](https://github.com/betelabs/enterprise-k8s-platform/blob/main/platform.yaml): `platform.yaml`

### GitOps Delivery

- **GitHub Actions CI**
- **Image Build**
- **Helm Chart Update**
- **ArgoCD**

### Cluster Runtime

- **Kubernetes Cluster**
- **Istio Service Mesh**
- **OPA Gatekeeper**
- [Resource Limit Policy](https://github.com/betelabs/enterprise-k8s-platform/blob/main/require-resource-limits.yaml): `require-resource-limits.yaml`
- **Vault Secrets**
- **Trivy Scanning**
- **Falco Detection**

### Operations

- [Prometheus Alerting](https://github.com/betelabs/enterprise-k8s-platform/blob/main/slo-burn-rate.yaml): `slo-burn-rate.yaml`
- **Grafana Dashboards**
- **ELK Logging**
- **Jaeger Tracing**
- **Kubecost FinOps**

### Other components

- **Developer**

## Connections

- Developer → GitHub Actions CI: pushes changes (evidence: `README.md`)
- GitHub Actions CI → Image Build: builds image (evidence: `README.md`)
- Image Build → Helm Chart Update: updates chart (evidence: `README.md`)
- Helm Chart Update → ArgoCD: syncs from Git (evidence: `README.md`)
- Cloud Provisioning → EKS AKS GKE: provisions (evidence: `README.md`)
- Platform Installer → Kubernetes Cluster: bootstraps (evidence: `README.md`)
- Platform Configuration → Kubernetes Cluster: configures
- ArgoCD → Kubernetes Cluster: deploys workloads (evidence: `README.md`)
- EKS AKS GKE → Kubernetes Cluster: hosts (evidence: `README.md`)
- Kubernetes Cluster → Istio Service Mesh: uses mesh (evidence: `README.md`)
- Kubernetes Cluster → OPA Gatekeeper: enforces policies (evidence: `README.md`)
- OPA Gatekeeper → Resource Limit Policy: applies constraint
- Kubernetes Cluster → Prometheus Alerting: exports metrics (evidence: `README.md`)
- Prometheus Alerting → Grafana Dashboards: supplies dashboards (evidence: `README.md`)
- Kubernetes Cluster → ELK Logging: sends logs (evidence: `README.md`)
- Kubernetes Cluster → Jaeger Tracing: sends traces (evidence: `README.md`)
- Kubernetes Cluster → Kubecost FinOps: supplies cost data (evidence: `README.md`)
- Kubernetes Cluster → Vault Secrets: uses secrets (evidence: `README.md`)
- Image Build → Trivy Scanning: scans image
- Kubernetes Cluster → Falco Detection: monitors runtime (evidence: `README.md`)
