Skip to main content

Basic WebUI for using Ansible

Project description

Basic WebUI for using Ansible

Buy me a coffee

Lint Test

DISCLAIMER: This is an unofficial community project! Do not confuse it with the vanilla Ansible product!

The goal is to allow users to quickly install & run a WebUI for using Ansible locally.

Keep it simple.


Setup

Local - PIP

Requires Python >=3.10

# install
python3 -m pip install ansibleguy-webui

# run
python3 -m ansibleguy-webui

Docker

Images: webui, webui-unprivileged, webui-aws

docker image pull ansible0guy/webui:latest
docker run -d --name ansible-webui --publish 127.0.0.1:8000:8000 ansible0guy/webui:latest

# or with persistent data (volumes: /data = storage for logs & DB, /play = ansible playbook base-directory)
docker run -d --name ansible-webui --publish 127.0.0.1:8000:8000 --volume $(pwd)/ansible/data:/data --volume $(pwd)/ansible/play:/play ansible0guy/webui:latest

Demo

Check out the demo at: demo.webui.ansibleguy.net

Login: User demo, Password Ansible1337


Usage

Documentation

Docs Uptime

Alternative Link


Contribute

Feel free to contribute to this project using pull-requests, issues and discussions!

Testers are also very welcome! Please give feedback

See also: Contributing


Advertisement


Roadmap

  • Ansible Config

    • Static Playbook-Directory

    • Git Repository support

  • Users

  • Jobs

    • Execute Ansible using ansible-runner

    • Job Logging

      • Write job metadata to database

      • Write full job-logs to Filesystem

    • Secret handling (Connect, Become, Vault)

      • User-specific job credentials
    • Alerting on Failure

      • E-Mail

      • Support for external Plugins (simple Interface for Scripts)

  • WebUI

    • Job Dashboard

      Status, Execute, Time of last & next execution, Last run User, Links to Warnings/Errors

    • Job Output

      Follow the jobs output in realtime

    • Job Errors

      UI that allows for easy error analysis. Access to logs and provide links to possible solutions

    • Show Ansible Running-Config

    • Show Ansible Collections

      • Check Collections for available updates (Galaxy + GitHub releases)
    • Mobile Support

    • Multi-Language Support

  • API

    • Manage and execute Jobs
  • Database

    • Support for MySQL
  • Testing

    • Unit Tests

    • Integration Tests

      • Basic WebUI checks

      • API Endpoints

      • Permission system

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ansibleguy_webui-0.0.25.tar.gz (239.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ansibleguy_webui-0.0.25-py3-none-any.whl (286.8 kB view details)

Uploaded Python 3

File details

Details for the file ansibleguy_webui-0.0.25.tar.gz.

File metadata

  • Download URL: ansibleguy_webui-0.0.25.tar.gz
  • Upload date:
  • Size: 239.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for ansibleguy_webui-0.0.25.tar.gz
Algorithm Hash digest
SHA256 3aea5218ba22c1d6352b28e1cf1589eaeb437c83e00285d71a858a7fe9d89f3e
MD5 844f71fb2b15f773bc7fe8b9020f459f
BLAKE2b-256 ffc0557e0e630a0706ad3ca70c7d1db23d75680c33714d9ac911567f51a5da2b

See more details on using hashes here.

File details

Details for the file ansibleguy_webui-0.0.25-py3-none-any.whl.

File metadata

File hashes

Hashes for ansibleguy_webui-0.0.25-py3-none-any.whl
Algorithm Hash digest
SHA256 60a9f6141ff0a89d6390d218e9b804ab8f55b11824c0a44354e968b391b55d59
MD5 e4f7d3b03f06b5fe6f474100e48954ad
BLAKE2b-256 92d8815962f41cf732c89091531b3ad23ce7fac8b4428646bbae2831ae662035

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page