Connecter un serveur VPS

Pour déployer, Paylood se connecte à vos serveurs via SSH. Aucun agent à installer : tout est automatisé.

Préréquis

• Un VPS sous Linux (Ubuntu recommandé).
• Un accès SSH : utilisateur (root ou autre) + mot de passe ou clé privée.
• Le port SSH ouvert (22 par défaut).

Connecter un serveur

1. Ouvrez Serveurs (Servers) puis cliquez sur Connecter un VPS (Connect New VPS Server).
2. Renseignez :
   • Adresse IP (ou hostname) du serveur.
   • Port SSH (défaut 22).
   • Utilisateur (ex : root).
3. Choisissez l’authentification :
   • Mot de passe : saisissez le mot de passe SSH.
   • Clé privée : collez le contenu de votre clé privée (et, si utilisée, sa passphrase).
4. Cliquez sur Tester la connexion (Test connection).

Le test de connexion

Le test affiche les étapes en direct pendant la tentative SSH :

1. Connexion au serveur.
2. Échange de clés / authentification.
3. Vérification de l’environnement (Docker installé ?).
4. Résultat : succès ou erreur détaillée.

Connecter un serveur existant à un projet

Pendant l’assistant de création (étape SSH Config), choisissez Connecter un serveur existant (Connect existing server) : la liste de vos VPS s’affiche et vous liez celui de votre choix sans resaisir les identifiants.

Modifier ou mettre à jour un serveur

Si l’adresse IP, le port, l’utilisateur, le mot de passe ou la clé privée d’un serveur changent :

1. Rendez-vous sur la page Serveurs (Servers).
2. Sur la carte du serveur concerné, cliquez sur le bouton Modifier (icône crayon/edit) situé à côté du bouton de suppression.
3. Le tiroir de modification s’ouvre avec les paramètres actuels du serveur.
4. Vous pouvez modifier le libellé, l’hôte, le port, l’utilisateur ou changer le mode d’authentification (mot de passe ↔ clé privée).
   • Note : Laissez les champs de mot de passe ou clé privée vides si vous souhaitez conserver les identifiants déjà enregistrés.
5. Cliquez sur Tester la connexion (Test Connection) pour vérifier la validité des accès en temps réel.
6. Cliquez sur Mettre à jour le serveur (Update Server) pour enregistrer les modifications.

Formats de clés SSH supportés

Pour garantir une compatibilité totale avec le moteur de déploiement SSH de Paylood, vos clés privées doivent respecter l’un des formats standards suivants :

• OpenSSH Ed25519 (Recommandé) : commence par -----BEGIN OPENSSH PRIVATE KEY-----
• RSA PEM (PKCS#1) : commence par -----BEGIN RSA PRIVATE KEY-----

Tutoriel : Résoudre l’erreur Cannot parse privateKey: Unsupported key format

Si lors d’un déploiement ou d’un test vous rencontrez l’erreur :

ERROR: Cannot parse privateKey: Unsupported key format

cela signifie que la clé privée enregistrée pour votre serveur est dans un format incompatible ou corrompue.

Voici la procédure pas à pas pour générer une nouvelle clé propre et reconnecter votre serveur :

Étape 1 : Générer une paire de clés OpenSSH

Sur votre terminal local (Linux, macOS ou Windows PowerShell) :

# Générer une clé Ed25519 au format OpenSSH standard :
ssh-keygen -t ed25519 -C "paylood-server" -f ~/.ssh/paylood_ed25519 -N ""

Deux fichiers seront créés :

• ~/.ssh/paylood_ed25519 : votre clé privée
• ~/.ssh/paylood_ed25519.pub : votre clé publique

Étape 2 : Installer la clé publique sur votre VPS

Copiez votre clé publique vers le serveur :

# Méthode automatique :
ssh-copy-id -i ~/.ssh/paylood_ed25519.pub root@VOTRE_IP_VPS

# Ou méthode manuelle sur le VPS :
cat ~/.ssh/paylood_ed25519.pub | ssh root@VOTRE_IP_VPS "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys"

Étape 3 : Mettre à jour la clé dans Paylood

1. Affichez le contenu de votre clé privée :

   cat ~/.ssh/paylood_ed25519

2. Copiez l’intégralité du texte (incluant -----BEGIN OPENSSH PRIVATE KEY----- et -----END OPENSSH PRIVATE KEY-----).
3. Dans Paylood, ouvrez la page Serveurs, cliquez sur le bouton Modifier (Edit) de votre VPS.
4. Dans l’onglet Private Key, collez votre clé privée.
5. Cliquez sur Test Connection pour vérifier, puis sur Update Server.
6. Relancez votre déploiement d’application.

En cas d’échec de connexion