Créer un Gateway
Exposez vos conteneurs sur internet avec une gateway gérée.
Prérequis
- Un projet créé dans votre organisation
- Un nom de domaine personnalisé que vous possédez (requis pour les listeners)
- Accès aux paramètres DNS de votre domaine
- (Optionnel) Au moins un conteneur déployé pour router le trafic
Guide Pas à Pas
1. Accéder aux Gateways
- Sélectionnez votre projet dans le sélecteur de projets
- Cliquez sur Gateways dans la barre latérale
- Cliquez sur Créer un Gateway
2. Configuration de Base
Nom de le Gateway
Entrez un nom unique pour votre gateway :
Valide: api-gateway, frontend, mon-app
Invalide: Ma Gateway, api_gateway, gateway.prod
Utilisez uniquement des lettres minuscules, chiffres et tirets. Commencez par une lettre.
3. Classe de Gateway
Sélectionnez la classe de gateway selon vos besoins en bandwidth :
| Classe | Bande Passante | Prix | Cas d'Utilisation |
|---|---|---|---|
| gw-small | 200 Mbps | 0,0365€/heure | Développement, petites applications |
| gw-medium | 500 Mbps | 0,0770€/heure | Applications à trafic moyen |
| gw-large | 1 Gbps | 0,1290€/heure | Production à fort trafic |
| gw-xlarge | 4 Gbps | 1,2300€/heure | Entreprise, très fort trafic |
Commencez avec gw-small pour le développement. Passez à des classes supérieures à mesure que votre trafic augmente.
4. Configurer les Listeners
Les listeners définissent comment votre gateway accepte le trafic entrant. Cliquez sur Ajouter un Listener pour en créer un.
Configuration du Listener
| Champ | Description | Requis |
|---|---|---|
| Nom du Listener | Identifiant unique (ex: mon-listener) | Oui |
| Protocole | HTTPS (recommandé) ou HTTP | Oui |
| Hostname | Votre domaine (ex: api.example.com) | Oui |
| Port | Port réseau (443 pour HTTPS, 80 pour HTTP) | Oui |
Vous devez fournir votre propre hostname. SailOps ne fournit pas de sous-domaines par défaut. Configurez le DNS de votre domaine pour pointer vers la gateway après la création.
Options de Protocole
- HTTPS - HTTP sécurisé avec certificat TLS automatique (recommandé)
- HTTP - HTTP non chiffré (uniquement pour les services internes)
Avec HTTPS, les certificats TLS sont automatiquement provisionnés et renouvelés via Let's Encrypt.
5. Créer le Gateway
- Vérifiez votre configuration dans le résumé de la barre latérale
- Vérifiez le coût estimé
- Cliquez sur Créer le Gateway
- Attendez le provisionnement (~15-30 secondes)
Après la Création
Configurer le DNS
Après la création de votre gateway, configurez votre DNS avec un enregistrement A :
Pour les sous-domaines :
Type: A
Nom: api (ou votre sous-domaine)
Valeur: <adresse-IP-depuis-les-détails-gateway>
TTL: 300
Pour les domaines apex :
Type: A
Nom: @
Valeur: <adresse-IP-depuis-les-détails-gateway>
TTL: 300
L'adresse IP est affichée dans les détails de votre gateway.
Provisionnement du Certificat SSL
Une fois le DNS correctement configuré :
- SailOps détecte automatiquement le changement DNS
- Le certificat SSL est provisionné (1-5 minutes)
- Votre gateway est prête à recevoir du trafic
Ajouter des Routes
Une fois la gateway active, configurez les routes pour diriger le trafic vers vos conteneurs :
- Allez dans les détails de votre gateway
- Accédez à la section Routes
- Cliquez sur Ajouter une Route
- Configurez la route :
| Champ | Description | Exemple |
|---|---|---|
| Chemin | Chemin URL à matcher | / ou /api |
| Conteneur | Conteneur cible | mon-app |
| Port | Port du conteneur | 3000 |
Tester Votre Gateway
# Tester votre domaine personnalisé
curl https://api.votredomaine.com
# Tester une route spécifique
curl https://api.votredomaine.com/health
Configuration de le Gateway
Listeners Multiples
Une seule gateway peut avoir plusieurs listeners pour différents domaines :
Listeners:
- name: api-listener
hostname: api.example.com
port: 443
protocol: HTTPS
- name: app-listener
hostname: app.example.com
port: 443
protocol: HTTPS
Configuration des Routes
Correspondance de Chemin
Les chemins sont matchés par correspondance de préfixe :
| Chemin Gateway | Correspond à |
|---|---|
/ | Toutes les requêtes |
/api | /api, /api/users, /api/v1/data |
/api/v1 | /api/v1, /api/v1/users |
Suppression du Préfixe de Chemin
Contrôlez comment les chemins sont transmis aux conteneurs :
| Option | Chemin Requête | Conteneur Reçoit |
|---|---|---|
| Garder le chemin | /api/users | /api/users |
| Supprimer le préfixe | /api/users | /users |
Priorité des Routes
Les routes sont matchées par ordre de spécificité :
- Correspondances exactes en premier
- Préfixes de chemin plus longs avant les plus courts
- Première route définie gagne en cas d'égalité de spécificité
États de le Gateway
| État | Description |
|---|---|
| Creating | La gateway est en cours de provisionnement |
| Active | La gateway route le trafic |
| Updating | Changement de configuration en cours |
| Error | Problème avec la configuration de la gateway |
Exemples
Application Web Simple
Conteneur unique servant une application web :
Gateway: mon-app-gateway
Classe: gw-small
Listeners:
- hostname: monapp.example.com
port: 443
protocol: HTTPS
Routes:
- path: /
container: web
port: 3000
API + Frontend
Conteneurs séparés pour l'API et le frontend sur différents sous-domaines :
Gateway: platform-gateway
Classe: gw-medium
Listeners:
- hostname: app.example.com
port: 443
- hostname: api.example.com
port: 443
Routes:
- hostname: api.example.com
path: /
container: api
port: 8080
- hostname: app.example.com
path: /
container: frontend
port: 3000
Microservices
Services multiples derrière une gateway avec routage par chemin :
Gateway: api-gateway
Classe: gw-large
Listeners:
- hostname: api.example.com
port: 443
Routes:
- path: /users
container: user-service
port: 8080
- path: /orders
container: order-service
port: 8080
- path: /payments
container: payment-service
port: 8080
- path: /
container: api-docs
port: 80
Dépannage
Certificat SSL Non Provisionné
- Vérifiez que le DNS est correctement configuré
- Vérifiez la propagation DNS (peut prendre jusqu'à 48 heures)
- Assurez-vous que le hostname correspond exactement à votre enregistrement DNS
- Attendez 5-10 minutes après le changement DNS
# Vérifier la configuration DNS
dig api.votredomaine.com
Gateway Ne Répond Pas
- Vérifiez que le DNS pointe vers le bon endpoint
- Vérifiez le statut du certificat SSL
- Vérifiez qu'au moins un listener est configuré
- Vérifiez que le conteneur est en cours d'exécution (si des routes sont configurées)
502 Bad Gateway
La gateway ne peut pas atteindre le conteneur :
- Le conteneur a peut-être crashé
- Discordance de port entre la route et le conteneur
- Le conteneur n'est pas encore prêt
# Vérifier le statut du conteneur
Tableau de bord → Conteneurs → votre-conteneur → Statut
504 Gateway Timeout
La requête a pris trop de temps :
- Le conteneur est surchargé
- Opération longue durée
- Envisagez de scaler votre conteneur