Aller au contenu

Configuration et variables Mis à jour le 2026-05-27

Support FTP/FTPS

Installer et utiliser le module FTP pour le transfert de fichiers, le téléchargement de journaux et l'édition de configuration sur les conteneurs d'application et de base de données Stack Harbor PaaS.

FTP (File Transfer Protocol) et sa variante avec TLS FTPS restent utiles quand vous devez déplacer des fichiers en lot entre votre poste local et un conteneur — téléversement d’assets, récupération de journaux, édition de fichiers de configuration. Stack Harbor PaaS propose FTP et FTPS comme module installable sur les serveurs d’application et les bases de données.

Le module n’est pas compatible avec les conteneurs Docker. Pour les piles basées Docker, utilisez SSH ou des montages de volumes à la place.

À quoi sert FTP

La liste honnête :

  • Téléverser ou télécharger des ressources en lot.
  • Récupérer des fichiers journaux pour analyse hors ligne.
  • Éditer des fichiers de configuration directement depuis un éditeur qui supporte FTP.
  • Synchroniser des fichiers locaux dans le conteneur avec un outil comme GoodSync.

La liste de ce à quoi FTP ne sert pas : déployer des applications. Les fichiers déposés via FTP n’apparaissent pas dans la liste de déploiements du tableau de bord, ce qui veut dire que les redéploiements et rollbacks ne fonctionneront pas comme attendu. Utilisez le déploiement par git ou le Deployment Manager à la place.

Prérequis

Trois conditions doivent être remplies avant d’installer FTP :

  1. Vous avez un client FTP local (FileZilla est le choix standard).
  2. L’environnement a un serveur d’application ou une base de données où le module FTP est supporté.
  3. Le nœud a une IP publique attachée. FTP a besoin d’une adresse externe stable.

Installer le module

  1. Cliquez sur Add-Ons du serveur d’application (ou de la base).
  2. Trouvez FTP dans la liste et cliquez sur Install.
  3. Confirmez dans la fenêtre.
  4. Vous recevez un courriel avec les identifiants : hôte FTP, login, mot de passe, IP. Gardez ça quelque part d’accessible — vous en aurez besoin à chaque connexion.

Se connecter

Depuis un client FTP

  1. Ouvrez FileZilla (ou le client de votre choix).
  2. Entrez l’hôte, le nom d’utilisateur et le mot de passe du courriel d’installation.
  3. Connectez-vous.
  4. Vous voyez l’arborescence du dossier config du conteneur. Téléchargez, éditez, téléversez, supprimez ou glissez-déposez les fichiers selon le besoin.
  5. Les changements faits via le client FTP apparaissent dans le gestionnaire de configuration du tableau de bord après rafraîchissement.

Via le navigateur

  1. Cliquez sur Add-Ons du serveur.
  2. Trouvez FTP dans la liste. Les IP disponibles sont indiquées à côté.
  3. Cliquez sur un lien IP. Le navigateur ouvre une session FTP.
  4. Entrez vos identifiants. L’arborescence du dossier config est affichée en lecture seule — utile pour un parcours rapide sans installer de client.

Flux courants

Transfert de fichiers

Glissez-déposez entre le panneau local et le panneau distant dans votre client FTP. Pour de plus grands ensembles, clic-droit sur la sélection et Upload ou Download. La fonction de file d’attente permet de mettre les transferts en attente et de les lancer par lots.

La comparaison de répertoires (dans FileZilla, View → Directory Comparison) est utile pour voir ce qui est désynchronisé sans vérifier chaque fichier à la main.

Récupération de fichiers journaux

Le dossier logs du conteneur est exposé via FTP. Entrez dedans, choisissez le fichier, téléchargez, ouvrez dans n’importe quel éditeur. C’est la façon recommandée de récupérer les journaux en lot — le visualiseur du tableau de bord est meilleur pour le suivi en direct, FTP est meilleur pour les récupérations d’archives.

Synchronisation avec GoodSync

  1. Ouvrez GoodSync, cliquez sur Browse à gauche.
  2. Choisissez l’onglet FTP, entrez l’hôte, le nom d’utilisateur et le mot de passe, cliquez sur Go.
  3. Choisissez le dossier sur le serveur.
  4. Cliquez sur Browse à droite et choisissez le dossier local.
  5. Analyze montre les différences. Sync les copie.

Édition de fichiers de configuration

La plupart des éditeurs qui supportent FTP (Sublime Text, VS Code avec la bonne extension, etc.) peuvent ouvrir les fichiers directement via FTP. Connectez-vous, parcourez jusqu’au fichier, éditez, sauvez — le changement est appliqué au conteneur immédiatement.

Passer à FTPS

Pour chiffrer les identifiants et le contenu en transit, utilisez FTPS plutôt que FTP en clair.

Dans FileZilla, File → Site Manager → New Site :

  • Host — votre hôte FTP.
  • Protocol — FTP (File Transfer Protocol).
  • Encryption — Require explicit FTP over TLS.
  • Logon Type — Interactive.
  • User — votre utilisateur FTP.

Cliquez sur Connect, entrez le mot de passe, et vous êtes connecté en FTPS.

Gérer les identifiants

Réinitialiser le mot de passe

  1. Cliquez sur Add-Ons du serveur.
  2. Trouvez FTP, cliquez sur Reset Password.
  3. Un nouveau mot de passe vous est envoyé par courriel.

Fixer un mot de passe personnalisé

Le mot de passe auto-généré convient, mais un mot de passe personnalisé que vous contrôlez est préférable — surtout si vous partagez l’accès à l’environnement avec une équipe.

  1. Générez une clé SSH et ajoutez-la à votre tableau de bord.

  2. Connectez-vous en SSH au conteneur avec le module FTP installé.

  3. Lancez :

    sudo /usr/bin/passwd jelastic-ftp

  4. Entrez et confirmez le nouveau mot de passe.

Vous pouvez voir des avertissements du type BAD PASSWORD: it is based on a dictionary word ou BAD PASSWORD: is too simple. Ce sont des recommandations ; le mot de passe est changé de toute façon. Choisissez un mot de passe solide si vous comptez ignorer les avertissements.

Désinstaller

Cliquez sur Add-Ons → FTP → Uninstall. Les identifiants deviennent inactifs et le service FTP s’arrête sur le conteneur.

Comportement face au scaling

Quand vous faites un scale horizontal d’un palier où le module FTP est installé, les nouveaux nœuds clonent l’installation FTP, identifiants inclus. GlassFish est l’exception — FTP ne se clone pas sur les nouveaux nœuds GlassFish ajoutés. Si vous voulez FTP sur une configuration GlassFish multi-nœuds, désinstallez et réinstallez après le scaling pour que chaque nœud termine avec le module.

La suite

  • Fichiers journaux — le visualiseur intégré du tableau de bord, pour le suivi en direct.
  • Accès SSH — pour un accès shell direct quand FTP ne suffit pas.
  • IP publique — requise pour que FTP soit joignable depuis l’extérieur.
  • TLS / SSL — pour chiffrer le transport sur les autres surfaces de la plateforme.