# aqibkhan-qa/podman-labs architecture

> Architecture diagram of the GitHub repository aqibkhan-qa/podman-labs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aqibkhan-qa/podman-labs
- Repository: https://github.com/aqibkhan-qa/podman-labs

## Overview

##### Project type and purpose
- This is not a runnable application but a set of hands-on labs (“Podman-Labs”) teaching Podman image building, rootless containers on OpenShift (OCP), and statefulset deployments.
- The four Markdown files break the content into three focused labs plus a README that introduces the Podman-Labs collection.

##### File structure
- Top level:
- Bootc-Images.md – lab on bootable/container images
- rootless-image-for-ocp.md – lab on creating rootless images suited for OCP
- statefulset-deployment-and-configuration.md – lab on running stateful workloads in OCP using StatefulSets
- README.md – high-level project title (“Podman-Labs”)
- No code directories; these are purely instructional docs.

##### Extract additional insights from README
- README simply names the repo “Podman-Labs.”
- Implicit goal: demonstrates end-to-end flows: build images → push to registry → deploy to OCP with proper configuration.

##### Detailed architecture capture
- For each lab, annotate the exact commands or references to the Markdown file sections.
- Don’t shy from multiple small components: e.g., split OCP cluster into API server, scheduler, kubelet, CSI driver.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Documentation"
        Overview["Podman-Labs Overview"]:::workflow
        BootLab["Bootable Images Lab"]:::workflow
        RootlessLab["Rootless Images Lab"]:::workflow
        StatefulLab["StatefulSet Deployment Lab"]:::workflow
    end

    subgraph "Developer Host"
        Developer["Developer Workstation"]:::workflow
        PodmanRootful["Podman Engine (rootful)"]:::security_rootful
        PodmanRootless["Podman Engine (rootless)"]:::security_rootless
        BuildTools["Buildah/Podman Build"]:::workflow
    end

    subgraph "Container Registry"
        Registry["Container Registry"]:::workflow
    end

    subgraph "OpenShift Cluster"
        API["API Server"]:::workflow
        Scheduler["Scheduler"]:::workflow
        Controller["StatefulSet Controller"]:::workflow
        Kubelet["Kubelet + CSI Driver"]:::workflow
        PVC["PersistentVolumeClaim"]:::storage
        PV["PersistentVolume"]:::storage
    end

    Overview --> Developer
    BootLab --> Developer
    RootlessLab --> Developer
    StatefulLab --> Developer

    Developer --> PodmanRootful
    Developer --> PodmanRootless
    PodmanRootful -->|"podman build"| BuildTools
    PodmanRootless -->|"podman build --rootless"| BuildTools
    BuildTools -->|"push image"| Registry
    Registry -->|"pull image"| Kubelet
    API -->|"schedule pods"| Scheduler
    Scheduler -->|"bind pods"| Kubelet
    API -->|"run controller"| Controller
    Controller -->|"create pods"| Kubelet
    PVC -->|"claim volume"| PV
    Kubelet -->|"mount volume"| PV

    click Overview "https://github.com/aqibkhan-qa/podman-labs/blob/main/README.md"
    click BootLab "https://github.com/aqibkhan-qa/podman-labs/blob/main/Bootc-Images.md"
    click RootlessLab "https://github.com/aqibkhan-qa/podman-labs/blob/main/rootless-image-for-ocp.md"
    click StatefulLab "https://github.com/aqibkhan-qa/podman-labs/blob/main/statefulset-deployment-and-configuration.md"

    classDef workflow fill:#DCEEFB,stroke:#0366D6,color:#0366D6
    classDef security_rootful fill:#FEE2E2,stroke:#B91C1C,color:#B91C1C
    classDef security_rootless fill:#ECFDF5,stroke:#15803D,color:#15803D
    classDef storage fill:#FFEDD5,stroke:#C2410C,color:#C2410C
```
