Déployer avec Docker Compose

Le service Apps vous permet de déployer une application en utilisant un fichier docker-compose.yml situé dans le dépôt. Cela permet d’exécuter tout type d’application, y compris celles construites avec des frameworks frontend et backend non directement pris en charge par le service.

Pré-requis

• Placez le fichier docker-compose.yml à la racine du dépôt.

• N’utilisez pas les ports 80 et 443 comme ports hôtes dans le manifeste. Ces ports sont réservés à Nginx.

• Le proxy est configuré pour le premier service listé dans docker-compose.yml. Les autres services, s’ils disposent de ports hôtes définis, ne seront accessibles que via ces ports spécifiques. Par exemple :

 

services:
  my-app:
    ports:
      - "9000:80"
  adminer:
    ports:
      - "8080:8080"

 

Dans ce cas :

• • my-app sera accessible via le domaine principal.
    adminer sera accessible via http://<domaine>:8080.

Les volumes définis dans docker-compose.yml ne seront pas conservés entre les déploiements.

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

1. Allez dans la section Plateforme d’Apps et cliquez sur Créer.
2. Sélectionnez l’onglet Docker Compose.

Étape 2. Connecter un Dépôt

Sélectionnez le dépôt contenant l’application. Le fichier docker-compose.yml doit se trouver à 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 un lien vers un dépôt hébergé sur n’importe quelle plateforme. Cliquez sur Connecter le dépôt via URL et entrez l’URL Git. Si le dépôt est privé, saisissez é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 à déployer.

Par défaut, l’option "Build avec le dernier commit exécuté" est activée. Dans ce cas, la plateforme déploiera le commit le plus récent 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 spécifique manuellement, désactivez cette option.

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

Votre application doit être exécutée sur un serveur cloud dédié. Choisissez la région et la configuration du serveur.

Vous pourrez toujours mettre à niveau le serveur ultérieurement, mais une rétrogradation ne sera pas possible.

Étape 5. Configurer le Réseau Privé

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

Notez que vous ne pourrez plus modifier le réseau privé après le déploiement.

Étape 6. Configurer les Paramètres de Build

La Plateforme d’Apps lira les instructions du fichier docker-compose.yml et construira l’application en conséquence.

À ce stade, vous pouvez définir des variables si nécessaire. Si elles sont déjà spécifiées dans docker-compose.yml ou dans le Dockerfile, inutile de les dupliquer. Ces variables seront utilisées pendant la phase de build du Dockerfile, mais ne peuvent actuellement pas être transmises au fichier docker-compose.yml.

Par la suite, vous pourrez modifier ces paramètres, choisir une autre branche ou un autre commit et relancer le déploiement avec les nouveaux paramètres.

Étape 7. Saisir les Informations de l’Application

Ici, vous pouvez définir un nom et un commentaire pour votre application, qui seront affichés dans le tableau de bord Hostman. Vous pouvez également sélectionner un projet auquel rattacher l’application.

Ces paramètres peuvent aussi être modifiés plus tard.

Étape 8. Déployer

Cliquez sur Démarrer le déploiement. Une fois le processus lancé, vous verrez le journal de déploiement dans l’onglet Deploy.

Le journal contient toutes les informations nécessaires pour résoudre d’éventuels problèmes. En cas d’erreur — par exemple une erreur dans le code — une notification indiquant la cause sera affichée dans le log.

Lors du premier déploiement d’un projet, l’installation du serveur peut prendre un certain temps. Une fois terminé, le statut de l’application sera mis à jour et un message apparaîtra dans le journal.

C’est fait !

Vous trouverez l’adresse IP de l’application et le domaine technique associé dans l’onglet Dashboard. Pour connecter votre propre domaine, suivez ce guide.

L’application s’exécute sur les ports 80 et 443.

À l’avenir, la plateforme App surveillera les mises à jour dans le dépôt et, si le déploiement automatique est activé, reconstruira automatiquement le projet en cas de modification.