# elmir-ahmed/taskflow_devops architecture

> Architecture diagram of the GitHub repository elmir-ahmed/taskflow_devops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/elmir-ahmed/taskflow_devops
- Repository: https://github.com/elmir-ahmed/taskflow_devops

## Overview

This repository describes a local DevOps infrastructure lab: Docker provides three target servers, and Ansible configures them over SSH to run application, CI/CD, and monitoring services. The principal workflow is provisioning, inventory-based Ansible configuration, then Compose-managed services. The README also describes a future Git-triggered Jenkins pipeline; it explicitly cautions that this pipeline and effective metrics collection may not yet be configured. No source excerpts were provided, so relationships below rely on README statements only.

Main entry points: [`docker-compose.yml`](https://github.com/elmir-ahmed/taskflow_devops/blob/main/docker-compose.yml) (Target servers), [`ansible/playbooks/site.yml`](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/playbooks/site.yml) (Deployment playbooks), [`ansible/roles/app/templates/docker-compose.yml.j2`](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2) (App Compose template), [`ansible/roles/app/tasks/main.yml`](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/tasks/main.yml) (App configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["Provisioning"]
  node_base_image["Target image<br/>[Dockerfile.ubuntu]"]
  node_bootstrap["Container bootstrap<br/>[entrypoint.sh]"]
  node_target_hosts["Target servers<br/>[docker-compose.yml]"]
end

subgraph group_ansible["Ansible control"]
  node_inventory["Host inventory<br/>[inventory.ini]"]
  node_playbooks["Deployment playbooks<br/>[site.yml]"]
  node_app_role["App configuration<br/>[main.yml]"]
  node_cicd_role["CI/CD configuration<br/>[main.yml]"]
  node_monitoring_role["Monitoring configuration<br/>[main.yml]"]
  node_common_role["Common configuration<br/>[main.yml]"]
end

subgraph group_application["Application stack"]
  node_app_compose["App Compose template"]
  node_frontend["Frontend"]
  node_api["Backend API"]
  node_mysql[("MySQL")]
  node_phpmyadmin["phpMyAdmin"]
end

subgraph group_cicd["CI/CD stack"]
  node_cicd_compose["CI/CD Compose template"]
  node_jenkins["Jenkins"]
  node_sonarqube["SonarQube"]
end

subgraph group_monitoring["Monitoring stack"]
  node_monitoring_compose["Monitoring Compose template"]
  node_prometheus_config["Prometheus configuration<br/>[prometheus.yml.j2]"]
  node_prometheus["Prometheus"]
  node_grafana["Grafana"]
end

node_operator(("Operator"))
node_browser(("Browser user"))
node_git["Git repository"]

node_operator -->|"builds"| node_base_image
node_operator -->|"starts"| node_target_hosts
node_base_image -->|"builds"| node_target_hosts
node_bootstrap -->|"starts SSH"| node_target_hosts
node_operator -->|"runs"| node_playbooks
node_playbooks -->|"uses"| node_inventory
node_playbooks -->|"applies"| node_app_role
node_playbooks -->|"applies"| node_cicd_role
node_playbooks -->|"applies"| node_monitoring_role
node_app_role -->|"configures via SSH"| node_target_hosts
node_cicd_role -->|"configures via SSH"| node_target_hosts
node_monitoring_role -->|"configures via SSH"| node_target_hosts
node_common_role -->|"prepares hosts"| node_target_hosts
node_app_role -->|"renders"| node_app_compose
node_cicd_role -->|"renders"| node_cicd_compose
node_monitoring_role -->|"renders"| node_monitoring_compose
node_app_compose -->|"starts"| node_frontend
node_app_compose -->|"starts"| node_api
node_app_compose -->|"starts"| node_mysql
node_app_compose -->|"starts"| node_phpmyadmin
node_frontend -->|"calls"| node_api
node_api -->|"accesses"| node_mysql
node_cicd_compose -->|"starts"| node_jenkins
node_cicd_compose -->|"starts"| node_sonarqube
node_monitoring_compose -->|"starts"| node_prometheus
node_monitoring_compose -->|"starts"| node_grafana
node_prometheus_config -->|"configures"| node_prometheus
node_browser -->|"uses"| node_frontend
node_git -.->|"may trigger"| node_jenkins
node_jenkins -.->|"may analyze"| node_sonarqube
node_prometheus -->|"visualizes metrics"| node_grafana

click node_base_image "https://github.com/elmir-ahmed/taskflow_devops/blob/main/Dockerfile.ubuntu"
click node_bootstrap "https://github.com/elmir-ahmed/taskflow_devops/blob/main/entrypoint.sh"
click node_target_hosts "https://github.com/elmir-ahmed/taskflow_devops/blob/main/docker-compose.yml"
click node_inventory "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/inventory.ini"
click node_playbooks "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/playbooks/site.yml"
click node_app_role "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/tasks/main.yml"
click node_cicd_role "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/tasks/main.yml"
click node_monitoring_role "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/tasks/main.yml"
click node_common_role "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/common/tasks/main.yml"
click node_app_compose "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2"
click node_frontend "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2"
click node_api "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2"
click node_mysql "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2"
click node_phpmyadmin "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2"
click node_cicd_compose "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/templates/docker-compose.yml.j2"
click node_jenkins "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/templates/docker-compose.yml.j2"
click node_sonarqube "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/templates/docker-compose.yml.j2"
click node_monitoring_compose "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/docker-compose.yml.j2"
click node_prometheus_config "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/prometheus.yml.j2"
click node_prometheus "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/docker-compose.yml.j2"
click node_grafana "https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/docker-compose.yml.j2"

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_base_image,node_bootstrap,node_target_hosts,node_browser toneBlue
class node_inventory,node_playbooks,node_app_role,node_cicd_role,node_monitoring_role,node_common_role toneAmber
class node_app_compose,node_frontend,node_api,node_mysql,node_phpmyadmin toneMint
class node_cicd_compose,node_jenkins,node_sonarqube toneRose
class node_monitoring_compose,node_prometheus_config,node_prometheus,node_grafana,node_operator,node_git toneIndigo
```

## Components

### Provisioning

- [Target image](https://github.com/elmir-ahmed/taskflow_devops/blob/main/Dockerfile.ubuntu): `Dockerfile.ubuntu`
- [Container bootstrap](https://github.com/elmir-ahmed/taskflow_devops/blob/main/entrypoint.sh): `entrypoint.sh`
- [Target servers](https://github.com/elmir-ahmed/taskflow_devops/blob/main/docker-compose.yml): `docker-compose.yml`

### Ansible control

- [Host inventory](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/inventory.ini): `ansible/inventory.ini`
- [Deployment playbooks](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/playbooks/site.yml): `ansible/playbooks/site.yml`
- [App configuration](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/tasks/main.yml): `ansible/roles/app/tasks/main.yml`
- [CI/CD configuration](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/tasks/main.yml): `ansible/roles/cicd/tasks/main.yml`
- [Monitoring configuration](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/tasks/main.yml): `ansible/roles/monitoring/tasks/main.yml`
- [Common configuration](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/common/tasks/main.yml): `ansible/roles/common/tasks/main.yml`

### Application stack

- [App Compose template](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2): `ansible/roles/app/templates/docker-compose.yml.j2`
- [Frontend](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2): `ansible/roles/app/templates/docker-compose.yml.j2`
- [Backend API](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2): `ansible/roles/app/templates/docker-compose.yml.j2`
- [MySQL](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2): `ansible/roles/app/templates/docker-compose.yml.j2`
- [phpMyAdmin](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/app/templates/docker-compose.yml.j2): `ansible/roles/app/templates/docker-compose.yml.j2`

### CI/CD stack

- [CI/CD Compose template](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/templates/docker-compose.yml.j2): `ansible/roles/cicd/templates/docker-compose.yml.j2`
- [Jenkins](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/templates/docker-compose.yml.j2): `ansible/roles/cicd/templates/docker-compose.yml.j2`
- [SonarQube](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/cicd/templates/docker-compose.yml.j2): `ansible/roles/cicd/templates/docker-compose.yml.j2`

### Monitoring stack

- [Monitoring Compose template](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/docker-compose.yml.j2): `ansible/roles/monitoring/templates/docker-compose.yml.j2`
- [Prometheus configuration](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/prometheus.yml.j2): `ansible/roles/monitoring/templates/prometheus.yml.j2`
- [Prometheus](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/docker-compose.yml.j2): `ansible/roles/monitoring/templates/docker-compose.yml.j2`
- [Grafana](https://github.com/elmir-ahmed/taskflow_devops/blob/main/ansible/roles/monitoring/templates/docker-compose.yml.j2): `ansible/roles/monitoring/templates/docker-compose.yml.j2`

### Other components

- **Operator**
- **Browser user**
- **Git repository**

## Connections

- Operator → Target image: builds (evidence: `README.md`)
- Operator → Target servers: starts (evidence: `README.md`)
- Target image → Target servers: builds (evidence: `README.md`)
- Container bootstrap → Target servers: starts SSH (evidence: `README.md`)
- Operator → Deployment playbooks: runs (evidence: `README.md`)
- Deployment playbooks → Host inventory: uses (evidence: `README.md`)
- Deployment playbooks → App configuration: applies (evidence: `README.md`)
- Deployment playbooks → CI/CD configuration: applies (evidence: `README.md`)
- Deployment playbooks → Monitoring configuration: applies (evidence: `README.md`)
- App configuration → Target servers: configures via SSH (evidence: `README.md`)
- CI/CD configuration → Target servers: configures via SSH (evidence: `README.md`)
- Monitoring configuration → Target servers: configures via SSH (evidence: `README.md`)
- Common configuration → Target servers: prepares hosts (evidence: `README.md`)
- App configuration → App Compose template: renders (evidence: `README.md`)
- CI/CD configuration → CI/CD Compose template: renders (evidence: `README.md`)
- Monitoring configuration → Monitoring Compose template: renders (evidence: `README.md`)
- App Compose template → Frontend: starts (evidence: `README.md`)
- App Compose template → Backend API: starts (evidence: `README.md`)
- App Compose template → MySQL: starts (evidence: `README.md`)
- App Compose template → phpMyAdmin: starts (evidence: `README.md`)
- Frontend → Backend API: calls (evidence: `README.md`)
- Backend API → MySQL: accesses (evidence: `README.md`)
- CI/CD Compose template → Jenkins: starts (evidence: `README.md`)
- CI/CD Compose template → SonarQube: starts (evidence: `README.md`)
- Monitoring Compose template → Prometheus: starts (evidence: `README.md`)
- Monitoring Compose template → Grafana: starts (evidence: `README.md`)
- Prometheus configuration → Prometheus: configures (evidence: `README.md`)
- Browser user → Frontend: uses (evidence: `README.md`)
- Git repository → Jenkins: may trigger (evidence: `README.md`)
- Jenkins → SonarQube: may analyze (evidence: `README.md`)
- Prometheus → Grafana: visualizes metrics (evidence: `README.md`)
