# iesgn/proyectoawx architecture

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

- Interactive diagram: https://gitdiagram.com/iesgn/proyectoawx
- Repository: https://github.com/iesgn/proyectoawx

## Overview

A continuación encontrarás una guía detallada para elaborar un diagrama de arquitectura/sistema que refleje con precisión el proyecto “proyectoawx”. He tenido en cuenta tu petición de “corregir para representar”, adaptando el paso a paso a la realidad del árbol de ficheros y el README que proporcionaste.

##### Identificación del tipo de proyecto y propósito
- Este proyecto es una solución de automatización de infraestructura y configuración basada en AWX (la GUI/API de Ansible Tower) desplegada con Docker-Compose.
- Sirve para crear y gestionar infraestructuras (OpenStack o similar), configurar servicios (Apache, DNS, Docker, MySQL) y desplegar sitios web mediante playbooks de Ansible orquestados desde AWX.

##### Análisis de la estructura de ficheros
- Top-level:
- awxcompose/ → Definición de contenedores AWX (docker-compose.yml, environment.sh, SECRET_KEY, credentials.py).
- playbooks/ → Playbooks de Ansible (create_servers.yml, config_servers.yml, delete_servers.yml, hosting.yml).
- inventories/, host_vars/ → Inventarios e variables de Ansible.
- roles/ → Roles de Ansible: infra (crea instancias), config (instala y configura software), hosting (configura servicios y despliega sitios). También incluye un esqueleto de rol y la dependencia geerlingguy.docker.
- awx-cli.bash y scripts auxiliares (variables para API, openrc.sh).
- Además: README, requeriments.txt (dependencias Python), licencias, ejemplos de vars.

##### Principales componentes a representar
1. **Entorno de desarrollo / usuario**
- Bash CLI (awx-cli.bash) + entorno virtual Python → Invoca la API de AWX para crear/lanza plantillas de trabajo (job templates).
2. **AWX Orquestador** (contenedores desplegados por docker-compose)
- Servicios: web (UI/API), tareas (runner), base de datos (PostgreSQL), broker (RabbitMQ/Redis).
3. **Repositorio Git**
- Código del proyecto (playbooks, roles, inventories) que AWX clona/pulling.
4. **Control de configuración**
- Inventories + host_vars + variables de plantilla (infra-vars.sh, config-vars.sh, hosting-vars.sh).
5. **Infraestructura destino**
- OpenStack (o proveedor de nube) + hosts/servidores recién creados.
- Servicios instalados/configurados: Apache, DNS (Bind), Docker, MySQL, despliegue de sitios web.

##### Relaciones e interacciones
- El **usuario** ejecuta `awx-cli.bash` apuntando a AWX_API (flecha → AWX).
- **AWX** (UI/API) orquesta jobs:
- Clona el **repositorio Git** con proyectos (playbooks/roles).
- Usa los **inventories** y **host_vars** para definir targets.
- Dispara los **playbooks** (infra → config → hosting) que ejecutan código en los **hosts**, a través de SSH.
- Los **roles** internas llaman a módulos de Ansible para interactuar con OpenStack (creación/eliminación de instancias) y luego configuran software.
- AWX almacena estado/job logs en la **base de datos** y/o broker.

##### Patrones arquitectónicos y principios
- **Separación de responsabilidades**:
- Infra → aprovisionamiento de instancias.
- Config → instalación y parametrización de servicios.
- Hosting → despliegue de sitios y reglas de firewall.
- **Infraestructura inmutable** vs **configuración idempotente** con Ansible.
- **Microservicios de orquestación**: contenedores Docker para cada componente AWX.
- **Infraestructura como Código**: todo versionado en Git.

##### Tecnologías clave
- AWX (Ansible Tower OSS)
- Docker-Compose
- Ansible (playbooks, roles, módulos OpenStack)
- Python (entorno virtual + AWX CLI)
- Git
- OpenStack (o similar)

##### Directrices para el diagrama
- Usa **rectángulos**/colores distintos para cada gran componente (Dev, AWX, Git, Infra destino).
- **Flechas direccionales** claras:
- Usuario → AWX_API
- AWX → Git (pull)
- AWX → Hosts (SSH playbooks)
- Añade **etiquetas**: “Job Template: create_servers”, “Role: infra”, etc.
- Usa **leyenda** para tecnologías (Docker, Ansible, OpenStack).

##### Consideraciones finales
- Sé lo más detallado posible en los componentes internos de AWX y cada fase de playbook.
- Refleja explícitamente la transición de “infra → config → hosting” para que se aprecie el workflow.
- No olvides marcar los ficheros de variables (infra-vars.sh, etc.) como inputs críticos.

Con esta guía tendrás todo lo necesario para dibujar un diagrama completo, claro y ajustado a la arquitectura del proyecto. ¡Éxito en la representación!

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Environment
    subgraph "Developer Environment" 
        DEV["Bash CLI + Python Env"]:::dev
    end

    %% AWX Orchestrator
    subgraph "AWX Orchestrator (Docker-Compose)" 
        API["AWX UI/API"]:::awx
        TASK["Task Runner"]:::awx
        DB["PostgreSQL DB"]:::awx
        BROKER["Broker (RabbitMQ/Redis)"]:::awx
    end

    %% Git Repository
    subgraph "Git Repository (Ansible Projects)" 
        PLAYBOOKS["Playbooks"]:::git
        ROLES["Roles"]:::git
    end

    %% Configuration Management
    subgraph "Configuration Management" 
        INVENTORY["Inventories & host_vars"]:::config
        VARS["Playbook Vars Templates"]:::config
    end

    %% Playbook Workflow
    subgraph "Playbook Workflow" 
        INFRA["Role: infra"]:::infra
        CONFIG["Role: config"]:::infra
        HOSTING["Role: hosting"]:::infra
    end

    %% Target Infrastructure
    TARGET["OpenStack / Cloud Hosts"]:::infra

    %% Connections
    DEV -->|"invoke awx-cli.bash"| API
    API -->|"orchestrates jobs"| TASK
    API -->|"stores logs"| DB
    TASK -->|"queues tasks"| BROKER
    API -->|"pulls code"| PLAYBOOKS
    API -->|"pulls code"| ROLES
    API -->|"reads inventories"| INVENTORY
    API -->|"reads playbook vars"| VARS
    PLAYBOOKS -->|"includes roles"| ROLES
    API -->|"executes infra playbook"| INFRA
    INFRA -->|"creates instances"| TARGET
    API -->|"executes config playbook"| CONFIG
    CONFIG -->|"configures services on"| TARGET
    API -->|"executes hosting playbook"| HOSTING
    HOSTING -->|"deploys sites on"| TARGET

    %% Click Events
    click DEV "https://github.com/iesgn/proyectoawx/blob/master/awx-cli.bash"
    click DEV "https://github.com/iesgn/proyectoawx/blob/master/openrc.sh"
    click DEV "https://github.com/iesgn/proyectoawx/blob/master/requeriments.txt"
    click API "https://github.com/iesgn/proyectoawx/blob/master/awxcompose/docker-compose.yml"
    click API "https://github.com/iesgn/proyectoawx/blob/master/awxcompose/environment.sh"
    click API "https://github.com/iesgn/proyectoawx/tree/master/awxcompose/SECRET_KEY"
    click API "https://github.com/iesgn/proyectoawx/blob/master/awxcompose/credentials.py"
    click PLAYBOOKS "https://github.com/iesgn/proyectoawx/blob/master/playbooks/create_servers.yml"
    click PLAYBOOKS "https://github.com/iesgn/proyectoawx/blob/master/playbooks/config_servers.yml"
    click PLAYBOOKS "https://github.com/iesgn/proyectoawx/blob/master/playbooks/delete_servers.yml"
    click PLAYBOOKS "https://github.com/iesgn/proyectoawx/blob/master/playbooks/hosting.yml"
    click PLAYBOOKS "https://github.com/iesgn/proyectoawx/tree/master/playbooks/host_vars/"
    click ROLES "https://github.com/iesgn/proyectoawx/tree/master/roles/infra/"
    click ROLES "https://github.com/iesgn/proyectoawx/tree/master/roles/config/"
    click ROLES "https://github.com/iesgn/proyectoawx/tree/master/roles/hosting/"
    click ROLES "https://github.com/iesgn/proyectoawx/tree/master/roles/geerlingguy.docker/"
    click INVENTORY "https://github.com/iesgn/proyectoawx/blob/master/inventories/local.yml"
    click INVENTORY "https://github.com/iesgn/proyectoawx/blob/master/host_vars/http_ports.yml"
    click INVENTORY "https://github.com/iesgn/proyectoawx/blob/master/host_vars/local/auth.yml"
    click INVENTORY "https://github.com/iesgn/proyectoawx/blob/master/host_vars/local/main.yml"
    click INVENTORY "https://github.com/iesgn/proyectoawx/blob/master/host_vars/local/servers.yml"

    %% Styles
    classDef dev fill:#f9f,stroke:#333,stroke-width:1px
    classDef awx fill:#bbf,stroke:#333,stroke-width:1px
    classDef git fill:#bfb,stroke:#333,stroke-width:1px
    classDef config fill:#ffb,stroke:#333,stroke-width:1px
    classDef infra fill:#fbf,stroke:#333,stroke-width:1px
```
