# eazytraining/ansible-training architecture

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

- Interactive diagram: https://gitdiagram.com/eazytraining/ansible-training
- Repository: https://github.com/eazytraining/ansible-training

## Overview

##### Project type and purpose
- This is not a web‐app or microservice suite but a **training repository** for “Ansible Pour DevOps” exercises.
- It contains two parallel tracks:
- TPs-eazylab – labs run against real/cloud hosts (AWS, AWX)
- TPs-vagrant – the same labs but run in a local Vagrant environment
- Each “TP” directory is a self-contained Ansible project illustrating a concept (ad-hoc commands, inventories, roles, templates, Vault, AWX, etc.).

##### File‐structure analysis
- Top level:
- README.md – course title
- TPs-eazylab/ – lab projects against real or cloud VMs
- TPs-vagrant/ – lab projects on Vagrant VMs
- Under each TP directory (0 through 10, plus mini-projet):
- ansible.cfg – project configuration
- hosts*.yml or hosts.ini – static inventory
- group_vars, host_vars – variable definitions
- deploy*.yml – playbooks (sometimes multiple versions)
- roles or webapp subdirs – templating, tasks, defaults, files, vault secrets
- Special labs:
- TP10 integrates AWS dynamic inventory and cloud-provisioning
- TP9 uses AWX/Tower as a scheduler/UI
- mini-projet demonstrates a complete role with tests

##### Key README insights
- The labs themselves (corrige.md, note.md) often comment on pitfalls and best practices.

##### Detail but keep it high-level
- Don’t overcrowd with every file—group by category (inventories, playbooks, roles)
- One representative “TP” project and annotate that all numbered TPs follow the same pattern
- Call out the mini-projet role structure in a sidebar to illustrate best-practice role anatomy

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Control Plane
    subgraph "Control Plane"
        CP_Config_TP10["ansible.cfg (TP10 eazylab)"]:::artifact
        CP_Config_TP9["ansible.cfg (TP9 AWX)"]:::artifact
        CP_Config_Mini["ansible.cfg (mini-projet)"]:::artifact
    end

    %% Inventories
    subgraph "Inventories"
        Static_TP5["hosts.yml (TP5)"]:::hosts
        Static_TP4["hosts.ini (TP4)"]:::hosts
        Dyn_TP10["AWS Dynamic Inventory"]:::external
    end

    %% Vault
    Vault["Vault Secrets"]:::external

    %% Playbooks
    subgraph "Playbooks"
        Deploy_TP5["deploy_v1.yml (TP5)"]:::artifact
        Deploy_TP9["deploy.yml (TP9 AWX)"]:::artifact
        Deploy_Mini["deploy-app.yml (mini-projet)"]:::artifact
    end

    %% Roles & Templates
    subgraph "Roles & Templates"
        Role_Mini["basic-apache-container Role"]:::artifact
        Template_Mini["index.html.j2"]:::artifact
    end

    %% Execution Engine
    Ansible_Core["Ansible Core (SSH Execution)"]:::execution

    %% AWX/Tower
    AWX_UI["AWX/Tower UI & API"]:::external

    %% Managed Nodes
    subgraph "Managed Nodes"
        Cloud["AWS Instances"]:::hosts
        Vagrant["Vagrant VMs"]:::hosts
    end

    %% Flows
    CP_Config_TP10 -->|"reads cfg"| Static_TP5
    CP_Config_TP10 -->|"reads cfg"| Static_TP4
    CP_Config_TP10 -->|"reads cfg"| Dyn_TP10
    CP_Config_TP9 -->|"reads cfg"| Static_TP5
    CP_Config_Mini -->|"reads cfg"| Static_TP5

    Static_TP5 -->|"provide hosts"| Ansible_Core
    Static_TP4 -->|"provide hosts"| Ansible_Core
    Dyn_TP10 -->|"dynamic hosts"| Ansible_Core

    CP_Config_TP7 -.->|"decrypts"| Vault
    Vault -.->|"secrets"| Ansible_Core

    Ansible_Core -->|"executes"| Deploy_TP5
    Ansible_Core -->|"executes"| Deploy_TP9
    Ansible_Core -->|"executes"| Deploy_Mini

    Deploy_Mini -->|"calls"| Role_Mini
    Role_Mini -->|"uses template"| Template_Mini

    Ansible_Core -->|"SSH"| Cloud
    Ansible_Core -->|"SSH"| Vagrant

    AWX_UI -->|"triggers"| CP_Config_TP9
    AWX_UI -->|"schedules"| Deploy_TP9

    %% Click Events
    click CP_Config_TP10 "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP10- Ansible & AWS/ansible.cfg"
    click CP_Config_TP9 "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP9 - TOWER ou AWX/ansible.cfg"
    click CP_Config_Mini "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/mini-projet/ansible.cfg"
    click Static_TP5 "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP5 - Déployez un conteneur apache/webapp/hosts.yml"
    click Static_TP4 "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP4 - Inventaire et Variables/hosts.ini"
    click Dyn_TP10 "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP10- Ansible & AWS/deploy.yml"
    click Deploy_TP5 "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP5 - Déployez un conteneur apache/webapp/deploy_v1.yml"
    click Deploy_TP9 "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP9 - TOWER ou AWX/deploy.yml"
    click Deploy_Mini "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/mini-projet/deploy-app.yml"
    click Role_Mini "https://github.com/eazytraining/ansible-training/tree/main/TPs-eazylab/mini-projet/roles/basic-apache-container/"
    click Template_Mini "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/mini-projet/roles/basic-apache-container/templates/index.html.j2"
    click Vault "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP7 - Key pair et vault/vault/webapp/files/secrets/credentials.vault"
    click AWX_UI "https://github.com/eazytraining/ansible-training/blob/main/TPs-eazylab/TP9 - TOWER ou AWX/note.md"

    %% Styles
    classDef artifact fill:#cfe2f3,stroke:#0366d6,color:#000;
    classDef hosts fill:#d9ead3,stroke:#38761d,color:#000;
    classDef external fill:#fce5cd,stroke:#e69138,color:#000;
    classDef execution fill:#ffe599,stroke:#bf9000,color:#000;
```
