├── hosts.json
├── start.bat
├── health_report.j2
├── security_report.j2
├── DIRECTORY_STRUCTURE.md
├── .github
    └── copilot-instructions.md
├── requirements.yml
├── screenshoot
    ├── about.png
    ├── execute.png
    ├── Dashboard.png
    └── Live Execution Output.png
├── __pycache__
    └── server.cpython-313.pyc
├── playbooks
    ├── test-unixy-minimal.yml
    ├── updateOS.yml
    ├── health_report.j2
    ├── security_report.j2
    ├── ceph-management.yml
    └── monitoring.yml
├── launch.json
├── .vscode
    └── launch.json
├── ansible-admin.service
├── .gitignore
├── wiki
    ├── _Footer.md
    ├── _Sidebar.md
    ├── Home.md
    ├── Installation.md
    ├── Basic-Usage.md
    ├── Configuration.md
    ├── Troubleshooting.md
    ├── API-Reference.md
    ├── FAQ.md
    └── Contributing.md
├── backup
    └── updateos-debianfam.yaml
├── ansible.cfg
├── install-service.sh
├── inventory.ini
├── SERVICE-README.md
├── CHANGELOG.md
├── datastore
    └── hosts.json
├── service-manager.sh
├── README.md
├── test_history.html
├── dashboard.html
├── updateOS.html
└── usage.html


/hosts.json:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/start.bat:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/health_report.j2:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/security_report.j2:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/DIRECTORY_STRUCTURE.md:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/.github/copilot-instructions.md:
--------------------------------------------------------------------------------
1 | 


--------------------------------------------------------------------------------
/requirements.yml:
--------------------------------------------------------------------------------
1 | ---
2 | collections:
3 |   - name: community.general
4 |     version: ">=8.0.0"
5 | 


--------------------------------------------------------------------------------
/screenshoot/about.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dionipe/ansible-admin/HEAD/screenshoot/about.png


--------------------------------------------------------------------------------
/screenshoot/execute.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dionipe/ansible-admin/HEAD/screenshoot/execute.png


--------------------------------------------------------------------------------
/screenshoot/Dashboard.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dionipe/ansible-admin/HEAD/screenshoot/Dashboard.png


--------------------------------------------------------------------------------
/__pycache__/server.cpython-313.pyc:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dionipe/ansible-admin/HEAD/__pycache__/server.cpython-313.pyc


--------------------------------------------------------------------------------
/screenshoot/Live Execution Output.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/dionipe/ansible-admin/HEAD/screenshoot/Live Execution Output.png


--------------------------------------------------------------------------------
/playbooks/test-unixy-minimal.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | - name: Test Unixy Callback - Minimal
 3 |   hosts: localhost
 4 |   connection: local
 5 |   gather_facts: false
 6 | 
 7 |   tasks:
 8 |     - name: Simple debug message
 9 |       debug:
10 |         msg: "Testing unixy callback output"
11 | 
12 |     - name: Another simple task
13 |       debug:
14 |         msg: "This should show condensed output"
15 | 


--------------------------------------------------------------------------------
/launch.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "version": "0.2.0",
 3 |     "configurations": [
 4 |         {
 5 |             "name": "Python: Run server.py",
 6 |             "type": "python",
 7 |             "request": "launch",
 8 |             "program": "${workspaceFolder}/server.py",
 9 |             "console": "integratedTerminal",
10 |             "preLaunchTask": "kill_and_wait"
11 |         }
12 |     ],
13 |     "tasks": [
14 |         {
15 |             "label": "kill_and_wait",
16 |             "type": "shell",
17 |             "command": "pkill -f 'python3 server.py' || true && sleep 1"
18 |         }
19 |     ]
20 | }
21 | 


--------------------------------------------------------------------------------
/.vscode/launch.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "version": "0.2.0",
 3 |     "configurations": [
 4 |         {
 5 |             "name": "Python: Run server.py",
 6 |             "type": "python",
 7 |             "request": "launch",
 8 |             "program": "${workspaceFolder}/server.py",
 9 |             "console": "integratedTerminal",
10 |             "preLaunchTask": "kill_and_wait"
11 |         }
12 |     ],
13 |     "tasks": [
14 |         {
15 |             "label": "kill_and_wait",
16 |             "type": "shell",
17 |             "command": "pkill -f 'python3 server.py' || true && sleep 1"
18 |         }
19 |     ]
20 | }
21 | 


--------------------------------------------------------------------------------
/ansible-admin.service:
--------------------------------------------------------------------------------
 1 | [Unit]
 2 | Description=Ansible Admin Dashboard Server
 3 | After=network.target
 4 | Wants=network.target
 5 | 
 6 | [Service]
 7 | Type=simple
 8 | User=dionipe
 9 | Group=dionipe
10 | WorkingDirectory=/home/dionipe/ansible-admin
11 | ExecStart=/usr/bin/python3 /home/dionipe/ansible-admin/server.py
12 | Restart=always
13 | RestartSec=5
14 | StandardOutput=journal
15 | StandardError=journal
16 | SyslogIdentifier=ansible-admin
17 | 
18 | # Security settings
19 | NoNewPrivileges=yes
20 | PrivateTmp=yes
21 | ProtectSystem=strict
22 | ReadWritePaths=/home/dionipe/ansible-admin
23 | ProtectHome=no
24 | 
25 | [Install]
26 | WantedBy=multi-user.target
27 | 


--------------------------------------------------------------------------------
/playbooks/updateOS.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | # Update Operating System packages
 3 | # Comprehensive OS update playbook for Debian/Ubuntu systems
 4 | 
 5 | - name: Update Operating System
 6 |   hosts: all
 7 |   become: yes
 8 | 
 9 |   tasks:
10 |     - name: Update package cache
11 |       apt:
12 |         update_cache: yes
13 |       when: ansible_os_family == "Debian"
14 | 
15 |     - name: Upgrade all packages
16 |       apt:
17 |         upgrade: dist
18 |         autoremove: yes
19 |         autoclean: yes
20 |       when: ansible_os_family == "Debian"
21 | 
22 |     - name: Update package cache (RedHat)
23 |       yum:
24 |         name: '*'
25 |         state: latest
26 |       when: ansible_os_family == "RedHat"
27 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 2 | 
 3 | # dependencies
 4 | /node_modules
 5 | /.pnp
 6 | .pnp.*
 7 | .yarn/*
 8 | !.yarn/patches
 9 | !.yarn/plugins
10 | !.yarn/releases
11 | !.yarn/versions
12 | 
13 | # testing
14 | /coverage
15 | 
16 | # next.js
17 | /.next/
18 | /out/
19 | 
20 | # production
21 | /build
22 | 
23 | # misc
24 | .DS_Store
25 | *.pem
26 | 
27 | # debug
28 | npm-debug.log*
29 | yarn-debug.log*
30 | yarn-error.log*
31 | .pnpm-debug.log*
32 | 
33 | # env files (can opt-in for committing if needed)
34 | .env*
35 | 
36 | # vercel
37 | .vercel
38 | 
39 | # typescript
40 | *.tsbuildinfo
41 | next-env.d.ts
42 | 
43 | # Ansible Admin data
44 | data/
45 | 


--------------------------------------------------------------------------------
/wiki/_Footer.md:
--------------------------------------------------------------------------------
 1 | # Footer
 2 | 
 3 | ---
 4 | 
 5 | ## Ansible Admin
 6 | 
 7 | **Version:** 2.0.0 | **Released:** September 8, 2025
 8 | 
 9 | A modern web-based interface for managing and executing Ansible playbooks with real-time monitoring and live execution output.
10 | 
11 | ### Quick Links
12 | - [🏠 Home](https://github.com/dionipe/ansible-admin)
13 | - [📖 Documentation](https://github.com/dionipe/ansible-admin/wiki)
14 | - [🐛 Report Issues](https://github.com/dionipe/ansible-admin/issues)
15 | - [💬 Discussions](https://github.com/dionipe/ansible-admin/discussions)
16 | 
17 | ### Technologies
18 | - **Backend:** Python HTTP Server
19 | - **Frontend:** HTML, CSS, JavaScript
20 | - **Automation:** Ansible
21 | - **UI Framework:** Bootstrap 5
22 | - **Icons:** Font Awesome
23 | 
24 | ### License
25 | This project is licensed under the [MIT License](https://opensource.org/licenses/MIT).
26 | 
27 | ### Support
28 | Need help? Check our [[FAQ]] or [[create an issue|https://github.com/dionipe/ansible-admin/issues/new]].
29 | 
30 | ---
31 | 
32 | *Made with ❤️ by the Ansible Admin team*</content>
33 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/_Footer.md
34 | 


--------------------------------------------------------------------------------
/playbooks/health_report.j2:
--------------------------------------------------------------------------------
 1 | System Health Report for {{ ansible_hostname }}
 2 | Generated on: {{ ansible_date_time.iso8601 }}
 3 | 
 4 | === SYSTEM INFORMATION ===
 5 | Hostname: {{ ansible_hostname }}
 6 | OS: {{ ansible_distribution }} {{ ansible_distribution_version }}
 7 | Kernel: {{ ansible_kernel }}
 8 | Architecture: {{ ansible_architecture }}
 9 | Uptime: {{ system_load.stdout | default('N/A') }}
10 | 
11 | === HARDWARE INFORMATION ===
12 | CPU Cores: {{ ansible_processor_cores }}
13 | Memory Total: {{ ansible_memtotal_mb }} MB
14 | Memory Free: {{ ansible_memory_mb.free | default(ansible_memory_mb.nofree | default('N/A')) }} MB
15 | 
16 | === DISK USAGE ===
17 | {{ disk_usage.stdout | default('N/A') }}
18 | 
19 | === MEMORY INFORMATION ===
20 | {{ memory_info.stdout | default('N/A') }}
21 | 
22 | === NETWORK INTERFACES ===
23 | {% for interface in ansible_interfaces %}
24 | {% if interface != 'lo' %}
25 | {{ interface }}: {{ hostvars[inventory_hostname]['ansible_' + interface] | default('N/A') }}
26 | {% endif %}
27 | {% endfor %}
28 | 
29 | === RUNNING SERVICES ===
30 | {{ running_services.stdout | default('N/A') }}
31 | 
32 | Report generated by Ansible Admin Dashboard
33 | 


--------------------------------------------------------------------------------
/playbooks/security_report.j2:
--------------------------------------------------------------------------------
 1 | Security Audit Report for {{ ansible_hostname }}
 2 | Generated on: {{ ansible_date_time.iso8601 }}
 3 | 
 4 | === SECURITY SUMMARY ===
 5 | Hostname: {{ ansible_hostname }}
 6 | OS: {{ ansible_distribution }} {{ ansible_distribution_version }}
 7 | 
 8 | === SECURITY UPDATES ===
 9 | Available security updates: {{ security_updates.stdout | default('0') }}
10 | 
11 | === SSH CONFIGURATION ===
12 | {{ ssh_config.stdout | default('N/A') }}
13 | 
14 | === USER ACCOUNTS ===
15 | Regular user accounts:
16 | {{ user_accounts.stdout | default('N/A') }}
17 | 
18 | === NETWORK SECURITY ===
19 | Firewall Status:
20 | {{ firewall_status.stdout | default('N/A') }}
21 | 
22 | DNS Resolution:
23 | {{ dns_check.stdout | default('N/A') }}
24 | 
25 | Internet Connectivity:
26 | {{ internet_check.stdout | default('N/A') }}
27 | 
28 | === RECOMMENDATIONS ===
29 | {% if (security_updates.stdout | int) > 0 %}
30 | - Apply available security updates
31 | {% endif %}
32 | {% if 'PermitRootLogin yes' in ssh_config.stdout %}
33 | - Consider disabling root SSH login
34 | {% endif %}
35 | {% if 'PasswordAuthentication yes' in ssh_config.stdout %}
36 | - Consider using key-based authentication only
37 | {% endif %}
38 | 
39 | Report generated by Ansible Admin Dashboard
40 | 


--------------------------------------------------------------------------------
/wiki/_Sidebar.md:
--------------------------------------------------------------------------------
 1 | # Sidebar
 2 | 
 3 | ## Ansible Admin Wiki
 4 | 
 5 | ### Getting Started
 6 | - [[Home]]
 7 | - [[Installation]]
 8 | - [[Configuration]]
 9 | - [[Basic Usage]]
10 | 
11 | ### User Guides
12 | - [[Dashboard]]
13 | - [[Playbooks]]
14 | - [[Inventory]]
15 | - [[Execution]]
16 | - [[History]]
17 | - [[OS Updates]]
18 | 
19 | ### Advanced Topics
20 | - [[API Reference]]
21 | - [[Templates]]
22 | - [[Security]]
23 | - [[Troubleshooting]]
24 | 
25 | ### Development
26 | - [[Contributing]]
27 | - [[Development Setup]]
28 | - [[Architecture]]
29 | 
30 | ### Support
31 | - [[FAQ]]
32 | - [[Troubleshooting]]
33 | 
34 | ---
35 | 
36 | ## Quick Links
37 | - [GitHub Repository](https://github.com/dionipe/ansible-admin)
38 | - [Issues](https://github.com/dionipe/ansible-admin/issues)
39 | - [Discussions](https://github.com/dionipe/ansible-admin/discussions)
40 | - [Releases](https://github.com/dionipe/ansible-admin/releases)
41 | 
42 | ## External Links
43 | - [Ansible Documentation](https://docs.ansible.com/)
44 | - [Python Documentation](https://docs.python.org/3/)
45 | - [Bootstrap Documentation](https://getbootstrap.com/docs/)
46 | 
47 | ---
48 | 
49 | *Last updated: September 8, 2025*</content>
50 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/_Sidebar.md
51 | 


--------------------------------------------------------------------------------
/backup/updateos-debianfam.yaml:
--------------------------------------------------------------------------------
 1 | ---
 2 | - name: Update Operating System
 3 |   hosts: all
 4 |   become: yes
 5 |   tasks:
 6 |     - name: Update package cache
 7 |       package:
 8 |         update_cache: yes
 9 |       when: ansible_os_family == 'Debian' or ansible_os_family == 'Ubuntu'
10 | 
11 |     - name: Update all packages
12 |       package:
13 |         name: "*"
14 |         state: latest
15 |       when: ansible_os_family == 'Debian' or ansible_os_family == 'Ubuntu'
16 | 
17 |     - name: Update package cache (RedHat/CentOS)
18 |       yum:
19 |         name: "*"
20 |         state: latest
21 |       when: ansible_os_family == 'RedHat'
22 | 
23 |     - name: Update package cache (Fedora)
24 |       dnf:
25 |         name: "*"
26 |         state: latest
27 |       when: ansible_os_family == 'Fedora'
28 | 
29 |     - name: Clean package cache
30 |       command: apt-get autoremove -y
31 |       when: ansible_os_family == 'Debian' or ansible_os_family == 'Ubuntu'
32 | 
33 |     - name: Reboot if required
34 |       reboot:
35 |         msg: "Rebooting after system update"
36 |         connect_timeout: 5
37 |         reboot_timeout: 300
38 |         pre_reboot_delay: 0
39 |         post_reboot_delay: 30
40 |         test_command: uptime
41 |       when: ansible_os_family == 'Debian' or ansible_os_family == 'Ubuntu'
42 | 


--------------------------------------------------------------------------------
/ansible.cfg:
--------------------------------------------------------------------------------
 1 | [defaults]
 2 | # Use the unixy callback for condensed, readable output
 3 | stdout_callback = community.general.unixy
 4 | # Display OK hosts for better visibility
 5 | display_ok_hosts = false
 6 | # Display skipped hosts to show what's being skipped
 7 | display_skipped_hosts = true
 8 | # Show task path on failure for debugging
 9 | show_task_path_on_failure = true
10 | # Include custom stats in play recap
11 | show_custom_stats = true
12 | # Show per-host start times for better monitoring
13 | show_per_host_start = true
14 | # Enable check mode markers
15 | check_mode_markers = true
16 | 
17 | # Force color output for better terminal display
18 | force_color = true
19 | 
20 | # Enable 256 color support for brighter colors
21 | force_256color = true
22 | 
23 | # Set callback plugins path - include the actual location
24 | callback_plugins = /usr/lib/python3/dist-packages/ansible_collections/community/general/plugins/callback:~/.ansible/plugins/callback:/usr/share/ansible/plugins/callback
25 | 
26 | # Disable verbose output to get cleaner unixy format
27 | verbosity = 0
28 | 
29 | # Disable warnings for cleaner output
30 | deprecation_warnings = false
31 | command_warnings = false
32 | 
33 | # Configure unixy callback options
34 | [callback_unixy]
35 | display_ok_hosts = false
36 | display_skipped_hosts = true
37 | show_task_path_on_failure = true
38 | show_custom_stats = true
39 | show_per_host_start = false
40 | check_mode_markers = true
41 | 


--------------------------------------------------------------------------------
/playbooks/ceph-management.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | # Ceph Service Management Playbook
 3 | # For managing Ceph services across Proxmox clusters
 4 | 
 5 | - name: Manage Ceph Monitor Services
 6 |   hosts: proxmox-indobsd,proxmox-idbsd-biz,proxmox-idbsd-biz2
 7 |   gather_facts: false
 8 |   become: yes
 9 |   tasks:
10 |     - name: Restart Ceph Monitor
11 |       service:
12 |         name: ceph-mon@{{ ansible_hostname }}
13 |         state: restarted
14 |       ignore_errors: yes
15 | 
16 |     - name: Restart Ceph Manager
17 |       service:
18 |         name: ceph-mgr@{{ ansible_hostname }}
19 |         state: restarted
20 |       ignore_errors: yes
21 | 
22 |     - name: Check Ceph cluster status
23 |       shell: ceph -s
24 |       register: ceph_status
25 |       ignore_errors: yes
26 | 
27 |     - name: Display Ceph status
28 |       debug:
29 |         msg: "{{ ceph_status.stdout_lines }}"
30 |       when: ceph_status.stdout is defined
31 | 
32 | - name: Ceph OSD Management
33 |   hosts: proxmox-indobsd,proxmox-idbsd-biz,proxmox-idbsd-biz2
34 |   gather_facts: false
35 |   become: yes
36 |   tasks:
37 |     - name: List Ceph OSDs
38 |       shell: ceph osd ls
39 |       register: osd_list
40 | 
41 |     - name: Display OSD list
42 |       debug:
43 |         msg: "OSDs: {{ osd_list.stdout }}"
44 | 
45 |     - name: Check OSD status
46 |       shell: ceph osd status
47 |       register: osd_status
48 | 
49 |     - name: Display OSD status
50 |       debug:
51 |         msg: "{{ osd_status.stdout_lines }}"
52 | 


--------------------------------------------------------------------------------
/playbooks/monitoring.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | # System Monitoring and Health Checks
 3 | # Comprehensive monitoring playbook for system health assessment
 4 | 
 5 | - name: System Monitoring
 6 |   hosts: all
 7 |   become: yes
 8 | 
 9 |   tasks:
10 |     - name: Install monitoring tools
11 |       apt:
12 |         name:
13 |           - htop
14 |           - iotop
15 |           - sysstat
16 |           - ncdu
17 |         state: present
18 |       when: ansible_os_family == "Debian"
19 | 
20 |     - name: Check system uptime
21 |       shell: uptime
22 |       register: uptime_result
23 | 
24 |     - name: Display system uptime
25 |       debug:
26 |         msg: "{{ uptime_result.stdout }}"
27 | 
28 |     - name: Check disk usage
29 |       shell: df -h | grep -E '^/dev/'
30 |       register: disk_usage
31 | 
32 |     - name: Display disk usage
33 |       debug:
34 |         msg: "{{ disk_usage.stdout }}"
35 | 
36 |     - name: Check memory usage
37 |       shell: free -h
38 |       register: memory_usage
39 | 
40 |     - name: Display memory usage
41 |       debug:
42 |         msg: "{{ memory_usage.stdout }}"
43 | 
44 |     - name: Check CPU load
45 |       shell: top -bn1 | grep "Cpu(s)"
46 |       register: cpu_load
47 | 
48 |     - name: Display CPU load
49 |       debug:
50 |         msg: "{{ cpu_load.stdout }}"
51 | 
52 |     - name: Check running services
53 |       shell: systemctl list-units --type=service --state=running | head -20
54 |       register: services
55 | 
56 |     - name: Display running services
57 |       debug:
58 |         msg: "{{ services.stdout }}"


--------------------------------------------------------------------------------
/install-service.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | # Ansible Admin Service Installation Script
 4 | # This script installs the ansible-admin service for automatic startup
 5 | 
 6 | SERVICE_NAME="ansible-admin"
 7 | SERVICE_FILE="/home/dionipe/ansible-admin/ansible-admin.service"
 8 | SYSTEMD_PATH="/etc/systemd/system/${SERVICE_NAME}.service"
 9 | 
10 | echo "🔧 Installing Ansible Admin Service..."
11 | 
12 | # Check if running as root
13 | if [[ $EUID -ne 0 ]]; then
14 |    echo "❌ This script must be run as root (sudo)"
15 |    exit 1
16 | fi
17 | 
18 | # Copy service file to systemd directory
19 | echo "📋 Copying service file to systemd..."
20 | cp "$SERVICE_FILE" "$SYSTEMD_PATH"
21 | 
22 | # Set proper permissions
23 | chmod 644 "$SYSTEMD_PATH"
24 | 
25 | # Reload systemd daemon
26 | echo "🔄 Reloading systemd daemon..."
27 | systemctl daemon-reload
28 | 
29 | # Enable the service
30 | echo "✅ Enabling service to start on boot..."
31 | systemctl enable "$SERVICE_NAME"
32 | 
33 | echo ""
34 | echo "🎉 Service installation complete!"
35 | echo ""
36 | echo "📋 Service Commands:"
37 | echo "  Start service:   sudo systemctl start $SERVICE_NAME"
38 | echo "  Stop service:    sudo systemctl stop $SERVICE_NAME"
39 | echo "  Restart service: sudo systemctl restart $SERVICE_NAME"
40 | echo "  Status:          sudo systemctl status $SERVICE_NAME"
41 | echo "  View logs:       sudo journalctl -u $SERVICE_NAME -f"
42 | echo ""
43 | echo "🌐 Web interface will be available at: http://localhost:8000"
44 | echo ""
45 | echo "💡 To start the service now, run: sudo systemctl start $SERVICE_NAME"
46 | 


--------------------------------------------------------------------------------
/inventory.ini:
--------------------------------------------------------------------------------
 1 | [ipe-store]
 2 | store-01 ansible_host=192.168.200.1 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
 3 | store-02 ansible_host=192.168.200.2 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
 4 | store-03 ansible_host=192.168.200.3 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
 5 | 
 6 | [proxmox-indobsd]
 7 | alpha ansible_host=192.168.255.1 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
 8 | bravo ansible_host=192.168.255.2 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
 9 | charlie ansible_host=192.168.255.3 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
10 | 
11 | [proxmox-idbsd-biz]
12 | mercurius ansible_host=172.16.214.5 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
13 | venus ansible_host=172.16.214.6 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
14 | bumi ansible_host=172.16.214.7 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
15 | 
16 | [proxmox-idbsd-biz2]
17 | mars ansible_host=172.16.214.8 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
18 | jupiter ansible_host=172.16.214.9 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
19 | saturnus ansible_host=172.16.214.10 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
20 | 
21 | [ipe-project-c]
22 | project-c ansible_host=192.168.200.12 ansible_user=root ansible_ssh_private_key_file=~/.ssh/id_ed25519
23 | 
24 | [all:vars]
25 | ansible_python_interpreter=/usr/bin/python3
26 | ansible_ssh_private_key_file=~/.ssh/id_ed25519
27 | ansible_ssh_common_args='-o ServerAliveInterval=5 -o StrictHostKeyChecking=no'


--------------------------------------------------------------------------------
/wiki/Home.md:
--------------------------------------------------------------------------------
 1 | # Ansible Admin Wiki
 2 | 
 3 | Welcome to the Ansible Admin Wiki! This comprehensive documentation will help you get the most out of your Ansible management interface.
 4 | 
 5 | ## 🚀 Quick Start
 6 | 
 7 | - [[Installation Guide|Installation]]
 8 | - [[Configuration|Configuration]]
 9 | - [[Basic Usage|Basic-Usage]]
10 | 
11 | ## 📚 Documentation
12 | 
13 | ### User Guides
14 | - [[Dashboard Overview|Dashboard]]
15 | - [[Managing Playbooks|Playbooks]]
16 | - [[Inventory Management|Inventory]]
17 | - [[Executing Playbooks|Execution]]
18 | - [[Viewing History|History]]
19 | - [[OS Updates|OS-Updates]]
20 | 
21 | ### Advanced Topics
22 | - [[API Reference|API-Reference]]
23 | - [[Templates|Templates]]
24 | - [[Security|Security]]
25 | - [[Troubleshooting|Troubleshooting]]
26 | 
27 | ### Development
28 | - [[Contributing|Contributing]]
29 | - [[Development Setup|Development]]
30 | - [[Architecture|Architecture]]
31 | 
32 | ## 🔧 Features
33 | 
34 | Ansible Admin provides a modern web interface for managing Ansible playbooks with:
35 | 
36 | - **Real-time Execution Monitoring**: Live streaming of playbook execution with color-coded output
37 | - **Template System**: Built-in Jinja2 templates for dynamic playbook generation
38 | - **Inventory Management**: Dynamic host and group management
39 | - **Execution History**: Complete audit trail of all playbook runs
40 | - **Modern UI**: Glassmorphism design with responsive layout
41 | 
42 | ## 📊 System Requirements
43 | 
44 | - **Python**: 3.8 or higher
45 | - **Ansible**: 2.9 or higher
46 | - **Web Browser**: Modern browser with JavaScript enabled
47 | - **Operating System**: Linux, macOS, or Windows
48 | 
49 | ## 🆘 Support
50 | 
51 | - [[Frequently Asked Questions|FAQ]]
52 | - [[Troubleshooting|Troubleshooting]]
53 | - [GitHub Issues](https://github.com/dionipe/ansible-admin/issues)
54 | - [Discussions](https://github.com/dionipe/ansible-admin/discussions)
55 | 
56 | ## 📈 Latest Updates
57 | 
58 | **Version 2.0.0** - September 8, 2025
59 | - Complete UI redesign with glassmorphism effects
60 | - Enhanced real-time execution monitoring
61 | - Improved error handling and user feedback
62 | - New template system with Jinja2 support
63 | 
64 | ---
65 | 
66 | *This wiki is maintained by the Ansible Admin development team. Contributions are welcome!*</content>
67 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/Home.md
68 | 


--------------------------------------------------------------------------------
/SERVICE-README.md:
--------------------------------------------------------------------------------
  1 | # Ansible Admin Service Setup
  2 | 
  3 | This directory contains scripts to set up the Ansible Admin Dashboard as a systemd service.
  4 | 
  5 | ## Files Created
  6 | 
  7 | - `ansible-admin.service` - Systemd service configuration file
  8 | - `install-service.sh` - Installation script (requires sudo)
  9 | - `service-manager.sh` - Easy service management script
 10 | 
 11 | ## Installation
 12 | 
 13 | 1. **Install the service** (requires sudo):
 14 |    ```bash
 15 |    sudo ./install-service.sh
 16 |    ```
 17 | 
 18 |    Or use the service manager:
 19 |    ```bash
 20 |    sudo ./service-manager.sh install
 21 |    ```
 22 | 
 23 | ## Service Management
 24 | 
 25 | Use the service manager script for easy control:
 26 | 
 27 | ```bash
 28 | # Start the service
 29 | ./service-manager.sh start
 30 | 
 31 | # Stop the service
 32 | ./service-manager.sh stop
 33 | 
 34 | # Restart the service
 35 | ./service-manager.sh restart
 36 | 
 37 | # Check status
 38 | ./service-manager.sh status
 39 | 
 40 | # View logs (follow mode)
 41 | ./service-manager.sh logs
 42 | ```
 43 | 
 44 | Or use standard systemctl commands:
 45 | 
 46 | ```bash
 47 | # Start
 48 | sudo systemctl start ansible-admin
 49 | 
 50 | # Stop
 51 | sudo systemctl stop ansible-admin
 52 | 
 53 | # Restart
 54 | sudo systemctl restart ansible-admin
 55 | 
 56 | # Status
 57 | sudo systemctl status ansible-admin
 58 | 
 59 | # Enable on boot
 60 | sudo systemctl enable ansible-admin
 61 | 
 62 | # Disable on boot
 63 | sudo systemctl disable ansible-admin
 64 | 
 65 | # View logs
 66 | sudo journalctl -u ansible-admin -f
 67 | ```
 68 | 
 69 | ## Service Configuration
 70 | 
 71 | The service is configured with:
 72 | - **User**: dionipe
 73 | - **Working Directory**: /home/dionipe/ansible-admin
 74 | - **Auto-restart**: Yes (with 5-second delay)
 75 | - **Security**: Enhanced security settings
 76 | - **Logging**: Systemd journal integration
 77 | 
 78 | ## Web Interface
 79 | 
 80 | Once the service is running, access the web interface at:
 81 | **http://localhost:8000**
 82 | 
 83 | ## Troubleshooting
 84 | 
 85 | 1. **Service won't start**:
 86 |    - Check logs: `sudo journalctl -u ansible-admin -n 50`
 87 |    - Verify Python3 is available: `which python3`
 88 |    - Check file permissions
 89 | 
 90 | 2. **Port already in use**:
 91 |    - Kill existing process: `pkill -f "python3 server.py"`
 92 |    - Wait a few seconds and try again
 93 | 
 94 | 3. **Permission issues**:
 95 |    - Ensure user `dionipe` has access to the directory
 96 |    - Check file permissions: `ls -la /home/dionipe/ansible-admin/`
 97 | 
 98 | ## Manual Control
 99 | 
100 | If you prefer to run manually instead of as a service:
101 | 
102 | ```bash
103 | # Run directly
104 | python3 server.py
105 | 
106 | # Run in background
107 | python3 server.py &
108 | 
109 | # Kill manual process
110 | pkill -f "python3 server.py"
111 | ```
112 | 


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # Changelog
 2 | 
 3 | All notable changes to this project will be documented in this file.
 4 | 
 5 | The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 6 | and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 7 | 
 8 | ## [2.0.0] - 2025-09-08
 9 | 
10 | ### Added
11 | - **Complete Web Interface**: Modern glassmorphism design with responsive layout
12 | - **Usage Guide Page**: Comprehensive documentation and user guide
13 | - **Real-time Execution Monitoring**: Live streaming of Ansible playbook execution
14 | - **Advanced Playbook Management**: Create, edit, and organize playbooks with templates
15 | - **Dynamic Inventory Management**: Host and group management with SSH configuration
16 | - **Execution History**: Track and review past playbook executions
17 | - **OS Update Management**: Automated system updates and patching
18 | - **Modern UI Components**: Bootstrap 5 with custom glassmorphism effects
19 | - **Interactive Features**: Print guide, scroll to top, contact support
20 | - **API Endpoints**: RESTful API for all operations
21 | - **Background Processing**: Non-blocking playbook execution
22 | - **Error Handling**: Comprehensive error reporting and recovery
23 | 
24 | ### Changed
25 | - **UI Design**: Complete redesign with modern glassmorphism effects
26 | - **Navigation**: Sidebar navigation with active state indicators
27 | - **Footer**: Sticky footer with real-time updates and developer credits
28 | - **Color Scheme**: Updated color palette with better contrast and accessibility
29 | 
30 | ### Technical Improvements
31 | - **Server Architecture**: Python HTTP server with proper routing
32 | - **Real-time Updates**: Server-Sent Events for live execution monitoring
33 | - **CORS Support**: Cross-origin resource sharing enabled
34 | - **Responsive Design**: Mobile-first approach with Bootstrap 5
35 | - **Performance**: Optimized loading and execution monitoring
36 | 
37 | ### Features
38 | - **Dashboard**: System metrics and quick access to features
39 | - **Playbooks**: Template system with Jinja2 support
40 | - **Inventory**: Dynamic host management with groups
41 | - **Execute**: Real-time execution with streaming output
42 | - **History**: Execution logs with filtering and pagination
43 | - **Update OS**: Automated system maintenance
44 | - **Usage Guide**: Complete documentation and troubleshooting
45 | 
46 | ## [1.0.0] - 2024-01-01
47 | 
48 | ### Added
49 | - Initial release of Ansible Admin
50 | - Basic playbook execution functionality
51 | - Simple web interface
52 | - Basic inventory management
53 | - Execution history tracking
54 | 
55 | ### Technical
56 | - Python backend with basic HTTP server
57 | - Ansible integration
58 | - Basic error handling
59 | - Simple UI with Bootstrap
60 | 
61 | ---
62 | 
63 | ## Version History
64 | 
65 | - **v2.0.0** (2025-09-08): Complete redesign with modern UI and comprehensive features
66 | - **v1.0.0** (2025-09-06): Initial release with basic functionality
67 | 
68 | ## Development
69 | 
70 | This project follows semantic versioning. For more information about upcoming features and planned changes, see the project roadmap.
71 | 
72 | ---
73 | 
74 | *For more detailed information about each release, see the [GitHub Releases](https://github.com/yourusername/ansible-admin/releases) page.*
75 | 


--------------------------------------------------------------------------------
/datastore/hosts.json:
--------------------------------------------------------------------------------
  1 | {
  2 |   "hosts": [
  3 |     {
  4 |       "group": "ipe-store",
  5 |       "hostname": "store-01",
  6 |       "ip": "192.168.200.1",
  7 |       "username": "root",
  8 |       "sshKey": "~/.ssh/id_ed25519"
  9 |     },
 10 |     {
 11 |       "group": "proxmox-indobsd",
 12 |       "hostname": "alpha",
 13 |       "ip": "192.168.255.1",
 14 |       "username": "root",
 15 |       "sshKey": "~/.ssh/id_ed25519"
 16 |     },
 17 |     {
 18 |       "group": "proxmox-indobsd",
 19 |       "hostname": "bravo",
 20 |       "ip": "192.168.255.2",
 21 |       "username": "root",
 22 |       "sshKey": "~/.ssh/id_ed25519"
 23 |     },
 24 |     {
 25 |       "group": "proxmox-indobsd",
 26 |       "hostname": "charlie",
 27 |       "ip": "192.168.255.3",
 28 |       "username": "root",
 29 |       "sshKey": "~/.ssh/id_ed25519"
 30 |     },
 31 |     {
 32 |       "group": "proxmox-idbsd-biz",
 33 |       "hostname": "mercurius",
 34 |       "ip": "172.16.214.5",
 35 |       "username": "root",
 36 |       "sshKey": "~/.ssh/id_ed25519"
 37 |     },
 38 |     {
 39 |       "group": "proxmox-idbsd-biz",
 40 |       "hostname": "venus",
 41 |       "ip": "172.16.214.6",
 42 |       "username": "root",
 43 |       "sshKey": "~/.ssh/id_ed25519"
 44 |     },
 45 |     {
 46 |       "group": "proxmox-idbsd-biz",
 47 |       "hostname": "bumi",
 48 |       "ip": "172.16.214.7",
 49 |       "username": "root",
 50 |       "sshKey": "~/.ssh/id_ed25519"
 51 |     },
 52 |     {
 53 |       "group": "proxmox-idbsd-biz2",
 54 |       "hostname": "mars",
 55 |       "ip": "172.16.214.8",
 56 |       "username": "root",
 57 |       "sshKey": "~/.ssh/id_ed25519"
 58 |     },
 59 |     {
 60 |       "group": "proxmox-idbsd-biz2",
 61 |       "hostname": "jupiter",
 62 |       "ip": "172.16.214.9",
 63 |       "username": "root",
 64 |       "sshKey": "~/.ssh/id_ed25519"
 65 |     },
 66 |     {
 67 |       "group": "proxmox-idbsd-biz2",
 68 |       "hostname": "saturnus",
 69 |       "ip": "172.16.214.10",
 70 |       "username": "root",
 71 |       "sshKey": "~/.ssh/id_ed25519"
 72 |     },
 73 |     {
 74 |       "group": "ipe-store",
 75 |       "hostname": "store-02",
 76 |       "ip": "192.168.200.2",
 77 |       "username": "root",
 78 |       "sshKey": "~/.ssh/id_ed25519"
 79 |     },
 80 |     {
 81 |       "group": "ipe-store",
 82 |       "hostname": "store-03",
 83 |       "ip": "192.168.200.3",
 84 |       "username": "root",
 85 |       "sshKey": "~/.ssh/id_ed25519"
 86 |     },
 87 |     {
 88 |       "group": "ipe-project-c",
 89 |       "hostname": "project-c",
 90 |       "ip": "192.168.200.12",
 91 |       "username": "root",
 92 |       "sshKey": "~/.ssh/id_ed25519"
 93 |     }
 94 |   ],
 95 |   "hostGroups": [
 96 |     {
 97 |       "name": "ipe-store",
 98 |       "description": "IPE Store servers"
 99 |     },
100 |     {
101 |       "name": "proxmox-indobsd",
102 |       "description": "Proxmox IndoBSD core servers"
103 |     },
104 |     {
105 |       "name": "proxmox-idbsd-biz",
106 |       "description": "Proxmox IDBSD business servers"
107 |     },
108 |     {
109 |       "name": "proxmox-idbsd-biz2",
110 |       "description": "Proxmox IDBSD business secondary servers"
111 |     },
112 |     {
113 |       "name": "ipe-project-c",
114 |       "description": "VM Development"
115 |     }
116 |   ]
117 | }


--------------------------------------------------------------------------------
/service-manager.sh:
--------------------------------------------------------------------------------
  1 | #!/bin/bash
  2 | 
  3 | # Ansible Admin Service Management Script
  4 | # Easy way to manage the ansible-admin service
  5 | 
  6 | SERVICE_NAME="ansible-admin"
  7 | 
  8 | # Colors for output
  9 | RED='\033[0;31m'
 10 | GREEN='\033[0;32m'
 11 | YELLOW='\033[1;33m'
 12 | BLUE='\033[0;34m'
 13 | NC='\033[0m' # No Color
 14 | 
 15 | # Function to show usage
 16 | show_usage() {
 17 |     echo -e "${BLUE}Ansible Admin Service Manager${NC}"
 18 |     echo ""
 19 |     echo "Usage: $0 {start|stop|restart|status|logs|install}"
 20 |     echo ""
 21 |     echo "Commands:"
 22 |     echo "  start   - Start the ansible-admin service"
 23 |     echo "  stop    - Stop the ansible-admin service"
 24 |     echo "  restart - Restart the ansible-admin service"
 25 |     echo "  status  - Show service status"
 26 |     echo "  logs    - Show service logs (follow mode)"
 27 |     echo "  install - Install the service (requires sudo)"
 28 |     echo ""
 29 |     echo "Examples:"
 30 |     echo "  $0 start"
 31 |     echo "  $0 status"
 32 |     echo "  sudo $0 install"
 33 | }
 34 | 
 35 | # Function to check if service exists
 36 | service_exists() {
 37 |     systemctl list-units --type=service | grep -q "$SERVICE_NAME"
 38 | }
 39 | 
 40 | # Function to start service
 41 | start_service() {
 42 |     if service_exists; then
 43 |         echo -e "${BLUE}Starting ansible-admin service...${NC}"
 44 |         sudo systemctl start "$SERVICE_NAME"
 45 |         if [[ $? -eq 0 ]]; then
 46 |             echo -e "${GREEN}✅ Service started successfully${NC}"
 47 |             echo -e "${BLUE}🌐 Web interface: http://localhost:8000${NC}"
 48 |         else
 49 |             echo -e "${RED}❌ Failed to start service${NC}"
 50 |         fi
 51 |     else
 52 |         echo -e "${RED}❌ Service not installed. Run 'sudo $0 install' first${NC}"
 53 |     fi
 54 | }
 55 | 
 56 | # Function to stop service
 57 | stop_service() {
 58 |     if service_exists; then
 59 |         echo -e "${BLUE}Stopping ansible-admin service...${NC}"
 60 |         sudo systemctl stop "$SERVICE_NAME"
 61 |         if [[ $? -eq 0 ]]; then
 62 |             echo -e "${GREEN}✅ Service stopped successfully${NC}"
 63 |         else
 64 |             echo -e "${RED}❌ Failed to stop service${NC}"
 65 |         fi
 66 |     else
 67 |         echo -e "${YELLOW}⚠️  Service not installed or already stopped${NC}"
 68 |     fi
 69 | }
 70 | 
 71 | # Function to restart service
 72 | restart_service() {
 73 |     if service_exists; then
 74 |         echo -e "${BLUE}Restarting ansible-admin service...${NC}"
 75 |         sudo systemctl restart "$SERVICE_NAME"
 76 |         if [[ $? -eq 0 ]]; then
 77 |             echo -e "${GREEN}✅ Service restarted successfully${NC}"
 78 |             echo -e "${BLUE}🌐 Web interface: http://localhost:8000${NC}"
 79 |         else
 80 |             echo -e "${RED}❌ Failed to restart service${NC}"
 81 |         fi
 82 |     else
 83 |         echo -e "${RED}❌ Service not installed. Run 'sudo $0 install' first${NC}"
 84 |     fi
 85 | }
 86 | 
 87 | # Function to show status
 88 | show_status() {
 89 |     if service_exists; then
 90 |         echo -e "${BLUE}Ansible Admin Service Status:${NC}"
 91 |         sudo systemctl status "$SERVICE_NAME" --no-pager -l
 92 |     else
 93 |         echo -e "${RED}❌ Service not installed${NC}"
 94 |     fi
 95 | }
 96 | 
 97 | # Function to show logs
 98 | show_logs() {
 99 |     if service_exists; then
100 |         echo -e "${BLUE}Ansible Admin Service Logs (press Ctrl+C to exit):${NC}"
101 |         sudo journalctl -u "$SERVICE_NAME" -f
102 |     else
103 |         echo -e "${RED}❌ Service not installed${NC}"
104 |     fi
105 | }
106 | 
107 | # Function to install service
108 | install_service() {
109 |     echo -e "${BLUE}Installing ansible-admin service...${NC}"
110 |     sudo ./install-service.sh
111 | }
112 | 
113 | # Main script logic
114 | case "$1" in
115 |     start)
116 |         start_service
117 |         ;;
118 |     stop)
119 |         stop_service
120 |         ;;
121 |     restart)
122 |         restart_service
123 |         ;;
124 |     status)
125 |         show_status
126 |         ;;
127 |     logs)
128 |         show_logs
129 |         ;;
130 |     install)
131 |         install_service
132 |         ;;
133 |     *)
134 |         show_usage
135 |         exit 1
136 |         ;;
137 | esac
138 | 


--------------------------------------------------------------------------------
/wiki/Installation.md:
--------------------------------------------------------------------------------
  1 | # Installation Guide
  2 | 
  3 | This guide will walk you through installing and setting up Ansible Admin on your system.
  4 | 
  5 | ## Prerequisites
  6 | 
  7 | Before installing Ansible Admin, ensure your system meets these requirements:
  8 | 
  9 | ### System Requirements
 10 | - **Operating System**: Linux, macOS, or Windows
 11 | - **Python**: Version 3.8 or higher
 12 | - **Ansible**: Version 2.9 or higher
 13 | - **Web Browser**: Modern browser with JavaScript support
 14 | 
 15 | ### Required Software
 16 | ```bash
 17 | # Install Python (if not already installed)
 18 | # Ubuntu/Debian
 19 | sudo apt update
 20 | sudo apt install python3 python3-pip
 21 | 
 22 | # CentOS/RHEL
 23 | sudo yum install python3 python3-pip
 24 | 
 25 | # macOS
 26 | brew install python3
 27 | 
 28 | # Windows - Download from python.org
 29 | ```
 30 | 
 31 | ```bash
 32 | # Install Ansible
 33 | # Ubuntu/Debian
 34 | sudo apt install ansible
 35 | 
 36 | # CentOS/RHEL
 37 | sudo yum install ansible
 38 | 
 39 | # macOS
 40 | brew install ansible
 41 | 
 42 | # Windows - Use WSL or install via pip
 43 | pip3 install ansible
 44 | ```
 45 | 
 46 | ## Installation Methods
 47 | 
 48 | ### Method 1: Direct Download (Recommended)
 49 | 
 50 | 1. **Download the latest release**:
 51 |    ```bash
 52 |    wget https://github.com/dionipe/ansible-admin/archive/refs/tags/v2.0.0.zip
 53 |    unzip v2.0.0.zip
 54 |    cd ansible-admin-2.0.0
 55 |    ```
 56 | 
 57 | 2. **Clone from GitHub**:
 58 |    ```bash
 59 |    git clone https://github.com/dionipe/ansible-admin.git
 60 |    cd ansible-admin
 61 |    ```
 62 | 
 63 | 3. **Install Python dependencies**:
 64 |    ```bash
 65 |    pip3 install -r requirements.txt
 66 |    ```
 67 | 
 68 | 4. **Install Ansible collections**:
 69 |    ```bash
 70 |    ansible-galaxy collection install -r requirements.yml
 71 |    ```
 72 | 
 73 | ### Method 2: Docker Installation
 74 | 
 75 | ```bash
 76 | # Build Docker image
 77 | docker build -t ansible-admin .
 78 | 
 79 | # Run container
 80 | docker run -p 8000:8000 -v /path/to/playbooks:/app/playbooks ansible-admin
 81 | ```
 82 | 
 83 | ## Configuration
 84 | 
 85 | ### Basic Configuration
 86 | 
 87 | 1. **Ansible Configuration**:
 88 |    The application includes a pre-configured `ansible.cfg` file. You can modify it for your environment:
 89 | 
 90 |    ```ini
 91 |    [defaults]
 92 |    stdout_callback = community.general.unixy
 93 |    display_ok_hosts = true
 94 |    display_skipped_hosts = true
 95 |    show_task_path_on_failure = true
 96 |    force_color = true
 97 |    ```
 98 | 
 99 | 2. **Application Settings**:
100 |    Edit `server.py` to configure:
101 |    - Port number (default: 8000)
102 |    - Host binding (default: 0.0.0.0)
103 |    - Debug mode
104 | 
105 | ### Directory Structure
106 | 
107 | After installation, your directory should look like this:
108 | ```
109 | ansible-admin/
110 | ├── server.py              # Main application server
111 | ├── ansible.cfg           # Ansible configuration
112 | ├── requirements.txt      # Python dependencies
113 | ├── requirements.yml      # Ansible collections
114 | ├── playbooks/            # Your Ansible playbooks
115 | ├── templates/            # Jinja2 templates
116 | ├── datastore/            # Application data
117 | ├── static/               # Static web assets
118 | └── *.html               # Web interface files
119 | ```
120 | 
121 | ## Starting the Application
122 | 
123 | ### Development Mode
124 | 
125 | ```bash
126 | # Start the server
127 | python3 server.py
128 | 
129 | # Or with custom port
130 | python3 server.py --port 8080
131 | ```
132 | 
133 | ### Production Mode
134 | 
135 | 1. **Using systemd** (Linux):
136 |    ```bash
137 |    # Copy service file
138 |    sudo cp ansible-admin.service /etc/systemd/system/
139 | 
140 |    # Enable and start service
141 |    sudo systemctl enable ansible-admin
142 |    sudo systemctl start ansible-admin
143 |    ```
144 | 
145 | 2. **Using the service manager script**:
146 |    ```bash
147 |    # Make script executable
148 |    chmod +x service-manager.sh
149 | 
150 |    # Start service
151 |    ./service-manager.sh start
152 | 
153 |    # Check status
154 |    ./service-manager.sh status
155 |    ```
156 | 
157 | ## Verification
158 | 
159 | 1. **Check if the server is running**:
160 |    ```bash
161 |    curl http://localhost:8000
162 |    ```
163 | 
164 | 2. **Open in browser**:
165 |    Navigate to `http://localhost:8000` in your web browser.
166 | 
167 | 3. **Test basic functionality**:
168 |    - Access the dashboard
169 |    - Try uploading a simple playbook
170 |    - Execute a basic command
171 | 
172 | ## Troubleshooting Installation
173 | 
174 | ### Common Issues
175 | 
176 | **Python version error**:
177 | ```bash
178 | python3 --version
179 | # Should show 3.8 or higher
180 | ```
181 | 
182 | **Ansible not found**:
183 | ```bash
184 | ansible --version
185 | # Should show version 2.9 or higher
186 | ```
187 | 
188 | **Permission denied**:
189 | ```bash
190 | # Make sure you have write permissions
191 | chmod -R 755 ansible-admin/
192 | ```
193 | 
194 | **Port already in use**:
195 | ```bash
196 | # Find process using port 8000
197 | lsof -i :8000
198 | # Kill the process or use a different port
199 | ```
200 | 
201 | ## Next Steps
202 | 
203 | Once installed, you can:
204 | - [[Configure your environment|Configuration]]
205 | - [[Create your first playbook|Basic-Usage]]
206 | - [[Set up inventory|Inventory]]
207 | - [[Explore advanced features|Advanced-Features]]
208 | 
209 | ## Support
210 | 
211 | If you encounter issues during installation:
212 | - Check the [[Troubleshooting|Troubleshooting]] guide
213 | - Search existing [GitHub Issues](https://github.com/dionipe/ansible-admin/issues)
214 | - Create a new issue with detailed error information</content>
215 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/Installation.md
216 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # Ansible Admin Dashboard
  2 | 
  3 | A modern web-based interface for managing and executing Ansible playbooks with real-time monitoring and live execution output.
  4 | 
  5 | ## Features
  6 | 
  7 | ### 🎯 Core Functionality
  8 | - **Playbook Management**: Create, edit, and organize Ansible playbooks
  9 | - **Template System**: Built-in templates and Jinja2 template support
 10 | - **Inventory Management**: Dynamic host and group management
 11 | - **Real-time Execution**: Live monitoring of playbook execution with streaming output
 12 | - **Execution History**: Track and review past playbook runs
 13 | 
 14 | ### 🎨 Enhanced Output Display
 15 | - **Unixy Callback Integration**: Uses Ansible's `community.general.unixy` callback for condensed, readable output
 16 | - **Color-Coded Output**: Syntax highlighting for different Ansible output types:
 17 |   - 🟢 **OK/Success**: Green highlighting
 18 |   - 🟡 **Changed**: Yellow highlighting
 19 |   - 🔴 **Failed**: Red highlighting with background
 20 |   - 🔵 **Info**: Blue for informational messages
 21 |   - 🟣 **Headers**: Purple for PLAY/TASK headers
 22 |   - ⚪ **Skipped**: Gray for skipped tasks
 23 | - **Responsive Design**: Optimized for both desktop and mobile viewing
 24 | 
 25 | ### 🔧 Technical Features
 26 | - **Server-Sent Events**: Real-time output streaming during execution
 27 | - **Background Processing**: Non-blocking playbook execution
 28 | - **Error Handling**: Comprehensive error reporting and recovery
 29 | - **CORS Support**: Cross-origin resource sharing enabled
 30 | - **RESTful API**: Clean API endpoints for all operations
 31 | 
 32 | ## Screenshots
 33 | 
 34 | ### Dashboard
 35 | ![Dashboard](screenshoot/Dashboard.png)
 36 | 
 37 | ### Playbook Execution
 38 | ![Playbook Execution](screenshoot/execute.png)
 39 | 
 40 | ### Live Execution Output
 41 | ![Live Execution Output](screenshoot/Live%20Execution%20Output.png)
 42 | 
 43 | ### About Modal
 44 | ![About Modal](screenshoot/about.png)
 45 | 
 46 | ## Installation
 47 | 
 48 | ### Prerequisites
 49 | - Python 3.8+
 50 | - Ansible 2.9+
 51 | - `community.general` collection (automatically installed)
 52 | 
 53 | ### Setup
 54 | 1. Clone the repository:
 55 | ```bash
 56 | git clone <repository-url>
 57 | cd ansible-admin
 58 | ```
 59 | 
 60 | 2. Install Python dependencies:
 61 | ```bash
 62 | pip install -r requirements.txt
 63 | ```
 64 | 
 65 | 3. Install Ansible collections:
 66 | ```bash
 67 | ansible-galaxy collection install -r requirements.yml
 68 | ```
 69 | 
 70 | 4. Start the server:
 71 | ```bash
 72 | python3 server.py
 73 | ```
 74 | 
 75 | 5. Open your browser to `http://localhost:8000`
 76 | 
 77 | ## Configuration
 78 | 
 79 | ### Ansible Configuration
 80 | The application uses a custom `ansible.cfg` file with the following settings:
 81 | 
 82 | ```ini
 83 | [defaults]
 84 | stdout_callback = community.general.unixy
 85 | display_ok_hosts = true
 86 | display_skipped_hosts = true
 87 | show_task_path_on_failure = true
 88 | force_color = true
 89 | ```
 90 | 
 91 | ### Unixy Callback Features
 92 | The unixy callback provides:
 93 | - **Condensed Output**: More compact than default Ansible output
 94 | - **Color Coding**: Visual distinction between different output types
 95 | - **Timing Information**: Execution time for each task
 96 | - **Host Status**: Clear indication of success/failure per host
 97 | - **Check Mode Support**: Visual markers for dry-run mode
 98 | 
 99 | ## Usage
100 | 
101 | ### Running Playbooks
102 | 1. Navigate to the **Execute** page
103 | 2. Select a playbook from the dropdown or enter a custom path
104 | 3. Configure inventory and target hosts
105 | 4. Add any additional Ansible options
106 | 5. Click **Execute** to start the playbook
107 | 6. Monitor progress in real-time with color-coded output
108 | 
109 | ### Managing Templates
110 | - **Built-in Templates**: Pre-configured playbooks for common tasks
111 | - **Jinja2 Templates**: Dynamic templates with variable substitution
112 | - **Custom Templates**: Save and reuse your own templates
113 | 
114 | ### Monitoring Execution
115 | - **Live Output**: Real-time streaming of Ansible execution
116 | - **Status Indicators**: Visual status badges (Running, Completed, Failed)
117 | - **Execution Timer**: Track total execution time
118 | - **Auto-scroll**: Automatically scroll to latest output
119 | - **Download Logs**: Export execution logs for analysis
120 | 
121 | ## API Endpoints
122 | 
123 | ### Playbook Management
124 | - `GET /api/list-playbooks` - List available playbooks
125 | - `POST /api/save-playbook` - Save a playbook
126 | - `POST /api/delete-playbook` - Delete a playbook
127 | 
128 | ### Template Management
129 | - `GET /api/list-jinja-templates` - List Jinja2 templates
130 | - `GET /api/get-jinja-template?name=<name>` - Get template content
131 | 
132 | ### Execution
133 | - `POST /execute-playbook` - Start playbook execution
134 | - `GET /execution-stream/<execution_id>` - Stream execution output
135 | - `POST /cancel-execution` - Cancel running execution
136 | 
137 | ### History
138 | - `GET /get-execution-history` - Get execution history
139 | - `GET /execution-details/<execution_id>` - Get detailed execution info
140 | 
141 | ## Development
142 | 
143 | ### Project Structure
144 | ```
145 | ansible-admin/
146 | ├── server.py              # Main HTTP server
147 | ├── ansible.cfg           # Ansible configuration with unixy callback
148 | ├── requirements.yml      # Ansible collection requirements
149 | ├── execute.html          # Playbook execution interface
150 | ├── playbooks/            # Ansible playbooks directory
151 | ├── templates/            # Jinja2 templates directory
152 | ├── datastore/            # Data storage (JSON files)
153 | └── static/               # Static web assets
154 | ```
155 | 
156 | ### Adding New Features
157 | 1. **Backend**: Add new endpoints in `server.py`
158 | 2. **Frontend**: Update HTML/JavaScript files
159 | 3. **Styling**: Modify CSS for new UI elements
160 | 4. **Configuration**: Update `ansible.cfg` for new Ansible settings
161 | 
162 | ## Troubleshooting
163 | 
164 | ### Common Issues
165 | 
166 | **Unixy callback not working:**
167 | - Ensure `community.general` collection is installed
168 | - Check that `ansible.cfg` is in the project root
169 | - Verify ANSIBLE_CONFIG environment variable is set
170 | 
171 | **Output not streaming:**
172 | - Check browser console for JavaScript errors
173 | - Verify Server-Sent Events are supported
174 | - Check server logs for connection issues
175 | 
176 | **Color output not displaying:**
177 | - Ensure `force_color = true` in ansible.cfg
178 | - Check terminal/browser color support
179 | 
180 | ### Debug Mode
181 | Enable verbose output by adding `-vvv` to Ansible options for detailed debugging.
182 | 
183 | ## Contributing
184 | 
185 | 1. Fork the repository
186 | 2. Create a feature branch
187 | 3. Make your changes
188 | 4. Test thoroughly
189 | 5. Submit a pull request
190 | 
191 | ## License
192 | 
193 | This project is licensed under the MIT License - see the LICENSE file for details.
194 | 
195 | ## Acknowledgments
196 | 
197 | - [Ansible](https://ansible.com) - Automation framework
198 | - [community.general.unixy](https://docs.ansible.com/ansible/latest/collections/community/general/unixy_callback.html) - Condensed output callback
199 | - [Bootstrap](https://getbootstrap.com) - UI framework
200 | - [Server-Sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events) - Real-time communication
201 | 


--------------------------------------------------------------------------------
/wiki/Basic-Usage.md:
--------------------------------------------------------------------------------
  1 | # Basic Usage Guide
  2 | 
  3 | This guide covers the fundamental operations of Ansible Admin.
  4 | 
  5 | ## Getting Started
  6 | 
  7 | ### First Login
  8 | 
  9 | 1. **Start the application**:
 10 |    ```bash
 11 |    python3 server.py
 12 |    ```
 13 | 
 14 | 2. **Open your browser**:
 15 |    Navigate to `http://localhost:8000`
 16 | 
 17 | 3. **Access the dashboard**:
 18 |    The main dashboard provides an overview of your system.
 19 | 
 20 | ## Dashboard Overview
 21 | 
 22 | ### System Information
 23 | 
 24 | The dashboard displays:
 25 | - **Server Status**: Current server health
 26 | - **Active Playbooks**: Running playbook executions
 27 | - **Recent Activity**: Latest playbook runs
 28 | - **System Resources**: CPU, memory, and disk usage
 29 | 
 30 | ### Navigation
 31 | 
 32 | Use the sidebar to navigate between sections:
 33 | - **Dashboard**: Main overview
 34 | - **Playbooks**: Manage Ansible playbooks
 35 | - **Inventory**: Host management
 36 | - **Execute**: Run playbooks
 37 | - **History**: View execution history
 38 | - **OS Updates**: System updates
 39 | 
 40 | ## Managing Playbooks
 41 | 
 42 | ### Creating Playbooks
 43 | 
 44 | 1. **Navigate to Playbooks**:
 45 |    Click "Playbooks" in the sidebar.
 46 | 
 47 | 2. **Create new playbook**:
 48 |    - Click "New Playbook"
 49 |    - Enter a name and description
 50 |    - Write your Ansible YAML content
 51 | 
 52 | 3. **Example playbook**:
 53 |    ```yaml
 54 |    ---
 55 |    - name: Basic server setup
 56 |      hosts: webservers
 57 |      become: yes
 58 |      tasks:
 59 |        - name: Update package cache
 60 |          apt:
 61 |            update_cache: yes
 62 | 
 63 |        - name: Install nginx
 64 |          apt:
 65 |            name: nginx
 66 |            state: present
 67 | 
 68 |        - name: Start nginx service
 69 |          service:
 70 |            name: nginx
 71 |            state: started
 72 |            enabled: yes
 73 |    ```
 74 | 
 75 | ### Uploading Playbooks
 76 | 
 77 | 1. **File upload**:
 78 |    - Click "Upload Playbook"
 79 |    - Select your YAML file
 80 |    - Choose upload location
 81 | 
 82 | 2. **Directory structure**:
 83 |    ```
 84 |    playbooks/
 85 |    ├── web/
 86 |    │   ├── nginx.yml
 87 |    │   └── apache.yml
 88 |    ├── db/
 89 |    │   ├── mysql.yml
 90 |    │   └── postgresql.yml
 91 |    └── system/
 92 |        └── updates.yml
 93 |    ```
 94 | 
 95 | ## Inventory Management
 96 | 
 97 | ### Adding Hosts
 98 | 
 99 | 1. **Navigate to Inventory**:
100 |    Click "Inventory" in the sidebar.
101 | 
102 | 2. **Add single host**:
103 |    - Click "Add Host"
104 |    - Enter hostname/IP
105 |    - Specify connection details
106 | 
107 | 3. **Add host group**:
108 |    - Click "Add Group"
109 |    - Enter group name
110 |    - Add hosts to group
111 | 
112 | ### Host Configuration
113 | 
114 | ```yaml
115 | # Host variables
116 | web1:
117 |   ansible_host: 192.168.1.10
118 |   ansible_user: admin
119 |   ansible_ssh_private_key_file: ~/.ssh/id_rsa
120 |   ansible_python_interpreter: /usr/bin/python3
121 | 
122 | # Group variables
123 | [webservers:vars]
124 | ansible_user=www-data
125 | http_port=8080
126 | ```
127 | 
128 | ## Executing Playbooks
129 | 
130 | ### Basic Execution
131 | 
132 | 1. **Navigate to Execute**:
133 |    Click "Execute" in the sidebar.
134 | 
135 | 2. **Select playbook**:
136 |    Choose from dropdown or enter path.
137 | 
138 | 3. **Configure execution**:
139 |    - Select target hosts/groups
140 |    - Add extra variables
141 |    - Set Ansible options
142 | 
143 | 4. **Start execution**:
144 |    Click "Execute" to begin.
145 | 
146 | ### Real-time Monitoring
147 | 
148 | During execution, you can:
149 | - **View live output**: Real-time streaming
150 | - **Monitor progress**: Task completion status
151 | - **Stop execution**: Cancel running playbooks
152 | - **View results**: Success/failure summary
153 | 
154 | ## Working with Templates
155 | 
156 | ### Using Built-in Templates
157 | 
158 | 1. **Access templates**:
159 |    Click "Templates" section.
160 | 
161 | 2. **Select template**:
162 |    Choose from available templates.
163 | 
164 | 3. **Customize variables**:
165 |    Modify template variables.
166 | 
167 | ### Creating Templates
168 | 
169 | 1. **Template syntax**:
170 |    ```yaml
171 |    ---
172 |    - name: "{{ service_name }} setup"
173 |      hosts: "{{ target_hosts }}"
174 |      become: yes
175 |      vars:
176 |        service_name: "{{ service_name | default('nginx') }}"
177 |        target_hosts: "{{ target_hosts | default('webservers') }}"
178 |      tasks:
179 |        - name: Install {{ service_name }}
180 |          package:
181 |            name: "{{ service_name }}"
182 |            state: present
183 |    ```
184 | 
185 | 2. **Variable files**:
186 |    ```yaml
187 |    # vars.yml
188 |    service_name: apache2
189 |    target_hosts: webservers
190 |    config_file: /etc/apache2/apache2.conf
191 |    ```
192 | 
193 | ## Execution History
194 | 
195 | ### Viewing History
196 | 
197 | 1. **Navigate to History**:
198 |    Click "History" in the sidebar.
199 | 
200 | 2. **Filter results**:
201 |    - By date range
202 |    - By playbook name
203 |    - By execution status
204 |    - By target host
205 | 
206 | 3. **View details**:
207 |    Click on any execution for detailed information.
208 | 
209 | ### Exporting Logs
210 | 
211 | 1. **Select executions**:
212 |    Choose executions to export.
213 | 
214 | 2. **Export format**:
215 |    - JSON format
216 |    - Text format
217 |    - CSV format
218 | 
219 | 3. **Download logs**:
220 |    Click "Export" to download.
221 | 
222 | ## OS Updates
223 | 
224 | ### System Updates
225 | 
226 | 1. **Navigate to OS Updates**:
227 |    Click "OS Updates" in the sidebar.
228 | 
229 | 2. **Select targets**:
230 |    Choose hosts/groups for updates.
231 | 
232 | 3. **Update options**:
233 |    - Security updates only
234 |    - All updates
235 |    - Specific packages
236 | 
237 | 4. **Schedule updates**:
238 |    Set update schedule or run immediately.
239 | 
240 | ## Best Practices
241 | 
242 | ### Playbook Organization
243 | 
244 | ```
245 | playbooks/
246 | ├── roles/
247 | │   ├── common/
248 | │   ├── web/
249 | │   └── db/
250 | ├── inventory/
251 | │   ├── production
252 | │   └── staging
253 | └── vars/
254 |     ├── main.yml
255 |     └── secrets.yml
256 | ```
257 | 
258 | ### Security Considerations
259 | 
260 | 1. **Use vault for secrets**:
261 |    ```bash
262 |    ansible-vault encrypt secrets.yml
263 |    ```
264 | 
265 | 2. **Limit sudo access**:
266 |    ```yaml
267 |    - name: Run with limited privileges
268 |      command: systemctl restart nginx
269 |      become: yes
270 |      become_user: www-data
271 |    ```
272 | 
273 | 3. **Use SSH keys**:
274 |    ```bash
275 |    ssh-keygen -t ed25519 -C "ansible-admin"
276 |    ```
277 | 
278 | ### Performance Optimization
279 | 
280 | 1. **Use forks**:
281 |    ```bash
282 |    ansible-playbook playbook.yml -f 10
283 |    ```
284 | 
285 | 2. **Enable pipelining**:
286 |    ```ini
287 |    [ssh_connection]
288 |    pipelining = true
289 |    ```
290 | 
291 | 3. **Use async tasks**:
292 |    ```yaml
293 |    - name: Long running task
294 |      command: sleep 300
295 |      async: 600
296 |      poll: 10
297 |    ```
298 | 
299 | ## Troubleshooting
300 | 
301 | ### Common Issues
302 | 
303 | **Connection failed**:
304 | ```bash
305 | # Test SSH connection
306 | ssh user@host
307 | 
308 | # Check Ansible reachability
309 | ansible -m ping host
310 | ```
311 | 
312 | **Permission denied**:
313 | ```bash
314 | # Check sudo configuration
315 | sudo -l
316 | 
317 | # Use become
318 | ansible-playbook playbook.yml --become
319 | ```
320 | 
321 | **Task failed**:
322 | ```bash
323 | # Run with verbose output
324 | ansible-playbook playbook.yml -vvv
325 | 
326 | # Check logs
327 | tail -f /var/log/ansible.log
328 | ```
329 | 
330 | ## Next Steps
331 | 
332 | - [[Learn advanced features|Advanced-Features]]
333 | - [[Set up monitoring|Monitoring]]
334 | - [[Configure backups|Backup]]
335 | - [[Contribute to the project|Contributing]]</content>
336 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/Basic-Usage.md
337 | 


--------------------------------------------------------------------------------
/wiki/Configuration.md:
--------------------------------------------------------------------------------
  1 | # Configuration Guide
  2 | 
  3 | This guide covers all aspects of configuring Ansible Admin for your environment.
  4 | 
  5 | ## Application Configuration
  6 | 
  7 | ### Server Settings
  8 | 
  9 | Edit `server.py` to modify basic server settings:
 10 | 
 11 | ```python
 12 | # Server configuration
 13 | HOST = '0.0.0.0'  # Listen on all interfaces
 14 | PORT = 8000       # Server port
 15 | DEBUG = False     # Debug mode
 16 | ```
 17 | 
 18 | ### Environment Variables
 19 | 
 20 | You can use environment variables to configure the application:
 21 | 
 22 | ```bash
 23 | # Set server port
 24 | export ANSIBLE_ADMIN_PORT=8080
 25 | 
 26 | # Set host binding
 27 | export ANSIBLE_ADMIN_HOST=127.0.0.1
 28 | 
 29 | # Enable debug mode
 30 | export ANSIBLE_ADMIN_DEBUG=true
 31 | ```
 32 | 
 33 | ## Ansible Configuration
 34 | 
 35 | ### Basic Ansible Setup
 36 | 
 37 | The application includes a pre-configured `ansible.cfg` file:
 38 | 
 39 | ```ini
 40 | [defaults]
 41 | inventory = ./inventory.ini
 42 | stdout_callback = community.general.unixy
 43 | display_ok_hosts = true
 44 | display_skipped_hosts = true
 45 | show_task_path_on_failure = true
 46 | force_color = true
 47 | host_key_checking = false
 48 | ```
 49 | 
 50 | ### Advanced Ansible Settings
 51 | 
 52 | #### Callback Configuration
 53 | ```ini
 54 | [defaults]
 55 | # Use unixy callback for condensed output
 56 | stdout_callback = community.general.unixy
 57 | 
 58 | # Enable color output
 59 | force_color = true
 60 | 
 61 | # Display settings
 62 | display_ok_hosts = true
 63 | display_skipped_hosts = true
 64 | display_failed_hosts = true
 65 | ```
 66 | 
 67 | #### SSH Configuration
 68 | ```ini
 69 | [ssh_connection]
 70 | # SSH settings
 71 | ssh_args = -o ControlMaster=auto -o ControlPersist=60s -o StrictHostKeyChecking=no
 72 | control_path_dir = /tmp/.ansible/cp
 73 | pipelining = true
 74 | ```
 75 | 
 76 | ## Inventory Configuration
 77 | 
 78 | ### Static Inventory
 79 | 
 80 | Create `inventory.ini` for static host management:
 81 | 
 82 | ```ini
 83 | [webservers]
 84 | web1 ansible_host=192.168.1.10
 85 | web2 ansible_host=192.168.1.11
 86 | 
 87 | [dbservers]
 88 | db1 ansible_host=192.168.1.20
 89 | 
 90 | [all:vars]
 91 | ansible_user=ansible
 92 | ansible_ssh_private_key_file=~/.ssh/id_rsa
 93 | ansible_python_interpreter=/usr/bin/python3
 94 | ```
 95 | 
 96 | ### Dynamic Inventory
 97 | 
 98 | For dynamic inventory, create executable scripts:
 99 | 
100 | ```bash
101 | # Make script executable
102 | chmod +x dynamic-inventory.py
103 | 
104 | # Test inventory script
105 | ./dynamic-inventory.py --list
106 | ```
107 | 
108 | ## Security Configuration
109 | 
110 | ### SSL/TLS Setup
111 | 
112 | To enable HTTPS:
113 | 
114 | 1. **Generate SSL certificate**:
115 |    ```bash
116 |    openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365
117 |    ```
118 | 
119 | 2. **Configure server for SSL**:
120 |    ```python
121 |    import ssl
122 | 
123 |    context = ssl.SSLContext(ssl.PROTOCOL_TLSv1_2)
124 |    context.load_cert_chain('cert.pem', 'key.pem')
125 | 
126 |    # Use HTTPS
127 |    httpd.socket = context.wrap_socket(httpd.socket, server_side=True)
128 |    ```
129 | 
130 | ### Authentication
131 | 
132 | #### Basic Authentication
133 | ```python
134 | # Add to server.py
135 | from http.server import HTTPBasicAuthHandler
136 | 
137 | class AuthHandler(HTTPBasicAuthHandler):
138 |     def do_AUTHHEAD(self):
139 |         self.send_response(401)
140 |         self.send_header('WWW-Authenticate', 'Basic realm="Ansible Admin"')
141 |         self.end_headers()
142 | ```
143 | 
144 | #### SSH Key Management
145 | ```bash
146 | # Generate SSH key pair
147 | ssh-keygen -t rsa -b 4096 -C "ansible-admin"
148 | 
149 | # Copy public key to managed hosts
150 | ssh-copy-id user@host
151 | 
152 | # Test connection
153 | ssh -i ~/.ssh/id_rsa user@host
154 | ```
155 | 
156 | ## Directory Structure
157 | 
158 | ### Custom Directories
159 | 
160 | ```bash
161 | # Playbooks directory
162 | PLAYBOOKS_DIR = './playbooks'
163 | 
164 | # Templates directory
165 | TEMPLATES_DIR = './templates'
166 | 
167 | # Logs directory
168 | LOGS_DIR = './logs'
169 | 
170 | # Backup directory
171 | BACKUP_DIR = './backup'
172 | ```
173 | 
174 | ### File Permissions
175 | 
176 | ```bash
177 | # Set proper permissions
178 | chmod 755 server.py
179 | chmod 644 *.html
180 | chmod 600 ansible.cfg
181 | chmod 600 ~/.ssh/id_rsa
182 | ```
183 | 
184 | ## Performance Tuning
185 | 
186 | ### Server Performance
187 | 
188 | ```python
189 | # Increase server performance
190 | import socket
191 | 
192 | # Set socket options
193 | httpd.socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
194 | httpd.socket.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)
195 | ```
196 | 
197 | ### Ansible Performance
198 | 
199 | ```ini
200 | [defaults]
201 | # Performance settings
202 | forks = 50
203 | poll_interval = 15
204 | timeout = 30
205 | 
206 | [ssh_connection]
207 | # SSH performance
208 | control_path_dir = /tmp/.ansible/cp
209 | pipelining = true
210 | ```
211 | 
212 | ## Monitoring and Logging
213 | 
214 | ### Application Logging
215 | 
216 | ```python
217 | import logging
218 | 
219 | # Configure logging
220 | logging.basicConfig(
221 |     filename='ansible-admin.log',
222 |     level=logging.INFO,
223 |     format='%(asctime)s - %(levelname)s - %(message)s'
224 | )
225 | ```
226 | 
227 | ### Ansible Logging
228 | 
229 | ```ini
230 | [defaults]
231 | log_path = ./ansible.log
232 | ```
233 | 
234 | ## Backup Configuration
235 | 
236 | ### Automated Backups
237 | 
238 | ```bash
239 | # Create backup script
240 | #!/bin/bash
241 | BACKUP_DIR="/path/to/backup"
242 | DATE=$(date +%Y%m%d_%H%M%S)
243 | 
244 | # Backup application data
245 | tar -czf $BACKUP_DIR/app_backup_$DATE.tar.gz \
246 |     datastore/ \
247 |     playbooks/ \
248 |     templates/
249 | 
250 | # Backup configuration
251 | cp ansible.cfg $BACKUP_DIR/
252 | cp inventory.ini $BACKUP_DIR/
253 | ```
254 | 
255 | ### Restore from Backup
256 | 
257 | ```bash
258 | # Restore backup
259 | tar -xzf backup/app_backup_20230908.tar.gz -C /
260 | 
261 | # Restore configuration
262 | cp backup/ansible.cfg .
263 | cp backup/inventory.ini .
264 | ```
265 | 
266 | ## Troubleshooting Configuration
267 | 
268 | ### Common Configuration Issues
269 | 
270 | **Permission denied errors**:
271 | ```bash
272 | # Check file permissions
273 | ls -la
274 | chmod 644 *.html
275 | chmod 755 *.py
276 | ```
277 | 
278 | **Ansible connection failed**:
279 | ```bash
280 | # Test SSH connection
281 | ssh -vvv user@host
282 | 
283 | # Check Ansible configuration
284 | ansible -m ping host
285 | ```
286 | 
287 | **Port binding issues**:
288 | ```bash
289 | # Check if port is in use
290 | netstat -tlnp | grep :8000
291 | 
292 | # Use different port
293 | python3 server.py --port 8080
294 | ```
295 | 
296 | ## Advanced Configuration
297 | 
298 | ### Custom Modules
299 | 
300 | Create custom Ansible modules in the `library/` directory:
301 | 
302 | ```python
303 | #!/usr/bin/python3
304 | # custom_module.py
305 | 
306 | from ansible.module_utils.basic import AnsibleModule
307 | 
308 | def main():
309 |     module = AnsibleModule(
310 |         argument_spec=dict(
311 |             name=dict(type='str', required=True),
312 |             state=dict(type='str', default='present', choices=['present', 'absent'])
313 |         )
314 |     )
315 | 
316 |     # Module logic here
317 |     module.exit_json(changed=True, result="Success")
318 | 
319 | if __name__ == '__main__':
320 |     main()
321 | ```
322 | 
323 | ### Custom Callbacks
324 | 
325 | Create custom Ansible callbacks in the `callback_plugins/` directory:
326 | 
327 | ```python
328 | # custom_callback.py
329 | from ansible.plugins.callback import CallbackBase
330 | 
331 | class CallbackModule(CallbackBase):
332 |     def v2_playbook_on_start(self, playbook):
333 |         print("Playbook started!")
334 | 
335 |     def v2_playbook_on_stats(self, stats):
336 |         print("Playbook completed!")
337 | ```
338 | 
339 | ## Next Steps
340 | 
341 | After configuration:
342 | - [[Test your setup|Basic-Usage]]
343 | - [[Create your first playbook|Playbooks]]
344 | - [[Set up monitoring|Monitoring]]
345 | - [[Review security settings|Security]]</content>
346 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/Configuration.md
347 | 


--------------------------------------------------------------------------------
/test_history.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html>
  3 | <head>
  4 |     <title>Test History</title>
  5 |     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
  6 |     <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
  7 |     <style>
  8 |         /* Footer styling */
  9 |         footer {
 10 |             margin-top: auto;
 11 |         }
 12 |         footer a:hover {
 13 |             color: #667eea !important;
 14 |         }
 15 |     </style>
 16 | </head>
 17 | <body>
 18 |     <h1>Testing History Loading</h1>
 19 |     <div id="test-output">Loading...</div>
 20 | 
 21 |     <script>
 22 |         // Simple test to see if XMLHttpRequest works
 23 |         const xhr = new XMLHttpRequest();
 24 |         xhr.open('POST', 'http://localhost:8000/get-execution-history', true);
 25 |         xhr.setRequestHeader('Content-Type', 'application/json');
 26 | 
 27 |         xhr.onreadystatechange = function() {
 28 |             if (xhr.readyState === 4) {
 29 |                 document.getElementById('test-output').innerHTML = 'Status: ' + xhr.status + '<br>Response: ' + xhr.responseText.substring(0, 200) + '...';
 30 |             }
 31 |         };
 32 | 
 33 |         xhr.send();
 34 |     </script>
 35 | 
 36 |     <!-- Footer -->
 37 |     <footer class="sticky-footer">
 38 |         <div class="container-fluid py-3">
 39 |             <div class="row align-items-center">
 40 |                 <div class="col-md-6">
 41 |                     <small class="text-muted">
 42 |                         <i class="fas fa-cogs me-1"></i>
 43 |                         <strong>Ansible Admin</strong> v2.0.0 |
 44 |                         <i class="fas fa-server me-1"></i>Server Status: <span class="text-success">Online</span> |
 45 |                         <i class="fas fa-clock me-1"></i><span id="current-time"></span>
 46 |                     </small>
 47 |                 </div>
 48 |                 <div class="col-md-6 text-md-end">
 49 |                     <small class="text-muted">
 50 |                         <i class="fas fa-code me-1"></i>Built with Python & Bootstrap |
 51 |                         <i class="fas fa-user me-1"></i>Developed by <strong>Dionipe</strong> |
 52 |                         <i class="fas fa-info-circle me-1"></i><a href="#" class="text-decoration-none" data-bs-toggle="modal" data-bs-target="#aboutModal">About</a> |
 53 |                         <i class="fas fa-heart text-danger me-1"></i>
 54 |                         <a href="#" class="text-decoration-none">IndoBSD Infrastructure</a>
 55 |                     </small>
 56 |                 </div>
 57 |             </div>
 58 |         </div>
 59 |     </footer>
 60 | 
 61 |     <!-- About Modal -->
 62 |     <div class="modal fade" id="aboutModal" tabindex="-1" aria-labelledby="aboutModalLabel" aria-hidden="true">
 63 |         <div class="modal-dialog modal-dialog-centered">
 64 |             <div class="modal-content glass-card">
 65 |                 <div class="modal-header">
 66 |                     <h5 class="modal-title" id="aboutModalLabel">
 67 |                         <i class="fas fa-info-circle me-2"></i>About Ansible Admin
 68 |                     </h5>
 69 |                     <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
 70 |                 </div>
 71 |                 <div class="modal-body">
 72 |                     <div class="text-center mb-4">
 73 |                         <i class="fas fa-cogs fa-3x text-primary mb-3"></i>
 74 |                         <h4>Ansible Admin v2.0.0</h4>
 75 |                         <p class="text-muted">Modern Ansible Management Interface</p>
 76 |                         <div class="mb-3">
 77 |                             <span class="badge bg-success me-2">Latest Version</span>
 78 |                             <small class="text-muted">Released: September 8, 2025</small>
 79 |                         </div>
 80 |                     </div>
 81 |                     <div class="row">
 82 |                         <div class="col-md-6">
 83 |                             <h6><i class="fas fa-code me-2"></i>Technologies</h6>
 84 |                             <ul class="list-unstyled">
 85 |                                 <li><i class="fab fa-python me-2"></i>Python Backend</li>
 86 |                                 <li><i class="fas fa-globe me-2"></i>Web Interface</li>
 87 |                                 <li><i class="fas fa-server me-2"></i>Ansible Integration</li>
 88 |                                 <li><i class="fas fa-database me-2"></i>Real-time Updates</li>
 89 |                             </ul>
 90 | 
 91 |                             <h6><i class="fas fa-file-alt me-2"></i>Documentation</h6>
 92 |                             <ul class="list-unstyled">
 93 |                                 <li><i class="fas fa-book me-2"></i><a href="README.md" target="_blank" class="text-decoration-none">README</a></li>
 94 |                                 <li><i class="fas fa-history me-2"></i><a href="CHANGELOG.md" target="_blank" class="text-decoration-none">Changelog</a></li>
 95 |                                 <li><i class="fas fa-question-circle me-2"></i><a href="/usage" class="text-decoration-none">Usage Guide</a></li>
 96 |                             </ul>
 97 |                         </div>
 98 |                         <div class="col-md-6">
 99 |                             <h6><i class="fas fa-user me-2"></i>Developer</h6>
100 |                             <p><strong>Dionipe</strong></p>
101 |                             <p class="text-muted small">Full-stack Developer & DevOps Engineer</p>
102 |                             
103 |                             <h6><i class="fas fa-code-branch me-2"></i>My Projects</h6>
104 |                             <div class="mb-2">
105 |                                 <a href="https://github.com/dionipe/" target="_blank" class="btn btn-sm btn-outline-primary me-2 mb-1">
106 |                                     <i class="fab fa-github me-1"></i>GitHub Profile
107 |                                 </a>
108 |                                 <a href="https://github.com/dionipe/Bootstrap-Kubernetes-on-Proxmox-with-Qemu" target="_blank" class="btn btn-sm btn-outline-success me-2 mb-1">
109 |                                     <i class="fas fa-star me-1"></i>K8s on Proxmox
110 |                                 </a>
111 |                             </div>
112 |                             <p class="text-muted small mb-2">Explore 39+ open source projects</p>
113 |                             
114 |                             <h6><i class="fas fa-building me-2"></i>Organization</h6>
115 |                             <p>IndoBSD Infrastructure</p>
116 | 
117 |                             <h6><i class="fas fa-calendar me-2"></i>Version Info</h6>
118 |                             <ul class="list-unstyled small">
119 |                                 <li><strong>Current:</strong> v2.0.0</li>
120 |                                 <li><strong>Release Date:</strong> 2025-09-08</li>
121 |                                 <li><strong>Status:</strong> <span class="badge bg-success">Stable</span></li>
122 |                             </ul>
123 |                         </div>
124 |                     </div>
125 |                     <hr>
126 |                     <div class="text-center">
127 |                         <p class="mb-2"><strong>Features:</strong></p>
128 |                         <div class="row text-start">
129 |                             <div class="col-md-6">
130 |                                 <ul class="list-unstyled small">
131 |                                     <li><i class="fas fa-check text-success me-2"></i>Playbook Management</li>
132 |                                     <li><i class="fas fa-check text-success me-2"></i>Inventory Control</li>
133 |                                     <li><i class="fas fa-check text-success me-2"></i>Real-time Execution</li>
134 |                                 </ul>
135 |                             </div>
136 |                             <div class="col-md-6">
137 |                                 <ul class="list-unstyled small">
138 |                                     <li><i class="fas fa-check text-success me-2"></i>OS Updates</li>
139 |                                     <li><i class="fas fa-check text-success me-2"></i>Execution History</li>
140 |                                     <li><i class="fas fa-check text-success me-2"></i>Modern UI Design</li>
141 |                                 </ul>
142 |                             </div>
143 |                         </div>
144 |                     </div>
145 |                 </div>
146 |                 <div class="modal-footer">
147 |                     <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
148 |                     <button type="button" class="btn btn-primary">
149 |                         <i class="fas fa-external-link-alt me-2"></i>Visit Repository
150 |                     </button>
151 |                 </div>
152 |             </div>
153 |         </div>
154 |     </div>
155 | 
156 |     <script>
157 |         // Update current time in footer
158 |         function updateTime() {
159 |             const now = new Date();
160 |             const timeString = now.toLocaleTimeString();
161 |             document.getElementById('current-time').textContent = timeString;
162 |         }
163 | 
164 |         // Update time every second
165 |         setInterval(updateTime, 1000);
166 |         updateTime(); // Initial call
167 |     </script>
168 | </body>
169 | </html>
170 | 


--------------------------------------------------------------------------------
/wiki/Troubleshooting.md:
--------------------------------------------------------------------------------
  1 | # Troubleshooting Guide
  2 | 
  3 | This guide helps you diagnose and resolve common issues with Ansible Admin.
  4 | 
  5 | ## Quick Diagnosis
  6 | 
  7 | ### System Health Check
  8 | 
  9 | Run this command to check system health:
 10 | 
 11 | ```bash
 12 | # Check if server is running
 13 | curl -s http://localhost:8000 | head -20
 14 | 
 15 | # Check Python version
 16 | python3 --version
 17 | 
 18 | # Check Ansible version
 19 | ansible --version
 20 | 
 21 | # Check disk space
 22 | df -h
 23 | 
 24 | # Check memory usage
 25 | free -h
 26 | ```
 27 | 
 28 | ### Log Analysis
 29 | 
 30 | Check application logs:
 31 | 
 32 | ```bash
 33 | # View recent logs
 34 | tail -f ansible-admin.log
 35 | 
 36 | # Search for errors
 37 | grep "ERROR" ansible-admin.log
 38 | 
 39 | # Check Ansible logs
 40 | tail -f /var/log/ansible.log
 41 | ```
 42 | 
 43 | ## Common Issues and Solutions
 44 | 
 45 | ### Server Won't Start
 46 | 
 47 | **Issue**: Server fails to start on port 8000
 48 | 
 49 | **Solutions**:
 50 | 
 51 | 1. **Port already in use**:
 52 |    ```bash
 53 |    # Find process using port 8000
 54 |    lsof -i :8000
 55 | 
 56 |    # Kill the process
 57 |    kill -9 <PID>
 58 | 
 59 |    # Or use different port
 60 |    python3 server.py --port 8080
 61 |    ```
 62 | 
 63 | 2. **Permission denied**:
 64 |    ```bash
 65 |    # Check file permissions
 66 |    ls -la server.py
 67 | 
 68 |    # Fix permissions
 69 |    chmod +x server.py
 70 |    ```
 71 | 
 72 | 3. **Missing dependencies**:
 73 |    ```bash
 74 |    # Install missing packages
 75 |    pip3 install -r requirements.txt
 76 | 
 77 |    # Install Ansible collections
 78 |    ansible-galaxy collection install -r requirements.yml
 79 |    ```
 80 | 
 81 | ### Web Interface Not Loading
 82 | 
 83 | **Issue**: Browser shows connection error
 84 | 
 85 | **Solutions**:
 86 | 
 87 | 1. **Firewall blocking**:
 88 |    ```bash
 89 |    # Check firewall status
 90 |    sudo ufw status
 91 | 
 92 |    # Allow port 8000
 93 |    sudo ufw allow 8000
 94 |    ```
 95 | 
 96 | 2. **Wrong host binding**:
 97 |    ```python
 98 |    # In server.py, change:
 99 |    HOST = '127.0.0.1'  # Only localhost
100 |    # To:
101 |    HOST = '0.0.0.0'   # All interfaces
102 |    ```
103 | 
104 | 3. **Browser cache**:
105 |    - Hard refresh: `Ctrl+F5` (Windows/Linux) or `Cmd+Shift+R` (macOS)
106 |    - Clear browser cache
107 |    - Try incognito mode
108 | 
109 | ### Ansible Connection Issues
110 | 
111 | **Issue**: Playbook execution fails with connection errors
112 | 
113 | **Solutions**:
114 | 
115 | 1. **SSH key issues**:
116 |    ```bash
117 |    # Test SSH connection
118 |    ssh -v user@host
119 | 
120 |    # Check SSH key permissions
121 |    ls -la ~/.ssh/
122 |    chmod 600 ~/.ssh/id_rsa
123 |    chmod 644 ~/.ssh/id_rsa.pub
124 |    ```
125 | 
126 | 2. **Host key verification**:
127 |    ```bash
128 |    # Disable host key checking (temporary)
129 |    export ANSIBLE_HOST_KEY_CHECKING=False
130 | 
131 |    # Or add to ansible.cfg
132 |    [defaults]
133 |    host_key_checking = false
134 |    ```
135 | 
136 | 3. **Python interpreter**:
137 |    ```bash
138 |    # Check Python on target host
139 |    ssh user@host python --version
140 | 
141 |    # Specify Python path
142 |    ansible_host: 192.168.1.10
143 |    ansible_python_interpreter: /usr/bin/python3
144 |    ```
145 | 
146 | ### Playbook Execution Problems
147 | 
148 | **Issue**: Playbooks fail to execute properly
149 | 
150 | **Solutions**:
151 | 
152 | 1. **Syntax errors**:
153 |    ```bash
154 |    # Validate playbook syntax
155 |    ansible-playbook --syntax-check playbook.yml
156 | 
157 |    # Dry run
158 |    ansible-playbook --check playbook.yml
159 |    ```
160 | 
161 | 2. **Variable issues**:
162 |    ```yaml
163 |    # Check variable definitions
164 |    - debug:
165 |        var: my_variable
166 | 
167 |    # Use proper quoting
168 |    my_variable: "{{ ansible_hostname }}"
169 |    ```
170 | 
171 | 3. **Privilege escalation**:
172 |    ```yaml
173 |    # Add become
174 |    - name: Install package
175 |      apt:
176 |        name: nginx
177 |        state: present
178 |      become: yes
179 |    ```
180 | 
181 | ### Performance Issues
182 | 
183 | **Issue**: Slow response times or high resource usage
184 | 
185 | **Solutions**:
186 | 
187 | 1. **Memory optimization**:
188 |    ```python
189 |    # Reduce memory usage in server.py
190 |    MAX_WORKERS = 4  # Reduce from default
191 |    ```
192 | 
193 | 2. **Ansible optimization**:
194 |    ```ini
195 |    # In ansible.cfg
196 |    [defaults]
197 |    forks = 10  # Reduce parallel processes
198 |    timeout = 30  # Connection timeout
199 |    ```
200 | 
201 | 3. **Database optimization**:
202 |    ```bash
203 |    # Clean up old execution data
204 |    find datastore/ -name "*.json" -mtime +30 -delete
205 |    ```
206 | 
207 | ### File Upload Issues
208 | 
209 | **Issue**: Cannot upload playbooks or templates
210 | 
211 | **Solutions**:
212 | 
213 | 1. **File size limits**:
214 |    ```python
215 |    # Increase upload limit in server.py
216 |    MAX_CONTENT_LENGTH = 100 * 1024 * 1024  # 100MB
217 |    ```
218 | 
219 | 2. **Permission issues**:
220 |    ```bash
221 |    # Check directory permissions
222 |    ls -la playbooks/
223 |    chmod 755 playbooks/
224 |    ```
225 | 
226 | 3. **File type restrictions**:
227 |    ```python
228 |    # Allow more file types
229 |    ALLOWED_EXTENSIONS = {'yml', 'yaml', 'j2', 'txt'}
230 |    ```
231 | 
232 | ## Advanced Troubleshooting
233 | 
234 | ### Debug Mode
235 | 
236 | Enable debug mode for detailed logging:
237 | 
238 | ```python
239 | # In server.py
240 | DEBUG = True
241 | LOG_LEVEL = 'DEBUG'
242 | ```
243 | 
244 | ### Network Debugging
245 | 
246 | ```bash
247 | # Test network connectivity
248 | ping host
249 | 
250 | # Test port connectivity
251 | telnet host 22
252 | 
253 | # Check DNS resolution
254 | nslookup host
255 | ```
256 | 
257 | ### Ansible Debugging
258 | 
259 | ```bash
260 | # Verbose output
261 | ansible-playbook -vvv playbook.yml
262 | 
263 | # Debug specific task
264 | - name: Debug task
265 |   debug:
266 |     var: ansible_facts
267 | 
268 | # Check facts
269 | ansible -m setup host
270 | ```
271 | 
272 | ### Database Issues
273 | 
274 | **Issue**: Data corruption or missing files
275 | 
276 | **Solutions**:
277 | 
278 | 1. **Backup data**:
279 |    ```bash
280 |    # Create backup
281 |    tar -czf backup_$(date +%Y%m%d).tar.gz datastore/
282 |    ```
283 | 
284 | 2. **Repair data**:
285 |    ```python
286 |    # Python script to repair JSON files
287 |    import json
288 |    import os
289 | 
290 |    def repair_json(file_path):
291 |        try:
292 |            with open(file_path, 'r') as f:
293 |                data = json.load(f)
294 |            print(f"{file_path}: OK")
295 |        except json.JSONDecodeError:
296 |            print(f"{file_path}: CORRUPTED")
297 |            # Attempt repair or recreate
298 |    ```
299 | 
300 | 3. **Reset datastore**:
301 |    ```bash
302 |    # WARNING: This will delete all data
303 |    rm -rf datastore/*
304 |    mkdir -p datastore
305 |    ```
306 | 
307 | ## Monitoring and Alerts
308 | 
309 | ### System Monitoring
310 | 
311 | Set up monitoring for common issues:
312 | 
313 | ```bash
314 | # Monitor server process
315 | ps aux | grep python3
316 | 
317 | # Monitor port
318 | netstat -tlnp | grep :8000
319 | 
320 | # Monitor disk usage
321 | df -h | grep -E "9[0-9]|100"
322 | 
323 | # Monitor memory
324 | free -h
325 | ```
326 | 
327 | ### Log Monitoring
328 | 
329 | ```bash
330 | # Monitor logs in real-time
331 | tail -f ansible-admin.log | grep -E "ERROR|WARNING"
332 | 
333 | # Set up log rotation
334 | # /etc/logrotate.d/ansible-admin
335 | /var/log/ansible-admin.log {
336 |     daily
337 |     rotate 7
338 |     compress
339 |     missingok
340 |     notifempty
341 | }
342 | ```
343 | 
344 | ## Recovery Procedures
345 | 
346 | ### Emergency Recovery
347 | 
348 | 1. **Stop the server**:
349 |    ```bash
350 |    pkill -f server.py
351 |    ```
352 | 
353 | 2. **Backup current state**:
354 |    ```bash
355 |    tar -czf emergency_backup_$(date +%Y%m%d_%H%M%S).tar.gz .
356 |    ```
357 | 
358 | 3. **Reset to clean state**:
359 |    ```bash
360 |    # Remove temporary files
361 |    find . -name "*.pyc" -delete
362 |    find . -name "__pycache__" -type d -exec rm -rf {} +
363 | 
364 |    # Reset datastore
365 |    rm -rf datastore/*
366 |    mkdir -p datastore
367 |    ```
368 | 
369 | 4. **Restart services**:
370 |    ```bash
371 |    # Start fresh
372 |    python3 server.py
373 |    ```
374 | 
375 | ### Data Recovery
376 | 
377 | 1. **From backup**:
378 |    ```bash
379 |    # Restore from backup
380 |    tar -xzf backup_20230908.tar.gz -C /
381 |    ```
382 | 
383 | 2. **Partial recovery**:
384 |    ```bash
385 |    # Restore specific files
386 |    cp backup/datastore/executions.json datastore/
387 |    ```
388 | 
389 | ## Support Resources
390 | 
391 | ### Getting Help
392 | 
393 | 1. **Check documentation**:
394 |    - [[Installation Guide|Installation]]
395 |    - [[Configuration Guide|Configuration]]
396 |    - [[API Reference|API-Reference]]
397 | 
398 | 2. **Community support**:
399 |    - [GitHub Issues](https://github.com/dionipe/ansible-admin/issues)
400 |    - [GitHub Discussions](https://github.com/dionipe/ansible-admin/discussions)
401 | 
402 | 3. **Debug information**:
403 |    ```bash
404 |    # Collect system information
405 |    uname -a > debug_info.txt
406 |    python3 --version >> debug_info.txt
407 |    ansible --version >> debug_info.txt
408 |    pip3 list >> debug_info.txt
409 |    ```
410 | 
411 | ### Preventive Measures
412 | 
413 | 1. **Regular backups**:
414 |    ```bash
415 |    # Add to crontab
416 |    0 2 * * * tar -czf /backup/ansible-admin-$(date +\%Y\%m\%d).tar.gz /path/to/ansible-admin
417 |    ```
418 | 
419 | 2. **Monitor system resources**:
420 |    ```bash
421 |    # Install monitoring tools
422 |    sudo apt install htop iotop
423 |    ```
424 | 
425 | 3. **Keep dependencies updated**:
426 |    ```bash
427 |    # Update Python packages
428 |    pip3 install --upgrade -r requirements.txt
429 | 
430 |    # Update Ansible
431 |    sudo apt update && sudo apt upgrade ansible
432 |    ```
433 | 
434 | ## Common Error Messages
435 | 
436 | | Error Message | Likely Cause | Solution |
437 | |---------------|--------------|----------|
438 | | `Connection refused` | Server not running | Start server with `python3 server.py` |
439 | | `Permission denied` | File permissions | Check and fix with `chmod` |
440 | | `Module not found` | Missing dependency | Install with `pip3 install` |
441 | | `SSH connection failed` | SSH key or config | Check SSH setup and keys |
442 | | `Syntax error` | YAML formatting | Validate with `ansible-playbook --syntax-check` |
443 | | `Timeout` | Network or performance | Increase timeout or check network |
444 | 
445 | ## Performance Tuning
446 | 
447 | ### Server Optimization
448 | 
449 | ```python
450 | # Optimize server settings
451 | MAX_WORKERS = 8
452 | TIMEOUT = 30
453 | MAX_REQUEST_SIZE = 50 * 1024 * 1024  # 50MB
454 | ```
455 | 
456 | ### Ansible Optimization
457 | 
458 | ```ini
459 | # ansible.cfg optimization
460 | [defaults]
461 | forks = 20
462 | timeout = 30
463 | poll_interval = 15
464 | gathering = smart
465 | fact_caching = jsonfile
466 | fact_caching_connection = /tmp/ansible_facts
467 | fact_caching_timeout = 86400
468 | ```
469 | 
470 | ## Next Steps
471 | 
472 | If you can't resolve an issue:
473 | - [[Create a detailed bug report|Contributing]]
474 | - [[Check for similar issues|FAQ]]
475 | - [[Contact the maintainers|Support]]</content>
476 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/Troubleshooting.md
477 | 


--------------------------------------------------------------------------------
/wiki/API-Reference.md:
--------------------------------------------------------------------------------
  1 | # API Reference
  2 | 
  3 | This document provides comprehensive information about Ansible Admin's REST API endpoints.
  4 | 
  5 | ## Base URL
  6 | 
  7 | ```
  8 | http://localhost:8000
  9 | ```
 10 | 
 11 | ## Authentication
 12 | 
 13 | Currently, the API does not require authentication. Authentication may be added in future versions.
 14 | 
 15 | ## Response Format
 16 | 
 17 | All API responses are in JSON format:
 18 | 
 19 | ```json
 20 | {
 21 |   "success": true,
 22 |   "data": {},
 23 |   "message": "Operation completed successfully"
 24 | }
 25 | ```
 26 | 
 27 | ## Error Responses
 28 | 
 29 | Error responses follow this format:
 30 | 
 31 | ```json
 32 | {
 33 |   "success": false,
 34 |   "error": "Error message",
 35 |   "code": "ERROR_CODE"
 36 | }
 37 | ```
 38 | 
 39 | ## Endpoints
 40 | 
 41 | ### Playbook Management
 42 | 
 43 | #### GET /api/list-playbooks
 44 | 
 45 | List all available playbooks.
 46 | 
 47 | **Response:**
 48 | ```json
 49 | {
 50 |   "success": true,
 51 |   "data": {
 52 |     "playbooks": [
 53 |       {
 54 |         "name": "nginx-setup.yml",
 55 |         "path": "/app/playbooks/nginx-setup.yml",
 56 |         "size": 1024,
 57 |         "modified": "2023-09-08T10:30:00Z"
 58 |       }
 59 |     ]
 60 |   }
 61 | }
 62 | ```
 63 | 
 64 | #### POST /api/save-playbook
 65 | 
 66 | Save a playbook to the server.
 67 | 
 68 | **Request Body:**
 69 | ```json
 70 | {
 71 |   "name": "my-playbook.yml",
 72 |   "content": "---\n- hosts: all\n  tasks:\n    - name: Hello World\n      debug:\n        msg: 'Hello World'"
 73 | }
 74 | ```
 75 | 
 76 | **Response:**
 77 | ```json
 78 | {
 79 |   "success": true,
 80 |   "message": "Playbook saved successfully"
 81 | }
 82 | ```
 83 | 
 84 | #### POST /api/delete-playbook
 85 | 
 86 | Delete a playbook from the server.
 87 | 
 88 | **Request Body:**
 89 | ```json
 90 | {
 91 |   "name": "my-playbook.yml"
 92 | }
 93 | ```
 94 | 
 95 | **Response:**
 96 | ```json
 97 | {
 98 |   "success": true,
 99 |   "message": "Playbook deleted successfully"
100 | }
101 | ```
102 | 
103 | ### Template Management
104 | 
105 | #### GET /api/list-jinja-templates
106 | 
107 | List all available Jinja2 templates.
108 | 
109 | **Response:**
110 | ```json
111 | {
112 |   "success": true,
113 |   "data": {
114 |     "templates": [
115 |       {
116 |         "name": "nginx-config.j2",
117 |         "path": "/app/templates/nginx-config.j2",
118 |         "variables": ["server_name", "port"]
119 |       }
120 |     ]
121 |   }
122 | }
123 | ```
124 | 
125 | #### GET /api/get-jinja-template
126 | 
127 | Get the content of a specific template.
128 | 
129 | **Parameters:**
130 | - `name` (string): Template name
131 | 
132 | **Example:**
133 | ```
134 | GET /api/get-jinja-template?name=nginx-config.j2
135 | ```
136 | 
137 | **Response:**
138 | ```json
139 | {
140 |   "success": true,
141 |   "data": {
142 |     "name": "nginx-config.j2",
143 |     "content": "server {\n    listen {{ port }};\n    server_name {{ server_name }};\n}",
144 |     "variables": ["server_name", "port"]
145 |   }
146 | }
147 | ```
148 | 
149 | ### Execution Management
150 | 
151 | #### POST /execute-playbook
152 | 
153 | Execute an Ansible playbook.
154 | 
155 | **Request Body:**
156 | ```json
157 | {
158 |   "playbook": "nginx-setup.yml",
159 |   "inventory": "webservers",
160 |   "extra_vars": {
161 |     "version": "1.20",
162 |     "environment": "production"
163 |   },
164 |   "options": {
165 |     "verbose": 2,
166 |     "check": false,
167 |     "diff": true
168 |   }
169 | }
170 | ```
171 | 
172 | **Response:**
173 | ```json
174 | {
175 |   "success": true,
176 |   "data": {
177 |     "execution_id": "exec_123456789",
178 |     "status": "running"
179 |   }
180 | }
181 | ```
182 | 
183 | #### GET /execution-stream/{execution_id}
184 | 
185 | Stream execution output in real-time.
186 | 
187 | **Parameters:**
188 | - `execution_id` (string): Execution identifier
189 | 
190 | **Response:** Server-Sent Events stream
191 | ```
192 | data: {"type": "output", "data": "TASK [Gathering Facts] *************\n"}
193 | 
194 | data: {"type": "status", "data": {"status": "running", "progress": 25}}
195 | 
196 | data: {"type": "complete", "data": {"status": "success", "duration": 45.2}}
197 | ```
198 | 
199 | #### POST /cancel-execution
200 | 
201 | Cancel a running execution.
202 | 
203 | **Request Body:**
204 | ```json
205 | {
206 |   "execution_id": "exec_123456789"
207 | }
208 | ```
209 | 
210 | **Response:**
211 | ```json
212 | {
213 |   "success": true,
214 |   "message": "Execution cancelled successfully"
215 | }
216 | ```
217 | 
218 | ### History Management
219 | 
220 | #### GET /get-execution-history
221 | 
222 | Get execution history with pagination.
223 | 
224 | **Parameters:**
225 | - `page` (integer, optional): Page number (default: 1)
226 | - `limit` (integer, optional): Items per page (default: 10)
227 | - `status` (string, optional): Filter by status
228 | - `playbook` (string, optional): Filter by playbook name
229 | 
230 | **Example:**
231 | ```
232 | GET /get-execution-history?page=1&limit=20&status=success
233 | ```
234 | 
235 | **Response:**
236 | ```json
237 | {
238 |   "success": true,
239 |   "data": {
240 |     "executions": [
241 |       {
242 |         "id": "exec_123456789",
243 |         "playbook": "nginx-setup.yml",
244 |         "status": "success",
245 |         "start_time": "2023-09-08T10:30:00Z",
246 |         "end_time": "2023-09-08T10:31:15Z",
247 |         "duration": 75,
248 |         "target_hosts": ["web1", "web2"],
249 |         "executed_by": "admin"
250 |       }
251 |     ],
252 |     "pagination": {
253 |       "page": 1,
254 |       "limit": 20,
255 |       "total": 150,
256 |       "pages": 8
257 |     }
258 |   }
259 | }
260 | ```
261 | 
262 | #### GET /execution-details/{execution_id}
263 | 
264 | Get detailed information about a specific execution.
265 | 
266 | **Parameters:**
267 | - `execution_id` (string): Execution identifier
268 | 
269 | **Response:**
270 | ```json
271 | {
272 |   "success": true,
273 |   "data": {
274 |     "id": "exec_123456789",
275 |     "playbook": "nginx-setup.yml",
276 |     "inventory": "webservers",
277 |     "extra_vars": {"version": "1.20"},
278 |     "output": "TASK [Gathering Facts] *************\nok: [web1]\nok: [web2]\n...",
279 |     "status": "success",
280 |     "start_time": "2023-09-08T10:30:00Z",
281 |     "end_time": "2023-09-08T10:31:15Z",
282 |     "duration": 75,
283 |     "error_message": null
284 |   }
285 | }
286 | ```
287 | 
288 | ### Inventory Management
289 | 
290 | #### GET /api/list-inventory
291 | 
292 | List all inventory hosts and groups.
293 | 
294 | **Response:**
295 | ```json
296 | {
297 |   "success": true,
298 |   "data": {
299 |     "groups": [
300 |       {
301 |         "name": "webservers",
302 |         "hosts": ["web1", "web2"],
303 |         "variables": {"http_port": 80}
304 |       }
305 |     ],
306 |     "ungrouped": ["db1"]
307 |   }
308 | }
309 | ```
310 | 
311 | #### POST /api/add-host
312 | 
313 | Add a new host to inventory.
314 | 
315 | **Request Body:**
316 | ```json
317 | {
318 |   "name": "web3",
319 |   "ip": "192.168.1.13",
320 |   "group": "webservers",
321 |   "variables": {
322 |     "ansible_user": "admin",
323 |     "ansible_ssh_private_key_file": "/home/admin/.ssh/id_rsa"
324 |   }
325 | }
326 | ```
327 | 
328 | #### POST /api/update-host
329 | 
330 | Update an existing host.
331 | 
332 | **Request Body:**
333 | ```json
334 | {
335 |   "name": "web3",
336 |   "ip": "192.168.1.14",
337 |   "variables": {
338 |     "ansible_user": "ubuntu"
339 |   }
340 | }
341 | ```
342 | 
343 | ### System Management
344 | 
345 | #### GET /api/system-status
346 | 
347 | Get system status and health information.
348 | 
349 | **Response:**
350 | ```json
351 | {
352 |   "success": true,
353 |   "data": {
354 |     "cpu_usage": 45.2,
355 |     "memory_usage": 67.8,
356 |     "disk_usage": 23.1,
357 |     "uptime": "5 days, 3 hours",
358 |     "load_average": [1.2, 1.1, 1.0]
359 |   }
360 | }
361 | ```
362 | 
363 | #### GET /api/logs
364 | 
365 | Get application logs.
366 | 
367 | **Parameters:**
368 | - `lines` (integer, optional): Number of lines to return (default: 100)
369 | - `level` (string, optional): Log level filter
370 | 
371 | **Example:**
372 | ```
373 | GET /api/logs?lines=50&level=ERROR
374 | ```
375 | 
376 | **Response:**
377 | ```json
378 | {
379 |   "success": true,
380 |   "data": {
381 |     "logs": [
382 |       {
383 |         "timestamp": "2023-09-08T10:30:00Z",
384 |         "level": "INFO",
385 |         "message": "Playbook execution started"
386 |       }
387 |     ]
388 |   }
389 | }
390 | ```
391 | 
392 | ## Rate Limiting
393 | 
394 | - **General limit**: 100 requests per minute per IP
395 | - **Execution endpoints**: 10 concurrent executions
396 | - **Streaming endpoints**: No limit (but monitored)
397 | 
398 | ## Error Codes
399 | 
400 | | Code | Description |
401 | |------|-------------|
402 | | `INVALID_REQUEST` | Malformed request data |
403 | | `PLAYBOOK_NOT_FOUND` | Specified playbook doesn't exist |
404 | | `EXECUTION_FAILED` | Playbook execution failed |
405 | | `PERMISSION_DENIED` | Insufficient permissions |
406 | | `RATE_LIMIT_EXCEEDED` | Too many requests |
407 | | `INTERNAL_ERROR` | Server internal error |
408 | 
409 | ## SDK Examples
410 | 
411 | ### Python
412 | 
413 | ```python
414 | import requests
415 | 
416 | class AnsibleAdminClient:
417 |     def __init__(self, base_url="http://localhost:8000"):
418 |         self.base_url = base_url
419 | 
420 |     def list_playbooks(self):
421 |         response = requests.get(f"{self.base_url}/api/list-playbooks")
422 |         return response.json()
423 | 
424 |     def execute_playbook(self, playbook, inventory, extra_vars=None):
425 |         data = {
426 |             "playbook": playbook,
427 |             "inventory": inventory,
428 |             "extra_vars": extra_vars or {}
429 |         }
430 |         response = requests.post(f"{self.base_url}/execute-playbook", json=data)
431 |         return response.json()
432 | ```
433 | 
434 | ### JavaScript
435 | 
436 | ```javascript
437 | class AnsibleAdminAPI {
438 |     constructor(baseURL = 'http://localhost:8000') {
439 |         this.baseURL = baseURL;
440 |     }
441 | 
442 |     async listPlaybooks() {
443 |         const response = await fetch(`${this.baseURL}/api/list-playbooks`);
444 |         return await response.json();
445 |     }
446 | 
447 |     async executePlaybook(playbook, inventory, extraVars = {}) {
448 |         const response = await fetch(`${this.baseURL}/execute-playbook`, {
449 |             method: 'POST',
450 |             headers: {
451 |                 'Content-Type': 'application/json',
452 |             },
453 |             body: JSON.stringify({
454 |                 playbook,
455 |                 inventory,
456 |                 extra_vars: extraVars
457 |             })
458 |         });
459 |         return await response.json();
460 |     }
461 | }
462 | ```
463 | 
464 | ### cURL Examples
465 | 
466 | ```bash
467 | # List playbooks
468 | curl -X GET http://localhost:8000/api/list-playbooks
469 | 
470 | # Execute playbook
471 | curl -X POST http://localhost:8000/execute-playbook \
472 |   -H "Content-Type: application/json" \
473 |   -d '{
474 |     "playbook": "nginx-setup.yml",
475 |     "inventory": "webservers",
476 |     "extra_vars": {"version": "1.20"}
477 |   }'
478 | 
479 | # Get execution history
480 | curl -X GET "http://localhost:8000/get-execution-history?page=1&limit=10"
481 | ```
482 | 
483 | ## Webhooks
484 | 
485 | Configure webhooks for execution events:
486 | 
487 | ```json
488 | {
489 |   "url": "https://your-app.com/webhook",
490 |   "events": ["execution_started", "execution_completed", "execution_failed"],
491 |   "secret": "your-webhook-secret"
492 | }
493 | ```
494 | 
495 | ## Versioning
496 | 
497 | API versioning follows semantic versioning:
498 | - **v1.0.0**: Initial release
499 | - **v2.0.0**: Current version with enhanced features
500 | 
501 | ## Support
502 | 
503 | For API support:
504 | - Check the [[Troubleshooting|Troubleshooting]] guide
505 | - Review [GitHub Issues](https://github.com/dionipe/ansible-admin/issues) for similar problems
506 | - Create detailed bug reports with request/response examples</content>
507 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/API-Reference.md
508 | 


--------------------------------------------------------------------------------
/wiki/FAQ.md:
--------------------------------------------------------------------------------
  1 | # Frequently Asked Questions
  2 | 
  3 | This page addresses the most common questions about Ansible Admin.
  4 | 
  5 | ## General Questions
  6 | 
  7 | ### What is Ansible Admin?
  8 | 
  9 | Ansible Admin is a modern web-based interface for managing and executing Ansible playbooks. It provides:
 10 | 
 11 | - **Web Interface**: Easy-to-use graphical interface
 12 | - **Real-time Monitoring**: Live execution tracking
 13 | - **Template System**: Reusable playbook templates
 14 | - **Execution History**: Complete audit trail
 15 | - **Multi-user Support**: Role-based access control
 16 | 
 17 | ### Is it free?
 18 | 
 19 | Yes, Ansible Admin is completely free and open source, licensed under the MIT License.
 20 | 
 21 | ### What are the system requirements?
 22 | 
 23 | **Minimum Requirements:**
 24 | - Python 3.8+
 25 | - Ansible 2.9+
 26 | - 2GB RAM
 27 | - 10GB disk space
 28 | - Modern web browser
 29 | 
 30 | **Recommended:**
 31 | - Python 3.9+
 32 | - Ansible 2.12+
 33 | - 4GB RAM
 34 | - 20GB disk space
 35 | - Chrome/Firefox latest version
 36 | 
 37 | ## Installation
 38 | 
 39 | ### How do I install Ansible Admin?
 40 | 
 41 | See the [[Installation Guide|Installation]] for detailed instructions.
 42 | 
 43 | **Quick installation:**
 44 | ```bash
 45 | git clone https://github.com/dionipe/ansible-admin.git
 46 | cd ansible-admin
 47 | pip3 install -r requirements.txt
 48 | python3 server.py
 49 | ```
 50 | 
 51 | ### Can I run it on Windows?
 52 | 
 53 | Yes, but it's recommended to use Windows Subsystem for Linux (WSL) for the best experience.
 54 | 
 55 | ### Can I use Docker?
 56 | 
 57 | Yes, a Docker setup is available:
 58 | 
 59 | ```bash
 60 | docker build -t ansible-admin .
 61 | docker run -p 8000:8000 ansible-admin
 62 | ```
 63 | 
 64 | ## Usage
 65 | 
 66 | ### How do I create my first playbook?
 67 | 
 68 | 1. Navigate to the "Playbooks" section
 69 | 2. Click "New Playbook"
 70 | 3. Enter a name and description
 71 | 4. Write your Ansible YAML content
 72 | 5. Save and execute
 73 | 
 74 | **Example playbook:**
 75 | ```yaml
 76 | ---
 77 | - name: Basic server setup
 78 |   hosts: webservers
 79 |   become: yes
 80 |   tasks:
 81 |     - name: Update package cache
 82 |       apt:
 83 |         update_cache: yes
 84 | 
 85 |     - name: Install nginx
 86 |       apt:
 87 |         name: nginx
 88 |         state: present
 89 | ```
 90 | 
 91 | ### How do I add hosts to inventory?
 92 | 
 93 | 1. Go to the "Inventory" section
 94 | 2. Click "Add Host"
 95 | 3. Enter hostname/IP address
 96 | 4. Specify connection details (SSH key, user, etc.)
 97 | 5. Assign to groups if needed
 98 | 
 99 | ### Why is my playbook execution failing?
100 | 
101 | Common reasons:
102 | 
103 | 1. **SSH connection issues**:
104 |    - Check SSH key permissions: `chmod 600 ~/.ssh/id_rsa`
105 |    - Verify host key: `ssh-keyscan host >> ~/.ssh/known_hosts`
106 | 
107 | 2. **Permission problems**:
108 |    - Add `become: yes` for privileged operations
109 |    - Check sudo configuration on target hosts
110 | 
111 | 3. **Syntax errors**:
112 |    - Validate YAML: `ansible-playbook --syntax-check playbook.yml`
113 |    - Check indentation and quotes
114 | 
115 | 4. **Missing dependencies**:
116 |    - Install required Ansible collections
117 |    - Update Python packages
118 | 
119 | ### How do I monitor execution in real-time?
120 | 
121 | Ansible Admin provides live monitoring:
122 | 
123 | 1. Execute a playbook
124 | 2. Watch the real-time output stream
125 | 3. Monitor progress indicators
126 | 4. View color-coded results
127 | 5. Stop execution if needed
128 | 
129 | ### Can I schedule playbook execution?
130 | 
131 | Currently, scheduling is not built-in, but you can:
132 | 
133 | 1. Use cron jobs to trigger executions
134 | 2. Create wrapper scripts
135 | 3. Use external scheduling tools like Jenkins or Airflow
136 | 
137 | ## Configuration
138 | 
139 | ### How do I configure Ansible settings?
140 | 
141 | Edit the `ansible.cfg` file:
142 | 
143 | ```ini
144 | [defaults]
145 | inventory = ./inventory.ini
146 | stdout_callback = community.general.unixy
147 | force_color = true
148 | host_key_checking = false
149 | timeout = 30
150 | ```
151 | 
152 | ### How do I change the server port?
153 | 
154 | Edit `server.py`:
155 | 
156 | ```python
157 | # Change this line
158 | PORT = 8000  # Change to desired port
159 | ```
160 | 
161 | Or use command line:
162 | ```bash
163 | python3 server.py --port 8080
164 | ```
165 | 
166 | ### How do I enable SSL/HTTPS?
167 | 
168 | 1. Generate SSL certificate:
169 |    ```bash
170 |    openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365
171 |    ```
172 | 
173 | 2. Configure server for SSL in `server.py`
174 | 
175 | 3. Access via `https://localhost:8000`
176 | 
177 | ## Security
178 | 
179 | ### Is Ansible Admin secure?
180 | 
181 | Security features include:
182 | 
183 | - **No default credentials**: No built-in authentication
184 | - **SSH key support**: Secure host connections
185 | - **Vault integration**: Encrypt sensitive data
186 | - **Access control**: File system permissions
187 | - **HTTPS support**: SSL/TLS encryption
188 | 
189 | ### How do I secure my installation?
190 | 
191 | 1. **Use strong SSH keys**:
192 |    ```bash
193 |    ssh-keygen -t ed25519 -b 4096
194 |    ```
195 | 
196 | 2. **Enable firewall**:
197 |    ```bash
198 |    sudo ufw enable
199 |    sudo ufw allow 8000
200 |    ```
201 | 
202 | 3. **Use HTTPS** in production
203 | 
204 | 4. **Regular updates**:
205 |    ```bash
206 |    pip install --upgrade -r requirements.txt
207 |    ```
208 | 
209 | 5. **Secure file permissions**:
210 |    ```bash
211 |    chmod 600 ansible.cfg
212 |    chmod 600 ~/.ssh/id_rsa
213 |    ```
214 | 
215 | ### Can I use Ansible Vault?
216 | 
217 | Yes, Ansible Admin supports Ansible Vault:
218 | 
219 | ```bash
220 | # Create encrypted variable file
221 | ansible-vault create vars/secret.yml
222 | 
223 | # Edit encrypted file
224 | ansible-vault edit vars/secret.yml
225 | 
226 | # Use in playbooks
227 | vars_files:
228 |   - vars/secret.yml
229 | ```
230 | 
231 | ## Performance
232 | 
233 | ### Why is it slow?
234 | 
235 | Common performance issues:
236 | 
237 | 1. **Large inventories**: Break into smaller groups
238 | 2. **Network latency**: Check connection speeds
239 | 3. **Resource constraints**: Increase RAM/CPU
240 | 4. **Concurrent executions**: Limit parallel tasks
241 | 
242 | ### How many hosts can it handle?
243 | 
244 | Depends on your server resources:
245 | 
246 | - **Small scale**: 10-50 hosts
247 | - **Medium scale**: 50-200 hosts
248 | - **Large scale**: 200+ hosts (with optimizations)
249 | 
250 | ### Can I run multiple executions simultaneously?
251 | 
252 | Yes, but it's limited by:
253 | 
254 | - Server resources (CPU, memory)
255 | - Ansible's `forks` setting
256 | - Network bandwidth
257 | - Target host capacity
258 | 
259 | ## Troubleshooting
260 | 
261 | ### The web interface won't load
262 | 
263 | Check:
264 | 
265 | 1. **Server running**: `ps aux | grep python3`
266 | 2. **Port available**: `netstat -tlnp | grep :8000`
267 | 3. **Firewall**: `sudo ufw status`
268 | 4. **Browser cache**: Hard refresh (Ctrl+F5)
269 | 
270 | ### Ansible commands fail
271 | 
272 | Common fixes:
273 | 
274 | 1. **Update Ansible**: `pip install --upgrade ansible`
275 | 2. **Check Python path**: `ansible -m ping host`
276 | 3. **Verify inventory**: `ansible-inventory --list`
277 | 4. **Test connection**: `ansible -m ping host -v`
278 | 
279 | ### Database errors
280 | 
281 | If you see data-related errors:
282 | 
283 | 1. **Check permissions**: `ls -la datastore/`
284 | 2. **Repair JSON files**: Look for corrupted files
285 | 3. **Reset datastore**: `rm -rf datastore/* && mkdir datastore`
286 | 4. **Backup first**: Always backup before resetting
287 | 
288 | ## Development
289 | 
290 | ### How do I contribute?
291 | 
292 | See the [[Contributing Guide|Contributing]] for detailed information.
293 | 
294 | **Quick start:**
295 | 1. Fork the repository
296 | 2. Create a feature branch
297 | 3. Make your changes
298 | 4. Add tests
299 | 5. Submit a pull request
300 | 
301 | ### Can I modify the interface?
302 | 
303 | Yes, the interface is built with:
304 | 
305 | - **HTML**: Page structure
306 | - **CSS**: Styling (Bootstrap + custom)
307 | - **JavaScript**: Interactivity
308 | - **Python**: Backend logic
309 | 
310 | ### Where are the logs stored?
311 | 
312 | Logs are stored in:
313 | - **Application logs**: `ansible-admin.log`
314 | - **Ansible logs**: `/var/log/ansible.log`
315 | - **System logs**: `/var/log/syslog`
316 | 
317 | ## Advanced Features
318 | 
319 | ### Can I use custom Ansible modules?
320 | 
321 | Yes, place custom modules in the `library/` directory:
322 | 
323 | ```python
324 | #!/usr/bin/python3
325 | # library/custom_module.py
326 | 
327 | from ansible.module_utils.basic import AnsibleModule
328 | 
329 | def main():
330 |     module = AnsibleModule(
331 |         argument_spec=dict(
332 |             name=dict(type='str', required=True),
333 |             state=dict(type='str', default='present')
334 |         )
335 |     )
336 | 
337 |     # Module logic here
338 |     module.exit_json(changed=True, result="Success")
339 | 
340 | if __name__ == '__main__':
341 |     main()
342 | ```
343 | 
344 | ### How do I integrate with CI/CD?
345 | 
346 | Ansible Admin can be integrated with CI/CD pipelines:
347 | 
348 | ```yaml
349 | # .github/workflows/deploy.yml
350 | name: Deploy
351 | on: [push]
352 | jobs:
353 |   deploy:
354 |     runs-on: ubuntu-latest
355 |     steps:
356 |       - uses: actions/checkout@v2
357 |       - name: Execute playbook
358 |         run: |
359 |           curl -X POST http://your-server:8000/execute-playbook \
360 |             -H "Content-Type: application/json" \
361 |             -d '{"playbook": "deploy.yml", "inventory": "production"}'
362 | ```
363 | 
364 | ### Can I use it with Kubernetes?
365 | 
366 | Yes, you can manage Kubernetes clusters:
367 | 
368 | 1. **Install kubectl** on target hosts
369 | 2. **Use k8s modules**:
370 |    ```yaml
371 |    - name: Deploy to Kubernetes
372 |      community.kubernetes.k8s:
373 |        state: present
374 |        definition: "{{ lookup('file', 'deployment.yml') }}"
375 |    ```
376 | 
377 | 3. **Use helm**:
378 |    ```yaml
379 |    - name: Deploy helm chart
380 |      community.kubernetes.helm:
381 |        name: myapp
382 |        chart_ref: ./charts/myapp
383 |        release_namespace: default
384 |    ```
385 | 
386 | ## Support
387 | 
388 | ### Where can I get help?
389 | 
390 | - **Documentation**: This wiki and README
391 | - **Issues**: [GitHub Issues](https://github.com/dionipe/ansible-admin/issues)
392 | - **Discussions**: [GitHub Discussions](https://github.com/dionipe/ansible-admin/discussions)
393 | - **Community**: Check existing issues and discussions first
394 | 
395 | ### How do I report a bug?
396 | 
397 | When reporting bugs, include:
398 | 
399 | 1. **Steps to reproduce**
400 | 2. **Expected vs actual behavior**
401 | 3. **Environment details** (OS, Python, Ansible versions)
402 | 4. **Error messages and logs**
403 | 5. **Screenshots** if applicable
404 | 
405 | ### Can I request features?
406 | 
407 | Yes! Feature requests are welcome:
408 | 
409 | 1. Check if the feature already exists
410 | 2. Search existing issues
411 | 3. Create a new issue with:
412 |    - Clear description
413 |    - Use case
414 |    - Proposed solution
415 |    - Any mockups or examples
416 | 
417 | ## Updates and Maintenance
418 | 
419 | ### How do I update Ansible Admin?
420 | 
421 | ```bash
422 | # Pull latest changes
423 | git pull origin main
424 | 
425 | # Update dependencies
426 | pip install -r requirements.txt --upgrade
427 | 
428 | # Restart server
429 | sudo systemctl restart ansible-admin
430 | ```
431 | 
432 | ### What's the release cycle?
433 | 
434 | - **Major releases**: Every 6 months with new features
435 | - **Minor releases**: Monthly with bug fixes and improvements
436 | - **Patch releases**: As needed for critical fixes
437 | 
438 | ### How do I stay updated?
439 | 
440 | - **Watch the repository** on GitHub
441 | - **Follow releases** for update notifications
442 | - **Check changelog** for detailed changes
443 | - **Join discussions** for community updates
444 | 
445 | ## License and Legal
446 | 
447 | ### What license is Ansible Admin under?
448 | 
449 | Ansible Admin is licensed under the MIT License, which allows:
450 | 
451 | - ✅ Commercial use
452 | - ✅ Modification
453 | - ✅ Distribution
454 | - ✅ Private use
455 | - ⚠️ Must include copyright notice
456 | 
457 | ### Can I use it in production?
458 | 
459 | Yes, but:
460 | 
461 | 1. **Security review**: Conduct your own security assessment
462 | 2. **Backup strategy**: Implement regular backups
463 | 3. **Monitoring**: Set up monitoring and alerting
464 | 4. **Support**: Consider commercial support options
465 | 
466 | ### Are there any restrictions?
467 | 
468 | The MIT License has minimal restrictions:
469 | 
470 | - Include the original copyright notice
471 | - Don't use the authors' names for endorsement
472 | - No warranty or liability from the authors
473 | 
474 | ## Getting Started
475 | 
476 | If you're new to Ansible Admin:
477 | 
478 | 1. **Read the [[Installation Guide|Installation]]**
479 | 2. **Follow the [[Basic Usage Guide|Basic-Usage]]**
480 | 3. **Explore the [[Dashboard|Dashboard]]**
481 | 4. **Try the [[API Reference|API-Reference]]**
482 | 
483 | ## Still Need Help?
484 | 
485 | If your question isn't answered here:
486 | 
487 | - [[Search existing issues|https://github.com/dionipe/ansible-admin/issues]]
488 | - [[Create a new discussion|https://github.com/dionipe/ansible-admin/discussions]]
489 | - [[Check the troubleshooting guide|Troubleshooting]]
490 | 
491 | We're here to help! 🚀</content>
492 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/FAQ.md
493 | 


--------------------------------------------------------------------------------
/wiki/Contributing.md:
--------------------------------------------------------------------------------
  1 | # Contributing Guide
  2 | 
  3 | Welcome! We appreciate your interest in contributing to Ansible Admin. This guide will help you get started.
  4 | 
  5 | ## Ways to Contribute
  6 | 
  7 | ### Code Contributions
  8 | - **Bug fixes**: Fix issues and improve stability
  9 | - **New features**: Add functionality and enhancements
 10 | - **Documentation**: Improve docs and examples
 11 | - **Tests**: Add test cases and improve coverage
 12 | 
 13 | ### Non-Code Contributions
 14 | - **Bug reports**: Report issues with detailed information
 15 | - **Feature requests**: Suggest new functionality
 16 | - **Documentation**: Write guides, tutorials, and examples
 17 | - **Testing**: Test releases and provide feedback
 18 | - **Translation**: Help translate the interface
 19 | 
 20 | ## Development Setup
 21 | 
 22 | ### Prerequisites
 23 | 
 24 | - Python 3.8+
 25 | - Ansible 2.9+
 26 | - Git
 27 | - Modern web browser
 28 | 
 29 | ### Local Development
 30 | 
 31 | 1. **Fork and clone**:
 32 |    ```bash
 33 |    git clone https://github.com/your-username/ansible-admin.git
 34 |    cd ansible-admin
 35 |    ```
 36 | 
 37 | 2. **Create virtual environment**:
 38 |    ```bash
 39 |    python3 -m venv venv
 40 |    source venv/bin/activate  # On Windows: venv\Scripts\activate
 41 |    ```
 42 | 
 43 | 3. **Install dependencies**:
 44 |    ```bash
 45 |    pip install -r requirements.txt
 46 |    ansible-galaxy collection install -r requirements.yml
 47 |    ```
 48 | 
 49 | 4. **Install development dependencies**:
 50 |    ```bash
 51 |    pip install -r requirements-dev.txt
 52 |    ```
 53 | 
 54 | 5. **Run tests**:
 55 |    ```bash
 56 |    python -m pytest
 57 |    ```
 58 | 
 59 | 6. **Start development server**:
 60 |    ```bash
 61 |    python server.py --debug --reload
 62 |    ```
 63 | 
 64 | ### Project Structure
 65 | 
 66 | ```
 67 | ansible-admin/
 68 | ├── server.py              # Main HTTP server
 69 | ├── ansible.cfg           # Ansible configuration
 70 | ├── requirements.txt      # Python dependencies
 71 | ├── requirements-dev.txt  # Development dependencies
 72 | ├── pytest.ini           # Test configuration
 73 | ├── docs/                # Documentation
 74 | ├── tests/               # Test files
 75 | ├── static/              # Static assets (CSS, JS, images)
 76 | ├── templates/           # Jinja2 templates
 77 | ├── playbooks/           # Example playbooks
 78 | └── *.html              # Web interface files
 79 | ```
 80 | 
 81 | ## Development Workflow
 82 | 
 83 | ### 1. Choose an Issue
 84 | 
 85 | - Check [GitHub Issues](https://github.com/dionipe/ansible-admin/issues) for open tasks
 86 | - Look for issues labeled `good first issue` or `help wanted`
 87 | - Comment on the issue to indicate you're working on it
 88 | 
 89 | ### 2. Create a Branch
 90 | 
 91 | ```bash
 92 | # Create and switch to new branch
 93 | git checkout -b feature/your-feature-name
 94 | 
 95 | # Or for bug fixes
 96 | git checkout -b fix/issue-number-description
 97 | ```
 98 | 
 99 | ### 3. Make Changes
100 | 
101 | - Follow the existing code style
102 | - Write clear, concise commit messages
103 | - Add tests for new functionality
104 | - Update documentation as needed
105 | 
106 | ### 4. Test Your Changes
107 | 
108 | ```bash
109 | # Run all tests
110 | python -m pytest
111 | 
112 | # Run specific test file
113 | python -m pytest tests/test_server.py
114 | 
115 | # Run with coverage
116 | python -m pytest --cov=.
117 | 
118 | # Test manually
119 | python server.py
120 | # Open browser to http://localhost:8000
121 | ```
122 | 
123 | ### 5. Commit Changes
124 | 
125 | ```bash
126 | # Stage your changes
127 | git add .
128 | 
129 | # Commit with descriptive message
130 | git commit -m "Add feature: brief description
131 | 
132 | - What was changed
133 | - Why it was changed
134 | - Any breaking changes
135 | "
136 | 
137 | # For multiple commits, use rebase to clean up
138 | git rebase -i HEAD~n
139 | ```
140 | 
141 | ### 6. Push and Create Pull Request
142 | 
143 | ```bash
144 | # Push your branch
145 | git push origin feature/your-feature-name
146 | 
147 | # Create pull request on GitHub
148 | # - Go to your fork on GitHub
149 | # - Click "Compare & pull request"
150 | # - Fill out the pull request template
151 | # - Link to any related issues
152 | ```
153 | 
154 | ## Coding Standards
155 | 
156 | ### Python Code Style
157 | 
158 | We follow PEP 8 with some modifications:
159 | 
160 | ```python
161 | # Good: Clear variable names
162 | def get_playbook_execution_status(execution_id):
163 |     """Get the status of a playbook execution."""
164 |     pass
165 | 
166 | # Bad: Unclear abbreviations
167 | def get_pb_exec_stat(eid):
168 |     pass
169 | ```
170 | 
171 | ### Key Guidelines
172 | 
173 | 1. **Use type hints**:
174 |    ```python
175 |    def execute_playbook(playbook_path: str, inventory: str) -> dict:
176 |        pass
177 |    ```
178 | 
179 | 2. **Write docstrings**:
180 |    ```python
181 |    def execute_playbook(playbook_path: str, inventory: str) -> dict:
182 |        """Execute an Ansible playbook.
183 | 
184 |        Args:
185 |            playbook_path: Path to the playbook file
186 |            inventory: Inventory to use for execution
187 | 
188 |        Returns:
189 |            Dictionary containing execution results
190 | 
191 |        Raises:
192 |            ExecutionError: If playbook execution fails
193 |        """
194 |    ```
195 | 
196 | 3. **Handle errors gracefully**:
197 |    ```python
198 |    try:
199 |        result = execute_playbook(playbook, inventory)
200 |    except ExecutionError as e:
201 |        logger.error(f"Playbook execution failed: {e}")
202 |        return {"success": False, "error": str(e)}
203 |    except Exception as e:
204 |        logger.exception("Unexpected error during playbook execution")
205 |        return {"success": False, "error": "Internal server error"}
206 |    ```
207 | 
208 | 4. **Use logging**:
209 |    ```python
210 |    import logging
211 | 
212 |    logger = logging.getLogger(__name__)
213 | 
214 |    def some_function():
215 |        logger.debug("Starting function execution")
216 |        logger.info("Processing data")
217 |        logger.warning("This is a warning")
218 |        logger.error("This is an error")
219 |        logger.critical("This is critical")
220 |    ```
221 | 
222 | ### HTML/CSS/JavaScript Standards
223 | 
224 | 1. **Use semantic HTML**:
225 |    ```html
226 |    <!-- Good -->
227 |    <nav class="navbar">
228 |      <ul class="nav-list">
229 |        <li><a href="/dashboard">Dashboard</a></li>
230 |      </ul>
231 |    </nav>
232 | 
233 |    <!-- Bad -->
234 |    <div class="navbar">
235 |      <div class="nav-list">
236 |        <div><a href="/dashboard">Dashboard</a></div>
237 |      </div>
238 |    </div>
239 |    ```
240 | 
241 | 2. **Follow BEM CSS methodology**:
242 |    ```css
243 |    /* Good */
244 |    .button {}
245 |    .button--primary {}
246 |    .button__icon {}
247 | 
248 |    /* Bad */
249 |    .btnPrimary {}
250 |    .btn-primary-icon {}
251 |    ```
252 | 
253 | 3. **Use modern JavaScript**:
254 |    ```javascript
255 |    // Good: Async/await
256 |    async function loadPlaybooks() {
257 |      try {
258 |        const response = await fetch('/api/playbooks');
259 |        const data = await response.json();
260 |        return data;
261 |      } catch (error) {
262 |        console.error('Failed to load playbooks:', error);
263 |        throw error;
264 |      }
265 |    }
266 | 
267 |    // Bad: Callbacks
268 |    function loadPlaybooks(callback) {
269 |      fetch('/api/playbooks')
270 |        .then(response => response.json())
271 |        .then(data => callback(null, data))
272 |        .catch(error => callback(error));
273 |    }
274 |    ```
275 | 
276 | ## Testing
277 | 
278 | ### Unit Tests
279 | 
280 | ```python
281 | # tests/test_server.py
282 | import pytest
283 | from server import app
284 | 
285 | class TestServer:
286 |     def test_home_page(self):
287 |         with app.test_client() as client:
288 |             response = client.get('/')
289 |             assert response.status_code == 200
290 |             assert b'Ansible Admin' in response.data
291 | 
292 |     def test_api_list_playbooks(self):
293 |         with app.test_client() as client:
294 |             response = client.get('/api/list-playbooks')
295 |             assert response.status_code == 200
296 |             data = response.get_json()
297 |             assert 'success' in data
298 |             assert 'data' in data
299 | ```
300 | 
301 | ### Integration Tests
302 | 
303 | ```python
304 | # tests/test_integration.py
305 | import pytest
306 | import tempfile
307 | import os
308 | 
309 | class TestIntegration:
310 |     def test_full_playbook_execution(self, client):
311 |         # Create temporary playbook
312 |         playbook_content = """
313 |         ---
314 |         - hosts: localhost
315 |           tasks:
316 |             - name: Test task
317 |               debug:
318 |                 msg: "Hello World"
319 |         """
320 | 
321 |         with tempfile.NamedTemporaryFile(mode='w', suffix='.yml', delete=False) as f:
322 |             f.write(playbook_content)
323 |             playbook_path = f.name
324 | 
325 |         try:
326 |             # Upload playbook
327 |             response = client.post('/api/save-playbook',
328 |                                  json={'name': 'test.yml', 'content': playbook_content})
329 |             assert response.status_code == 200
330 | 
331 |             # Execute playbook
332 |             response = client.post('/execute-playbook',
333 |                                  json={'playbook': 'test.yml', 'inventory': 'localhost'})
334 |             assert response.status_code == 200
335 | 
336 |             data = response.get_json()
337 |             assert data['success'] is True
338 |             assert 'execution_id' in data['data']
339 | 
340 |         finally:
341 |             os.unlink(playbook_path)
342 | ```
343 | 
344 | ### Running Tests
345 | 
346 | ```bash
347 | # Run all tests
348 | pytest
349 | 
350 | # Run with coverage
351 | pytest --cov=. --cov-report=html
352 | 
353 | # Run specific test file
354 | pytest tests/test_server.py
355 | 
356 | # Run tests matching pattern
357 | pytest -k "test_playbook"
358 | 
359 | # Run tests in verbose mode
360 | pytest -v
361 | 
362 | # Run tests and stop on first failure
363 | pytest -x
364 | ```
365 | 
366 | ## Documentation
367 | 
368 | ### Writing Documentation
369 | 
370 | 1. **Use clear headings**:
371 |    ```markdown
372 |    # Main Title
373 | 
374 |    ## Section
375 | 
376 |    ### Subsection
377 | 
378 |    #### Sub-subsection
379 |    ```
380 | 
381 | 2. **Include code examples**:
382 |    ```python
383 |    # Good example with comments
384 |    def example_function(param):
385 |        """Example function with documentation."""
386 |        return param * 2
387 |    ```
388 | 
389 | 3. **Use tables for structured data**:
390 |    | Feature | Status | Notes |
391 |    |---------|--------|-------|
392 |    | Basic execution | ✅ Complete | Fully functional |
393 |    | Advanced templates | 🚧 In progress | Partial implementation |
394 | 
395 | 4. **Add cross-references**:
396 |    ```markdown
397 |    See [[Installation Guide|Installation]] for setup instructions.
398 |    ```
399 | 
400 | ### Documentation Structure
401 | 
402 | ```
403 | docs/
404 | ├── user-guide/
405 | │   ├── getting-started.md
406 | │   ├── dashboard.md
407 | │   └── playbooks.md
408 | ├── api/
409 | │   ├── reference.md
410 | │   └── examples.md
411 | ├── developer/
412 | │   ├── setup.md
413 | │   ├── testing.md
414 | │   └── deployment.md
415 | └── README.md
416 | ```
417 | 
418 | ## Pull Request Process
419 | 
420 | ### Before Submitting
421 | 
422 | 1. **Update documentation** for any new features
423 | 2. **Add tests** for new functionality
424 | 3. **Ensure all tests pass**:
425 |    ```bash
426 |    pytest
427 |    ```
428 | 4. **Check code style**:
429 |    ```bash
430 |    flake8 .
431 |    black --check .
432 |    ```
433 | 5. **Update CHANGELOG.md** if needed
434 | 
435 | ### Pull Request Template
436 | 
437 | ```markdown
438 | ## Description
439 | Brief description of the changes made.
440 | 
441 | ## Type of Change
442 | - [ ] Bug fix (non-breaking change)
443 | - [ ] New feature (non-breaking change)
444 | - [ ] Breaking change
445 | - [ ] Documentation update
446 | - [ ] Refactoring
447 | 
448 | ## Testing
449 | - [ ] Unit tests added/updated
450 | - [ ] Integration tests added/updated
451 | - [ ] Manual testing completed
452 | - [ ] All tests pass
453 | 
454 | ## Screenshots (if applicable)
455 | Add screenshots of UI changes.
456 | 
457 | ## Checklist
458 | - [ ] Code follows project style guidelines
459 | - [ ] Documentation updated
460 | - [ ] Tests added for new functionality
461 | - [ ] CHANGELOG.md updated
462 | - [ ] Commit messages are clear and descriptive
463 | 
464 | ## Related Issues
465 | Closes #123
466 | ```
467 | 
468 | ### Review Process
469 | 
470 | 1. **Automated checks** run first (tests, linting)
471 | 2. **Code review** by maintainers
472 | 3. **Feedback** and requested changes
473 | 4. **Approval** and merge
474 | 
475 | ## Issue Reporting
476 | 
477 | ### Bug Reports
478 | 
479 | When reporting bugs, please include:
480 | 
481 | 1. **Clear title** describing the issue
482 | 2. **Steps to reproduce**:
483 |    ```markdown
484 |    1. Go to '...'
485 |    2. Click on '...'
486 |    3. See error
487 |    ```
488 | 3. **Expected behavior**: What should happen
489 | 4. **Actual behavior**: What actually happens
490 | 5. **Environment**:
491 |    - OS: [e.g., Ubuntu 20.04]
492 |    - Browser: [e.g., Chrome 91]
493 |    - Python version: [e.g., 3.9]
494 |    - Ansible version: [e.g., 2.12]
495 | 6. **Screenshots**: If applicable
496 | 7. **Additional context**: Any other relevant information
497 | 
498 | ### Feature Requests
499 | 
500 | For feature requests, please include:
501 | 
502 | 1. **Clear description** of the proposed feature
503 | 2. **Use case**: Why is this feature needed?
504 | 3. **Proposed solution**: How should it work?
505 | 4. **Alternatives considered**: Other approaches?
506 | 5. **Additional context**: Screenshots, mockups, etc.
507 | 
508 | ## Community Guidelines
509 | 
510 | ### Code of Conduct
511 | 
512 | - Be respectful and inclusive
513 | - Focus on constructive feedback
514 | - Help newcomers learn and contribute
515 | - Maintain professional communication
516 | 
517 | ### Getting Help
518 | 
519 | - **Documentation**: Check the wiki first
520 | - **Issues**: Search existing issues before creating new ones
521 | - **Discussions**: Use GitHub Discussions for questions
522 | - **Discord/Slack**: Join our community chat (if available)
523 | 
524 | ## Recognition
525 | 
526 | Contributors are recognized in several ways:
527 | 
528 | - **Contributors file**: Listed in CONTRIBUTORS.md
529 | - **Changelog**: Mentioned in release notes
530 | - **GitHub recognition**: GitHub's contributor insights
531 | - **Special mentions**: Featured in release announcements
532 | 
533 | ## License
534 | 
535 | By contributing to this project, you agree that your contributions will be licensed under the same license as the project (MIT License).
536 | 
537 | ## Questions?
538 | 
539 | If you have questions about contributing:
540 | 
541 | - Check the [[FAQ|FAQ]]
542 | - Ask in [GitHub Discussions](https://github.com/dionipe/ansible-admin/discussions)
543 | - Contact the maintainers
544 | 
545 | Thank you for contributing to Ansible Admin! 🎉</content>
546 | <parameter name="filePath">/home/dionipe/ansible-admin/wiki/Contributing.md
547 | 


--------------------------------------------------------------------------------
/dashboard.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en">
  3 | <head>
  4 |     <meta charset="UTF-8">
  5 |     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6 |     <title>Dashboard - Ansible Admin</title>
  7 |     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
  8 |     <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
  9 |     <style>
 10 |         .sidebar {
 11 |             min-height: 100vh;
 12 |             background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
 13 |             color: white;
 14 |         }
 15 |         .sidebar .nav-link {
 16 |             color: rgba(255, 255, 255, 0.8);
 17 |             transition: all 0.3s;
 18 |         }
 19 |         .sidebar .nav-link:hover {
 20 |             color: white;
 21 |             background-color: rgba(255, 255, 255, 0.1);
 22 |         }
 23 |         .sidebar .nav-link.active {
 24 |             background-color: rgba(255, 255, 255, 0.2);
 25 |             color: white;
 26 |         }
 27 |         .card {
 28 |             border: none;
 29 |             border-radius: 10px;
 30 |             box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
 31 |         }
 32 |         .btn-ansible {
 33 |             background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
 34 |             border: none;
 35 |             color: white;
 36 |         }
 37 |         .btn-ansible:hover {
 38 |             background: linear-gradient(135deg, #5a6fd8 0%, #6a4190 100%);
 39 |             color: white;
 40 |         }
 41 |         .form-control:focus {
 42 |             border-color: #667eea;
 43 |             box-shadow: 0 0 0 0.2rem rgba(102, 126, 234, 0.25);
 44 |         }
 45 | 
 46 |         /* Glassmorphism Effects */
 47 |         .glass-card {
 48 |             background: rgba(255, 255, 255, 0.1);
 49 |             backdrop-filter: blur(10px);
 50 |             -webkit-backdrop-filter: blur(10px);
 51 |             border: 1px solid rgba(255, 255, 255, 0.2);
 52 |             box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
 53 |         }
 54 | 
 55 |         .glass-sidebar {
 56 |             background: rgba(102, 126, 234, 0.9);
 57 |             backdrop-filter: blur(15px);
 58 |             -webkit-backdrop-filter: blur(15px);
 59 |             border-right: 1px solid rgba(255, 255, 255, 0.1);
 60 |         }
 61 | 
 62 |         .glass-modal {
 63 |             background: rgba(255, 255, 255, 0.95);
 64 |             backdrop-filter: blur(20px);
 65 |             -webkit-backdrop-filter: blur(20px);
 66 |             border: 1px solid rgba(255, 255, 255, 0.3);
 67 |         }
 68 | 
 69 |         .glass-button {
 70 |             background: rgba(102, 126, 234, 0.8);
 71 |             backdrop-filter: blur(5px);
 72 |             -webkit-backdrop-filter: blur(5px);
 73 |             border: 1px solid rgba(255, 255, 255, 0.2);
 74 |             transition: all 0.3s ease;
 75 |         }
 76 | 
 77 |         .glass-button:hover {
 78 |             background: rgba(102, 126, 234, 0.9);
 79 |             transform: translateY(-2px);
 80 |             box-shadow: 0 8px 25px rgba(102, 126, 234, 0.3);
 81 |         }
 82 | 
 83 |         /* Sticky Footer */
 84 |         .sticky-footer {
 85 |             position: fixed;
 86 |             bottom: 0;
 87 |             left: 0;
 88 |             right: 0;
 89 |             z-index: 1030;
 90 |             background: rgba(248, 249, 250, 0.95);
 91 |             backdrop-filter: blur(10px);
 92 |             -webkit-backdrop-filter: blur(10px);
 93 |             border-top: 1px solid rgba(255, 255, 255, 0.2);
 94 |             box-shadow: 0 -4px 20px rgba(0, 0, 0, 0.1);
 95 |         }
 96 | 
 97 |         /* Add padding to body to account for sticky footer */
 98 |         body {
 99 |             padding-bottom: 60px;
100 |         }
101 | 
102 |         /* Footer styling */
103 |         footer a:hover {
104 |             color: #667eea !important;
105 |         }
106 |     </style>
107 | </head>
108 | <body>
109 |     <div class="container-fluid">
110 |         <div class="row">
111 |             <!-- Sidebar -->
112 |             <div class="col-md-3 col-lg-2 px-0 sidebar">
113 |                 <div class="p-3">
114 |                     <h4 class="mb-4"><i class="fas fa-cogs me-2"></i>Ansible Admin</h4>
115 |                     <nav class="nav flex-column">
116 |                         <a class="nav-link active" href="/dashboard">
117 |                             <i class="fas fa-tachometer-alt me-2"></i>Dashboard
118 |                         </a>
119 |                         <a class="nav-link" href="/playbooks">
120 |                             <i class="fas fa-play me-2"></i>Playbooks
121 |                         </a>
122 |                         <a class="nav-link" href="/inventory">
123 |                             <i class="fas fa-server me-2"></i>Inventory
124 |                         </a>
125 |                         <a class="nav-link" href="/run-playbook">
126 |                             <i class="fas fa-play-circle me-2"></i>Execute
127 |                         </a>
128 |                         <a class="nav-link" href="/updateOS">
129 |                             <i class="fas fa-arrow-up me-2"></i>Update OS
130 |                         </a>
131 |                         <a class="nav-link" href="/history">
132 |                             <i class="fas fa-history me-2"></i>History
133 |                         </a>
134 |                         <a class="nav-link" href="/usage">
135 |                             <i class="fas fa-question-circle me-2"></i>Usage Guide
136 |                         </a>
137 |                     </nav>
138 |                 </div>
139 |             </div>
140 | 
141 |             <!-- Main Content -->
142 |             <div class="col-md-9 col-lg-10 px-4 py-4">
143 |                 <div class="d-flex justify-content-between align-items-center mb-4">
144 |                     <h2><i class="fas fa-tachometer-alt me-2"></i>Dashboard</h2>
145 |                     <button class="btn btn-ansible" onclick="refreshDashboard()">
146 |                         <i class="fas fa-sync me-2"></i>Refresh
147 |                     </button>
148 |                 </div>
149 | 
150 |                 <div class="row mb-4">
151 |                     <div class="col-md-3">
152 |                         <div class="card glass-card text-center">
153 |                             <div class="card-body">
154 |                                 <i class="fas fa-play fa-2x text-primary mb-2"></i>
155 |                                 <h5 class="card-title">Active Jobs</h5>
156 |                                 <h3 class="text-primary" id="active-jobs">0</h3>
157 |                             </div>
158 |                         </div>
159 |                     </div>
160 |                     <div class="col-md-3">
161 |                         <div class="card glass-card text-center">
162 |                             <div class="card-body">
163 |                                 <i class="fas fa-server fa-2x text-success mb-2"></i>
164 |                                 <h5 class="card-title">Total Hosts</h5>
165 |                                 <h3 class="text-success" id="total-hosts">0</h3>
166 |                             </div>
167 |                         </div>
168 |                     </div>
169 |                     <div class="col-md-3">
170 |                         <div class="card text-center">
171 |                             <div class="card-body">
172 |                                 <i class="fas fa-check-circle fa-2x text-info mb-2"></i>
173 |                                 <h5 class="card-title">Successful Runs</h5>
174 |                                 <h3 class="text-info" id="successful-runs">0</h3>
175 |                             </div>
176 |                         </div>
177 |                     </div>
178 |                     <div class="col-md-3">
179 |                         <div class="card text-center">
180 |                             <div class="card-body">
181 |                                 <i class="fas fa-exclamation-triangle fa-2x text-warning mb-2"></i>
182 |                                 <h5 class="card-title">Failed Runs</h5>
183 |                                 <h3 class="text-warning" id="failed-runs">0</h3>
184 |                             </div>
185 |                         </div>
186 |                     </div>
187 |                 </div>
188 | 
189 |                 <div class="card">
190 |                     <div class="card-header">
191 |                         <h5><i class="fas fa-history me-2"></i>Recent Activity</h5>
192 |                     </div>
193 |                     <div class="card-body">
194 |                         <div id="recent-activity" class="list-group list-group-flush">
195 |                             <div class="list-group-item">
196 |                                 <i class="fas fa-info-circle text-info me-2"></i>
197 |                                 System initialized successfully
198 |                                 <small class="text-muted float-end">Just now</small>
199 |                             </div>
200 |                         </div>
201 |                     </div>
202 |                 </div>
203 |             </div>
204 |         </div>
205 |     </div>
206 | 
207 |     <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
208 |     <script>
209 |         // Dashboard functions
210 |         async function refreshDashboard() {
211 |             try {
212 |                 const response = await fetch('/get-dashboard-data');
213 |                 if (response.ok) {
214 |                     const data = await response.json();
215 |                     updateDashboard(data);
216 |                 }
217 |             } catch (error) {
218 |                 console.error('Error refreshing dashboard:', error);
219 |             }
220 |         }
221 | 
222 |         function updateDashboard(data) {
223 |             document.getElementById('active-jobs').textContent = data.activeJobs || 0;
224 |             document.getElementById('total-hosts').textContent = data.totalHosts || 0;
225 |             document.getElementById('successful-runs').textContent = data.successfulRuns || 0;
226 |             document.getElementById('failed-runs').textContent = data.failedRuns || 0;
227 | 
228 |             const activityList = document.getElementById('recent-activity');
229 |             if (data.recentActivity && data.recentActivity.length > 0) {
230 |                 activityList.innerHTML = data.recentActivity.map(activity =>
231 |                     `<div class="list-group-item">
232 |                         <i class="fas fa-${activity.icon || 'info-circle'} text-${activity.type || 'info'} me-2"></i>
233 |                         ${activity.message}
234 |                         <small class="text-muted float-end">${activity.time || 'Just now'}</small>
235 |                     </div>`
236 |                 ).join('');
237 |             }
238 |         }
239 | 
240 |         // Initialize dashboard
241 |         document.addEventListener('DOMContentLoaded', function() {
242 |             refreshDashboard();
243 |         });
244 |     </script>
245 | 
246 |     <!-- Footer -->
247 |     <footer class="sticky-footer">
248 |         <div class="container-fluid py-3">
249 |             <div class="row align-items-center">
250 |                 <div class="col-md-6">
251 |                     <small class="text-muted">
252 |                         <i class="fas fa-cogs me-1"></i>
253 |                         <strong>Ansible Admin</strong> v2.0.0 |
254 |                         <i class="fas fa-server me-1"></i>Server Status: <span class="text-success">Online</span> |
255 |                         <i class="fas fa-clock me-1"></i><span id="current-time"></span>
256 |                     </small>
257 |                 </div>
258 |                 <div class="col-md-6 text-md-end">
259 |                     <small class="text-muted">
260 |                         <i class="fas fa-code me-1"></i>Built with Python & Bootstrap |
261 |                         <i class="fas fa-user me-1"></i>Developed by <strong>Dionipe</strong> |
262 |                         <i class="fas fa-info-circle me-1"></i><a href="#" class="text-decoration-none" data-bs-toggle="modal" data-bs-target="#aboutModal">About</a> |
263 |                         <i class="fas fa-heart text-danger me-1"></i>
264 |                         <a href="#" class="text-decoration-none">IndoBSD Infrastructure</a>
265 |                     </small>
266 |                 </div>
267 |             </div>
268 |         </div>
269 |     </footer>
270 | 
271 |     <!-- About Modal -->
272 |     <div class="modal fade" id="aboutModal" tabindex="-1" aria-labelledby="aboutModalLabel" aria-hidden="true">
273 |         <div class="modal-dialog modal-dialog-centered">
274 |             <div class="modal-content glass-card">
275 |                 <div class="modal-header">
276 |                     <h5 class="modal-title" id="aboutModalLabel">
277 |                         <i class="fas fa-info-circle me-2"></i>About Ansible Admin
278 |                     </h5>
279 |                     <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
280 |                 </div>
281 |                 <div class="modal-body">
282 |                     <div class="text-center mb-4">
283 |                         <i class="fas fa-cogs fa-3x text-primary mb-3"></i>
284 |                         <h4>Ansible Admin v2.0.0</h4>
285 |                         <p class="text-muted">Modern Ansible Management Interface</p>
286 |                         <div class="mb-3">
287 |                             <span class="badge bg-success me-2">Latest Version</span>
288 |                             <small class="text-muted">Released: September 8, 2025</small>
289 |                         </div>
290 |                     </div>
291 |                     <div class="row">
292 |                         <div class="col-md-6">
293 |                             <h6><i class="fas fa-code me-2"></i>Technologies</h6>
294 |                             <ul class="list-unstyled">
295 |                                 <li><i class="fab fa-python me-2"></i>Python Backend</li>
296 |                                 <li><i class="fas fa-globe me-2"></i>Web Interface</li>
297 |                                 <li><i class="fas fa-server me-2"></i>Ansible Integration</li>
298 |                                 <li><i class="fas fa-database me-2"></i>Real-time Updates</li>
299 |                             </ul>
300 | 
301 |                             <h6><i class="fas fa-file-alt me-2"></i>Documentation</h6>
302 |                             <ul class="list-unstyled">
303 |                                 <li><i class="fas fa-book me-2"></i><a href="README.md" target="_blank" class="text-decoration-none">README</a></li>
304 |                                 <li><i class="fas fa-history me-2"></i><a href="CHANGELOG.md" target="_blank" class="text-decoration-none">Changelog</a></li>
305 |                                 <li><i class="fas fa-question-circle me-2"></i><a href="/usage" class="text-decoration-none">Usage Guide</a></li>
306 |                             </ul>
307 |                         </div>
308 |                         <div class="col-md-6">
309 |                             <h6><i class="fas fa-user me-2"></i>Developer</h6>
310 |                             <p><strong>Dionipe</strong></p>
311 |                             <p class="text-muted small">Full-stack Developer & DevOps Engineer</p>
312 |                             
313 |                             <h6><i class="fas fa-code-branch me-2"></i>My Projects</h6>
314 |                             <div class="mb-2">
315 |                                 <a href="https://github.com/dionipe/" target="_blank" class="btn btn-sm btn-outline-primary me-2 mb-1">
316 |                                     <i class="fab fa-github me-1"></i>GitHub Profile
317 |                                 </a>
318 |                                 <a href="https://github.com/dionipe/Bootstrap-Kubernetes-on-Proxmox-with-Qemu" target="_blank" class="btn btn-sm btn-outline-success me-2 mb-1">
319 |                                     <i class="fas fa-star me-1"></i>K8s on Proxmox
320 |                                 </a>
321 |                             </div>
322 |                             <p class="text-muted small mb-2">Explore 39+ open source projects</p>
323 |                             
324 |                             <h6><i class="fas fa-building me-2"></i>Organization</h6>
325 |                             <p>IndoBSD Infrastructure</p>
326 | 
327 |                             <h6><i class="fas fa-calendar me-2"></i>Version Info</h6>
328 |                             <ul class="list-unstyled small">
329 |                                 <li><strong>Current:</strong> v2.0.0</li>
330 |                                 <li><strong>Release Date:</strong> 2025-09-08</li>
331 |                                 <li><strong>Status:</strong> <span class="badge bg-success">Stable</span></li>
332 |                             </ul>
333 |                         </div>
334 |                     </div>
335 |                     <hr>
336 |                     <div class="text-center">
337 |                         <p class="mb-2"><strong>Features:</strong></p>
338 |                         <div class="row text-start">
339 |                             <div class="col-md-6">
340 |                                 <ul class="list-unstyled small">
341 |                                     <li><i class="fas fa-check text-success me-2"></i>Playbook Management</li>
342 |                                     <li><i class="fas fa-check text-success me-2"></i>Inventory Control</li>
343 |                                     <li><i class="fas fa-check text-success me-2"></i>Real-time Execution</li>
344 |                                 </ul>
345 |                             </div>
346 |                             <div class="col-md-6">
347 |                                 <ul class="list-unstyled small">
348 |                                     <li><i class="fas fa-check text-success me-2"></i>OS Updates</li>
349 |                                     <li><i class="fas fa-check text-success me-2"></i>Execution History</li>
350 |                                     <li><i class="fas fa-check text-success me-2"></i>Modern UI Design</li>
351 |                                 </ul>
352 |                             </div>
353 |                         </div>
354 |                     </div>
355 |                 </div>
356 |                 <div class="modal-footer">
357 |                     <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
358 |                     <button type="button" class="btn btn-primary">
359 |                         <i class="fas fa-external-link-alt me-2"></i>Visit Repository
360 |                     </button>
361 |                 </div>
362 |             </div>
363 |         </div>
364 |     </div>
365 | 
366 |     <script>
367 |         // Update current time in footer
368 |         function updateTime() {
369 |             const now = new Date();
370 |             const timeString = now.toLocaleTimeString();
371 |             document.getElementById('current-time').textContent = timeString;
372 |         }
373 | 
374 |         // Update time every second
375 |         setInterval(updateTime, 1000);
376 |         updateTime(); // Initial call
377 |     </script>
378 | </body>
379 | </html>
380 | 


--------------------------------------------------------------------------------
/updateOS.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en">
  3 | <head>
  4 |     <meta charset="UTF-8">
  5 |     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6 |     <title>Update OS - Ansible Admin</title>
  7 |     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
  8 |     <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
  9 |     <style>
 10 |         .sidebar {
 11 |             min-height: 100vh;
 12 |             background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
 13 |             color: white;
 14 |         }
 15 |         .sidebar .nav-link {
 16 |             color: rgba(255, 255, 255, 0.8);
 17 |             transition: all 0.3s;
 18 |         }
 19 |         .sidebar .nav-link:hover {
 20 |             color: white;
 21 |             background-color: rgba(255, 255, 255, 0.1);
 22 |         }
 23 |         .sidebar .nav-link.active {
 24 |             background-color: rgba(255, 255, 255, 0.2);
 25 |             color: white;
 26 |         }
 27 |         .card {
 28 |             border: none;
 29 |             border-radius: 10px;
 30 |             box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
 31 |         }
 32 |         .btn-ansible {
 33 |             background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
 34 |             border: none;
 35 |             color: white;
 36 |         }
 37 |         .btn-ansible:hover {
 38 |             background: linear-gradient(135deg, #5a6fd8 0%, #6a4190 100%);
 39 |             color: white;
 40 |         }
 41 |         .form-control:focus {
 42 |             border-color: #667eea;
 43 |             box-shadow: 0 0 0 0.2rem rgba(102, 126, 234, 0.25);
 44 |         }
 45 |         .execution-controls {
 46 |             transition: all 0.3s ease;
 47 |         }
 48 |         .execution-output {
 49 |             font-family: 'Courier New', Monaco, monospace;
 50 |             font-size: 0.9em;
 51 |             line-height: 1.4;
 52 |         }
 53 |         .execution-status {
 54 |             position: sticky;
 55 |             top: 0;
 56 |             background: rgba(255, 255, 255, 0.9);
 57 |             padding: 10px;
 58 |             border-bottom: 1px solid #dee2e6;
 59 |             font-weight: bold;
 60 |         }
 61 | 
 62 |         /* Glassmorphism Effects */
 63 |         .glass-card {
 64 |             background: rgba(255, 255, 255, 0.1);
 65 |             backdrop-filter: blur(10px);
 66 |             -webkit-backdrop-filter: blur(10px);
 67 |             border: 1px solid rgba(255, 255, 255, 0.2);
 68 |             box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1);
 69 |         }
 70 | 
 71 |         .glass-sidebar {
 72 |             background: rgba(102, 126, 234, 0.9);
 73 |             backdrop-filter: blur(15px);
 74 |             -webkit-backdrop-filter: blur(15px);
 75 |             border-right: 1px solid rgba(255, 255, 255, 0.1);
 76 |         }
 77 | 
 78 |         .glass-modal {
 79 |             background: rgba(255, 255, 255, 0.95);
 80 |             backdrop-filter: blur(20px);
 81 |             -webkit-backdrop-filter: blur(20px);
 82 |             border: 1px solid rgba(255, 255, 255, 0.3);
 83 |         }
 84 | 
 85 |         .glass-button {
 86 |             background: rgba(102, 126, 234, 0.8);
 87 |             backdrop-filter: blur(5px);
 88 |             -webkit-backdrop-filter: blur(5px);
 89 |             border: 1px solid rgba(255, 255, 255, 0.2);
 90 |             transition: all 0.3s ease;
 91 |         }
 92 | 
 93 |         .glass-button:hover {
 94 |             background: rgba(102, 126, 234, 0.9);
 95 |             transform: translateY(-2px);
 96 |             box-shadow: 0 8px 25px rgba(102, 126, 234, 0.3);
 97 |         }
 98 | 
 99 |         /* Sticky Footer */
100 |         .sticky-footer {
101 |             position: fixed;
102 |             bottom: 0;
103 |             left: 0;
104 |             right: 0;
105 |             z-index: 1030;
106 |             background: rgba(248, 249, 250, 0.95);
107 |             backdrop-filter: blur(10px);
108 |             -webkit-backdrop-filter: blur(10px);
109 |             border-top: 1px solid rgba(255, 255, 255, 0.2);
110 |             box-shadow: 0 -4px 20px rgba(0, 0, 0, 0.1);
111 |         }
112 | 
113 |         /* Add padding to body to account for sticky footer */
114 |         body {
115 |             padding-bottom: 60px;
116 |         }
117 | 
118 |         /* Footer styling */
119 |         footer a:hover {
120 |             color: #667eea !important;
121 |         }
122 |     </style>
123 | </head>
124 | <body>
125 |     <div class="container-fluid">
126 |         <div class="row">
127 |             <!-- Sidebar -->
128 |             <div class="col-md-3 col-lg-2 px-0 sidebar">
129 |                 <div class="p-3">
130 |                     <h4 class="mb-4"><i class="fas fa-cogs me-2"></i>Ansible Admin</h4>
131 |                     <nav class="nav flex-column">
132 |                         <a class="nav-link" href="/dashboard">
133 |                             <i class="fas fa-tachometer-alt me-2"></i>Dashboard
134 |                         </a>
135 |                         <a class="nav-link" href="/playbooks">
136 |                             <i class="fas fa-play me-2"></i>Playbooks
137 |                         </a>
138 |                         <a class="nav-link" href="/inventory">
139 |                             <i class="fas fa-server me-2"></i>Inventory
140 |                         </a>
141 |                         <a class="nav-link" href="/run-playbook">
142 |                             <i class="fas fa-play-circle me-2"></i>Execute
143 |                         </a>
144 |                         <a class="nav-link active" href="/updateOS">
145 |                             <i class="fas fa-sync me-2"></i>Update OS
146 |                         </a>
147 |                         <a class="nav-link" href="/history">
148 |                             <i class="fas fa-history me-2"></i>History
149 |                         </a>
150 |                         <a class="nav-link" href="/usage">
151 |                             <i class="fas fa-question-circle me-2"></i>Usage Guide
152 |                         </a>
153 |                     </nav>
154 |                 </div>
155 |             </div>
156 | 
157 |             <!-- Main Content -->
158 |             <div class="col-md-9 col-lg-10 px-4 py-4">
159 |                 <div class="d-flex justify-content-between align-items-center mb-4">
160 |                     <h2><i class="fas fa-sync me-2"></i>Update Operating System</h2>
161 |                 </div>
162 | 
163 |                 <div class="card">
164 |                     <div class="card-body">
165 |                         <div class="row">
166 |                             <div class="col-md-6">
167 |                                 <div class="mb-3">
168 |                                     <label for="inventory-file" class="form-label">Inventory File</label>
169 |                                     <select class="form-select" id="inventory-file">
170 |                                         <option value="inventory.ini">inventory.ini</option>
171 |                                     </select>
172 |                                 </div>
173 |                                 <div class="mb-3">
174 |                                     <label for="target-hosts-select" class="form-label">Target Hosts</label>
175 |                                     <select class="form-select" id="target-hosts-select">
176 |                                         <option value="all">All Hosts</option>
177 |                                     </select>
178 |                                 </div>
179 |                                 <div class="mb-3">
180 |                                     <label for="ansible-options" class="form-label">Additional Options</label>
181 |                                     <input type="text" class="form-control" id="ansible-options" placeholder="-v --check">
182 |                                 </div>
183 |                             </div>
184 |                             <div class="col-md-6">
185 |                                 <div class="card bg-light">
186 |                                     <div class="card-body">
187 |                                         <h5 class="card-title">Update OS Playbook</h5>
188 |                                         <p class="card-text">This playbook will:</p>
189 |                                         <ul class="list-unstyled">
190 |                                             <li><i class="fas fa-check text-success me-2"></i>Update package cache</li>
191 |                                             <li><i class="fas fa-check text-success me-2"></i>Upgrade all packages</li>
192 |                                             <li><i class="fas fa-check text-success me-2"></i>Remove unused dependencies</li>
193 |                                             <li><i class="fas fa-check text-success me-2"></i>Clean package cache</li>
194 |                                         </ul>
195 |                                         <p class="text-muted small">Playbook: <code>playbooks/updateOS.yml</code></p>
196 |                                     </div>
197 |                                 </div>
198 |                             </div>
199 |                         </div>
200 | 
201 |                         <div class="d-grid gap-2 d-md-flex justify-content-md-start mb-4">
202 |                             <button class="btn btn-ansible btn-lg me-md-2" onclick="executeUpdateOS()">
203 |                                 <i class="fas fa-play me-2"></i>Execute Update OS
204 |                             </button>
205 |                             <button class="btn btn-outline-secondary btn-lg" onclick="clearOutput()">
206 |                                 <i class="fas fa-trash me-2"></i>Clear Output
207 |                             </button>
208 |                         </div>
209 | 
210 |                         <!-- Execution Modal -->
211 |                         <div class="modal fade" id="executionModal" tabindex="-1" aria-labelledby="executionModalLabel" aria-hidden="true">
212 |                             <div class="modal-dialog modal-xl">
213 |                                 <div class="modal-content">
214 |                                     <div class="modal-header">
215 |                                         <h5 class="modal-title" id="executionModalLabel">
216 |                                             <i class="fas fa-terminal me-2"></i>Update OS Execution
217 |                                         </h5>
218 |                                         <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
219 |                                     </div>
220 |                                     <div class="modal-body">
221 |                                         <div class="execution-status mb-3">
222 |                                             <span id="execution-status">Preparing...</span>
223 |                                             <span class="float-end" id="execution-timer">00:00:00</span>
224 |                                         </div>
225 |                                         <div class="execution-output border rounded p-3 bg-dark text-light" id="modal-execution-output" style="height: 400px; overflow-y: auto;">
226 |                                             🚀 Preparing OS update execution...
227 |                                         </div>
228 |                                     </div>
229 |                                     <div class="modal-footer">
230 |                                         <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
231 |                                         <button type="button" class="btn btn-danger" onclick="cancelExecution()">
232 |                                             <i class="fas fa-stop me-2"></i>Cancel Execution
233 |                                         </button>
234 |                                     </div>
235 |                                 </div>
236 |                             </div>
237 |                         </div>
238 |                     </div>
239 |                 </div>
240 |             </div>
241 |         </div>
242 |     </div>
243 | 
244 |     <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
245 |     <script>
246 |         let executionStartTime;
247 |         let executionTimer;
248 |         let eventSource;
249 |         let autoScrollEnabled = true;
250 | 
251 |         // Load target hosts on page load
252 |         document.addEventListener('DOMContentLoaded', function() {
253 |             loadTargetHosts();
254 |         });
255 | 
256 |         async function loadTargetHosts() {
257 |             try {
258 |                 const response = await fetch('/get-target-hosts');
259 |                 if (response.ok) {
260 |                     const data = await response.json();
261 |                     const select = document.getElementById('target-hosts-select');
262 | 
263 |                     // Clear existing options except "All Hosts"
264 |                     select.innerHTML = '<option value="all">All Hosts</option>';
265 | 
266 |                     // Add host options
267 |                     data.hosts.forEach(host => {
268 |                         const option = document.createElement('option');
269 |                         option.value = host.name;
270 |                         option.textContent = `${host.name} (${host.ip}) - ${host.group}`;
271 |                         select.appendChild(option);
272 |                     });
273 |                 }
274 |             } catch (error) {
275 |                 console.error('Error loading target hosts:', error);
276 |             }
277 |         }
278 | 
279 |         async function executeUpdateOS() {
280 |             const inventory = document.getElementById('inventory-file').value;
281 |             const targetHosts = document.getElementById('target-hosts-select').value;
282 |             const options = document.getElementById('ansible-options').value;
283 | 
284 |             if (!inventory) {
285 |                 alert('Please select an inventory file');
286 |                 return;
287 |             }
288 | 
289 |             // Show execution modal
290 |             const modal = new bootstrap.Modal(document.getElementById('executionModal'));
291 |             modal.show();
292 | 
293 |             // Reset execution state
294 |             document.getElementById('execution-status').className = 'badge bg-secondary';
295 |             document.getElementById('execution-status').textContent = 'Preparing...';
296 |             document.getElementById('execution-timer').textContent = '00:00:00';
297 |             document.getElementById('modal-execution-output').innerHTML = '🚀 Preparing OS update execution...\n';
298 | 
299 |             // Start execution
300 |             try {
301 |                 const response = await fetch('/execute-playbook', {
302 |                     method: 'POST',
303 |                     headers: {
304 |                         'Content-Type': 'application/json',
305 |                     },
306 |                     body: JSON.stringify({
307 |                         playbook: 'updateOS.yml',
308 |                         inventory,
309 |                         targetHosts,
310 |                         options
311 |                     })
312 |                 });
313 | 
314 |                 if (response.ok) {
315 |                     const data = await response.json();
316 |                     startExecutionMonitoring(data.executionId);
317 |                 } else {
318 |                     throw new Error('Failed to start execution');
319 |                 }
320 |             } catch (error) {
321 |                 console.error('Error executing playbook:', error);
322 |                 document.getElementById('execution-status').className = 'badge bg-danger';
323 |                 document.getElementById('execution-status').textContent = 'Failed to start';
324 |                 document.getElementById('modal-execution-output').innerHTML += '\n❌ Failed to start execution: ' + error.message;
325 |             }
326 |         }
327 | 
328 |         function startExecutionMonitoring(executionId) {
329 |             executionStartTime = new Date();
330 |             startTimer();
331 | 
332 |             document.getElementById('execution-status').className = 'badge bg-primary';
333 |             document.getElementById('execution-status').textContent = 'Running...';
334 | 
335 |             // Connect to execution stream
336 |             eventSource = new EventSource(`/execution-stream/${executionId}`);
337 | 
338 |             eventSource.onmessage = function(event) {
339 |                 const data = JSON.parse(event.data);
340 |                 appendExecutionOutput(data.output);
341 | 
342 |                 if (data.status === 'completed') {
343 |                     executionCompleted(data.success);
344 |                 } else if (data.status === 'failed') {
345 |                     executionFailed(data.error);
346 |                 }
347 |             };
348 | 
349 |             eventSource.onerror = function() {
350 |                 console.error('EventSource error');
351 |                 executionFailed('Connection lost');
352 |             };
353 |         }
354 | 
355 |         function appendExecutionOutput(output) {
356 |             const outputElement = document.getElementById('modal-execution-output');
357 |             outputElement.textContent += output + '\n';
358 | 
359 |             if (autoScrollEnabled) {
360 |                 outputElement.scrollTop = outputElement.scrollHeight;
361 |             }
362 |         }
363 | 
364 |         function startTimer() {
365 |             executionTimer = setInterval(() => {
366 |                 const elapsed = Math.floor((new Date() - executionStartTime) / 1000);
367 |                 const hours = Math.floor(elapsed / 3600).toString().padStart(2, '0');
368 |                 const minutes = Math.floor((elapsed % 3600) / 60).toString().padStart(2, '0');
369 |                 const seconds = (elapsed % 60).toString().padStart(2, '0');
370 |                 document.getElementById('execution-timer').textContent = `${hours}:${minutes}:${seconds}`;
371 |             }, 1000);
372 |         }
373 | 
374 |         function executionCompleted(success) {
375 |             clearInterval(executionTimer);
376 |             document.getElementById('execution-status').className = success ? 'badge bg-success' : 'badge bg-danger';
377 |             document.getElementById('execution-status').textContent = success ? 'Completed' : 'Failed';
378 | 
379 |             if (eventSource) {
380 |                 eventSource.close();
381 |             }
382 |         }
383 | 
384 |         function executionFailed(error) {
385 |             clearInterval(executionTimer);
386 |             document.getElementById('execution-status').className = 'badge bg-danger';
387 |             document.getElementById('execution-status').textContent = 'Failed';
388 | 
389 |             if (eventSource) {
390 |                 eventSource.close();
391 |             }
392 |         }
393 | 
394 |         function cancelExecution() {
395 |             if (eventSource) {
396 |                 eventSource.close();
397 |             }
398 | 
399 |             document.getElementById('execution-status').className = 'badge bg-warning';
400 |             document.getElementById('execution-status').textContent = 'Cancelling...';
401 |             document.getElementById('modal-execution-output').innerHTML += '\n⚠️ Execution cancellation requested...\n';
402 |         }
403 | 
404 |         function clearOutput() {
405 |             document.getElementById('modal-execution-output').innerHTML = '';
406 |         }
407 | 
408 |         // Auto-scroll toggle
409 |         document.getElementById('modal-execution-output').addEventListener('scroll', function() {
410 |             const element = this;
411 |             const isAtBottom = element.scrollTop + element.clientHeight >= element.scrollHeight - 10;
412 |             autoScrollEnabled = isAtBottom;
413 |         });
414 |     </script>
415 | 
416 |     <!-- Footer -->
417 |     <footer class="sticky-footer">
418 |         <div class="container-fluid py-3">
419 |             <div class="row align-items-center">
420 |                 <div class="col-md-6">
421 |                     <small class="text-muted">
422 |                         <i class="fas fa-cogs me-1"></i>
423 |                         <strong>Ansible Admin</strong> v2.0.0 |
424 |                         <i class="fas fa-server me-1"></i>Server Status: <span class="text-success">Online</span> |
425 |                         <i class="fas fa-clock me-1"></i><span id="current-time"></span>
426 |                     </small>
427 |                 </div>
428 |                 <div class="col-md-6 text-md-end">
429 |                     <small class="text-muted">
430 |                         <i class="fas fa-code me-1"></i>Built with Python & Bootstrap |
431 |                         <i class="fas fa-user me-1"></i>Developed by <strong>Dionipe</strong> |
432 |                         <i class="fas fa-info-circle me-1"></i><a href="#" class="text-decoration-none" data-bs-toggle="modal" data-bs-target="#aboutModal">About</a> |
433 |                         <i class="fas fa-heart text-danger me-1"></i>
434 |                         <a href="#" class="text-decoration-none">IndoBSD Infrastructure</a>
435 |                     </small>
436 |                 </div>
437 |             </div>
438 |         </div>
439 |     </footer>
440 | 
441 |     <!-- About Modal -->
442 |     <div class="modal fade" id="aboutModal" tabindex="-1" aria-labelledby="aboutModalLabel" aria-hidden="true">
443 |         <div class="modal-dialog modal-dialog-centered">
444 |             <div class="modal-content glass-card">
445 |                 <div class="modal-header">
446 |                     <h5 class="modal-title" id="aboutModalLabel">
447 |                         <i class="fas fa-info-circle me-2"></i>About Ansible Admin
448 |                     </h5>
449 |                     <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
450 |                 </div>
451 |                 <div class="modal-body">
452 |                     <div class="text-center mb-4">
453 |                         <i class="fas fa-cogs fa-3x text-primary mb-3"></i>
454 |                         <h4>Ansible Admin v2.0.0</h4>
455 |                         <p class="text-muted">Modern Ansible Management Interface</p>
456 |                         <div class="mb-3">
457 |                             <span class="badge bg-success me-2">Latest Version</span>
458 |                             <small class="text-muted">Released: September 8, 2025</small>
459 |                         </div>
460 |                     </div>
461 |                     <div class="row">
462 |                         <div class="col-md-6">
463 |                             <h6><i class="fas fa-code me-2"></i>Technologies</h6>
464 |                             <ul class="list-unstyled">
465 |                                 <li><i class="fab fa-python me-2"></i>Python Backend</li>
466 |                                 <li><i class="fas fa-globe me-2"></i>Web Interface</li>
467 |                                 <li><i class="fas fa-server me-2"></i>Ansible Integration</li>
468 |                                 <li><i class="fas fa-database me-2"></i>Real-time Updates</li>
469 |                             </ul>
470 | 
471 |                             <h6><i class="fas fa-file-alt me-2"></i>Documentation</h6>
472 |                             <ul class="list-unstyled">
473 |                                 <li><i class="fas fa-book me-2"></i><a href="README.md" target="_blank" class="text-decoration-none">README</a></li>
474 |                                 <li><i class="fas fa-history me-2"></i><a href="CHANGELOG.md" target="_blank" class="text-decoration-none">Changelog</a></li>
475 |                                 <li><i class="fas fa-question-circle me-2"></i><a href="/usage" class="text-decoration-none">Usage Guide</a></li>
476 |                             </ul>
477 |                         </div>
478 |                         <div class="col-md-6">
479 |                             <h6><i class="fas fa-user me-2"></i>Developer</h6>
480 |                             <p><strong>Dionipe</strong></p>
481 |                             <p class="text-muted small">Full-stack Developer & DevOps Engineer</p>
482 |                             
483 |                             <h6><i class="fas fa-code-branch me-2"></i>My Projects</h6>
484 |                             <div class="mb-2">
485 |                                 <a href="https://github.com/dionipe/" target="_blank" class="btn btn-sm btn-outline-primary me-2 mb-1">
486 |                                     <i class="fab fa-github me-1"></i>GitHub Profile
487 |                                 </a>
488 |                                 <a href="https://github.com/dionipe/Bootstrap-Kubernetes-on-Proxmox-with-Qemu" target="_blank" class="btn btn-sm btn-outline-success me-2 mb-1">
489 |                                     <i class="fas fa-star me-1"></i>K8s on Proxmox
490 |                                 </a>
491 |                             </div>
492 |                             <p class="text-muted small mb-2">Explore 39+ open source projects</p>
493 |                             
494 |                             <h6><i class="fas fa-building me-2"></i>Organization</h6>
495 |                             <p>IndoBSD Infrastructure</p>
496 | 
497 |                             <h6><i class="fas fa-calendar me-2"></i>Version Info</h6>
498 |                             <ul class="list-unstyled small">
499 |                                 <li><strong>Current:</strong> v2.0.0</li>
500 |                                 <li><strong>Release Date:</strong> 2025-09-08</li>
501 |                                 <li><strong>Status:</strong> <span class="badge bg-success">Stable</span></li>
502 |                             </ul>
503 |                         </div>
504 |                     </div>
505 |                     <hr>
506 |                     <div class="text-center">
507 |                         <p class="mb-2"><strong>Features:</strong></p>
508 |                         <div class="row text-start">
509 |                             <div class="col-md-6">
510 |                                 <ul class="list-unstyled small">
511 |                                     <li><i class="fas fa-check text-success me-2"></i>Playbook Management</li>
512 |                                     <li><i class="fas fa-check text-success me-2"></i>Inventory Control</li>
513 |                                     <li><i class="fas fa-check text-success me-2"></i>Real-time Execution</li>
514 |                                 </ul>
515 |                             </div>
516 |                             <div class="col-md-6">
517 |                                 <ul class="list-unstyled small">
518 |                                     <li><i class="fas fa-check text-success me-2"></i>OS Updates</li>
519 |                                     <li><i class="fas fa-check text-success me-2"></i>Execution History</li>
520 |                                     <li><i class="fas fa-check text-success me-2"></i>Modern UI Design</li>
521 |                                 </ul>
522 |                             </div>
523 |                         </div>
524 |                     </div>
525 |                 </div>
526 |                 <div class="modal-footer">
527 |                     <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
528 |                     <button type="button" class="btn btn-primary">
529 |                         <i class="fas fa-external-link-alt me-2"></i>Visit Repository
530 |                     </button>
531 |                 </div>
532 |             </div>
533 |         </div>
534 |     </div>
535 | 
536 |     <script>
537 |         // Update current time in footer
538 |         function updateTime() {
539 |             const now = new Date();
540 |             const timeString = now.toLocaleTimeString();
541 |             document.getElementById('current-time').textContent = timeString;
542 |         }
543 | 
544 |         // Update time every second
545 |         setInterval(updateTime, 1000);
546 |         updateTime(); // Initial call
547 |     </script>
548 | </body>
549 | </html>
550 | 


--------------------------------------------------------------------------------
/usage.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE html>
  2 | <html lang="en">
  3 | <head>
  4 |     <meta charset="UTF-8">
  5 |     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6 |     <title>Usage Guide - Ansible Admin</title>
  7 |     <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
  8 |     <link href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css" rel="stylesheet">
  9 |     <style>
 10 |         .sidebar {
 11 |             min-height: 100vh;
 12 |             background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
 13 |             color: white;
 14 |         }
 15 |         .sidebar .nav-link {
 16 |             color: rgba(255, 255, 255, 0.8);
 17 |             transition: all 0.3s;
 18 |         }
 19 |         .sidebar .nav-link:hover {
 20 |             color: white;
 21 |             background-color: rgba(255, 255, 255, 0.1);
 22 |         }
 23 |         .sidebar .nav-link.active {
 24 |             background-color: rgba(255, 255, 255, 0.2);
 25 |             color: white;
 26 |         }
 27 |         .card {
 28 |             border: none;
 29 |             border-radius: 10px;
 30 |             box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
 31 |         }
 32 |         .btn-ansible {
 33 |             background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
 34 |             border: none;
 35 |             color: white;
 36 |         }
 37 |         .btn-ansible:hover {
 38 |             background: linear-gradient(135deg, #5a6fd8 0%, #6a4190 100%);
 39 |             color: white;
 40 |         }
 41 |         .form-control:focus {
 42 |             border-color: #667eea;
 43 |             box-shadow: 0 0 0 0.2rem rgba(102, 126, 234, 0.25);
 44 |         }
 45 | 
 46 |         /* Glassmorphism Effects */
 47 |         .glass-card {
 48 |             background: rgba(255, 255, 255, 0.1);
 49 |             backdrop-filter: blur(10px);
 50 |             -webkit-backdrop-filter: blur(10px);
 51 |             border: 1px solid rgba(255, 255, 255, 0.2);
 52 |         }
 53 | 
 54 |         /* Sticky Footer */
 55 |         .sticky-footer {
 56 |             position: fixed;
 57 |             bottom: 0;
 58 |             width: 100%;
 59 |             background: rgba(255, 255, 255, 0.95);
 60 |             backdrop-filter: blur(10px);
 61 |             -webkit-backdrop-filter: blur(10px);
 62 |             border-top: 1px solid rgba(255, 255, 255, 0.2);
 63 |             z-index: 1030;
 64 |         }
 65 | 
 66 |         body {
 67 |             padding-bottom: 80px; /* Space for sticky footer */
 68 |         }
 69 | 
 70 |         /* Usage Guide Styles */
 71 |         .step-card {
 72 |             transition: transform 0.3s ease;
 73 |         }
 74 |         .step-card:hover {
 75 |             transform: translateY(-5px);
 76 |         }
 77 |         .feature-icon {
 78 |             width: 60px;
 79 |             height: 60px;
 80 |             border-radius: 50%;
 81 |             display: flex;
 82 |             align-items: center;
 83 |             justify-content: center;
 84 |             margin: 0 auto 1rem;
 85 |         }
 86 |         .code-block {
 87 |             background: rgba(0, 0, 0, 0.05);
 88 |             border: 1px solid rgba(0, 0, 0, 0.1);
 89 |             border-radius: 5px;
 90 |             padding: 1rem;
 91 |             font-family: 'Courier New', monospace;
 92 |             font-size: 0.9rem;
 93 |         }
 94 |         .highlight-box {
 95 |             background: linear-gradient(135deg, rgba(102, 126, 234, 0.1), rgba(118, 75, 162, 0.1));
 96 |             border-left: 4px solid #667eea;
 97 |             padding: 1rem;
 98 |             margin: 1rem 0;
 99 |         }
100 |     </style>
101 | </head>
102 | <body>
103 |     <!-- Sidebar -->
104 |     <div class="container-fluid">
105 |         <div class="row">
106 |             <div class="col-md-3 col-lg-2 px-0">
107 |                 <div class="sidebar p-3">
108 |                     <h4 class="text-white mb-4">
109 |                         <i class="fas fa-cogs me-2"></i>Ansible Admin
110 |                     </h4>
111 |                     <nav class="nav flex-column">
112 |                         <a class="nav-link" href="/dashboard">
113 |                             <i class="fas fa-tachometer-alt me-2"></i>Dashboard
114 |                         </a>
115 |                         <a class="nav-link" href="/playbooks">
116 |                             <i class="fas fa-book me-2"></i>Playbooks
117 |                         </a>
118 |                         <a class="nav-link" href="/inventory">
119 |                             <i class="fas fa-server me-2"></i>Inventory
120 |                         </a>
121 |                         <a class="nav-link" href="/run-playbook">
122 |                             <i class="fas fa-play-circle me-2"></i>Execute
123 |                         </a>
124 |                         <a class="nav-link" href="/updateOS">
125 |                             <i class="fas fa-arrow-up me-2"></i>Update OS
126 |                         </a>
127 |                         <a class="nav-link" href="/history">
128 |                             <i class="fas fa-history me-2"></i>History
129 |                         </a>
130 |                         <a class="nav-link active" href="/usage">
131 |                             <i class="fas fa-question-circle me-2"></i>Usage Guide
132 |                         </a>
133 |                     </nav>
134 |                 </div>
135 |             </div>
136 | 
137 |             <!-- Main Content -->
138 |             <div class="col-md-9 col-lg-10 px-4 py-4 main-content">
139 |                 <div class="d-flex justify-content-between align-items-center mb-4">
140 |                     <div>
141 |                         <h2 class="mb-1"><i class="fas fa-question-circle me-2"></i>Usage Guide</h2>
142 |                         <small class="text-muted">Complete guide to using Ansible Admin</small>
143 |                     </div>
144 |                     <div class="d-flex gap-2">
145 |                         <button class="btn btn-outline-primary btn-sm" onclick="printGuide()">
146 |                             <i class="fas fa-print me-1"></i>Print Guide
147 |                         </button>
148 |                         <button class="btn btn-ansible btn-sm" onclick="scrollToTop()">
149 |                             <i class="fas fa-arrow-up me-1"></i>Top
150 |                         </button>
151 |                     </div>
152 |                 </div>
153 | 
154 |                 <!-- Quick Start -->
155 |                 <div class="glass-card p-4 mb-4">
156 |                     <h4 class="mb-3"><i class="fas fa-rocket me-2"></i>Quick Start</h4>
157 |                     <div class="row">
158 |                         <div class="col-md-4 mb-3">
159 |                             <div class="text-center">
160 |                                 <div class="feature-icon bg-primary text-white">
161 |                                     <i class="fas fa-server fa-2x"></i>
162 |                                 </div>
163 |                                 <h6>1. Setup Inventory</h6>
164 |                                 <p class="small text-muted">Add your servers and configure SSH access</p>
165 |                             </div>
166 |                         </div>
167 |                         <div class="col-md-4 mb-3">
168 |                             <div class="text-center">
169 |                                 <div class="feature-icon bg-success text-white">
170 |                                     <i class="fas fa-book fa-2x"></i>
171 |                                 </div>
172 |                                 <h6>2. Create Playbooks</h6>
173 |                                 <p class="small text-muted">Write or upload your Ansible playbooks</p>
174 |                             </div>
175 |                         </div>
176 |                         <div class="col-md-4 mb-3">
177 |                             <div class="text-center">
178 |                                 <div class="feature-icon bg-warning text-white">
179 |                                     <i class="fas fa-play fa-2x"></i>
180 |                                 </div>
181 |                                 <h6>3. Execute & Monitor</h6>
182 |                                 <p class="small text-muted">Run playbooks and monitor execution in real-time</p>
183 |                             </div>
184 |                         </div>
185 |                     </div>
186 |                 </div>
187 | 
188 |                 <!-- Detailed Guide -->
189 |                 <div class="row">
190 |                     <div class="col-lg-8">
191 |                         <!-- Getting Started -->
192 |                         <div class="card step-card mb-4">
193 |                             <div class="card-header bg-primary text-white">
194 |                                 <h5 class="mb-0"><i class="fas fa-play me-2"></i>Getting Started</h5>
195 |                             </div>
196 |                             <div class="card-body">
197 |                                 <h6>System Requirements</h6>
198 |                                 <ul class="mb-3">
199 |                                     <li><strong>Ansible:</strong> Version 2.9+ installed on the server</li>
200 |                                     <li><strong>Python:</strong> Version 3.6+ with required packages</li>
201 |                                     <li><strong>SSH Access:</strong> Password or key-based authentication to target servers</li>
202 |                                     <li><strong>Web Browser:</strong> Modern browser with JavaScript enabled</li>
203 |                                 </ul>
204 | 
205 |                                 <h6>Initial Setup</h6>
206 |                                 <div class="highlight-box">
207 |                                     <strong>1. Configure Inventory:</strong> Add your target servers with IP addresses, hostnames, and SSH credentials.
208 |                                     <br><strong>2. Test Connection:</strong> Verify SSH connectivity to all configured hosts.
209 |                                     <br><strong>3. Create Playbooks:</strong> Write or upload Ansible playbooks for your automation tasks.
210 |                                 </div>
211 |                             </div>
212 |                         </div>
213 | 
214 |                         <!-- Dashboard Usage -->
215 |                         <div class="card step-card mb-4">
216 |                             <div class="card-header bg-info text-white">
217 |                                 <h5 class="mb-0"><i class="fas fa-tachometer-alt me-2"></i>Dashboard</h5>
218 |                             </div>
219 |                             <div class="card-body">
220 |                                 <p>The dashboard provides an overview of your Ansible infrastructure:</p>
221 |                                 <ul>
222 |                                     <li><strong>System Metrics:</strong> CPU, memory, and disk usage across all hosts</li>
223 |                                     <li><strong>Recent Activity:</strong> Latest playbook executions and their status</li>
224 |                                     <li><strong>Quick Actions:</strong> Direct links to common tasks</li>
225 |                                     <li><strong>Health Status:</strong> Real-time status of all managed servers</li>
226 |                                 </ul>
227 |                                 <div class="code-block">
228 | Use the dashboard to monitor your infrastructure health and quickly access recent activities.
229 |                                 </div>
230 |                             </div>
231 |                         </div>
232 | 
233 |                         <!-- Playbook Management -->
234 |                         <div class="card step-card mb-4">
235 |                             <div class="card-header bg-success text-white">
236 |                                 <h5 class="mb-0"><i class="fas fa-book me-2"></i>Playbook Management</h5>
237 |                             </div>
238 |                             <div class="card-body">
239 |                                 <h6>Creating Playbooks</h6>
240 |                                 <ol>
241 |                                     <li>Navigate to the <strong>Playbooks</strong> section</li>
242 |                                     <li>Click <strong>"Create New Playbook"</strong></li>
243 |                                     <li>Choose between writing YAML or using templates</li>
244 |                                     <li>Save and validate your playbook</li>
245 |                                 </ol>
246 | 
247 |                                 <h6>Using Templates</h6>
248 |                                 <p>Pre-built templates are available for common tasks:</p>
249 |                                 <ul>
250 |                                     <li><strong>Basic Template:</strong> Package updates and system maintenance</li>
251 |                                     <li><strong>Web Server:</strong> Apache/Nginx installation and configuration</li>
252 |                                     <li><strong>Monitoring:</strong> System monitoring tools setup</li>
253 |                                     <li><strong>Security:</strong> Firewall and security hardening</li>
254 |                                 </ul>
255 |                             </div>
256 |                         </div>
257 | 
258 |                         <!-- Inventory Management -->
259 |                         <div class="card step-card mb-4">
260 |                             <div class="card-header bg-warning text-white">
261 |                                 <h5 class="mb-0"><i class="fas fa-server me-2"></i>Inventory Management</h5>
262 |                             </div>
263 |                             <div class="card-body">
264 |                                 <h6>Adding Hosts</h6>
265 |                                 <div class="code-block">
266 | 1. Go to Inventory → Add Host<br>
267 | 2. Enter hostname and IP address<br>
268 | 3. Configure SSH credentials<br>
269 | 4. Set connection parameters<br>
270 | 5. Test connection before saving
271 |                                 </div>
272 | 
273 |                                 <h6>Host Groups</h6>
274 |                                 <p>Organize your servers into logical groups:</p>
275 |                                 <ul>
276 |                                     <li><strong>webservers:</strong> Web application servers</li>
277 |                                     <li><strong>databases:</strong> Database servers</li>
278 |                                     <li><strong>loadbalancers:</strong> Load balancing servers</li>
279 |                                     <li><strong>monitoring:</strong> Monitoring and logging servers</li>
280 |                                 </ul>
281 |                             </div>
282 |                         </div>
283 | 
284 |                         <!-- Execution -->
285 |                         <div class="card step-card mb-4">
286 |                             <div class="card-header bg-danger text-white">
287 |                                 <h5 class="mb-0"><i class="fas fa-play-circle me-2"></i>Executing Playbooks</h5>
288 |                             </div>
289 |                             <div class="card-body">
290 |                                 <h6>Running Playbooks</h6>
291 |                                 <ol>
292 |                                     <li>Select a playbook from the dropdown</li>
293 |                                     <li>Choose target hosts or groups</li>
294 |                                     <li>Configure execution parameters</li>
295 |                                     <li>Click <strong>"Execute Playbook"</strong></li>
296 |                                     <li>Monitor execution in real-time</li>
297 |                                 </ol>
298 | 
299 |                                 <h6>Execution Options</h6>
300 |                                 <ul>
301 |                                     <li><strong>Dry Run:</strong> Test playbook without making changes</li>
302 |                                     <li><strong>Verbose Mode:</strong> Detailed execution output</li>
303 |                                     <li><strong>Limiting Hosts:</strong> Run on specific hosts only</li>
304 |                                     <li><strong>Tags:</strong> Execute specific parts of playbooks</li>
305 |                                 </ul>
306 |                             </div>
307 |                         </div>
308 |                     </div>
309 | 
310 |                     <!-- Sidebar with Tips -->
311 |                     <div class="col-lg-4">
312 |                         <div class="card mb-4">
313 |                             <div class="card-header bg-light">
314 |                                 <h6 class="mb-0"><i class="fas fa-lightbulb me-2"></i>Pro Tips</h6>
315 |                             </div>
316 |                             <div class="card-body">
317 |                                 <div class="mb-3">
318 |                                     <h6>🔐 Security Best Practices</h6>
319 |                                     <ul class="small">
320 |                                         <li>Use SSH key authentication</li>
321 |                                         <li>Limit sudo access</li>
322 |                                         <li>Regular key rotation</li>
323 |                                         <li>Monitor access logs</li>
324 |                                     </ul>
325 |                                 </div>
326 | 
327 |                                 <div class="mb-3">
328 |                                     <h6>⚡ Performance Optimization</h6>
329 |                                     <ul class="small">
330 |                                         <li>Use host groups for targeting</li>
331 |                                         <li>Implement parallel execution</li>
332 |                                         <li>Cache facts when possible</li>
333 |                                         <li>Use async tasks for long operations</li>
334 |                                     </ul>
335 |                                 </div>
336 | 
337 |                                 <div class="mb-3">
338 |                                     <h6>🔄 Backup Strategy</h6>
339 |                                     <ul class="small">
340 |                                         <li>Version control your playbooks</li>
341 |                                         <li>Backup inventory files</li>
342 |                                         <li>Document custom variables</li>
343 |                                         <li>Test in staging first</li>
344 |                                     </ul>
345 |                                 </div>
346 |                             </div>
347 |                         </div>
348 | 
349 |                         <div class="card">
350 |                             <div class="card-header bg-light">
351 |                                 <h6 class="mb-0"><i class="fas fa-question me-2"></i>Need Help?</h6>
352 |                             </div>
353 |                             <div class="card-body">
354 |                                 <p class="small mb-2">Having trouble? Check these resources:</p>
355 |                                 <div class="d-grid gap-2">
356 |                                     <a href="#troubleshooting" class="btn btn-outline-primary btn-sm">
357 |                                         <i class="fas fa-tools me-1"></i>Troubleshooting
358 |                                     </a>
359 |                                     <a href="#faq" class="btn btn-outline-info btn-sm">
360 |                                         <i class="fas fa-question-circle me-1"></i>FAQ
361 |                                     </a>
362 |                                     <button class="btn btn-outline-success btn-sm" onclick="contactSupport()">
363 |                                         <i class="fas fa-envelope me-1"></i>Contact Support
364 |                                     </button>
365 |                                 </div>
366 |                             </div>
367 |                         </div>
368 |                     </div>
369 |                 </div>
370 | 
371 |                 <!-- Troubleshooting Section -->
372 |                 <div id="troubleshooting" class="card step-card mb-4">
373 |                     <div class="card-header bg-secondary text-white">
374 |                         <h5 class="mb-0"><i class="fas fa-tools me-2"></i>Troubleshooting</h5>
375 |                     </div>
376 |                     <div class="card-body">
377 |                         <div class="row">
378 |                             <div class="col-md-6">
379 |                                 <h6>Common Issues</h6>
380 |                                 <div class="mb-3">
381 |                                     <strong>SSH Connection Failed:</strong>
382 |                                     <ul class="small">
383 |                                         <li>Verify SSH credentials</li>
384 |                                         <li>Check firewall settings</li>
385 |                                         <li>Ensure SSH service is running</li>
386 |                                         <li>Test manual SSH connection</li>
387 |                                     </ul>
388 |                                 </div>
389 | 
390 |                                 <div class="mb-3">
391 |                                     <strong>Playbook Execution Errors:</strong>
392 |                                     <ul class="small">
393 |                                         <li>Validate YAML syntax</li>
394 |                                         <li>Check variable definitions</li>
395 |                                         <li>Verify module availability</li>
396 |                                         <li>Review error logs</li>
397 |                                     </ul>
398 |                                 </div>
399 |                             </div>
400 |                             <div class="col-md-6">
401 |                                 <h6>Debug Commands</h6>
402 |                                 <div class="code-block small">
403 | ansible -i inventory.ini all -m ping<br>
404 | ansible-playbook --syntax-check playbook.yml<br>
405 | ansible-playbook -vvv playbook.yml<br>
406 | ansible all -m setup | grep ansible_distribution
407 |                                 </div>
408 | 
409 |                                 <h6>Log Locations</h6>
410 |                                 <ul class="small">
411 |                                     <li><strong>Ansible logs:</strong> /var/log/ansible.log</li>
412 |                                     <li><strong>Application logs:</strong> /home/dionipe/ansible-admin/logs/</li>
413 |                                     <li><strong>System logs:</strong> /var/log/syslog</li>
414 |                                 </ul>
415 |                             </div>
416 |                         </div>
417 |                     </div>
418 |                 </div>
419 | 
420 |                 <!-- FAQ Section -->
421 |                 <div id="faq" class="card step-card mb-4">
422 |                     <div class="card-header bg-info text-white">
423 |                         <h5 class="mb-0"><i class="fas fa-question-circle me-2"></i>Frequently Asked Questions</h5>
424 |                     </div>
425 |                     <div class="card-body">
426 |                         <div class="accordion" id="faqAccordion">
427 |                             <div class="accordion-item">
428 |                                 <h2 class="accordion-header">
429 |                                     <button class="accordion-button" type="button" data-bs-toggle="collapse" data-bs-target="#faq1">
430 |                                         How do I add multiple hosts at once?
431 |                                     </button>
432 |                                 </h2>
433 |                                 <div id="faq1" class="accordion-collapse collapse show" data-bs-parent="#faqAccordion">
434 |                                     <div class="accordion-body">
435 |                                         You can add multiple hosts by creating a CSV file or using Ansible's dynamic inventory scripts. For bulk import, use the "Import Hosts" feature in the Inventory section.
436 |                                     </div>
437 |                                 </div>
438 |                             </div>
439 | 
440 |                             <div class="accordion-item">
441 |                                 <h2 class="accordion-header">
442 |                                     <button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#faq2">
443 |                                         Can I schedule playbook executions?
444 |                                     </button>
445 |                                 </h2>
446 |                                 <div id="faq2" class="accordion-collapse collapse" data-bs-parent="#faqAccordion">
447 |                                     <div class="accordion-body">
448 |                                         Yes, you can use cron jobs or Ansible Tower/AWX for scheduling. For simple scheduling, create a cron job that calls the Ansible Admin API endpoints.
449 |                                     </div>
450 |                                 </div>
451 |                             </div>
452 | 
453 |                             <div class="accordion-item">
454 |                                 <h2 class="accordion-header">
455 |                                     <button class="accordion-button collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#faq3">
456 |                                         How do I backup my configurations?
457 |                                     </button>
458 |                                 </h2>
459 |                                 <div id="accordion-collapse" class="accordion-collapse collapse" data-bs-parent="#faqAccordion">
460 |                                     <div class="accordion-body">
461 |                                         Regularly backup your inventory files, playbooks, and configuration. Use version control (Git) for playbooks and document all custom variables and settings.
462 |                                     </div>
463 |                                 </div>
464 |                             </div>
465 |                         </div>
466 |                     </div>
467 |                 </div>
468 |             </div>
469 |         </div>
470 |     </div>
471 | 
472 |     <!-- Footer -->
473 |     <footer class="sticky-footer">
474 |         <div class="container-fluid py-3">
475 |             <div class="row align-items-center">
476 |                 <div class="col-md-6">
477 |                     <small class="text-muted">
478 |                         <i class="fas fa-cogs me-1"></i>
479 |                         <strong>Ansible Admin</strong> v2.0.0 |
480 |                         <i class="fas fa-server me-1"></i>Server Status: <span class="text-success">Online</span> |
481 |                         <i class="fas fa-clock me-1"></i><span id="current-time"></span>
482 |                     </small>
483 |                 </div>
484 |                 <div class="col-md-6 text-md-end">
485 |                     <small class="text-muted">
486 |                         <i class="fas fa-code me-1"></i>Built with Python & Bootstrap |
487 |                         <i class="fas fa-user me-1"></i>Developed by <strong>Dionipe</strong> |
488 |                         <i class="fas fa-info-circle me-1"></i><a href="#" class="text-decoration-none" data-bs-toggle="modal" data-bs-target="#aboutModal">About</a> |
489 |                         <i class="fas fa-heart text-danger me-1"></i>
490 |                         <a href="#" class="text-decoration-none">IndoBSD Infrastructure</a>
491 |                     </small>
492 |                 </div>
493 |             </div>
494 |         </div>
495 |     </footer>
496 | 
497 |     <!-- About Modal -->
498 |     <div class="modal fade" id="aboutModal" tabindex="-1" aria-labelledby="aboutModalLabel" aria-hidden="true">
499 |         <div class="modal-dialog modal-dialog-centered">
500 |             <div class="modal-content glass-card">
501 |                 <div class="modal-header">
502 |                     <h5 class="modal-title" id="aboutModalLabel">
503 |                         <i class="fas fa-info-circle me-2"></i>About Ansible Admin
504 |                     </h5>
505 |                     <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
506 |                 </div>
507 |                 <div class="modal-body">
508 |                     <div class="text-center mb-4">
509 |                         <i class="fas fa-cogs fa-3x text-primary mb-3"></i>
510 |                         <h4>Ansible Admin v2.0.0</h4>
511 |                         <p class="text-muted">Modern Ansible Management Interface</p>
512 |                         <div class="mb-3">
513 |                             <span class="badge bg-success me-2">Latest Version</span>
514 |                             <small class="text-muted">Released: September 8, 2025</small>
515 |                         </div>
516 |                     </div>
517 |                     <div class="row">
518 |                         <div class="col-md-6">
519 |                             <h6><i class="fas fa-code me-2"></i>Technologies</h6>
520 |                             <ul class="list-unstyled">
521 |                                 <li><i class="fab fa-python me-2"></i>Python Backend</li>
522 |                                 <li><i class="fas fa-globe me-2"></i>Web Interface</li>
523 |                                 <li><i class="fas fa-server me-2"></i>Ansible Integration</li>
524 |                                 <li><i class="fas fa-database me-2"></i>Real-time Updates</li>
525 |                             </ul>
526 | 
527 |                             <h6><i class="fas fa-file-alt me-2"></i>Documentation</h6>
528 |                             <ul class="list-unstyled">
529 |                                 <li><i class="fas fa-book me-2"></i><a href="README.md" target="_blank" class="text-decoration-none">README</a></li>
530 |                                 <li><i class="fas fa-history me-2"></i><a href="CHANGELOG.md" target="_blank" class="text-decoration-none">Changelog</a></li>
531 |                                 <li><i class="fas fa-question-circle me-2"></i><a href="/usage" class="text-decoration-none">Usage Guide</a></li>
532 |                             </ul>
533 |                         </div>
534 |                         <div class="col-md-6">
535 |                             <h6><i class="fas fa-user me-2"></i>Developer</h6>
536 |                             <p><strong>Dionipe</strong></p>
537 |                             <p class="text-muted small">Full-stack Developer & DevOps Engineer</p>
538 |                             
539 |                             <h6><i class="fas fa-code-branch me-2"></i>My Projects</h6>
540 |                             <div class="mb-2">
541 |                                 <a href="https://github.com/dionipe/" target="_blank" class="btn btn-sm btn-outline-primary me-2 mb-1">
542 |                                     <i class="fab fa-github me-1"></i>GitHub Profile
543 |                                 </a>
544 |                                 <a href="https://github.com/dionipe/Bootstrap-Kubernetes-on-Proxmox-with-Qemu" target="_blank" class="btn btn-sm btn-outline-success me-2 mb-1">
545 |                                     <i class="fas fa-star me-1"></i>K8s on Proxmox
546 |                                 </a>
547 |                             </div>
548 |                             <p class="text-muted small mb-2">Explore 39+ open source projects</p>
549 |                             
550 |                             <h6><i class="fas fa-building me-2"></i>Organization</h6>
551 |                             <p>IndoBSD Infrastructure</p>
552 | 
553 |                             <h6><i class="fas fa-calendar me-2"></i>Version Info</h6>
554 |                             <ul class="list-unstyled small">
555 |                                 <li><strong>Current:</strong> v2.0.0</li>
556 |                                 <li><strong>Release Date:</strong> 2025-09-08</li>
557 |                                 <li><strong>Status:</strong> <span class="badge bg-success">Stable</span></li>
558 |                             </ul>
559 |                         </div>
560 |                     </div>
561 |                     <hr>
562 |                     <div class="text-center">
563 |                         <p class="mb-2"><strong>Features:</strong></p>
564 |                         <div class="row text-start">
565 |                             <div class="col-md-6">
566 |                                 <ul class="list-unstyled small">
567 |                                     <li><i class="fas fa-check text-success me-2"></i>Playbook Management</li>
568 |                                     <li><i class="fas fa-check text-success me-2"></i>Inventory Control</li>
569 |                                     <li><i class="fas fa-check text-success me-2"></i>Real-time Execution</li>
570 |                                 </ul>
571 |                             </div>
572 |                             <div class="col-md-6">
573 |                                 <ul class="list-unstyled small">
574 |                                     <li><i class="fas fa-check text-success me-2"></i>OS Updates</li>
575 |                                     <li><i class="fas fa-check text-success me-2"></i>Execution History</li>
576 |                                     <li><i class="fas fa-check text-success me-2"></i>Modern UI Design</li>
577 |                                 </ul>
578 |                             </div>
579 |                         </div>
580 |                     </div>
581 |                 </div>
582 |                 <div class="modal-footer">
583 |                     <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
584 |                     <button type="button" class="btn btn-primary">
585 |                         <i class="fas fa-external-link-alt me-2"></i>Visit Repository
586 |                     </button>
587 |                 </div>
588 |             </div>
589 |         </div>
590 |     </div>
591 | 
592 |     <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
593 |     <script>
594 |         // Update current time in footer
595 |         function updateTime() {
596 |             const now = new Date();
597 |             const timeString = now.toLocaleTimeString();
598 |             document.getElementById('current-time').textContent = timeString;
599 |         }
600 | 
601 |         // Update time every second
602 |         setInterval(updateTime, 1000);
603 |         updateTime(); // Initial call
604 | 
605 |         // Print guide function
606 |         function printGuide() {
607 |             window.print();
608 |         }
609 | 
610 |         // Scroll to top function
611 |         function scrollToTop() {
612 |             window.scrollTo({ top: 0, behavior: 'smooth' });
613 |         }
614 | 
615 |         // Contact support function
616 |         function contactSupport() {
617 |             const subject = encodeURIComponent('Ansible Admin Support Request');
618 |             const body = encodeURIComponent('Please describe your issue or question about Ansible Admin:');
619 |             window.location.href = `mailto:support@example.com?subject=${subject}&body=${body}`;
620 |         }
621 | 
622 |         // Smooth scrolling for anchor links
623 |         document.querySelectorAll('a[href^="#"]').forEach(anchor => {
624 |             anchor.addEventListener('click', function (e) {
625 |                 e.preventDefault();
626 |                 const target = document.querySelector(this.getAttribute('href'));
627 |                 if (target) {
628 |                     target.scrollIntoView({
629 |                         behavior: 'smooth',
630 |                         block: 'start'
631 |                     });
632 |                 }
633 |             });
634 |         });
635 |     </script>
636 | </body>
637 | </html>
638 | 


--------------------------------------------------------------------------------