PoWA container images

This repository contains container images of PoWA.

Those images are not intended for production usage, USE AT YOUR OWN RISK.

The powa-archivist contains images for a PostgreSQL cluster with PoWA installed. All major version supported by PoWA are included.

The powa-web directory contains the UI for powa, intended to be used with one of the powa-archivist provided image.

The powa-collector directory contains the collector, required for remote mode in v4.

Those images are also available in "-git" version, which should provide more recent changes not yet released.

This repository also contains some compose files to run either a local or a remote version of PoWA. UI will be available without providing any credential, see the next paragraph for more details on how to use them.

Testing PoWA with podman-compose

Two compose images are provided with this repository:

• powa_standalone_mode.yml
• powa_remote_mode.yml

The first will setup a environment with a single PostgreSQL server storing both the metrics (using the dedicated bgworker) and any custom data that suits your needs. The second one will setup a dedicated repository server to store the metrics, and two regular remote PostgreSQL servers, configured in streaming replication, to store any custom data that suits your need.

Those files are intended for doing tests and not for production use. They're also mainly thought as template that can be adapted depending on your needs.

If you're not familiar with podman-compose, you can quickly launch the wanted setup from any directory using the -f option of podman-compsoe. For instance, if you cloned this repository in ~/powa-docker and want to run the images for a remote mode, simply run:

podman-compose -f ~/powa-podman/compose/powa_remote_mode.yml up

Please refer to https://github.com/containers/podman-compose for more details on how to use podman-compose.

The initialization might take a minute or so depending on your machine. Once done, the powa-web UI will be available at http://127.0.0.1:8888.

Note that only the powa-web UI port is exposed to your local machine, as most people using those files are likely to also run their application in containers. If that's not your case and want to directly connect to the PostgreSQL server from your host, you can easily do that by adding a ports section for the wanted instance(s). You can refer to the official compose file specification at https://github.com/compose-spec/compose-spec/blob/master/spec.md#ports for more details.

Adding support for a new PostgreSQL major version

To generate the new powa-archivist files for a new version, simply create the required "powa-archivist/XY" directory and run "make" in this repository root directory. The new files for the version XY will automatically be generated.

Once done, those additional file should get updated too to reference the new PostgreSQL major version:

• compose/powa_standalone_mode.yml
• powa-archivist-git/Containerfile