Créer un Conteneur
Déployez votre premier conteneur en quelques minutes.
Prérequis
Avant de créer un conteneur, assurez-vous d'avoir :
- Un projet créé dans votre organisation
- Une image Docker prête à déployer
- (Optionnel) Un Docker Registry configuré pour les images privées
Mode Simple vs Avancé
Le formulaire de création de conteneur propose deux modes :
- Mode simple - Formulaire simplifié avec quatre sections : Configuration de Base, Réseau, Connexions de Services, et Ressources & Scaling. Idéal pour les déploiements rapides.
- Mode avancé - Ajoute des sections supplémentaires : Environnement & Fichiers (variables d'environnement, fichiers montés) et Paramètres Avancés (sondes de santé, conteneurs d'init, contexte de sécurité).
Basculez entre les modes en utilisant l'interrupteur Simple / Avancé en haut du formulaire de création.
Guide Étape par Étape
1. Accéder aux Conteneurs
- Sélectionnez votre projet dans le sélecteur de projet
- Cliquez sur Conteneurs dans la barre latérale
- Cliquez sur Nouveau Conteneur
2. Configuration de Base
Nom du Conteneur
Entrez un nom unique pour votre conteneur. Ce nom est utilisé pour :
- La résolution DNS interne
- L'identification dans les logs et métriques
- Le routage via les gateways
Valide : my-app, api-v2, frontend-prod
Invalide : My App, api_v2, frontend.prod
Utilisez des lettres minuscules, des chiffres et des tirets. Commencez par une lettre.
Image Docker
Spécifiez l'image Docker à déployer :
| Format | Exemple |
|---|---|
| Docker Hub | nginx:latest |
| Docker Hub (officiel) | library/nginx:1.25 |
| GitHub Registry | ghcr.io/org/image:tag |
| GitLab Registry | registry.gitlab.com/org/repo:tag |
| Registre personnalisé | registry.example.com/image:tag |
Pour les registres privés, configurez vos identifiants au préalable.
Commande du Conteneur (Optionnel)
Surchargez la commande qui démarre votre conteneur. Entrez la commande complète telle que vous la taperiez dans un terminal — le système la décompose en commande et arguments. Laissez vide pour utiliser la commande définie dans votre image Docker.
Exemples :
nginx -g 'daemon off;'
/bin/sh -c 'echo hello && sleep 5'
3. Configuration de Calcul
Classe de Calcul
Sélectionnez la classe de calcul appropriée pour votre charge de travail :
| Classe | Ratio CPU:RAM | Ressources Max | Cas d'Utilisation |
|---|---|---|---|
| Eco | 1:2 | 3 cœurs, 6 Go | Développement, tests, budgets limités |
| Standard | 1:4 | 15 cœurs, 58 Go | Charges de production générales |
| Production | 1:4 | 6 cœurs, 28 Go | Charges sensibles nécessitant des ressources dédiées |
| Prod. Compute | 1:2 | 6 cœurs, 16 Go | Tâches intensives en CPU (traitement de données, APIs) |
| Prod. Memory | 1:8 | 6 cœurs, 58 Go | Tâches intensives en mémoire (cache, inférence ML) |
| ARM | 1:4 | 8 cœurs, 32 Go | Charges ARM optimisées en coût |
Allocation des Ressources
Au sein de chaque classe de calcul, configurez les ressources avec des curseurs :
- CPU : Ajustable par incréments (varie selon la classe)
- Mémoire : Calculée automatiquement selon le ratio CPU:RAM
Exemple avec la classe Standard (ratio 1:4) :
- 1 vCPU → 4 Go RAM
- 2 vCPU → 8 Go RAM
- 4 vCPU → 16 Go RAM
Commencez avec la classe Eco et des ressources minimales pour le développement. Utilisez Standard ou Production pour la production.
Réplicas
Définissez le nombre d'instances de conteneur à exécuter. Pour la haute disponibilité, utilisez au moins 2 réplicas en production.
4. Configuration des Ports
Spécifiez les ports exposés par votre conteneur :
| Champ | Description |
|---|---|
| Port du Conteneur | Le port sur lequel votre application écoute |
| Protocole | TCP ou UDP |
Exemple : Application Node.js écoutant sur le port 3000
Port du Conteneur : 3000
Protocole : TCP
Vous pouvez également configurer Exposition Rapide ici pour créer automatiquement une URL publique via une gateway partagée lors de la création.
5. Connexions de Services
Connectez votre conteneur aux bases de données et services de votre projet. Les identifiants sont automatiquement injectés en tant que variables d'environnement.
- Sélectionnez un service (PostgreSQL, MariaDB, Valkey, NATS, etc.)
- Les détails de connexion sont automatiquement configurés
- Les variables d'environnement sont injectées au démarrage
Les Connexions de Services éliminent le besoin de configurer manuellement les URLs et identifiants de base de données. Les variables de connexion sont gérées automatiquement par SailOps.
6. Ressources & Scaling
Voir Configuration de Calcul ci-dessus pour les détails sur la classe de calcul et les ressources. Cette section inclut également :
Volume Persistant (Optionnel)
Activez Volume Persistant pour attacher du stockage durable à votre conteneur :
| Champ | Description |
|---|---|
| Chemin de Montage | Chemin absolu dans le conteneur (ex : /data) |
| Classe de Stockage | Standard (5K IOPS) ou Performance (15K IOPS). Standard par défaut |
| Taille | Taille du volume de 1 Go à 100 Go |
Attacher un volume limite votre conteneur à 1 réplica et désactive l'autoscaling. Les redéploiements entraînent une brève interruption (10–30 secondes). Consultez le guide des Volumes Persistants pour plus de détails.
Autoscaling
Configuration de l'autoscaling lors de la création d'un nouveau conteneur. Note : l'autoscaling n'est pas disponible lorsqu'un volume persistant est attaché.
7. Variables d'Environnement (Avancé)
En mode avancé, la section Environnement & Fichiers vous permet de configurer :
- Variables d'Environnement : Ajouter une configuration clé-valeur
- Fichiers : Monter des fichiers de configuration dans le conteneur
| Exemple de Clé | Exemple de Valeur |
|---|---|
NODE_ENV | production |
DATABASE_URL | postgresql://... |
API_KEY | votre-cle-secrete |
Pour les valeurs sensibles, utilisez le toggle secret pour masquer la valeur dans l'interface.
Les variables d'environnement peuvent également être gérées après la création dans l'onglet Environnements du conteneur.
8. Paramètres Avancés (Avancé)
En mode avancé, la section Paramètres Avancés fournit :
Vérifications de Santé
Configurez les health checks pour un redémarrage automatique en cas d'échec :
Health Check HTTP :
| Champ | Description |
|---|---|
| Chemin | Endpoint à vérifier (ex : /health) |
| Port | Port à vérifier |
| Intervalle | Temps entre les vérifications (défaut : 30s) |
| Délai d'attente | Temps d'attente max (défaut : 5s) |
| Seuil | Échecs avant redémarrage (défaut : 3) |
Health Check TCP : Pour les services non-HTTP, utilisez les vérifications TCP qui vérifient que le port accepte les connexions.
Conteneurs d'Init
Configurez des conteneurs d'initialisation qui s'exécutent avant le démarrage du conteneur principal. Utile pour les migrations de base de données, la configuration ou les vérifications de dépendances.
Contexte de Sécurité
Configurez les restrictions de sécurité pour votre conteneur. C'est optionnel - SailOps fournit une isolation forte des conteneurs par défaut.
| Champ | Description |
|---|---|
| Run As User ID | UID numérique (ex : 1000) |
| Run As Group ID | GID numérique (ex : 1000) |
9. Créer le Conteneur
- Vérifiez votre configuration
- Cliquez sur Créer
- Le conteneur est créé en état arrêté (0 réplicas)
Après la création, cliquez sur Démarrer sur le conteneur pour commencer le déploiement. Cela vous permet de vérifier la configuration avant de consommer des ressources de calcul.
Après la Création
Vérifier le Déploiement
- Vérifiez que le statut du conteneur est Running
- Consultez l'onglet Logs pour la sortie de l'application
- Vérifiez l'onglet Événements pour d'éventuels problèmes
Accéder à Votre Conteneur
Les conteneurs ne sont pas accessibles publiquement par défaut. Pour les exposer :
- Créez un Gateway et ajoutez une route vers votre conteneur
- Ou utilisez Exposition Rapide pour un accès public instantané via une gateway partagée
Exposition Rapide
Pour des tests rapides, cliquez sur le bouton Exposition Rapide sur votre conteneur pour créer automatiquement une URL publique via une gateway partagée. C'est idéal pour le développement et les démonstrations.
Accès Interne
Les autres conteneurs du même projet peuvent accéder à votre conteneur via le DNS interne :
http://{nom-service}.{namespace}:{port}
Par exemple, si votre conteneur s'appelle backend dans le namespace mon-projet-abc123 :
http://backend.mon-projet-abc123:3000
Le namespace est automatiquement attribué à votre projet. Vous pouvez le trouver dans les détails du conteneur.
Exemples de Configuration
Application Node.js
| Paramètre | Valeur |
|---|---|
| Nom | api-server |
| Image | node:20-alpine |
| Port | 3000 |
| Classe de Calcul | Standard |
| CPU | 2 cœurs |
| Mémoire | 8 Go (calculé automatiquement avec le ratio 1:4) |
Variables d'environnement : NODE_ENV=production, PORT=3000
Health check : HTTP sur /health:3000
Python Flask
| Paramètre | Valeur |
|---|---|
| Nom | flask-app |
| Image | python:3.12-slim |
| Port | 5000 |
| Classe de Calcul | Eco |
| CPU | 1 cœur |
| Mémoire | 2 Go (calculé automatiquement avec le ratio 1:2) |
Variables d'environnement : FLASK_ENV=production
Site Statique Nginx
| Paramètre | Valeur |
|---|---|
| Nom | static-site |
| Image | nginx:alpine |
| Port | 80 |
| Classe de Calcul | Eco |
| CPU | 0.5 cœurs |
| Mémoire | 1 Go (calculé automatiquement avec le ratio 1:2) |
Dépannage
Échec de Téléchargement de l'Image
- Vérifiez que le nom et le tag de l'image sont corrects
- Pour les registres privés, vérifiez la configuration du registre
- Assurez-vous que l'image existe et est accessible
Le Conteneur Crash
- Consultez les Logs pour les messages d'erreur
- Vérifiez que les variables d'environnement sont correctement définies
- Assurez-vous que l'application gère la variable d'environnement PORT
- Vérifiez que les limites de ressources ne sont pas trop restrictives
Problèmes de Port
- Vérifiez que le port du conteneur correspond à votre application
- Assurez-vous qu'il n'y a pas de conflits de ports
- Vérifiez que l'application se lie à
0.0.0.0, pas à127.0.0.1