Cette page vous guide dans le déploiement d’une application sur Stack Harbor PaaS pour la première fois. Elle couvre les deux chemins les plus courants — le téléversement d’une archive empaquetée et le déploiement depuis un dépôt Git — puis vous montre comment confirmer que l’application fonctionne.
Le détail complet de chaque option de déploiement, la référence des champs et les particularités propres à chaque runtime se trouvent dans le Guide de déploiement.
Ce que couvre cette page
- Ce dont vous avez besoin avant de déployer.
- Déployer depuis une archive (un fichier local ou une URL vers un artefact de build).
- Déployer depuis un dépôt Git via le Gestionnaire de déploiement.
- Pointer le déploiement vers le bon serveur applicatif.
- Ouvrir l’application dans un navigateur et lire les journaux pour confirmer qu’elle fonctionne.
Avant de commencer
Vous avez besoin d’une seule chose avant de pouvoir déployer : un environnement en cours d’exécution avec une couche de serveur applicatif.
Si vous n’avez pas encore créé d’environnement, suivez le guide Créer votre premier environnement, puis revenez ici. L’environnement doit avoir le statut Running dans le tableau de bord avant de continuer.
Les exemples de cette page utilisent des noms de démonstration : prod-app pour l’environnement et nodejs-api pour l’application déployée. Remplacez-les par vos propres noms partout où ils apparaissent.
Déployer depuis une archive
Le déploiement par archive prend un artefact de build empaqueté — un .zip, .tar.gz, .war, .jar ou similaire — et le place sur le serveur applicatif. Il n’y a pas de connexion à un dépôt et pas d’étape de build côté plateforme ; ce que votre pipeline produit est ce qui est déployé.
Deux façons de fournir l’archive : téléverser un fichier depuis votre ordinateur, ou donner à la plateforme une URL pointant directement vers l’artefact.
Ouvrir la boîte de dialogue de déploiement
Deux points d’entrée mènent à la même boîte de dialogue de déploiement :
- Depuis la ligne du serveur applicatif — Dans la topologie de l’environnement, survolez la couche de serveur applicatif dans votre environnement
prod-app. Une rangée d’icônes apparaît. Cliquez sur l’icône pour téléverser un fichier local ou pour saisir une URL, ce qui ouvre la boîte de dialogue de déploiement par archive. - Depuis le Gestionnaire de déploiement — Le panneau Gestionnaire de déploiement se trouve en bas du tableau de bord. Si vous avez déjà ajouté une archive, survolez-la et sélectionnez l’option pour la déployer dans un environnement. Voir Gestionnaire de déploiement pour savoir comment ajouter et organiser des archives.
Déployer — prod-app
Remplir les champs
| Champ | Quoi saisir |
|---|---|
| Local file ou URL | Sélectionnez un fichier depuis votre ordinateur, ou collez une URL de téléchargement direct vers l’artefact. Les formats acceptés comprennent .zip, .tar.gz, .tar.bz2, .tar, .war et .jar. |
| Environment | Sélectionnez prod-app (ou l’environnement que vous avez créé). Ce champ est prérempli si vous avez ouvert la boîte de dialogue depuis la ligne du serveur applicatif. |
| Path | Le chemin de contexte sur le serveur où l’application sera placée. Pour la plupart des runtimes, vous pouvez laisser la valeur par défaut. Python et Node.js utilisent un chemin fixe et n’acceptent pas de valeur personnalisée. |
| Deploy strategy | Si votre couche de serveur applicatif comporte plus d’un nœud, choisissez comment les nœuds sont mis à jour. Une mise à jour simultanée est plus rapide mais cause une brève interruption ; une mise à jour séquentielle avec délai entre les nœuds évite l’interruption. Sur une couche à nœud unique, ce réglage n’a aucun effet. |
Quand les champs sont corrects, confirmez le déploiement. La plateforme décompacte l’archive sur le serveur applicatif. Un indicateur de progression apparaît dans le panneau Tasks en bas du tableau de bord. Attendez qu’il soit terminé avant de passer à Vérifier que l’application est en ligne.
Déployer depuis Git
Si votre code se trouve dans un dépôt Git, la plateforme peut le cloner et déployer directement depuis une branche. C’est le chemin de déploiement VCS.
Les étapes en bref :
- Ouvrez le Gestionnaire de déploiement (en bas du tableau de bord).
- Ajoutez votre dépôt — fournissez l’URL du dépôt et les identifiants nécessaires.
- Une fois le dépôt enregistré, survolez-le dans le Gestionnaire de déploiement et sélectionnez l’option pour le déployer dans un environnement.
- Dans la boîte de dialogue de déploiement, sélectionnez votre environnement
prod-app, confirmez la branche (par défautmaster), et confirmez le chemin de déploiement. - Confirmez le déploiement.
La plateforme clone le dépôt et copie les fichiers sur le serveur applicatif. Pour les applications Java, la plateforme envoie d’abord le code source vers un nœud de build Maven ; le nœud de build compile et emballe l’artefact avant qu’il atteigne le serveur applicatif.
Pour une référence complète champ par champ de la boîte de dialogue de déploiement VCS — incluant l’option d’auto-déploiement par interrogation, la gestion des conflits et les particularités de runtime — consultez le Guide de déploiement.
Pour un flux déclenché par un push — où un git push déclenche immédiatement un déploiement sans interrogation — voir Git-Push-Deploy.
Vérifier que l’application est en ligne
Une fois le déploiement terminé, deux commandes confirment que l’application fonctionne correctement.
Ouvrir dans le navigateur
Sur la ligne de l’environnement prod-app, cliquez sur l’option pour ouvrir l’environnement dans un navigateur. Un nouvel onglet charge l’URL publique de l’application. Si vous voyez la réponse attendue — une page, un résultat JSON, un contrôle de santé d’API — le déploiement a réussi.
Si la page ne se charge pas, vérifiez les journaux avant de conclure que le déploiement a échoué. La plateforme est peut-être encore en train de démarrer le processus applicatif.
Consulter les journaux
Sur le nœud du serveur applicatif, cliquez sur l’icône de journal. La vue de journal affiche les journaux applicatifs, de déploiement et d’erreurs. Recherchez les erreurs de démarrage ou les messages de dépendances manquantes. Si l’application a démarré correctement, le journal affiche la sortie de démarrage normale pour votre runtime.
Pour en savoir plus sur la lecture des journaux, voir Consultation des journaux.
La suite
- Guide de déploiement — référence complète des champs des boîtes de dialogue de déploiement par archive et VCS, particularités de runtime, auto-déploiement et plus encore.
- Gestionnaire de déploiement — gérer les archives stockées et les dépôts enregistrés ; organiser les déploiements sur plusieurs environnements.
- Git-Push-Deploy — déploiements déclenchés immédiatement par un
git push, sans interrogation. - Déploiement blue/green — transfert de trafic entre deux environnements pour des mises en production sans interruption.
- Guide du tableau de bord — référence complète du tableau de bord : contrôles d’environnement, panneau de topologie, actions sur les nœuds et paramètres.