diff options
| author | Jake Mannens <jake@asger.xyz> | 2024-09-20 16:21:09 +1000 |
|---|---|---|
| committer | Jake Mannens <jake@asger.xyz> | 2024-10-29 11:42:54 +1100 |
| commit | e8e3c4cba8ffa0056e984c113cfbb75319e00022 (patch) | |
| tree | 8336315e61f9e77207276d478b25fe5dc7c3d06c /README.md | |
| parent | 0e21907c76dbefed11f382bcf949143f0716567f (diff) | |
v0.4-rc1v0.4-rc1
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 24 |
1 files changed, 20 insertions, 4 deletions
@@ -4,19 +4,29 @@ Pager Parser is a service designed to act as a "central hub" for pager messages. # Features - Flexible framework designed to receive pager messages from a variety of data sources such as [PagerMon](https://github.com/pagermon/pagermon) ([Jobyyy](https://jobyyy.net/)) -- Parsing of useful information from pager messages such as job type, paged services, etc +- Parsing of useful information from pager messages such as job type, location, etc - Storage of received pager messages for archival purposes - Storage of parsed pager message data for archival as well as generating useful metrics +- Integration with Home Assistent REST API for generating events on the event bus of configured Home Assistant servers +- Discord bot that allows users to subscribe and unsubscribe from pager message notifications # Building ### Pre-requisites -To build the project, the .NET 7.0 SDK is required +To build the project, the .NET 8.0 SDK is required, as well as Docker if building the project as a Docker container + +### Docker + +To build the project using [Docker](https://docker.com/), simply execute the following command from the project base directory: + +```sh +docker build -t pagerparser . +``` ### Standalone -To build the project, simply execute the following command from the project base directory: +To build the project without Docker, simply execute the following command from the project base directory: ```sh dotnet build -c Release @@ -28,8 +38,14 @@ The resulting output files may be found in the `bin/Release` directory ### Configuration -To configure the project, simply edit the `appsettings.json` file, populating the desired sections +To configure the project, simply edit the `appsettings.json` file, populating the desired sections. If using Docker, configuration should be done in the `compose.yaml` file. The provided file may be used as a template. + +### Docker +To deploy the project using Docker, simply execute the following command from the project base directory: +```sh +docker compose up -d +``` ### Standalone Standalone deployments of the project are current not supported in any official capacity. It is possible to run the project as a standalone deployment by registering the main executable to be started automatically and persisted in the background. This may be achieved on Linux using a systemd unit file or on Windows as an auto-start program. |
