init: with .gitignore and README.md
This commit is contained in:
commit
706fc53f64
|
@ -0,0 +1,9 @@
|
||||||
|
*~
|
||||||
|
.*.sw?
|
||||||
|
.sw?
|
||||||
|
\#*\#
|
||||||
|
DEADJOE
|
||||||
|
|
||||||
|
/pretrigger_notification.sh
|
||||||
|
/monitnotify.service
|
||||||
|
/test*
|
|
@ -0,0 +1,77 @@
|
||||||
|
# monitnotifyer
|
||||||
|
|
||||||
|
monitnotifyer is a wrapper which allows you to parse the monit mail notifications and forwards them to any application you want
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
### Requirements
|
||||||
|
Install [git](https://git-scm.com/) with your choosen package manager like [apt](https://wiki.debian.org/Apt) for [debian](https://www.debian.org/)
|
||||||
|
```bash
|
||||||
|
apt install git
|
||||||
|
```
|
||||||
|
Create a local account which will be used to converte the mails coming from monit
|
||||||
|
```bash
|
||||||
|
useradd -d /tmp/monit monitnotify
|
||||||
|
```
|
||||||
|
|
||||||
|
### Clone reposiroty
|
||||||
|
As the new user, clone the repository using git
|
||||||
|
```bash
|
||||||
|
su - monitnotify -s /bin/bash
|
||||||
|
git clone https://gitea.sons-of-sparda.at/oliver.schraml/monitnotifyer.git
|
||||||
|
```
|
||||||
|
|
||||||
|
### Setup service in systemd
|
||||||
|
As we want to run this as a service, you can use the monitnotify.service_sample file to create unitfile for systemd.
|
||||||
|
```bash
|
||||||
|
cp monitnotify.service_sample /etc/systemd/system/monitnotify.service
|
||||||
|
```
|
||||||
|
Modify the service file as you need it and afterwards run it for testing
|
||||||
|
```bash
|
||||||
|
systemctl start monitnotify.service
|
||||||
|
systemctl status monitnotify.service
|
||||||
|
```
|
||||||
|
If everything is fine, you can just enable it
|
||||||
|
```bash
|
||||||
|
systemctl enable monitnotify.service
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### Help
|
||||||
|
```bash
|
||||||
|
monitnotifyer.sh [-hd]
|
||||||
|
-h will show you this help message
|
||||||
|
-d will run the script in debug mode (output to stdout)
|
||||||
|
```
|
||||||
|
|
||||||
|
### Debuging
|
||||||
|
There is no need to directly execute it, as the service is configured in systemd to ensures that it is getting started and restarted if it fails.
|
||||||
|
If you still want to execute it manually, for example to debug some behavier you can run it like that:
|
||||||
|
```bash
|
||||||
|
su - monitnotify -s /bin/bash
|
||||||
|
cd /path/to/repo/monitnotifyer
|
||||||
|
./monitnotifyer.sh -d
|
||||||
|
```
|
||||||
|
|
||||||
|
## .gitignore
|
||||||
|
```bash
|
||||||
|
cat .gitignore
|
||||||
|
*~
|
||||||
|
.*.sw?
|
||||||
|
.sw?
|
||||||
|
\#*\#
|
||||||
|
DEADJOE
|
||||||
|
|
||||||
|
/pretrigger_notification.sh
|
||||||
|
/monitnotify.service
|
||||||
|
/test*
|
||||||
|
```
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
|
||||||
|
|
||||||
|
Please make sure to update tests as appropriate.
|
||||||
|
|
||||||
|
## License
|
||||||
|
[Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0)
|
Loading…
Reference in New Issue