# iesgn/tdd-jenkins-kitchen-dond architecture

> Architecture diagram of the GitHub repository iesgn/tdd-jenkins-kitchen-dond, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iesgn/tdd-jenkins-kitchen-dond
- Repository: https://github.com/iesgn/tdd-jenkins-kitchen-dond

## Overview

##### Project type and purpose
- This is not a typical web app but a container-based CI/CD toolchain for infrastructure automation.
- It bundles Jenkins, Test Kitchen (with Ansible, Inspec), Cookiecutter templates and Docker-on-Docker to build and test infrastructure code in ephemeral containers.

##### High-level component analysis
Top-level files:
- Dockerfile + docker-compose.yml → define a single “Jenkins + Kitchen” container, mounting host Docker socket.
- assets/bin/entrypoint.sh & plugins.txt → bootstrap Jenkins (install plugins, configure jobs).
- volumes/jenkins → persistent Jenkins home and job definitions.
- kitchen-docker-*.gem → custom Test Kitchen Docker driver inside the container.
- requirements.txt → Python deps for cookiecutter templating.

##### Key README insights
- The container image includes Jenkins, Ruby (Test Kitchen & custom gem), Python (cookiecutter), Ansible, Inspec.
- Workflow: developers generate infra-test projects via Cookiecutter → Jenkins jobs invoke kitchen commands → kitchen driver spins up Docker containers → Ansible provisions → Inspec/Serverspec run tests → containers are destroyed.
- The host Docker daemon is shared (mounted socket) to allow kitchen to launch nested containers.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External actors
    Developer["Developer"]:::external
    GitRepo["Git Repository"]:::external

    %% Host services
    HostDocker["Host Machine\nDocker Engine"]:::host

    %% Persistent volumes
    subgraph "Persistent Volumes"
        direction TB
        JenkinsVolume["/volumes/jenkins\n(Jenkins Home & Jobs)"]:::volume
        ProjectsVolume["/volumes/projects\n(Cookiecutter Output)"]:::volume
    end

    %% Ephemeral Test Containers
    Ephemeral["Ephemeral Kitchen Test Containers"]:::container

    %% Future services
    DockerHub["Docker Hub / Registry"]:::future

    %% Jenkins + Test Kitchen Container
    subgraph "Jenkins + Test Kitchen Container" 
        direction TB
        Jenkins["Jenkins Master\n(Web UI, Scheduler)"]:::container
        TestKitchen["Test Kitchen\n(Ruby + custom gem)"]:::container
        Ansible["Ansible & Inspec"]:::container
        Cookiecutter["Python & Cookiecutter"]:::container
        ContainerDef["Dockerfile"]:::container
        ComposeCfg["docker-compose.yml"]:::container
        Entrypoint["entrypoint.sh"]:::container
        EntrypointFn["entrypoint.functions"]:::container
        PluginsList["plugins.txt"]:::container
        KitchenGem["kitchen-docker-2.6.1.pre.gem"]:::container
        Requirements["requirements.txt"]:::container
        KitchenConfig["config.xml.tpl"]:::container
    end

    %% Connections
    Developer -->|push infra code| GitRepo
    GitRepo -->|webhook triggers| Jenkins
    Jenkins -->|generate projects| Cookiecutter
    Cookiecutter -->|writes to| ProjectsVolume
    Jenkins -->|invoke kitchen commands| HostDocker
    HostDocker -->|spawns containers| Ephemeral
    Ansible -->|provisions| Ephemeral
    Ansible -->|runs tests| Ephemeral
    Jenkins -->|future build image| HostDocker
    Jenkins -->|push tagged images| DockerHub

    %% Build assets to container
    ContainerDef --> Jenkins
    ComposeCfg --> Jenkins
    Entrypoint --> Jenkins
    EntrypointFn --> Jenkins
    PluginsList --> Jenkins
    KitchenGem --> TestKitchen
    Requirements --> Cookiecutter
    KitchenConfig --> JenkinsVolume

    %% Click Events
    click ContainerDef "https://github.com/iesgn/tdd-jenkins-kitchen-dond/tree/master/Dockerfile"
    click ComposeCfg "https://github.com/iesgn/tdd-jenkins-kitchen-dond/blob/master/docker-compose.yml"
    click Entrypoint "https://github.com/iesgn/tdd-jenkins-kitchen-dond/blob/master/assets/bin/entrypoint.sh"
    click EntrypointFn "https://github.com/iesgn/tdd-jenkins-kitchen-dond/blob/master/assets/bin/entrypoint.functions"
    click PluginsList "https://github.com/iesgn/tdd-jenkins-kitchen-dond/blob/master/assets/plugins/plugins.txt"
    click JenkinsVolume "https://github.com/iesgn/tdd-jenkins-kitchen-dond/tree/master/volumes/jenkins"
    click KitchenConfig "https://github.com/iesgn/tdd-jenkins-kitchen-dond/blob/master/volumes/jenkins/jobs/kitchen/config.xml.tpl"
    click KitchenGem "https://github.com/iesgn/tdd-jenkins-kitchen-dond/blob/master/kitchen-docker-2.6.1.pre.gem"
    click Requirements "https://github.com/iesgn/tdd-jenkins-kitchen-dond/blob/master/requirements.txt"

    %% Styles
    classDef external fill:#dddddd,stroke:#333,stroke-width:1px
    classDef host fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef container fill:#FFA500,stroke:#333,stroke-width:1px
    classDef volume fill:#90EE90,stroke:#333,stroke-width:1px
    classDef future fill:#E0E0E0,stroke:#333,stroke-width:1px
```
