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.
- Naviguez vers Services dans la barre latérale
- Cliquez sur Create Service et sélectionnez PostgreSQL
- Configurez votre base de données :
| Champ | Valeur |
|---|---|
| Nom | app-db |
| Version PostgreSQL | 16 (dernière) |
| Classe de Calcul | Eco |
| Profil (Flavor) | Small |
| Stockage | 5Gi |
| Classe de stockage | Standard |
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.
- 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}
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 :
- Allez dans Paramètres du Projet > Identifiants de Registre
- Cliquez sur Ajouter des Identifiants
- Configurez :
| Champ | Valeur |
|---|---|
| Nom | mon-registre |
| URL du Registre | ghcr.io ou docker.io ou votre registre privé |
| Nom d'utilisateur | Votre nom d'utilisateur du registre |
| Mot de passe | Votre token d'accès ou mot de passe |
- Cliquez sur Enregistrer
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.
- Allez dans Conteneurs dans la barre latérale
- Cliquez sur Nouveau Conteneur
- Configurez le conteneur :
| Champ | Valeur |
|---|---|
| Nom | web-app |
| Image | Votre image Docker |
| Port | Le port d'écoute de votre app |
| Classe de Calcul | Eco |
| CPU | 0.5 vCPU |
Variables d'Environnement
Ajoutez la connexion à la base de données comme variables d'environnement :
- Descendez jusqu'à Variables d'Environnement
- Ajoutez les suivantes :
| Clé | Valeur |
|---|---|
DATABASE_URL | postgresql://postgres:[email protected]:5432/postgres |
NODE_ENV | production |
- 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.
- Naviguez vers Gateways
- Cliquez sur Nouveau Gateway
- Configurez :
| Champ | Valeur |
|---|---|
| Nom | web-gateway |
| Type | HTTP/HTTPS |
-
Ajoutez une route :
- Chemin :
/ - Cible :
web-app - Port : Le port de votre app
- Chemin :
-
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 :
- Allez dans Gateways > votre gateway
- Cliquez sur Ajouter un Listener
- Entrez votre hostname (ex:
app.votredomaine.com) - SailOps crée automatiquement l'enregistrement DNS et provisionne le certificat SSL
Option B : Configuration DNS Manuelle
- Allez dans les détails de la gateway et copiez l'Adresse IP
- Créez un enregistrement A chez votre fournisseur DNS :
app.votredomaine.com A <adresse-ip-gateway> - Attendez la propagation DNS (quelques minutes à 24h)
- Ajoutez le listener dans SailOps avec votre hostname
- Le certificat SSL sera provisionné automatiquement
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
- Accédez à votre domaine configuré (ex:
https://app.votredomaine.com) - Votre application devrait se charger avec HTTPS
- 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 :
- Allez dans l'onglet Logs de votre conteneur
- Recherchez les messages d'erreur
- 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 :
- Allez dans Conteneurs > web-app > Autoscaling
- Activez l'autoscaling
- Configurez :
| Paramètre | Valeur |
|---|---|
| Min Réplicas | 1 |
| Max Réplicas | 5 |
| Cible CPU | 70% |
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
- Déployez une nouvelle version dans un nouveau conteneur
- Testez-la avec un gateway séparé
- Basculez le gateway principal vers le nouveau conteneur
- Supprimez l'ancien conteneur
Séparation des Environnements
Créez des projets séparés pour différents environnements :
production- Application en productionstaging- Tests pré-releasedevelopment- 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 :
- Configurer un domaine personnalisé
- Configurer les alertes de monitoring
- Activer les backups de base de données
- Inviter des membres d'équipe
Besoin d'aide pour le déploiement ? Contactez-nous à [email protected]