Le tableau de bord est la principale surface de contrôle de Stack Harbor PaaS. Chaque opération disponible via le CLI de la plateforme ou l’API a un équivalent visuel ici. Cette page est une référence pour trouver n’importe quel contrôle dans le tableau de bord et comprendre ce qu’il fait.
Un court tutoriel interactif est intégré au tableau de bord à Aide → Tutoriel.
Ce que couvre cette page
- Créer un environnement via l’assistant de topologie.
- Colonnes de la liste d’environnements et ensemble complet des statuts.
- Actions disponibles sur chaque rangée d’environnement.
- Les douze entrées de Paramètres d’environnement.
- Icônes d’action par couche et par nœud.
- Boîte de dialogue Importer, Marketplace, groupes d’environnements et recherche.
- Gestionnaire de déploiement et panneau des tâches.
- Paramètres utilisateur et menus Aide / Compte.
Aperçu du tableau de bord
- prod-app En cours d'exécution
- staging-app En veille
- mysql-prod En cours d'exécution
La barre supérieure contient :
- Nouvel environnement et Importer — créer ou restaurer des environnements.
- Marketplace — applications et modules complémentaires en un clic.
- Recherche — recherche plein texte dans les environnements, les conteneurs et le Marketplace (voir Recherche dans le tableau de bord).
- Les menus Paramètres utilisateur, Aide et Compte à l’extrémité droite.
La barre inférieure contient le Gestionnaire de déploiement et le Panneau des tâches (voir ces sections ci-dessous).
Créer un environnement
- Cliquez sur Nouvel environnement en haut à gauche du tableau de bord.
- L’assistant de topologie s’ouvre. Sélectionnez les couches dont vous avez besoin — répartiteur de charge, serveur applicatif, base de données, cache, nœud de build. Chaque couche expose ses propres paramètres : version du moteur d’exécution, limites de cloudlets, région, SSL et options de haute disponibilité.
- Saisissez un nom dans le champ Nom de l’environnement en bas de l’assistant.
- Cliquez sur Créer.
Créer un environnement
Environnement d'exécution
Couches de topologie
1 cloudlet = 128 MiB RAM + 200 MHz CPU
Une fois créé, l’environnement apparaît dans la liste et passe par les statuts Création → Lancement → En cours d’exécution (voir le tableau des statuts ci-dessous).
Liste d’environnements
Chaque environnement occupe une rangée. Les colonnes sont :
| Colonne | Ce qu’elle affiche |
|---|---|
| Nom / Alias | Le nom de l’environnement (ex. prod-app). Si un alias est défini, il apparaît comme étiquette principale ; le nom technique est affiché en dessous ou au survol. |
| Statut | L’état actuel du cycle de vie (voir le tableau ci-dessous). |
| Étiquettes | Groupes d’environnements et, dans les déploiements multi-régions, un badge de région. Cliquez sur un badge de région pour filtrer la liste sur cette région. |
| Utilisation | Consommation agrégée de ressources pour tous les nœuds de l’environnement — typiquement les cloudlets consommés, le stockage utilisé et le trafic. |
Statuts d’environnement
| Statut | Signification |
|---|---|
| En cours d’exécution | Tous les nœuds sont actifs et servent le trafic. Ensemble complet d’actions disponible. |
| En veille | L’environnement a été suspendu automatiquement après une période d’inactivité (quand la mise en veille sur inactivité est configurée). Les conteneurs sont en pause ; le stockage est intact. L’environnement se réveille à l’arrivée de trafic ou après un clic sur Démarrer. |
| Arrêté | Arrêté manuellement. Les conteneurs ne fonctionnent pas ; le stockage est intact. Seul un ensemble réduit d’actions est disponible (voir Limitations d’un environnement arrêté). |
| Création | Provisionnement initial : les conteneurs sont alloués et l’image de base est appliquée. |
| Lancement | Provisionnement terminé ; le moteur d’exécution démarre dans les conteneurs. |
| Arrêt en cours | Un arrêt a été demandé ; les conteneurs s’éteignent de manière progressive. |
| Clonage | Une opération de clonage est en cours. L’environnement source reste accessible. |
| Redéploiement | Un redéploiement de conteneur est en cours — une nouvelle version d’image est appliquée à un ou plusieurs nœuds. |
| Exportation | L’environnement est empaqueté dans une archive téléchargeable. |
| Installation | Un paquet Marketplace ou un manifeste JPS est appliqué à l’environnement. |
| Migration | L’environnement est déplacé vers une autre région. L’environnement n’est pas disponible pendant la migration. |
| Suppression | La suppression est en cours ; elle est irréversible une fois démarrée. |
Limitations d’un environnement arrêté
Quand un environnement est à l’état Arrêté, l’ensemble des actions disponibles est réduit. Seules Paramètres, Cloner, Démarrer et Supprimer apparaissent sur la rangée. Vous ne pouvez pas ouvrir l’environnement dans le navigateur, modifier la topologie ou utiliser les actions par nœud tant que l’environnement ne fonctionne pas à nouveau.
Actions sur la rangée d’environnement
Survolez une rangée d’environnement en cours d’exécution pour révéler la bande d’actions.
| Action | Ce qu’elle fait |
|---|---|
| Définir un alias | Attribuer un nom d’affichage convivial à l’environnement. L’alias apparaît comme étiquette principale dans la liste ; le domaine technique est inchangé. |
| Ouvrir dans le navigateur | Ouvre l’URL d’entrée de l’environnement dans un nouvel onglet. Affiché uniquement quand la topologie inclut un serveur applicatif ou un répartiteur de charge avec un point de terminaison public. |
| Paramètres | Ouvre le panneau de paramètres d’environnement (douze entrées — voir Paramètres d’environnement). |
| Modifier la topologie de l’environnement | Rouvre l’assistant de topologie pour ajouter, retirer ou redimensionner des couches sans détruire l’environnement. |
| Cloner l’environnement | Duplique l’environnement sous un nouveau nom. Le tableau de bord fait passer le clone par les statuts Clonage → En cours d’exécution. |
| Démarrer / Arrêter | Bascule l’état d’exécution. Les environnements en cours d’exécution affichent Arrêter ; les environnements arrêtés ou en veille affichent Démarrer. |
| Supprimer l’environnement | Supprime définitivement l’environnement et toutes ses données. Requiert une confirmation par mot de passe. Cette action est irréversible. |
| Ajouter/Modifier des groupes | Assigner l’environnement à un ou plusieurs groupes d’environnements pour le filtrage et l’isolation réseau (voir Groupes d’environnements). |
Paramètres d’environnement
Cliquez sur Paramètres d’une rangée d’environnement pour ouvrir le panneau de paramètres. Douze entrées sont disponibles.
| Paramètre | Ce qu’il fait |
|---|---|
| Domaines personnalisés | Lier un enregistrement CNAME ou A à l’environnement et configurer la permutation de domaines (basculer le trafic entre domaines sans délai de propagation DNS). |
| SSL personnalisé | Téléverser votre propre certificat et clé privée. Requiert un serveur applicatif ou un répartiteur de charge avec une IP publique. La plateforme gère l’installation et les rappels de renouvellement. |
| Accès SSH | Gérer les clés publiques SSH pour l’accès client, voir les détails de connexion au SSH Gate et la configuration Web SSH, et configurer l’accès SFTP et FISH. |
| Points de terminaison | Mapper des ports TCP ou UDP d’un conteneur vers des ports accessibles de l’extérieur via le répartiteur de charge partagé. Utilisez ceci pour exposer des services non-HTTP sans attacher d’IP publique. |
| Pare-feu | Configurer les règles entrantes et sortantes au niveau du conteneur. Les règles sont appliquées par nœud dans l’environnement. Voir Règles de pare-feu du conteneur pour la syntaxe complète. |
| Alertes de charge | Définir des seuils pour le CPU, la RAM, le trafic réseau, les E/S disque ou les IOPS. Quand un seuil est dépassé, la plateforme envoie un courriel aux destinataires configurés. L’onglet Historique liste les alertes déclenchées. |
| Mise à l’échelle horizontale automatique | Configurer des déclencheurs qui ajoutent ou retirent des nœuds dans une couche selon l’utilisation des ressources. Les conditions peuvent cibler le CPU, la RAM, le réseau ou les métriques disque, avec des périodes de refroidissement configurables pour le scale-up et le scale-down. |
| Collaboration | Accorder à d’autres comptes Stack Harbor l’accès à cet environnement. Vous pouvez optionnellement permettre au collaborateur de modifier la topologie de l’environnement ou d’utiliser SSH. |
| Changer le propriétaire | Transférer l’environnement à un autre compte sur la même plateforme. Utile pour remettre un projet ou déplacer entre des comptes d’équipe. |
| Migration | Déplacer l’environnement vers une autre région. L’environnement n’est pas disponible pendant la durée de la migration. |
| Exporter | Emballer la topologie et les données de l’environnement dans un seul fichier téléchargeable pour la sauvegarde ou le transfert. Note : Les conteneurs Windows, Storage, Elastic VPS, Maven et Docker personnalisés exportent la topologie seulement — leurs données doivent être transférées séparément. |
| Info | Résumé en lecture seule : domaine de l’environnement, compte propriétaire, compte créateur, région et date de création. |
Actions par couche et par nœud
Cliquez sur une rangée d’environnement pour la développer et révéler sa topologie en couches. Chaque couche (répartiteur de charge, serveur applicatif, base de données, cache) affiche ses nœuds comme sous-rangées. Survolez un en-tête de couche ou un nœud individuel pour révéler la bande d’icônes d’action pour cette cible.
Les icônes suivantes peuvent apparaître sur une rangée de couche ou de nœud, selon le type de couche :
| Icône / Action | Ce qu’elle fait |
|---|---|
| Définir un alias | Attribuer un nom d’affichage à ce nœud spécifique, indépendamment de l’alias d’environnement. |
| Ouvrir dans le navigateur | Ouvrir l’URL de ce nœud dans un nouvel onglet (disponible uniquement quand le nœud a un point de terminaison public). |
| Redémarrer le(s) nœud(s) | Redémarrer de manière progressive le processus du conteneur sur ce nœud ou tous les nœuds de la couche. |
| Config | Ouvrir le gestionnaire de fichiers intégré et l’éditeur de configuration pour le système de fichiers de ce conteneur. Modifier les fichiers de configuration, les fichiers .env et les configs d’application directement. |
| Journal | Ouvrir le visualiseur de journaux pour ce conteneur. Diffuse la sortie standard et les fichiers journaux d’application disponibles. |
| Statistiques | Ouvrir les graphiques d’utilisation des ressources pour ce nœud : CPU, RAM, réseau entrant/sortant, E/S disque et IOPS sur des fenêtres de temps configurables. |
| Web SSH | Ouvrir une session SSH dans le navigateur vers ce conteneur via le SSH Gate. Aucun client SSH local requis. |
| Redéployer le(s) conteneur(s) | Appliquer une nouvelle version d’image à ce nœud ou tous les nœuds de la couche. La plateforme gère le déploiement ; les données dans les volumes montés sont préservées. |
| Modules complémentaires | Voir et gérer les modules complémentaires installés sur ce nœud (par exemple, Let’s Encrypt, FTP/FTPS, agents de sauvegarde). |
| Bureau à distance | Ouvrir une session RDP dans le navigateur (disponible sur les conteneurs Windows uniquement). |
| Variables | Voir et modifier les variables d’environnement limitées à ce conteneur. Les changements prennent effet au prochain redémarrage du conteneur. |
| Liens | Configurer des liens entre couches pour que ce conteneur puisse joindre les nœuds d’une autre couche par alias de nom d’hôte. |
| Volumes | Voir et configurer les montages de volumes persistants pour ce conteneur. Voir Volumes de conteneur. |
| CMD / Point d’entrée | Remplacer la commande par défaut et le point d’entrée du conteneur. Utile pour personnaliser la façon dont un conteneur Docker démarre. |
| SFTP | Afficher les détails de connexion SFTP pour ce nœud (hôte, port, nom d’utilisateur, clé SSH). |
| Redimensionner les nœuds | Modifier le nombre de nœuds horizontaux pour cette couche directement depuis la bande de nœuds, sans rouvrir l’assistant de topologie. |
| Réinitialiser le mot de passe | Réinitialiser le mot de passe du service pour ce nœud (disponible sur les nœuds de base de données). Le nouveau mot de passe est affiché une fois et envoyé par courriel. |
| Connexion au panneau admin | Ouvrir le panneau d’administration de la base de données (par exemple, phpMyAdmin pour MySQL, Adminer pour PostgreSQL) directement dans le navigateur, avec authentification automatique. |
Importer
Le bouton Importer à côté de Nouvel environnement crée ou restaure un environnement à partir d’un fichier de manifeste.
Formats de fichiers acceptés : .json, .jps, .cs, .yml, .yaml.
La boîte de dialogue Importer comporte trois onglets :
| Onglet | Comment l’utiliser |
|---|---|
| Fichier local | Téléverser un fichier de manifeste depuis votre machine. |
| URL | Coller une URL pointant vers un manifeste hébergé sur un serveur web ou un dépôt Git. |
| JPS | Coller ou saisir du JSON ou YAML directement dans l’éditeur intégré. Utile pour tester ou modifier un manifeste avant de l’exécuter. |
Utilisez Importer pour :
- Créer un nouvel environnement à partir d’une archive d’environnement exporté.
- Appliquer un paquet JPS à un environnement existant.
- Restaurer une topologie depuis une autre installation Stack Harbor.
Marketplace
Cliquez sur Marketplace pour ouvrir le catalogue d’applications et de modules complémentaires. Recherchez par nom ou parcourez par catégorie. Cliquez sur Installer pour un paquet, remplissez les invites et la plateforme provisionne le paquet dans un environnement nouveau ou existant.
Voir la référence du Marketplace applicatif pour le catalogue complet et les options d’installation.
Groupes d’environnements
Regroupez les environnements pour organiser les grands comptes. Schémas de regroupement typiques : par projet (crm, data-pipeline), par étape (dev, staging, prod), ou par fonction (bases-de-donnees, services, stockage). Les sous-groupes sont pris en charge.
Pour assigner un environnement à un groupe, survolez sa rangée et cliquez sur Ajouter/Modifier des groupes.
Par défaut, les environnements d’un même compte peuvent se joindre sur le réseau interne de la plateforme. Activez l’isolation réseau sur un groupe pour restreindre le trafic inter-environnements : seuls les environnements dans le même groupe isolé peuvent communiquer. Utilisez ceci pour établir une limite stricte entre les environnements de production et hors-production.
Recherche dans le tableau de bord
La boîte de recherche se trouve en haut à droite du tableau de bord. Raccourci clavier : Ctrl+F (Windows/Linux) ou Cmd+F (macOS).
La recherche couvre les environnements par nom ou alias, les conteneurs par nom d’hôte, les noms de projets déployés et les paquets Marketplace.
| Opérateur | Effet |
|---|---|
terme | Trouver les environnements ou nœuds contenant terme. |
-terme | Exclure les résultats contenant terme. |
* | Caractère générique — correspond à toute séquence de caractères. Par exemple, prod-* correspond à prod-app, prod-db. |
Le formulaire de recherche offre aussi des filtres de catégorie :
- Environnements seulement.
- Adresses IP seulement (trouver quel environnement possède une IP donnée).
- Exclure les résultats Marketplace.
- Limiter la recherche au groupe courant plutôt qu’à tout le compte.
Un panneau d’aide dans le formulaire de recherche documente l’ensemble complet des opérateurs.
Gestionnaire de déploiement
L’onglet Gestionnaire de déploiement se trouve en bas du tableau de bord et stocke les artéfacts applicatifs réutilisables.
| Onglet | Ce qu’il stocke |
|---|---|
| Archive | Paquets d’application téléversés depuis votre machine ou récupérés depuis une URL externe (ZIP, WAR, JAR, EAR et similaires). |
| Git / SVN | Identifiants de dépôt pour les projets sous contrôle de source. Stockez une URL de dépôt et une authentification pour les réutiliser dans plusieurs déploiements. |
Une fois un artéfact enregistré dans le Gestionnaire de déploiement, vous pouvez le déployer ou le redéployer vers n’importe quel environnement en cours d’exécution en un clic, sans re-téléverser ni re-saisir les identifiants.
Panneau des tâches
L’onglet Panneau des tâches se trouve à côté du Gestionnaire de déploiement en bas du tableau de bord. Il affiche les opérations en direct et historiques.
- Créer l'environnement prod-app 4m ago 48s Terminé
- Déploiement prod-app nodejs-api 3m ago 12s Terminé
- Ajouter un nœud prod-app 2m ago 2m 14s… En cours
- Redéploiement mysql-prod 18m ago 31s Terminé
- Migration staging-app 1h ago 4m 2s Échoué
Chaque rangée du panneau des tâches affiche :
| Colonne | Ce qu’elle affiche |
|---|---|
| Statut | Roue (en cours), point vert (succès), point rouge (échec). |
| Heure | Heure de début de l’opération. Les rangées sont ordonnées du plus récent au plus ancien et regroupées par jour. |
| Environnement | L’environnement cible, ou — si l’opération est au niveau du compte. |
| Tâche | Description de l’opération (par exemple, « Démarrer l’environnement », « Cloner l’environnement », « Redéployer le conteneur »). |
| Durée | Temps d’exécution écoulé, affiché après la complétion de la tâche. |
Développez une rangée pour voir les paramètres complets de l’action envoyés à la plateforme et la réponse du serveur. Si l’opération a été déclenchée par un collaborateur, son adresse courriel apparaît dans la vue développée.
Signaler des erreurs
Une rangée de tâche échouée (point rouge) affiche un lien Signaler au support. Le cliquer ouvre une demande de support pré-remplie adressée au support Stack Harbor, avec l’identifiant de la tâche et le détail de l’erreur joints.
Journal actif
Pour un historique plus approfondi, basculez vers la vue Journal actif (l’icône loupe à côté de l’étiquette Panneau des tâches).
2026-05-30 14:23:11 UTC
ERROR
deploy-hook
deploy hook exited non-zero (exit 1): post-receive script failed at step finalize
2026-05-30 14:21:44 UTC
ERROR
healthcheck
health check failed: 502 from nodejs-api node 2 — upstream not ready
2026-05-30 14:21:39 UTC
ERROR
healthcheck
health check failed: 502 from nodejs-api node 2 — retrying (attempt 3/3)
2026-05-30 14:18:02 UTC
ERROR
certbot
TLS cert renew failed: DNS-01 challenge timeout after 60s for api.prod-app.example.com
2026-05-30 13:59:07 UTC
ERROR
migration
migration step 4/7 failed: ALTER TABLE users: lock wait timeout exceeded (innodb_lock_wait_timeout=50)
Fonctionnalités du journal actif :
- Recherche plein texte dans les paramètres des tâches et les réponses du serveur.
- Plages de dates personnalisées — sélectionnez n’importe quelle fenêtre dans la période de rétention de la plateforme.
- Filtre Erreurs seulement — afficher uniquement les opérations échouées dans tous les environnements.
Paramètres utilisateur
Cliquez sur l’icône Paramètres (ou votre avatar) en haut à droite pour ouvrir les paramètres au niveau du compte.
| Section | Ce qu’elle couvre |
|---|---|
| Compte | Activation de l’authentification à deux facteurs et changement de mot de passe. |
| Jetons d’accès | Générer et gérer des jetons d’accès personnels pour l’API de la plateforme et le CLI. |
| Clés SSH / Accès SSH | Gérer les clés publiques utilisées pour authentifier les sessions SSH vers vos conteneurs (via SSH Gate ou SSH direct). Gérer les clés privées utilisées pour Git-over-SSH lors du déploiement depuis des dépôts privés. Voir les instructions de connexion et les détails SFTP/SSH direct. |
| Collaboration | Deux listes : les environnements que vous avez partagés avec d’autres comptes, et les environnements partagés avec vous par d’autres. |
Menus Aide et Compte
Le menu déroulant Aide en haut à droite renvoie vers :
- Le support Stack Harbor.
- La documentation Stack Harbor (ce site).
- La référence API de la plateforme.
- La référence CLI de la plateforme.
- Le tutoriel interactif du tableau de bord.
Le menu déroulant Compte en haut à droite contient :
- Raccourci vers les paramètres utilisateur.
- Sélecteur de langue du tableau de bord.
- Déconnexion.