oqapi/webgui
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
webgui/CONTEXT.md
Arjan Widlak 9fdb1bfc25 distribution -> deploy (git mv, history kept) 
> distributino/docker-compose.yml -> compose.yml in the root, paths in file updated
> Dockerfile -> deploy/webgui/Containerfile
> deploy/webgui/Containerfile now with FROM localhost/webgui-deps
> New: deploy/webgui-deps/Containerfile with all cpan modules (and apt block that was above it)
all modules their own RUN cpanm --notest line
ENV PERL_CPANM_OPT to use cpan-mirror
README.md, CONTEXT.md and .dockerignore updated
--no-cache --force -> --notest (so i can test)
2026-06-30 20:00:40 +00:00

1.9 KiB
Raw Permalink Blame History

Project Context & Configuration

🛠️ Environment & Tech Stack

  • Containerization: Podman

Directory Structure & Key Files

  • CONTEXT.md, this file
  • README.md of the WebGUI project
  • compose.yml Current orchestration
  • the custom folder contains all files related to custom modules add to WebGUI
  • the deploy folder contains
    • webgui-deps/Containerfile - system packages and Perl modules (cpanm), built first as localhost/webgui-deps
    • webgui/Containerfile - the WebGUI app image, built FROM localhost/webgui-deps
    • nginx/nginx.conf - configuration file for nginx in seperate pod
    • share/create.sql - the create database file so mariadb can function as a database service for WebGUI
    • webgui/entrypoint - the script that runs when the WebGUI service starts
    • webgui/modperl.pl - an apache2 webserver configuration script used by WebGUI
    • webgui/webgui.conf - an apache2 webserver configuration file for WebGUI
    • webgui/www.example.com/conf - an example configuration file for a specific domain to use WebGUI
  • the docs folder is part of the WebGUI system, it contains
    • the changelogs, the upgrade scripts, several database dumps and descriptive files
  • the etc contains the configuration files for the domains that use WebGUI
  • the lib folder contains all the WebGUI code
  • the sbin folder contains WebGUI helper scripts
  • the share folder contains several files for the WebGUI service and the nginx reverse proxy service to work in conjunction
  • the t folder contains WebGUI tests
  • the www folder contains static files served by WebGUI

1. Current project goals

  • part of this repository is WebGUI, as described in README.md
  • right now, we are not concerned with changeing the WebGUI codebase
  • currently the only goal is to optimize the build process of WebGUI in a podman pod and
  • the orchestration so the WebGUI service runs well configured with
  • mariadb database service and
  • nginx reverse proxy