Un environnement est l’unité centrale de Stack Harbor PaaS : un groupe nommé et régional de conteneurs qui font tourner votre application. Cette page décrit la création d’un environnement depuis zéro à l’aide de l’assistant de topologie, afin que vous compreniez chaque choix avant de cliquer sur Créer.
Ce que couvre cette page
- Les prérequis pour créer votre premier environnement.
- Ouvrir l’assistant de topologie depuis le tableau de bord.
- Choisir un moteur d’exécution et configurer les paramètres de couche.
- Définir les limites de cloudlets pour l’allocation de ressources réservées et dynamiques.
- Choisir une région et nommer l’environnement.
- Ce qui se passe après avoir cliqué sur Créer — la progression des statuts jusqu’à En cours d’exécution.
- Comment confirmer que l’environnement est opérationnel et accessible.
Avant de commencer
Vous aurez besoin de :
- Un compte Stack Harbor. Si vous n’en avez pas, contactez Stack Harbor pour être provisionné.
- Être connecté au tableau de bord. Toutes les étapes de ce guide se font via l’interface du tableau de bord. Si vous préférez scripter la création d’environnements, consultez le CLI de la plateforme ou l’aperçu de l’API de la plateforme.
- Une idée générale de votre pile applicative. Vous n’avez pas besoin d’avoir arrêté chaque détail — vous pouvez modifier la topologie après la création sans détruire l’environnement. Un moteur d’exécution (par exemple Node.js) et une idée de si vous avez besoin d’une base de données suffisent pour commencer.
Étape 1 — Ouvrir l’assistant de topologie
En haut à gauche du tableau de bord, cliquez sur Nouvel environnement.
L’assistant de topologie s’ouvre. C’est ici que vous assemblez les couches qui composent votre environnement — vous ajoutez chaque palier de votre application (répartiteur de charge, serveur applicatif, base de données, cache) comme une couche distincte, et la plateforme les provisionne et les interconnecte.
Étape 2 — Choisir une pile et un moteur d’exécution
L’assistant de topologie présente les catégories de couches disponibles. Pour une application web classique, vous ajouterez au minimum une couche de serveur applicatif. Vous pouvez aussi ajouter un répartiteur de charge, une base de données, un cache ou un nœud de build.
Pour cette procédure, l’environnement de démonstration s’appelle prod-app et utilise un serveur applicatif Node.js :
- Dans l’assistant, repérez la catégorie des serveurs applicatifs.
- Sélectionnez Node.js parmi les moteurs d’exécution disponibles.
- L’assistant ajoute une couche Node.js à votre topologie avec les paramètres par défaut. Vous ajusterez ces paramètres à l’étape suivante.
La même procédure s’applique aux autres moteurs d’exécution — PHP, Java, Python, Ruby, Go ou .NET. Pour une base de données infogérée (MySQL, PostgreSQL, MongoDB, Redis ou Memcached), ajoutez une couche de base de données depuis la catégorie correspondante dans la même session de l’assistant.
Étape 3 — Configurer la topologie (couches et dimensionnement des cloudlets)
Avec la couche Node.js sélectionnée, le panneau de droite affiche ses options de configuration. Deux paramètres sont particulièrement importants lors de votre premier environnement :
Limites de cloudlets — réservés et dynamiques
Les ressources sur Stack Harbor PaaS sont allouées en cloudlets, l’unité de RAM et de CPU de la plateforme. Chaque couche vous permet de définir deux valeurs de cloudlets :
- Cloudlets réservés — le plancher : le nombre de cloudlets toujours alloués à chaque nœud de cette couche, quelle que soit la charge.
- Cloudlets dynamiques (parfois appelés limite de mise à l’échelle) — le plafond : le nombre maximum de cloudlets qu’un nœud peut utiliser quand il a besoin de plus que le montant réservé. Le nœud monte jusqu’à cette limite automatiquement et libère les cloudlets quand la charge baisse. Vous êtes facturé selon la consommation réelle, non selon le plafond.
Faites glisser les curseurs pour définir les deux valeurs. Pour un premier environnement exécutant une API Node.js légère (nodejs-api), commencer avec une petite allocation réservée et un plafond dynamique modéré est raisonnable — vous pouvez ajuster ces valeurs à tout moment sans recréer l’environnement.
Nombre de nœuds
Chaque couche peut avoir un ou plusieurs nœuds. Pour un premier environnement, un seul nœud par couche suffit. Vous pourrez mettre à l’échelle horizontalement plus tard depuis le tableau de bord ou en modifiant la topologie.
Autres paramètres de couche
Le panneau de couche expose aussi le sélecteur de version du moteur d’exécution (choisissez une version spécifique de Node.js si nécessaire) ainsi que les options SSL et de haute disponibilité. Laissez ces paramètres à leurs valeurs par défaut pour l’instant — ils peuvent être modifiés une fois l’environnement en cours d’exécution.
Si vous avez besoin d’une deuxième couche (par exemple, une base de données PostgreSQL), ajoutez-la maintenant en sélectionnant la catégorie base de données dans l’assistant et en choisissant PostgreSQL. Répétez l’étape de dimensionnement des cloudlets pour cette couche.
Étape 4 — Choisir une région
L’assistant de topologie inclut un sélecteur de Région. Choisissez la région la plus proche de vos utilisateurs ou, si vous évaluez la plateforme, la région par défaut de votre compte.
La région est définie au moment de la création. Pour déplacer un environnement vers une autre région ultérieurement, utilisez Paramètres → Migration — l’environnement ne sera pas disponible pendant la migration.
Étape 5 — Nommer l’environnement
En bas de l’assistant de topologie se trouve un champ Nom de l’environnement.
Saisissez un nom. Pour cette procédure, utilisez prod-app. Les noms d’environnement :
- Doivent être uniques au sein de votre compte.
- Sont utilisés pour construire le nom de domaine par défaut de l’environnement (par exemple,
prod-app.stackharbor.cloudou similaire — le modèle exact dépend de la configuration de votre plateforme). - Peuvent recevoir un alias d’affichage ultérieurement via Définir un alias sur la rangée d’environnement, mais le nom technique est fixé à la création.
Étape 6 — Créer l’environnement
Vérifiez le résumé de la topologie en haut de l’assistant : les couches que vous avez ajoutées, les limites de cloudlets, la région et le nom.
Quand tout vous convient, cliquez sur Créer.
Créer un environnement
Environnement d'exécution
Couches de topologie
1 cloudlet = 128 MiB RAM + 200 MHz CPU
Ce qui se passe ensuite
Après avoir cliqué sur Créer, le tableau de bord fait passer le nouvel environnement par une courte séquence de statuts. Vous pouvez observer cette progression sur la rangée de l’environnement dans la liste.
| Statut | Ce qui se passe |
|---|---|
| Création | La plateforme alloue les conteneurs et applique l’image de base du moteur d’exécution à chaque nœud de votre topologie. |
| Lancement | Le provisionnement est terminé ; le moteur d’exécution Node.js (ou celui que vous avez choisi) démarre dans les conteneurs. |
| En cours d’exécution | Tous les nœuds sont actifs. L’environnement est pleinement opérationnel et l’ensemble complet des actions du tableau de bord est disponible. |
La transition de Création à En cours d’exécution prend généralement moins d’une minute pour un environnement à couche unique. Vous pouvez observer la progression dans le Panneau des tâches en bas du tableau de bord, qui affiche un journal en direct des étapes de provisionnement.
Vérifier que l’environnement fonctionne
Une fois que l’environnement affiche En cours d’exécution :
- Survolez la rangée
prod-appdans la liste des environnements. - Cliquez sur Ouvrir dans le navigateur.
Votre navigateur ouvre l’URL par défaut de l’environnement. Pour un environnement Node.js fraîchement créé sans application déployée, la plateforme sert une page d’accueil par défaut confirmant que le conteneur est joignable.
Si Ouvrir dans le navigateur n’apparaît pas sur la bande d’actions, la topologie de l’environnement ne comporte pas de couche avec un point de terminaison public. Ajoutez une couche de répartiteur de charge ou confirmez que le serveur applicatif a un point d’entrée externe — consultez Gestion des environnements pour savoir comment modifier la topologie d’un environnement en cours d’exécution.
Vous pouvez aussi développer la rangée d’environnement en cliquant dessus. Cela affiche chaque couche et chaque nœud, et vous pouvez cliquer sur Journal ou Web SSH sur le nœud du serveur applicatif pour confirmer que le moteur d’exécution a démarré sans erreur.
La suite
L’environnement fonctionne mais ne contient pas encore de code d’application.
- Déployer votre première application — déployez du code dans l’environnement que vous venez de créer, de bout en bout.
- Guide du tableau de bord — référence complète de tous les contrôles du tableau de bord : actions sur l’environnement, actions sur les nœuds, panneau des tâches et gestionnaire de déploiement.
- Gestion des environnements — cloner, exporter, transférer, renommer et modifier la topologie d’un environnement en cours d’exécution.
- Mise à l’échelle et clustering — redimensionner les limites de cloudlets, ajouter des nœuds et configurer des déclencheurs de mise à l’échelle automatique sur un environnement existant.