Déployer avec un Dockerfile

Avec un Dockerfile, vous pouvez déployer n’importe quelle application sur la plateforme Hostman, quel que soit le framework utilisé.

Pré-requis

• Pour que le déploiement fonctionne correctement, le Dockerfile doit se trouver à la racine du dépôt. Il doit contenir toutes les instructions nécessaires pour construire et exécuter l’application.

• Vous devez spécifier le paramètre EXPOSE dans le Dockerfile afin que Hostman puisse déterminer sur quel port Nginx doit écouter. Si EXPOSE n’est pas défini, Nginx utilisera par défaut le port 8080 du conteneur.

Exemple :

FROM python:3.6
MAINTAINER Name Name "mail@mail.com"
COPY . /app
WORKDIR /app
RUN pip install -r requirements.txt
ENTRYPOINT ["python"]
CMD ["app.py"]
EXPOSE 3478

• Vous pouvez définir des variables d’environnement dans le Dockerfile ou dans le tableau de bord Hostman lors de la création d’une nouvelle app.

Étape 1. Sélectionner le Type d’Application

1. Accédez à la section Plateforme d’apps et cliquez sur Créer.

2. Sélectionnez l’onglet Dockerfile.

Étape 2. Connecter un Dépôt

Sélectionnez le dépôt contenant l’application. Le Dockerfile doit être situé à la racine du dépôt.

Vous pouvez connecter un dépôt :

• Depuis votre compte GitHub, GitLab ou Bitbucket. Cliquez sur le nom de la plateforme, connectez-vous et sélectionnez le dépôt souhaité. Si vous êtes déjà connecté, Hostman affichera immédiatement les dépôts disponibles.

• Par URL, en fournissant le lien vers un dépôt créé sur n’importe quelle plateforme. Cliquez sur Connecter via URL et entrez l’URL Git du dépôt. Si le dépôt est privé, renseignez également les identifiants d’accès.

En savoir plus sur la connexion des dépôts ici.

Étape 3. Sélectionner une Branche et un Commit

Sélectionnez une branche pour le déploiement.

Par défaut, l’option “Build avec le dernier commit exécuté” est activée. La plateforme déploiera alors le dernier commit, et reconstruira automatiquement l’application à chaque nouveau commit. Vous pouvez désactiver le déploiement automatique si nécessaire.

Si vous souhaitez sélectionner un commit précis manuellement, désactivez cette option.

Étape 4. Choisir l’Emplacement et la Configuration du Serveur

Votre application doit s’exécuter sur un serveur cloud dédié. Sélectionnez la région et la configuration du serveur.

Vous pourrez toujours faire un upgrade du serveur plus tard, mais il ne sera pas possible de faire un downgrade.

Étape 5. Configurer le Réseau Privé

Vous pouvez maintenant ajouter l’application à un réseau privé et spécifier l’adresse IP qu’elle utilisera.

Notez qu’il ne sera plus possible de modifier le réseau privé après le déploiement.

Étape 6. Configurer les Paramètres de Build

La plateforme lira les paramètres définis dans le Dockerfile et construira l’application en conséquence.

À ce stade, vous pouvez définir des variables si nécessaire. Si elles sont déjà dans le Dockerfile, il n’est pas nécessaire de les dupliquer.

Vous pourrez modifier ces paramètres plus tard, changer de branche ou de commit, et redéployer l’application avec les nouveaux réglages.

Étape 7. Renseigner les Informations de l’App

Vous pouvez ici définir un nom et un commentaire pour votre application, qui seront visibles dans le tableau de bord Hostman. Vous pouvez aussi associer l’app à un projet.

Ces réglages peuvent également être modifiés par la suite.

Étape 8. Déployer

Cliquez sur Lancer le déploiement. Une fois le processus démarré, vous verrez les logs dans l’onglet Deploy.

Le journal de déploiement contient toutes les informations nécessaires pour résoudre les éventuels problèmes. En cas d’erreur — par exemple dans le code — une notification apparaîtra avec la cause exacte.

Lors du premier déploiement, l’installation du serveur peut prendre un certain temps. Une fois terminée, le statut de l’application sera mis à jour et un message s’affichera dans les logs.

C’est terminé !

Vous trouverez l’adresse IP de l’app et le domaine technique lié dans l’onglet Dashboard. Pour lier votre propre domaine, suivez ce guide.

L’application fonctionne sur les ports 80 et 443.

La plateforme d'applications continuera à surveiller les mises à jour dans le dépôt et, si l’autodéploiement est activé, déploiera automatiquement les changements.