📖 Guide d’utilisation de xsshend

Guide complet pour maßtriser xsshend - Téléversement SSH simple et efficace via CLI

🎯 Vue d’ensemble

xsshend est un outil Rust moderne pour le téléversement de fichiers vers multiples serveurs SSH. Interface en ligne de commande simple avec filtrage avancé et suivi en temps réel des transferts.

🚀 Installation et configuration

Installation via Cargo

cargo install xsshend

Configuration initiale

# Initialisation assistée avec création du fichier hosts.json
xsshend init

# Forcer la réinitialisation si nécessaire
xsshend init --force

PremiĂšre utilisation

# Lister les serveurs disponibles
xsshend list

# Aide générale
xsshend --help

# Aide sur une commande spécifique
xsshend upload --help

⚙ Configuration des serveurs

Structure hiérarchique

xsshend organise les serveurs selon une structure Ă  3 niveaux :

Environment/
├── Region/
│   ├── Type/
│   │   ├── SERVER_NAME_1
│   │   └── SERVER_NAME_2
│   └── Type/
└── Region/

Fichier hosts.json

Le fichier ~/.ssh/hosts.json contient la configuration :

{
  "Production": {
    "Region-A": {
      "Public": {
        "WEB_SERVER_01": {
          "alias": "web01@prod-web-01.example.com",
          "env": "PROD"
        },
        "API_SERVER_01": {
          "alias": "api01@prod-api-01.example.com",
          "env": "PROD"
        }
      },
      "Private": {
        "DATABASE_01": {
          "alias": "db01@prod-db-01.example.com",
          "env": "PROD"
        }
      }
    }
  },
  "Staging": {
    "Region-A": {
      "Public": {
        "STAGE_WEB_01": {
          "alias": "web01@stage-web-01.example.com",
          "env": "STAGE"
        }
      }
    }
  },
  "Development": {
    "Local": {
      "Services": {
        "DEV_DATABASE": {
          "alias": "dev@dev-db.local.example.com",
          "env": "DEV"
        }
      }
    }
  }
}

🎼 Utilisation CLI

Commandes principales

Initialisation

xsshend init           # Configuration assistée
xsshend init --force   # RĂ©initialisation complĂšte

Liste des serveurs

xsshend list           # Affichage hiérarchique avec filtres CLI
xsshend --list         # Forme courte

Téléversement de fichiers

xsshend upload <FILES>... [OPTIONS]

Options de filtrage

Par environnement

xsshend upload config.json --env Production
xsshend upload app.jar --env Staging
xsshend upload debug.log --env Development

Par région

xsshend upload regional-config.json --region Region-A
xsshend upload backup.tar --region Region-B

Par type de serveur

xsshend upload public-config.json --type Public
xsshend upload db-script.sql --type Private

Filtrage combiné

# Environnement + RĂ©gion
xsshend upload config.json --env Production --region Region-A

# Environnement + Type
xsshend upload app.war --env Production --type Public

# RĂ©gion + Type
xsshend upload local-config.json --region Region-A --type Private

# Tous les filtres
xsshend upload deploy.sh --env Production --region Region-A --type Public

Gestion des destinations

# Destination par défaut (/tmp/)
xsshend upload file.txt --env Production

# Destination personnalisée
xsshend upload app.war --env Production --dest /opt/tomcat/webapps/
xsshend upload config.json --env Staging --dest /etc/myapp/
xsshend upload logs/ --env Development --dest /var/log/myapp/

Mode simulation (dry-run)

# Simulation complÚte sans transfert réel
xsshend upload deploy.sh --env Production --dry-run

# Vérification des serveurs ciblés
xsshend upload app.jar --env Production --region Region-A --dry-run

# Test avec filtrage complexe
xsshend upload config.json --env Production --type Public --dry-run

📊 Interface de progression

Affichage en temps réel

Les transferts montrent une progression détaillée :

🚀 DĂ©but du tĂ©lĂ©versement: 1 fichier(s) vers 3 serveur(s)
📂 Destination: /opt/uploads/
🎯 Serveurs ciblĂ©s:
   ‱ Production:Region-A:Public:WEB_SERVER_01 → web01@prod-web-01.example.com (PROD)
   ‱ Production:Region-A:Public:API_SERVER_01 → api01@prod-api-01.example.com (PROD)
   ‱ Production:Region-A:Private:DATABASE_01 → db01@prod-db-01.example.com (PROD)

đŸ“€ TĂ©lĂ©versement de ./myapp.jar en cours...

web01@prod-web-01... [████████████████████████████████] 2.3MB/2.3MB ✅
api01@prod-api-01... [██████████████████              ] 1.5MB/2.3MB ⏳
db01@prod-db-01..... [████████████████████████████     ] 2.1MB/2.3MB ⏳

✅ TĂ©lĂ©versement terminĂ© avec succĂšs!
📊 3 serveur(s) - 0 Ă©chec(s)

Gestion des erreurs

En cas d’erreur, xsshend affiche des dĂ©tails prĂ©cis :

❌ Échec de connexion: WEB_SERVER_02
   Erreur: Connection refused (port 22)
   Conseil: VĂ©rifier que le serveur est accessible

✅ TĂ©lĂ©versement partiel terminĂ©
📊 2/3 serveur(s) rĂ©ussis - 1 Ă©chec(s)

🔑 Gestion des clĂ©s SSH

DĂ©couverte automatique

xsshend détecte automatiquement les clés SSH :

  • Ed25519 : ~/.ssh/id_ed25519 (prioritĂ© 1)
  • RSA : ~/.ssh/id_rsa (prioritĂ© 2)
  • ECDSA : ~/.ssh/id_ecdsa (prioritĂ© 3)
  • DSA : ~/.ssh/id_dsa (prioritĂ© 4)

Intégration ssh-agent

Si aucune clĂ© n’est trouvĂ©e ou accessible, xsshend utilise ssh-agent :

# Vérifier les clés chargées
ssh-add -l

# Ajouter une clé
ssh-add ~/.ssh/id_ed25519

# Démarrer ssh-agent si nécessaire
eval $(ssh-agent)

📝 Exemples d’utilisation

DĂ©ploiement d’application

# DĂ©ploiement complet en production
xsshend upload myapp.war --env Production --dest /opt/tomcat/webapps/

# Mise Ă  jour de configuration
xsshend upload application.properties --env Production --dest /etc/myapp/

# DĂ©ploiement sur serveurs publics seulement
xsshend upload static-files/ --env Production --type Public --dest /var/www/

Gestion par environnement

# Configuration de développement
xsshend upload dev-config.json --env Development

# Test en staging
xsshend upload app-v2.jar --env Staging --dry-run

# DĂ©ploiement production avec validation
xsshend upload production-app.war --env Production --dry-run
xsshend upload production-app.war --env Production  # Si OK

Maintenance et logs

# Copie de logs pour analyse
xsshend upload analyze-script.py --env Production --type Private

# Sauvegarde de configuration
xsshend upload backup-script.sh --env Production --region Region-A

# Mise à jour de sécurité
xsshend upload security-patch.sh --env Production --dry-run  # Test
xsshend upload security-patch.sh --env Production          # Application

Multi-fichiers et répertoires

# Plusieurs fichiers
xsshend upload config.json app.jar deploy.sh --env Production

# Contenu d'un répertoire
xsshend upload static-files/ --env Production --type Public

# Mix fichiers et répertoires
xsshend upload app.war config/ scripts/ --env Staging

🔍 Commandes de diagnostic

Liste détaillée des serveurs

# Vue complĂšte avec filtres CLI
xsshend list

Sortie exemple :

🔍 Liste des cibles SSH disponibles:

📁 Production (--env Production)
  📂 Region-A (--region Region-A)
    📂 Public (--type Public)
      đŸ–„ïž  WEB_SERVER_01 → web01@prod-web-01.example.com (PROD)
      đŸ–„ïž  API_SERVER_01 → api01@prod-api-01.example.com (PROD)
    📂 Private (--type Private)
      đŸ—„ïž  DATABASE_01 → db01@prod-db-01.example.com (PROD)

📁 Staging (--env Staging)
  📂 Region-A (--region Region-A)
    📂 Public (--type Public)
      đŸ–„ïž  STAGE_WEB_01 → web01@stage-web-01.example.com (STAGE)

📊 Total: 4 cibles disponibles

💡 Exemples d'utilisation:
   xsshend upload --env Production file.txt
   xsshend upload --env Staging --region Region-A file.txt
   xsshend upload --region Region-A --type Public file.txt

Validation de configuration

# Test avec dry-run pour valider la configuration
xsshend upload test.txt --env Production --dry-run

# Test sur un serveur spécifique avec SSH manuel
ssh web01@prod-web-01.example.com "echo 'Test connection OK'"

đŸ› ïž Conseils et bonnes pratiques

Organisation des serveurs

  1. Environnements : Production, Staging, Development, Testing
  2. RĂ©gions : Region-A, Region-B, US-East, EU-West

  3. Types : Public, Private, Database, Cache, Load-Balancer

Workflow recommandé

  1. Test : Toujours utiliser --dry-run d’abord
  2. Staging : Tester sur environnement de staging
  3. Production : Déployer par étapes (région par région)

Sécurité

  • Utiliser des clĂ©s SSH Ed25519 de prĂ©fĂ©rence
  • Éviter les mots de passe, privilĂ©gier ssh-agent
  • Valider les permissions des fichiers de configuration

Performance

  • Grouper les fichiers pour rĂ©duire les connexions SSH
  • Utiliser le mode dry-run pour valider avant transfert
  • Organiser la configuration pour un filtrage efficace

đŸš« DĂ©pannage

ProblĂšmes de connexion SSH

# Test manuel de connexion
ssh -v web01@prod-web-01.example.com

# Vérification des clés
ssh-add -l

# Ajout de clé si nécessaire
ssh-add ~/.ssh/id_ed25519

Configuration

# RĂ©initialiser la configuration
xsshend init --force

# VĂ©rifier les permissions .ssh
ls -la ~/.ssh/
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_*

Logs et debug

# Mode verbeux
RUST_LOG=debug xsshend upload file.txt --env Production

# Logs trÚs détaillés
RUST_LOG=trace xsshend upload file.txt --env Production