# nickeoec/secnetdevops architecture

> Architecture diagram of the GitHub repository nickeoec/secnetdevops, 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/nickeoec/secnetdevops
- Repository: https://github.com/nickeoec/secnetdevops

## Overview

SecNetDevOps is an Ansible-based network-automation PoC for an emulated Cisco network. The principal workflow is an operator invoking a playbook on the control node, which uses the inventory and Ansible configuration to deploy network settings; separate playbooks support rollback, backups, telemetry, and a VLAN migration. The README also documents GitHub Actions validation and a reviewed-merge path to deployment. Source excerpts were unavailable, so relationships below are limited to those explicitly described in the README.

Main entry points: [`backup_red.yml`](https://github.com/nickeoec/secnetdevops/blob/main/backup_red.yml) (Configuration backup), [`deploy_network.yml`](https://github.com/nickeoec/secnetdevops/blob/main/deploy_network.yml) (Network deployment), [`rollback_network.yml`](https://github.com/nickeoec/secnetdevops/blob/main/rollback_network.yml) (Network rollback), [`deploy_telemetry.yml`](https://github.com/nickeoec/secnetdevops/blob/main/deploy_telemetry.yml) (Syslog telemetry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_automation["Network automation"]
  node_ansible["Ansible control"]
  node_inventory["Device inventory"]
  node_ansible_config["Ansible settings<br/>[ansible.cfg]"]
end

subgraph group_operations["Operational playbooks"]
  node_deploy["Network deployment<br/>[deploy_network.yml]"]
  node_rollback["Network rollback"]
  node_backup["Configuration backup<br/>[backup_red.yml]"]
  node_backup_files["Saved configurations"]
  node_telemetry["Syslog telemetry"]
  node_vlan_migration["VLAN migration<br/>[update_vlan11.yml]"]
  node_vlan_test["VLAN test artifact<br/>[update_vlan.yml]"]
end

subgraph group_governance["CI/CD governance"]
  node_github["GitHub"]
  node_actions["Actions validation<br/>[ansible-ci.yml]"]
  node_review["Pull request review"]
end

subgraph group_network["Managed environment"]
  node_network_devices{{"Cisco network"}}
  node_syslog_server["Syslog server"]
end

node_operator(("Operator"))

node_operator -->|"runs playbook"| node_ansible
node_ansible -->|"executes"| node_deploy
node_ansible -->|"executes"| node_rollback
node_ansible -->|"executes"| node_backup
node_ansible -->|"executes"| node_telemetry
node_ansible -->|"executes"| node_vlan_migration
node_ansible -->|"uses"| node_inventory
node_ansible -->|"uses"| node_ansible_config
node_deploy -->|"configures"| node_network_devices
node_rollback -->|"resets"| node_network_devices
node_backup -->|"extracts configs"| node_network_devices
node_backup -->|"backs up"| node_backup_files
node_telemetry -->|"configures syslog"| node_syslog_server
node_vlan_migration -->|"migrates VLAN"| node_network_devices
node_github -->|"runs validation"| node_actions
node_actions -->|"reports checks"| node_review
node_review -.->|"promotes merge"| node_ansible

click node_inventory "https://github.com/nickeoec/secnetdevops/blob/main/hosts"
click node_ansible_config "https://github.com/nickeoec/secnetdevops/blob/main/ansible.cfg"
click node_deploy "https://github.com/nickeoec/secnetdevops/blob/main/deploy_network.yml"
click node_rollback "https://github.com/nickeoec/secnetdevops/blob/main/rollback_network.yml"
click node_backup "https://github.com/nickeoec/secnetdevops/blob/main/backup_red.yml"
click node_backup_files "https://github.com/nickeoec/secnetdevops/tree/main/respaldos"
click node_telemetry "https://github.com/nickeoec/secnetdevops/blob/main/deploy_telemetry.yml"
click node_vlan_migration "https://github.com/nickeoec/secnetdevops/blob/main/update_vlan11.yml"
click node_vlan_test "https://github.com/nickeoec/secnetdevops/blob/main/update_vlan.yml"
click node_actions "https://github.com/nickeoec/secnetdevops/blob/main/.github/workflows/ansible-ci.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_ansible,node_inventory,node_ansible_config toneBlue
class node_deploy,node_rollback,node_backup,node_backup_files,node_telemetry,node_vlan_migration,node_vlan_test toneAmber
class node_github,node_actions,node_review toneMint
class node_network_devices,node_syslog_server toneRose
class node_operator toneIndigo
```

## Components

### Network automation

- **Ansible control**
- [Device inventory](https://github.com/nickeoec/secnetdevops/blob/main/hosts): `hosts`
- [Ansible settings](https://github.com/nickeoec/secnetdevops/blob/main/ansible.cfg): `ansible.cfg`

### Operational playbooks

- [Network deployment](https://github.com/nickeoec/secnetdevops/blob/main/deploy_network.yml): `deploy_network.yml`
- [Network rollback](https://github.com/nickeoec/secnetdevops/blob/main/rollback_network.yml): `rollback_network.yml`
- [Configuration backup](https://github.com/nickeoec/secnetdevops/blob/main/backup_red.yml): `backup_red.yml`
- [Saved configurations](https://github.com/nickeoec/secnetdevops/tree/main/respaldos): `respaldos`
- [Syslog telemetry](https://github.com/nickeoec/secnetdevops/blob/main/deploy_telemetry.yml): `deploy_telemetry.yml`
- [VLAN migration](https://github.com/nickeoec/secnetdevops/blob/main/update_vlan11.yml): `update_vlan11.yml`
- [VLAN test artifact](https://github.com/nickeoec/secnetdevops/blob/main/update_vlan.yml): `update_vlan.yml`

### CI/CD governance

- **GitHub**
- [Actions validation](https://github.com/nickeoec/secnetdevops/blob/main/.github/workflows/ansible-ci.yml): `.github/workflows/ansible-ci.yml`
- **Pull request review**

### Managed environment

- **Cisco network**
- **Syslog server**

### Other components

- **Operator**

## Connections

- Operator → Ansible control: runs playbook (evidence: `README.md`)
- Ansible control → Network deployment: executes (evidence: `README.md`)
- Ansible control → Network rollback: executes (evidence: `README.md`)
- Ansible control → Configuration backup: executes (evidence: `README.md`)
- Ansible control → Syslog telemetry: executes (evidence: `README.md`)
- Ansible control → VLAN migration: executes (evidence: `README.md`)
- Ansible control → Device inventory: uses (evidence: `README.md`)
- Ansible control → Ansible settings: uses (evidence: `README.md`)
- Network deployment → Cisco network: configures (evidence: `README.md`)
- Network rollback → Cisco network: resets (evidence: `README.md`)
- Configuration backup → Cisco network: extracts configs (evidence: `README.md`)
- Configuration backup → Saved configurations: backs up (evidence: `README.md`)
- Syslog telemetry → Syslog server: configures syslog (evidence: `README.md`)
- VLAN migration → Cisco network: migrates VLAN (evidence: `README.md`)
- GitHub → Actions validation: runs validation (evidence: `README.md`)
- Actions validation → Pull request review: reports checks (evidence: `README.md`)
- Pull request review → Ansible control: promotes merge (evidence: `README.md`)
