Le Stack Harbor PaaS déploie des conteneurs personnalisés depuis n’importe quelle image Docker standard — Docker Hub, GitHub Container Registry, GitLab, AWS ECR, GCR, ou un registre auto-hébergé. La plateforme prend en charge le substrat d’exécution (ordonnancement, réseau, supervision, mise à l’échelle, journaux) tout en laissant l’image elle-même intacte. Le comportement à l’intérieur du conteneur est la responsabilité de l’image, pas de la plateforme.
Cette page couvre le flux de l’assistant de topologie pour déployer un conteneur personnalisé, la différence entre la recherche Docker Hub et le chemin registre privé, et la configuration disponible une fois le conteneur en marche.
Ce que signifie « personnalisé » ici
Stack Harbor distingue deux types de conteneurs :
- Conteneurs certifiés — images infogérées par la plateforme pour les stacks bien connus (Tomcat, NGINX, PostgreSQL, …), maintenues à jour par Stack Harbor et exposées comme types de nœuds de première classe dans l’assistant de topologie.
- Conteneurs personnalisés — toute autre image que vous apportez. La plateforme l’exécute, la met à l’échelle, la supervise, l’expose sur le réseau interne, fournit journaux et gestionnaire de fichiers — mais le contenu de l’image, y compris le fait que l’application à l’intérieur fonctionne, relève de l’auteur de l’image.
Pour les images de base et architectures supportées, consultez la page d’exigences.
Déployer depuis Docker Hub
- Ouvrez l’assistant de topologie depuis le tableau de bord.
- Passez à l’onglet Custom. Le rail de gauche liste les paliers possibles (serveur d’application, répartiteur, base de données, extra) — chacun peut accueillir une image différente.
- Choisissez le palier voulu et cliquez sur Select Image.
- Dans la boîte Select Container, passez à l’onglet Search. Tapez tout ou partie du nom de l’image (
appsvcsample/static-site,nginx,ghcr.io/…) et faites Entrée. - Cliquez sur l’image voulue dans les résultats. Choisissez un tag dans le menu déroulant en haut — il est filtrable, pratique quand une image publie des centaines de tags.
- Cliquez sur Next pour revenir à la vue de topologie. Configurez le palier (nombre d’instances, redimensionnement vertical, IP publique au besoin, variables, points de montage) comme n’importe quel autre nœud.
- Cliquez sur Create pour provisionner l’environnement. La plateforme tire l’image, ordonnance les conteneurs, et démarre le palier.
Notes sur la boîte de recherche :
- Le lien More details sur chaque résultat ouvre la page Docker Hub de l’image dans un onglet séparé.
- L’étoile marque une image comme Favorite. Les favoris vivent dans leur propre onglet pour réutilisation rapide.
- On ne peut pas empiler des images différentes dans le même palier. Utilisez un palier distinct (ou un palier Extra) par image.
Déployer depuis un registre privé ou auto-hébergé
Les images privées se déploient via le sous-onglet Custom de la boîte Select Container. La plateforme stocke la référence d’image et les identifiants pour que les opérations ultérieures (scale-out, redéploiement) ne se ré-authentifient pas.
- Ouvrez l’assistant de topologie, passez à l’onglet Custom, puis cliquez sur Add New Image.
- Dans la boîte, renseignez Name avec le chemin d’image pleinement qualifié :
[{registry_hostname}/]{namespace}/{image_name}. Pour Docker Hub l’hôte du registre est optionnel ; pour tout autre (GHCR, GitLab, ECR, votre propre registre) incluez l’hôte. - Pour un dépôt privé, renseignez Username et Password. Pour un dépôt public, laissez vides.
- Cliquez sur Add. L’image apparaît dans la liste Custom et peut être sélectionnée sur n’importe quel palier.
La plateforme ne demande pas de tag à ce stade — les tags sont choisis au déploiement. La liste des tags disponibles est rafraîchie au moment du déploiement, donc vous n’avez pas à ré-ajouter l’image quand l’amont publie un nouveau tag.
Mettre à jour les identifiants de registre
Si un mot de passe de registre est tourné, mettez à jour les identifiants via l’action Repo Credentials — survolez le palier dans le tableau de bord, dépliez Additionally, et cliquez sur Repo Credentials. Définissez les nouveaux Login et Password et Apply. La plateforme stocke la mise à jour et l’utilise pour les tirages suivants.
Retirer une image de la liste Custom
L’icône poubelle en haut à droite d’une entrée d’image la retire de la liste Custom. L’image reste dans votre registre — seule la référence côté plateforme est supprimée.
Après le déploiement
Une fois l’environnement actif, les conteneurs personnalisés exposent la même surface de gestion que les nœuds infogérés :
- Open in Browser ouvre le domaine du conteneur dans un nouvel onglet. Utile si le conteneur parle HTTP sur le port 80 — le répartiteur partagé de la plateforme route le trafic automatiquement.
- File manager donne un accès root complet au système de fichiers du conteneur.
- Web SSH ouvre un shell navigateur dans le conteneur.
- Logs, Statistics et Alerts raccordent le conteneur à la surface d’observabilité de la plateforme.
Si le conteneur n’est pas un serveur HTTP sur le port 80, Open in Browser renvoie un 502. Ce n’est pas le signe d’une image cassée — simplement que la détection automatique de port n’a pas trouvé d’écouteur HTTP. Connectez-vous en SSH pour vérifier que le processus tourne, ou exposez un autre port via les paramètres du palier.