Porthos

Porthos web stack to serve DNF repositories and NS8 application Distfeed

The Porthos app announcement

Documentation can be found here

Porthos is a community application from the Nethserver repository. The sources can be found on Github. Please see the excerpt from the readme below.

README.md

Host Distfeed and Rocky Linux repository mirrors on Porthos
 
This module provides a simple web stack to serve DNF repositories and NS8
application Distfeed, based on Nginx + PHP-FPM.
 
## Install
 
Instantiate the module with:
 
    add-module ghcr.io/nethserver/porthos:latest 1
 
The output of the command will return the instance name.
Output example:
 
    {"module_id": "porthos1", "image_name": "porthos", "image_url": "ghcr.io/nethserver/porthos:latest"}
 
For optimal performance, mount a filesystem with data deduplication or a
LVM-VDO device. For example:
 
    dnf install lvm2 vdo vdo-support
    vgcreate porthos /dev/disk/by-id/scsi-porthos-volume
    lvcreate --type vdo --name webroot --extents '100%FREE' porthos
    mkfs.xfs -K /dev/porthos/webroot
    mkdir -vp /srv/porthos/webroot
    mount /dev/porthos/webroot /srv/porthos/webroot
    chown -c porthos1:porthos1 /srv/porthos/webroot
 
Create the `webroot` volume bounded to the device mount point:
 
    runagent -m porthos1 podman volume create --opt=device=/srv/porthos/webroot/ --opt=type=bind webroot
 
Then proceed with the first module configuration: see how to run
`configure-module` in the next section.
 
## Configure
 
See the current module setup:
 
    api-cli run module/porthos2/get-configuration
 
Output
 
```json
{
    "source": "rsync://mirror1.hs-esslingen.de",
    "retention": 45,
    "server_name": "rl1.dp.nethserver.net"
}
```
 
Change one or more attributes with a command like this:
 
    api-cli run module/porthos2/configure-module --data '{"retention":30}'
 
To publish the repository, a HTTP host name route must be configured from
the cluster-admin Settings page.
 
When the `configure-module` action is executed for the first time, service
and timer units are enabled and started.
 
Timers are:
 
- `take-snapshot.timer` is a weekly job that update Rocky Linux repository
  mirror contents and makes a copy of repodata.json and other metadata
  from NS8 repositories.
 
- `sync-head.timer` is a frequent job that 4 times per hour, from Monday to
  Friday and during working hours, makes a copy of repodata.json and other
  metadata from NS8 repositories.
 
Services are:
 
- `fpm.service`
- `nginx.service`
 
## Environment variables
 
- `PORTHOS_RETENTION`, number of snapshots preserved under `/srv/porthos/webroot`
- `PORTHOS_SOURCE`, base `rsync://` URL to a Rocky Linux official mirror
- `PORTHOS_SERVER_NAME`, name of virtual HTTP server; by default the node FQDN is set