Aller au contenu principal

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​

  1. Sélectionnez votre projet dans le sélecteur de projet
  2. Cliquez sur Conteneurs dans la barre latérale
  3. 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
Convention de Nommage

Utilisez des lettres minuscules, des chiffres et des tirets. Commencez par une lettre.

Image Docker​

Spécifiez l'image Docker à déployer :

FormatExemple
Docker Hubnginx:latest
Docker Hub (officiel)library/nginx:1.25
GitHub Registryghcr.io/org/image:tag
GitLab Registryregistry.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 :

ClasseRatio CPU:RAMRessources MaxCas d'Utilisation
Eco1:23 cœurs, 6 GoDéveloppement, tests, budgets limités
Standard1:415 cœurs, 58 GoCharges de production générales
Production1:46 cœurs, 28 GoCharges sensibles nécessitant des ressources dédiées
Prod. Compute1:26 cœurs, 16 GoTâches intensives en CPU (traitement de données, APIs)
Prod. Memory1:86 cœurs, 58 GoTâches intensives en mémoire (cache, inférence ML)
ARM1:48 cœurs, 32 GoCharges 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
Choisir les Ressources

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 :

ChampDescription
Port du ConteneurLe port sur lequel votre application écoute
ProtocoleTCP 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.

  1. Sélectionnez un service (PostgreSQL, MariaDB, Valkey, NATS, etc.)
  2. Les détails de connexion sont automatiquement configurés
  3. Les variables d'environnement sont injectées au démarrage
Identifiants Automatiques

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 :

ChampDescription
Chemin de MontageChemin absolu dans le conteneur (ex : /data)
Classe de StockageStandard (5K IOPS) ou Performance (15K IOPS). Standard par défaut
TailleTaille du volume de 1 Go à 100 Go
Limitations des Volumes

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_ENVproduction
DATABASE_URLpostgresql://...
API_KEYvotre-cle-secrete
Secrets

Pour les valeurs sensibles, utilisez le toggle secret pour masquer la valeur dans l'interface.

Après Création

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 :

ChampDescription
CheminEndpoint à vérifier (ex : /health)
PortPort à vérifier
IntervalleTemps entre les vérifications (défaut : 30s)
Délai d'attenteTemps 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.

ChampDescription
Run As User IDUID numérique (ex : 1000)
Run As Group IDGID numérique (ex : 1000)

9. Créer le Conteneur​

  1. Vérifiez votre configuration
  2. Cliquez sur Créer
  3. Le conteneur est créé en état arrêté (0 réplicas)
Démarrage Manuel

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​

  1. Vérifiez que le statut du conteneur est Running
  2. Consultez l'onglet Logs pour la sortie de l'application
  3. 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 :

  1. Créez un Gateway et ajoutez une route vers votre conteneur
  2. 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ètreValeur
Nomapi-server
Imagenode:20-alpine
Port3000
Classe de CalculStandard
CPU2 cœurs
Mémoire8 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ètreValeur
Nomflask-app
Imagepython:3.12-slim
Port5000
Classe de CalculEco
CPU1 cœur
Mémoire2 Go (calculé automatiquement avec le ratio 1:2)

Variables d'environnement : FLASK_ENV=production

Site Statique Nginx​

ParamètreValeur
Nomstatic-site
Imagenginx:alpine
Port80
Classe de CalculEco
CPU0.5 cœurs
Mémoire1 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

Prochaines Étapes​