mirror of
https://github.com/skylanix/MamieHenriette.git
synced 2026-02-06 23:10:36 +01:00
662a6ef34e
- Migration vers Debian Trixie avec surveillance Zabbix optionnelle - Configure variables d'environnement pour activation conditionnelle - Met à jour documentation avec instructions Docker complètes
145 lines
2.8 KiB
Markdown
Executable File
145 lines
2.8 KiB
Markdown
Executable File
|
|
# 👵 Mamie Henriette - Discord Status Bot 🤖
|
|
|
|
## 📖 Description
|
|
|
|
Mamie Henriette est un bot Discord intelligent qui change automatiquement de statut, surveillant et gérant votre serveur avec une touche d'humour et de caractère.
|
|
|
|
## ✨ Fonctionnalités
|
|
|
|
- Changement cyclique automatique des statuts
|
|
- Configuration flexible via variables d'environnement
|
|
- Gestion des erreurs et logging
|
|
- Support multi-statuts Discord
|
|
- Déploiement simplifié avec Docker
|
|
- 📊 Surveillance optionnelle avec Zabbix
|
|
|
|
## 🛠 Prérequis
|
|
|
|
- Docker et Docker Compose
|
|
- Compte Discord et Token du bot
|
|
- (Optionnel) Serveur Zabbix pour la surveillance
|
|
|
|
## 📦 Installation
|
|
|
|
1. Clonez le dépôt
|
|
```bash
|
|
git clone https://git.favrep.ch/lapatatedouce/MamieHenrriette
|
|
cd MamieHenrriette
|
|
```
|
|
|
|
2. Copiez le fichier de configuration
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
3. Éditez le fichier `.env` avec vos paramètres
|
|
```bash
|
|
nano .env
|
|
```
|
|
|
|
4. Démarrez le conteneur Docker
|
|
|
|
**Mode développement (avec logs):**
|
|
```bash
|
|
docker-compose up --build
|
|
```
|
|
|
|
**Mode production (en arrière-plan):**
|
|
```bash
|
|
docker-compose up --build -d
|
|
```
|
|
|
|
**Voir les logs:**
|
|
```bash
|
|
docker-compose logs -f discord-bot
|
|
```
|
|
|
|
**Arrêter le conteneur:**
|
|
```bash
|
|
docker-compose down
|
|
```
|
|
|
|
## 🔧 Configuration
|
|
|
|
### Variables d'environnement principales
|
|
|
|
- `TOKEN`: Votre token Discord (obligatoire)
|
|
- `STATUS`: Statut initial (défaut: online)
|
|
- `INTERVAL`: Intervalle de changement de statut (défaut: 3600 secondes)
|
|
|
|
### 📊 Configuration Zabbix (optionnelle)
|
|
|
|
- `ENABLE_ZABBIX`: Activer la surveillance Zabbix (défaut: false)
|
|
- `ZABBIX_SERVER`: Adresse du serveur Zabbix
|
|
- `ZABBIX_HOSTNAME`: Nom d'hôte pour identifier le bot
|
|
- `ZABBIX_PORT`: Port d'exposition Zabbix (défaut: 10050)
|
|
|
|
#### Métriques surveillées par Zabbix
|
|
|
|
- Statut du bot Discord
|
|
- Temps de fonctionnement (uptime)
|
|
- Utilisation mémoire
|
|
- Erreurs et avertissements dans les logs
|
|
- Connectivité à Discord
|
|
|
|
#### Activation de Zabbix
|
|
|
|
Dans votre fichier `.env` :
|
|
```bash
|
|
ENABLE_ZABBIX=true
|
|
ZABBIX_SERVER=votre-serveur-zabbix.com
|
|
ZABBIX_HOSTNAME=MamieHenriette
|
|
```
|
|
|
|
### Fichier `statuts.txt`
|
|
|
|
Créez un fichier `statuts.txt` avec vos statuts, un par ligne.
|
|
|
|
Exemple :
|
|
```
|
|
Surveiller le serveur
|
|
Mamie est là !
|
|
En mode supervision
|
|
```
|
|
|
|
## 📋 Dépendances
|
|
|
|
- discord.py==2.3.2
|
|
- python-dotenv==1.0.0
|
|
|
|
---
|
|
|
|
# 🖥️ Installation environnement de développement
|
|
|
|
## Installation des dépendances système
|
|
|
|
```bash
|
|
sudo apt install python3 python3-pip
|
|
```
|
|
|
|
## Création de l'environnement Python local
|
|
|
|
Dans le dossier du projet :
|
|
|
|
```bash
|
|
python3 -m venv .venv
|
|
```
|
|
|
|
Puis activer l'environnement :
|
|
|
|
```bash
|
|
source .venv/bin/activate
|
|
```
|
|
|
|
## Installation des dépendances Python
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
## Exécution
|
|
|
|
```bash
|
|
TOKEN=votre_token_discord python3 bot.py
|
|
``` |