Les conteneurs personnalisés ne livrent pas de surface graphique de gestion — l’entrée se fait en SSH. Le Stack Harbor PaaS offre deux chemins : la SSH Gateway de la plateforme avec authentification par clé (chemin recommandé), ou un accès direct par IP publique attachée au conteneur avec authentification par mot de passe.
Avant d’attaquer en SSH, vérifiez si le tableau de bord couvre déjà votre besoin :
- Configurations de conteneur modifient variables, volumes, liens, options d’exécution et ports exposés sans toucher au conteneur.
- Gestionnaire de fichiers ouvre le système de fichiers avec accès root complet, sans shell.
- CLI / API automatisent toutes les actions du tableau de bord — utile pour les opérations répétées et le scriptage du cycle de vie.
Si ces moyens ne suffisent pas — installer un paquet interactivement, déboguer un processus, lancer une commande shell ponctuelle — SSH est l’étape suivante.
Accès via la SSH Gateway (recommandé)
La SSH Gateway est un bastion infogéré qui fait façade pour chaque conteneur de la plateforme. L’authentification est par clé SSH ; la passerelle route vers le bon conteneur sans exposer chaque conteneur à l’internet.
Le flux :
- Générer une paire de clés sur votre poste si vous n’en avez pas (
ssh-keygen -t ed25519). - Ajouter la clé publique au tableau de bord. Ouvrez votre profil de compte, collez la clé publique dans la section clés SSH, sauvegardez.
- Connecter avec
ssh {gateway-user}@{gateway-host} -p {gateway-port}. Le tableau de bord affiche la commande exacte, y compris user/hôte/port pour votre région.
Une fois authentifié contre la passerelle, vous descendez dans n’importe quel conteneur de votre compte par le routage interne de la passerelle — la documentation de la SSH Gateway couvre les détails.
Le chemin passerelle a deux avantages principaux : les conteneurs n’ont pas besoin d’IP publique pour être joignables, et l’accès est lié à votre compte, donc le révoquer est une seule action (retirer la clé du tableau de bord) plutôt qu’une rotation de mot de passe par conteneur.
SSH direct par IP publique
Si vous ne voulez pas utiliser de clés SSH — par exemple, une vérification ponctuelle rapide — vous pouvez attacher une IP publique au conteneur et vous connecter par identifiant et mot de passe.
- Attachez une IP publique au conteneur via les paramètres du palier. Stack Harbor affiche le coût dans l’assistant de topologie ; la nouvelle IP est câblée en quelques minutes.
- Ouvrez un terminal.
- Connectez avec
ssh {username}@{hostname}, où{username}est le login envoyé par courriel à la création du conteneur et{hostname}est l’IP publique (aussi dans le courriel). - Saisissez le mot de passe du courriel.
Une fois à l’intérieur, le compte a les permissions root complètes dans le conteneur.
Si la connexion est refusée, deux causes courantes :
- Le conteneur a des règles pare-feu qui bloquent le port 22. Vérifiez les paramètres pare-feu du palier.
- L’image du conteneur n’exécute pas
openssh-server. Les modèles de base de la plateforme le démarrent par défaut, mais une image personnalisée peut devoir l’activer explicitement.
Réinitialiser le mot de passe d’un conteneur
Si vous perdez le courriel avec les identifiants, générez un nouveau mot de passe depuis le tableau de bord :
- Survolez le conteneur, dépliez le menu Additionally (icône engrenage).
- Choisissez Reset password.
Un nouveau mot de passe est envoyé par courriel. La réinitialisation s’applique à un conteneur unique ou à plusieurs d’un coup.