golang_pvnet/README.MD
2024-12-13 19:35:12 +01:00

5.4 KiB

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
  • 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

    git clone https://canguidev.fr/pvnet.git
    cd pvnet
    
  2. Installer les dépendances

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

    go mod tidy
    
  3. Construire l'application

    go build -o pvnet main.go
    

Configuration

Fichier .env

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

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

    ./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 : Pour charger les variables d'environnement depuis le fichier .env.
  • github.com/TwiN/go-choice : Pour afficher des choix interactifs dans le terminal.
  • 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.


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.