Aller au contenu principal

Votre Premier Déploiement

Un guide complet pour déployer une vraie application sur SailOps.

Ce guide vous accompagne dans le déploiement d'une application web complète avec une base de données, du début à la fin.

Ce Que Nous Allons Construire​

Nous allons déployer une application web simple avec :

  • Un Conteneur exécutant votre application
  • Une Base de données PostgreSQL pour le stockage des données
  • Un Gateway avec HTTPS pour l'accès public

Prérequis​

  • Un compte SailOps avec un projet configuré
  • Une image Docker (registre public ou privé)
  • Un nom de domaine (SailOps ne fournit pas de domaine par défaut)

Étape 1 : Créer une Base de Données​

Commençons par la base de données car notre application devra s'y connecter.

  1. Naviguez vers Services dans la barre latérale
  2. Cliquez sur Create Service et sélectionnez PostgreSQL
  3. Configurez votre base de données :
ChampValeur
Nomapp-db
Version PostgreSQL16 (dernière)
Classe de CalculEco
Profil (Flavor)Small
Stockage5Gi
Classe de stockageStandard

Pendant l'essai, utilisez Eco, Small et la classe de stockage Standard avec 5Gi. La console utilise Gi pour les GiB : 5Gi correspond à 5 GiB (5 120 MiB), la limite PostgreSQL de l'essai.

  1. Cliquez sur Créer

La base de données sera prête en environ 30 secondes. Notez les informations de connexion :

Host: app-db-rw.votre-projet
Port: 5432
Database: postgres
Username: postgres
Password: [généré automatiquement]

Le host utilise le format DNS interne : {nom-db}-rw.{nom-projet}

Connection String

Vous pouvez copier la chaîne de connexion complète depuis la page de détails de la base de données.

Étape 2 : Configurer les Identifiants du Registre (Optionnel)​

Si vous utilisez un Docker Registry privé, configurez d'abord les identifiants :

  1. Allez dans Paramètres du Projet > Identifiants de Registre
  2. Cliquez sur Ajouter des Identifiants
  3. Configurez :
ChampValeur
Nommon-registre
URL du Registreghcr.io ou docker.io ou votre registre privé
Nom d'utilisateurVotre nom d'utilisateur du registre
Mot de passeVotre token d'accès ou mot de passe
  1. Cliquez sur Enregistrer
GitHub Container Registry

Pour GitHub (ghcr.io), utilisez un Personal Access Token avec le scope read:packages comme mot de passe.

Étape 3 : Déployer Votre Application​

Maintenant, déployons le conteneur de l'application.

  1. Allez dans Conteneurs dans la barre latérale
  2. Cliquez sur Nouveau Conteneur
  3. Configurez le conteneur :
ChampValeur
Nomweb-app
ImageVotre image Docker
PortLe port d'écoute de votre app
Classe de CalculEco
CPU0.5 vCPU

Variables d'Environnement​

Ajoutez la connexion à la base de données comme variables d'environnement :

  1. Descendez jusqu'à Variables d'Environnement
  2. Ajoutez les suivantes :
CléValeur
DATABASE_URLpostgresql://postgres:[email protected]:5432/postgres
NODE_ENVproduction
  1. Cliquez sur Créer

Votre conteneur est créé à l'arrêt, avec le statut Stopped. Ouvrez web-app depuis la liste des conteneurs, cliquez sur Start (Démarrer) et confirmez. Attendez que le conteneur soit sain : la console actuelle affiche Running, avec toutes les instances prêtes. Votre application peut alors utiliser la connexion à la base de données configurée ci-dessus.

Étape 4 : Exposer Votre Application​

Créez un gateway pour rendre votre app accessible publiquement.

  1. Naviguez vers Gateways
  2. Cliquez sur Nouveau Gateway
  3. Configurez :
ChampValeur
Nomweb-gateway
TypeHTTP/HTTPS
  1. Ajoutez une route :

    • Chemin : /
    • Cible : web-app
    • Port : Le port de votre app
  2. Cliquez sur Créer

Configurer Votre Domaine​

SailOps ne fournit pas de domaine par défaut. Vous devez configurer le vôtre :

Option A : Gestion DNS Automatique (Recommandé)

Si vous avez configuré un fournisseur DNS dans les paramètres de l'organisation :

  1. Allez dans Gateways > votre gateway
  2. Cliquez sur Ajouter un Listener
  3. Entrez votre hostname (ex: app.votredomaine.com)
  4. SailOps crée automatiquement l'enregistrement DNS et provisionne le certificat SSL

Option B : Configuration DNS Manuelle

  1. Allez dans les détails de la gateway et copiez l'Adresse IP
  2. Créez un enregistrement A chez votre fournisseur DNS :
    app.votredomaine.com  A  <adresse-ip-gateway>
  3. Attendez la propagation DNS (quelques minutes à 24h)
  4. Ajoutez le listener dans SailOps avec votre hostname
  5. Le certificat SSL sera provisionné automatiquement
Intégration Fournisseur DNS

Configurez votre fournisseur DNS (Cloudflare, AWS Route53, etc.) dans Paramètres Organisation > DNS Providers pour la gestion automatique.

Étape 5 : Vérifier Votre Déploiement​

  1. Accédez à votre domaine configuré (ex: https://app.votredomaine.com)
  2. Votre application devrait se charger avec HTTPS
  3. Vérifiez la connectivité à la base de données en testant les fonctionnalités de votre app

Vérifier la Santé du Conteneur​

Dans Conteneurs > web-app :

  • Statut devrait être Running
  • Santé devrait montrer des vérifications réussies
  • Métriques devrait afficher l'utilisation CPU et mémoire

Vérifier les Logs​

Si quelque chose ne fonctionne pas :

  1. Allez dans l'onglet Logs de votre conteneur
  2. Recherchez les messages d'erreur
  3. Vérifiez l'onglet Événements pour les problèmes de déploiement

Étape 6 : Configurer l'Autoscaling (Optionnel)​

Pendant l'essai, conservez une seule réplique et ignorez cette étape. L'exemple ci-dessous nécessite une organisation hors période d'essai.

Pour gérer les pics de trafic :

  1. Allez dans Conteneurs > web-app > Autoscaling
  2. Activez l'autoscaling
  3. Configurez :
ParamètreValeur
Min Réplicas1
Max Réplicas5
Cible CPU70%

Votre application va maintenant scaler automatiquement en fonction de la charge.

Patterns de Déploiement Courants​

Architecture Multi-Services​

Déployez plusieurs conteneurs qui communiquent en interne :

Déploiements Blue-Green​

  1. Déployez une nouvelle version dans un nouveau conteneur
  2. Testez-la avec un gateway séparé
  3. Basculez le gateway principal vers le nouveau conteneur
  4. Supprimez l'ancien conteneur

Séparation des Environnements​

Créez des projets séparés pour différents environnements :

  • production - Application en production
  • staging - Tests pré-release
  • development - Tests développeur

Checklist de Déploiement​

  • Identifiants du registre configurés (si images privées)
  • Base de données créée et accessible
  • Conteneur déployé et en cours d'exécution
  • Variables d'environnement configurées
  • Gateway créé avec les bonnes routes
  • Domaine configuré avec enregistrement A pointant vers l'IP du gateway
  • Certificat SSL provisionné
  • Application accessible via HTTPS
  • Autoscaling configuré (si nécessaire)
  • Alertes de monitoring configurées

Dépannage​

Le Conteneur Crash au Démarrage​

  • Vérifiez les Logs pour les messages d'erreur
  • Vérifiez que les variables d'environnement sont correctement définies
  • Assurez-vous que l'image existe et est accessible

Erreur de Pull d'Image​

  • Vérifiez que les identifiants du registre sont correctement configurés
  • Vérifiez que le nom et le tag de l'image existent
  • Pour les registres privés, assurez-vous que le token a les permissions de lecture

Échec de Connexion à la Base de Données​

  • Vérifiez que la chaîne de connexion est correcte
  • Vérifiez que la base de données est en Running
  • Utilisez le hostname interne, pas externe

Le Gateway Retourne 502​

  • Le conteneur est peut-être encore en train de démarrer
  • Vérifiez le statut de santé du conteneur
  • Vérifiez que le mapping de port est correct

Prochaines Étapes​

Votre application est maintenant déployée ! Considérez :

  1. Configurer un domaine personnalisé
  2. Configurer les alertes de monitoring
  3. Activer les backups de base de données
  4. Inviter des membres d'équipe

Besoin d'aide pour le déploiement ? Contactez-nous à [email protected]