golang_pvnet/README.MD

# PVNet Backup Tool

## Description

PVNet Backup Tool est une application en Go conçue pour automatiser les sauvegardes de bases de données SQL et de sites web hébergés sur des serveurs distants via SSH. L'outil permet de sélectionner un hôte à partir d'une configuration SSH, d'exécuter des sauvegardes, et de télécharger les fichiers de sauvegarde localement. Il supporte également la vérification des serveurs Apache.

## Fonctionnalités

- **Sélection de l'hôte SSH** : Choisissez parmi une liste d'hôtes configurés pour établir une connexion sécurisée.
- **Sauvegarde SQL** : Effectuez des dumps MySQL et téléchargez les fichiers de sauvegarde.
- **Sauvegarde de site web** : Téléchargez des répertoires complets de sites web hébergés sur le serveur distant.
- **Vérification du serveur Apache** : Option pour vérifier l'état des serveurs Apache.
- **Gestion des configurations via Excel** : Utilise un fichier Excel pour gérer les configurations spécifiques à chaque hôte.

## Prérequis

- **Go** : Assurez-vous que Go est installé sur votre machine. [Télécharger Go](https://golang.org/dl/)
- **Fichiers de configuration SSH** : Accès SSH configuré pour les hôtes cibles.
- **Fichier `.env`** : Configurations des chemins et paramètres nécessaires.
- **Fichier Excel** : Contient les informations nécessaires pour les sauvegardes.

## Installation

1. **Cloner le dépôt**

   ```bash
   git clone https://canguidev.fr/pvnet.git
   cd pvnet
   ```

2. **Installer les dépendances**

   Utilisez `go mod` pour installer les dépendances nécessaires.

   ```bash
   go mod tidy
   ```

3. **Construire l'application**

   ```bash
   go build -o pvnet main.go
   ```

## Configuration

### Fichier `.env`

Créez un fichier `.env` à la racine du projet avec les variables suivantes :

```env
PATH_SSH=/Users/cangui/.ssh/id_rsa
PATH_SSH_CONF=/Users/cangui/.ssh/config
PATH_FOLDER_EXEL=/path/exel.xlsx
SHEET_SELECT="name"
```

- **PATH_SSH** : Chemin vers votre clé SSH.
- **PATH_SSH_CONF** : Chemin vers le fichier de configuration SSH.
- **PATH_FOLDER_EXEL** : Chemin vers le fichier Excel contenant les configurations de sauvegarde.
- **SHEET_SELECT** : Nom de la feuille dans le fichier Excel à utiliser.

### Fichier Excel

Le fichier Excel doit contenir les en-têtes suivants :

- `host` : Nom de l'hôte.
- `path_save_sql` : Chemin local où sauvegarder les fichiers SQL.
- `path_save_site` : Chemin local où sauvegarder les fichiers du site.
- `path_site_serveur` : Chemin sur le serveur où se trouve le site.
- `mysql_login` : Nom d'utilisateur MySQL.
- `mysql_pasw` : Mot de passe MySQL.
- `name_base` : Nom de la base de données.

**Exemple :**

| host       | path_save_sql                | path_save_site               | path_site_serveur    | mysql_login | mysql_pasw | name_base |
|------------|------------------------------|------------------------------|----------------------|-------------|------------|-----------|
| example1   | /local/backup/sql/           | /local/backup/site/          | /var/www/html/site1  | user1       | password1  | db1       |
| example2   | /local/backup/sql/           | /local/backup/site/          | /var/www/html/site2  | user2       | password2  | db2       |

## Utilisation

1. **Exécuter l'application**

   ```bash
   ./pvnet
   ```

2. **Sélectionner un hôte**

   Une liste d'hôtes configurés sera affichée. Utilisez les flèches pour sélectionner l'hôte désiré et appuyez sur Entrée.

3. **Choisir une action**

   Après sélection de l'hôte, choisissez l'action à effectuer :

   - **Backup SQL and download** : Effectue une sauvegarde SQL et télécharge le fichier.
   - **Backup site** : Sauvegarde le site web et télécharge les fichiers.
   - **Check serveur apache** : Vérifie l'état du serveur Apache.

4. **Processus de sauvegarde**

   Selon l'action choisie, le programme exécutera les commandes nécessaires sur le serveur distant, effectuera les sauvegardes, et téléchargera les fichiers sur votre machine locale.

## Structure du Projet

```
pvnet/
├── main.go
├── .env
├── go.mod
├── go.sum
├── function/
│   └── main.go
│ 
└──
```

- **main.go** : Point d'entrée de l'application.
- **.env** : Fichier de configuration des chemins et paramètres.
- **function** : Fichier de function .
- **simply-ssh/** : Module de connection ssh 

## Dépendances

L'application utilise plusieurs packages externes :

- [`github.com/joho/godotenv`](https://github.com/joho/godotenv) : Pour charger les variables d'environnement depuis le fichier `.env`.
- [`github.com/TwiN/go-choice`](https://github.com/TwiN/go-choice) : Pour afficher des choix interactifs dans le terminal.
- [`github.com/pkg/sftp`](https://github.com/pkg/sftp) : Pour les transferts de fichiers via SFTP.
- Packages internes : `canguidev.fr/pvnet/function` pour les fonctions personnalisées liées aux opérations SSH et aux manipulations Excel.

## Contribution

Les contributions sont les bienvenues ! Veuillez soumettre un pull request ou ouvrir une issue pour proposer des améliorations ou signaler des bugs.

## Licence

Ce projet est sous licence privée.

## Contact

Pour toute question ou suggestion, veuillez contacter [cangui@gmail.com](mailto:cangui@gmail.com).

---

**Remarque** : Assurez-vous que les chemins spécifiés dans le fichier `.env` et le fichier Excel sont corrects et que les permissions nécessaires sont accordées pour les opérations SSH et SFTP.