# kalel-ifpb/projeto-devops-com-vagrant-e-ansible architecture

> Architecture diagram of the GitHub repository kalel-ifpb/projeto-devops-com-vagrant-e-ansible, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible
- Repository: https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible

## Overview

This repository defines an IaC workflow for creating and configuring four Debian VMs. The documented entry point is `vagrant up`: Vagrant manages the VirtualBox machines, and Ansible provisions them in order, beginning with the file server that supplies DHCP and DNS. The graph preserves the documented ARQ, DB, APP, and CLI roles. Source excerpts were unavailable, so relationships are limited to those stated in the README; the Ansible inventory and configuration files are shown without inferred connections.

Main entry points: [`ansible/playbook.yml`](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml) (Provisioning playbook), [`Vagrantfile`](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/Vagrantfile) (Vagrant orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_provisioning["Provisioning"]
  node_vagrant["Vagrant orchestration"]
  node_ansible_config["Ansible settings<br/>[ansible.cfg]"]
  node_inventory["VM inventory<br/>[inventory.yml]"]
  node_playbook["Provisioning playbook<br/>[playbook.yml]"]
  node_host_dns["Host DNS configuration"]
end

subgraph group_network_storage["Network and Storage"]
  node_arq["ARQ file server<br/>[playbook.yml]"]
end

subgraph group_services["Application Services"]
  node_db[("DB database server<br/>[playbook.yml]")]
  node_app["APP web server<br/>[playbook.yml]"]
end

subgraph group_client["Client"]
  node_cli["CLI test client<br/>[playbook.yml]"]
end

node_operator(("Operator"))
node_virtualbox["VirtualBox"]

node_operator -->|"runs up"| node_vagrant
node_vagrant -->|"manages VMs"| node_virtualbox
node_vagrant -->|"provisions in order"| node_playbook
node_playbook -->|"configures first"| node_arq
node_playbook -->|"configures second"| node_db
node_playbook -->|"configures third"| node_app
node_playbook -->|"configures fourth"| node_cli
node_operator -->|"sets DNS"| node_host_dns

click node_vagrant "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/Vagrantfile"
click node_ansible_config "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/ansible.cfg"
click node_inventory "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/inventory.yml"
click node_playbook "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml"
click node_arq "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml"
click node_db "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml"
click node_app "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml"
click node_cli "https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml"

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_vagrant,node_ansible_config,node_inventory,node_playbook,node_host_dns toneBlue
class node_arq toneAmber
class node_db,node_app toneMint
class node_cli toneRose
class node_operator,node_virtualbox toneIndigo
```

## Components

### Provisioning

- [Vagrant orchestration](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/Vagrantfile): `Vagrantfile`
- [Ansible settings](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/ansible.cfg): `ansible/ansible.cfg`
- [VM inventory](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/inventory.yml): `ansible/inventory.yml`
- [Provisioning playbook](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml): `ansible/playbook.yml`
- **Host DNS configuration**

### Network and Storage

- [ARQ file server](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml): `ansible/playbook.yml`

### Application Services

- [DB database server](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml): `ansible/playbook.yml`
- [APP web server](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml): `ansible/playbook.yml`

### Client

- [CLI test client](https://github.com/kalel-ifpb/projeto-devops-com-vagrant-e-ansible/blob/main/ansible/playbook.yml): `ansible/playbook.yml`

### Other components

- **Operator**
- **VirtualBox**

## Connections

- Operator → Vagrant orchestration: runs up (evidence: `README.md`)
- Vagrant orchestration → VirtualBox: manages VMs (evidence: `README.md`)
- Vagrant orchestration → Provisioning playbook: provisions in order (evidence: `README.md`)
- Provisioning playbook → ARQ file server: configures first (evidence: `README.md`)
- Provisioning playbook → DB database server: configures second (evidence: `README.md`)
- Provisioning playbook → APP web server: configures third (evidence: `README.md`)
- Provisioning playbook → CLI test client: configures fourth (evidence: `README.md`)
- Operator → Host DNS configuration: sets DNS (evidence: `README.md`)
