# selvakuppusamy/tiny-infra-lab architecture

> Architecture diagram of the GitHub repository selvakuppusamy/tiny-infra-lab, 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/selvakuppusamy/tiny-infra-lab
- Repository: https://github.com/selvakuppusamy/tiny-infra-lab

## Overview

Tiny Infra Lab demonstrates a Node health endpoint and several alternative image-delivery and Kubernetes deployment experiments. The sampled server shows the HTTP behavior; README statements document the infrastructure flows and deployment capabilities. Workflow and Helm template contents were not sampled, so their relationships below rely on README evidence rather than inspected implementation details.

Main entry points: [`.github/workflows/02-build-local-deploy-local.yml`](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/02-build-local-deploy-local.yml) (Local Deploy), [`.github/workflows/03-push-image-to-ghcr.yml`](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/03-push-image-to-ghcr.yml) (Push Image), [`.github/workflows/04-pull-ghrc-image-deploy-local.yml`](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/04-pull-ghrc-image-deploy-local.yml) (Pull Deploy), [`helm/tiny-app/templates/deployment.yml`](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/helm/tiny-app/templates/deployment.yml) (Helm Deployment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_server["HTTP Server<br/>[server.js]"]
  node_health["Health Endpoint<br/>[server.js]"]
end

subgraph group_automation["Automation"]
  node_runner_check["Runner Check"]
  node_local_deploy["Local Deploy"]
  node_push_image["Push Image"]
  node_pull_deploy["Pull Deploy"]
  node_direct_pull["Cluster Pull"]
  node_ci_minikube["CI Minikube Check"]
end

subgraph group_delivery["Image Delivery"]
  node_image["Container Image"]
  node_registry[("GHCR")]
  node_runner["Self-hosted Runner"]
end

subgraph group_cluster["Kubernetes"]
  node_helm_deploy["Helm Deployment<br/>[deployment.yml]"]
  node_service["Kubernetes Service<br/>[service.yaml]"]
  node_ingress["Ingress<br/>[ingress.yml]"]
  node_cluster_runtime["Minikube / Kubernetes"]
  node_health_check["Health Verification"]
end

node_developer(("Operator"))

node_developer -->|"requests"| node_server
node_server -->|"routes"| node_health
node_health -->|"checks"| node_health_check
node_developer -->|"runs"| node_runner_check
node_developer -->|"runs"| node_local_deploy
node_developer -->|"runs"| node_push_image
node_developer -->|"runs"| node_pull_deploy
node_developer -->|"runs"| node_direct_pull
node_developer -->|"runs"| node_ci_minikube
node_local_deploy -->|"builds"| node_image
node_local_deploy -->|"deploys"| node_helm_deploy
node_push_image -->|"pushes"| node_registry
node_push_image -->|"builds"| node_image
node_pull_deploy -->|"pulls"| node_registry
node_pull_deploy -->|"deploys"| node_helm_deploy
node_direct_pull -->|"deploys"| node_helm_deploy
node_direct_pull -->|"pulls"| node_registry
node_runner_check -->|"checks"| node_runner
node_local_deploy -->|"runs on"| node_runner
node_push_image -->|"runs on"| node_runner
node_pull_deploy -->|"runs on"| node_runner
node_helm_deploy -->|"runs in"| node_cluster_runtime
node_service -->|"exposes"| node_cluster_runtime
node_ingress -.->|"routes to"| node_service
node_ci_minikube -->|"starts"| node_cluster_runtime
node_health_check -->|"verifies"| node_cluster_runtime
node_developer -->|"port-forwards"| node_health_check

click node_server "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/app/src/server.js"
click node_health "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/app/src/server.js"
click node_runner_check "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/01-self-hosted-runner-check.yaml"
click node_local_deploy "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/02-build-local-deploy-local.yml"
click node_push_image "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/03-push-image-to-ghcr.yml"
click node_pull_deploy "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/04-pull-ghrc-image-deploy-local.yml"
click node_direct_pull "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/05-ghcr-image-directly-pulled-by-k8s.yml"
click node_ci_minikube "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/06-minikube-check-in-ci-runner.yml"
click node_image "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/app/dockerfile"
click node_helm_deploy "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/helm/tiny-app/templates/deployment.yml"
click node_service "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/helm/tiny-app/templates/service.yaml"
click node_ingress "https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/helm/tiny-app/templates/ingress.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_server,node_health toneBlue
class node_runner_check,node_local_deploy,node_push_image,node_pull_deploy,node_direct_pull,node_ci_minikube toneAmber
class node_image,node_registry,node_runner toneMint
class node_helm_deploy,node_service,node_ingress,node_cluster_runtime,node_health_check toneRose
class node_developer toneIndigo
```

## Components

### Application

- [HTTP Server](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/app/src/server.js): `app/src/server.js`
- [Health Endpoint](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/app/src/server.js): `app/src/server.js`

### Automation

- [Runner Check](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/01-self-hosted-runner-check.yaml): `.github/workflows/01-self-hosted-runner-check.yaml`
- [Local Deploy](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/02-build-local-deploy-local.yml): `.github/workflows/02-build-local-deploy-local.yml`
- [Push Image](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/03-push-image-to-ghcr.yml): `.github/workflows/03-push-image-to-ghcr.yml`
- [Pull Deploy](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/04-pull-ghrc-image-deploy-local.yml): `.github/workflows/04-pull-ghrc-image-deploy-local.yml`
- [Cluster Pull](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/05-ghcr-image-directly-pulled-by-k8s.yml): `.github/workflows/05-ghcr-image-directly-pulled-by-k8s.yml`
- [CI Minikube Check](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/.github/workflows/06-minikube-check-in-ci-runner.yml): `.github/workflows/06-minikube-check-in-ci-runner.yml`

### Image Delivery

- [Container Image](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/app/dockerfile): `app/dockerfile`
- **GHCR**
- **Self-hosted Runner**

### Kubernetes

- [Helm Deployment](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/helm/tiny-app/templates/deployment.yml): `helm/tiny-app/templates/deployment.yml`
- [Kubernetes Service](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/helm/tiny-app/templates/service.yaml): `helm/tiny-app/templates/service.yaml`
- [Ingress](https://github.com/selvakuppusamy/tiny-infra-lab/blob/main/helm/tiny-app/templates/ingress.yml): `helm/tiny-app/templates/ingress.yml`
- **Minikube / Kubernetes**
- **Health Verification**

### Other components

- **Operator**

## Connections

- Operator → HTTP Server: requests (evidence: `README.md`)
- HTTP Server → Health Endpoint: routes (evidence: `app/src/server.js`)
- Health Endpoint → Health Verification: checks (evidence: `README.md`)
- Operator → Runner Check: runs (evidence: `README.md`)
- Operator → Local Deploy: runs (evidence: `README.md`)
- Operator → Push Image: runs (evidence: `README.md`)
- Operator → Pull Deploy: runs (evidence: `README.md`)
- Operator → Cluster Pull: runs (evidence: `README.md`)
- Operator → CI Minikube Check: runs (evidence: `README.md`)
- Local Deploy → Container Image: builds (evidence: `README.md`)
- Local Deploy → Helm Deployment: deploys (evidence: `README.md`)
- Push Image → GHCR: pushes (evidence: `README.md`)
- Push Image → Container Image: builds (evidence: `README.md`)
- Pull Deploy → GHCR: pulls (evidence: `README.md`)
- Pull Deploy → Helm Deployment: deploys (evidence: `README.md`)
- Cluster Pull → Helm Deployment: deploys (evidence: `README.md`)
- Cluster Pull → GHCR: pulls (evidence: `README.md`)
- Runner Check → Self-hosted Runner: checks (evidence: `README.md`)
- Local Deploy → Self-hosted Runner: runs on (evidence: `README.md`)
- Push Image → Self-hosted Runner: runs on (evidence: `README.md`)
- Pull Deploy → Self-hosted Runner: runs on (evidence: `README.md`)
- Helm Deployment → Minikube / Kubernetes: runs in (evidence: `README.md`)
- Kubernetes Service → Minikube / Kubernetes: exposes (evidence: `README.md`)
- Ingress → Kubernetes Service: routes to
- CI Minikube Check → Minikube / Kubernetes: starts (evidence: `README.md`)
- Health Verification → Minikube / Kubernetes: verifies (evidence: `README.md`)
- Operator → Health Verification: port-forwards (evidence: `README.md`)
