2020-04-26 14:33:08 +02:00
|
|
|
# Icinga Bot
|
|
|
|
|
|
|
|
|
|
Simple IRC Bot statusing icinga2 via its API.
|
|
|
|
|
|
|
|
|
|
**Table of content**
|
|
|
|
|
|
|
|
|
|
- [Installation](#installation)
|
|
|
|
|
- [Licence](#licence)
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
### Requirements
|
|
|
|
|
|
|
|
|
|
On a Debian-based host - running at least Debian Stretch, you will need the
|
|
|
|
|
following packages:
|
|
|
|
|
- git (recommended for getting the source)
|
|
|
|
|
- python3
|
|
|
|
|
- python3-irc
|
|
|
|
|
- python3-requests
|
|
|
|
|
|
|
|
|
|
### Manual installation
|
|
|
|
|
|
|
|
|
|
1. Clone repo in /srv/
|
|
|
|
|
|
|
|
|
|
$ cd /srv && git clone https://forge.april.org/adminsys/icingabot
|
|
|
|
|
$ chmod a+x icingabot/icingabot.py
|
|
|
|
|
|
|
|
|
|
2. Install the configuration in etc
|
|
|
|
|
|
|
|
|
|
$ mkdir /etc/icingabot
|
|
|
|
|
$ cp icingabot/icingabot.conf /etc/icingabot/
|
|
|
|
|
|
|
|
|
|
3. Configure the application
|
|
|
|
|
|
|
|
|
|
$ $EDITOR /etc/icingabot/icingabot.conf
|
|
|
|
|
|
|
|
|
|
4. Try it
|
|
|
|
|
|
|
|
|
|
$ ./icingabot/icingabot.py
|
|
|
|
|
|
|
|
|
|
5. Install a launcher
|
|
|
|
|
|
|
|
|
|
$ cp icingabot/icingabot.service /etc/systemd/system/
|
|
|
|
|
|
|
|
|
|
6. Start it
|
|
|
|
|
|
2020-07-10 13:07:53 +02:00
|
|
|
$ systemctl start icingabot
|
2020-04-26 14:33:08 +02:00
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
2020-07-10 12:47:23 +02:00
|
|
|
Icinga Bot is developed by April and licensed under the [AGPLv3+](LICENSE).
|
