Déployer du code et installer des modules

L’onglet Outils regroupe ce que vous pouvez faire avec un environnement. Vous y déployez votre code, gérez ses modules complémentaires et ouvrez son pare-feu, ses domaines et ses clés SSH.

Ouvrir les outils

1. Ouvrez l’environnement, puis sélectionnez Outils.
2. Les cartes sont regroupées.
   • Extensions contient Modules complémentaires, décrits plus bas sur cette page.
   • Déploiement contient Déployer depuis Git et Déployer depuis une archive. Ces cartes n’apparaissent que si vous avez accès aux fichiers du service.
   • Réseau et accès contient Pare-feu, Domaines et certificats et Clés SSH. Consultez Définir les règles de pare-feu d’un environnement, Ajouter un domaine personnalisé et un certificat SSL et Ajouter une clé SSH pour l’hébergement d’applications.

Déployer depuis Git

1. Sélectionnez Déployer depuis Git.
2. Saisissez l’URL du dépôt. Il doit s’agir d’un dépôt public en https://, par exemple https://git.example.com/northwind/boutique.git.
3. Saisissez une Branche si vous ne voulez pas celle par défaut. Ce champ est facultatif.
4. Choisissez la Couche où déployer. Il doit s’agir d’une couche d’application.
5. Indiquez le Contexte. ROOT sert l’application à l’adresse de l’environnement. Tout autre nom la sert sous ce chemin, par exemple /boutique.
6. Sélectionnez Déployer. Vous voyez Déploiement lancé.

Déployer depuis une archive

1. Sélectionnez Déployer depuis une archive.
2. Saisissez l’URL de l’archive, un lien https:// direct vers votre archive, par exemple un fichier .zip ou .war.
3. Choisissez la Couche et indiquez le Contexte, comme pour Git.
4. Sélectionnez Déployer.

Un déploiement remplace ce qui est déployé dans ce contexte, et l’application redémarre pendant le déploiement. Vous pouvez le suivre dans les actions en arrière-plan.

Voir les modules complémentaires d’un environnement

Les modules complémentaires sont des ajouts prêts à l’emploi que vous installez sur une couche, par exemple un certificat SSL gratuit, des sauvegardes planifiées ou la purge d’un cache. Chaque module ajoute ses propres boutons, appelés actions, et certains augmentent la consommation de ressources de la couche.

1. Ouvrez l’environnement, puis sélectionnez Outils, puis Modules complémentaires.
2. La page indique combien de modules sont installés et liste chaque couche avec ses modules.
3. Sélectionnez Gérer sur une couche pour ouvrir sa page, où vous installez, utilisez et retirez les modules.

L’environnement doit être en marche pour installer des modules ou utiliser leurs actions.

Installer un module complémentaire

1. Sur la page de la couche, repérez Modules complémentaires. Disponibles pour cette couche liste ce que vous pouvez ajouter. Sélectionnez Tout parcourir pour voir la liste complète, ou Installer un module.
2. Dans Ajouter un module complémentaire, cherchez avec Rechercher un module, puis choisissez-en un. Un badge Consomme des ressources signifie qu’il augmente votre consommation, facturée comme d’habitude.
3. Dans la fenêtre d’installation, vérifiez l’Environnement et la Couche, et remplissez les champs demandés par le module.
4. Si le module a des conditions, cochez J’accepte ces conditions.
5. Sélectionnez Installer.

Vous pouvez quitter la page pendant l’installation. À la fin, un message confirme l’installation, avec les détails éventuels renvoyés par le module.

Utiliser les actions d’un module

1. Sur la carte du module, sélectionnez un de ses boutons d’action. D’autres actions se trouvent dans son menu.
2. Certaines actions demandent une confirmation ou un court formulaire. Sélectionnez Appliquer pour l’exécuter.
3. Pour voir ce qu’a fait un module, sélectionnez Afficher les journaux.

La carte Actions rapides de la Vue d’ensemble de l’environnement affiche les mêmes boutons : vous n’avez pas à ouvrir la couche chaque fois.

Désinstaller un module

1. Sur la carte du module, ouvrez son menu et sélectionnez Désinstaller.
2. Confirmez. Le module exécute alors ses propres étapes de suppression sur la couche.

Badges des modules

• Installé signifie qu’il est sur cette couche.
• Géré par Stack Harbor signifie que nous nous en occupons. Vous ne pouvez ni le modifier ni le retirer.
• Permanent signifie qu’il ne peut pas être désinstallé.
• Consultation seule signifie que vous pouvez le voir, mais pas le modifier. Contactez le support si une modification est nécessaire.

En cas de problème

• Seules les URL https:// sont acceptées. Utilisez un lien qui commence par https:// à la place.
• Retirez le nom d’utilisateur et le mot de passe de l’URL. Seuls les liens publics sont acceptés. Les dépôts privés ne sont pas pris en charge ici.
• Le nom d’hôte de cette URL est introuvable. Vérifiez l’adresse.
• Les déploiements Git pour Java nécessitent une étape de compilation. Téléversez plutôt un fichier .war avec « Déployer depuis une archive ».
• Cet environnement n’a aucune couche d’application où déployer. Ajoutez d’abord une couche Nœud d’application.
• Vous devez avoir accès aux fichiers de ce service pour déployer. Adressez-vous au titulaire du compte.
• Une autre opération est en cours sur cette couche. Attendez qu’elle se termine.
• Démarrez d’abord l’environnement.
• Le module a mis trop de temps à répondre. L’opération peut encore aboutir ; vérifiez dans quelques instants. Ouvrez Afficher les journaux pour voir où il en est.
• Ce module a besoin d’une option que nous ne pouvons pas encore afficher ici. Notre équipe peut l’exécuter pour vous. Sélectionnez Contacter le support.
• Si vous ne pouvez pas installer ou utiliser de modules, la page nomme l’autorisation à demander au propriétaire du compte, comme Installer et supprimer des modules complémentaires ou Utiliser les actions des modules complémentaires.