Aller au contenu principal

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​

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

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 :

ClasseBande PassantePrixCas d'Utilisation
gw-small200 Mbps0,0365€/heureDéveloppement, petites applications
gw-medium500 Mbps0,0770€/heureApplications à trafic moyen
gw-large1 Gbps0,1290€/heureProduction à fort trafic
gw-xlarge4 Gbps1,2300€/heureEntreprise, très fort trafic
Choisir une Classe

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​

ChampDescriptionRequis
Nom du ListenerIdentifiant unique (ex: mon-listener)Oui
ProtocoleHTTPS (recommandé) ou HTTPOui
HostnameVotre domaine (ex: api.example.com)Oui
PortPort réseau (443 pour HTTPS, 80 pour HTTP)Oui
Hostname Requis

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​

  1. Vérifiez votre configuration dans le résumé de la barre latérale
  2. Vérifiez le coût estimé
  3. Cliquez sur Créer le Gateway
  4. 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é :

  1. SailOps détecte automatiquement le changement DNS
  2. Le certificat SSL est provisionné (1-5 minutes)
  3. 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 :

  1. Allez dans les détails de votre gateway
  2. Accédez à la section Routes
  3. Cliquez sur Ajouter une Route
  4. Configurez la route :
ChampDescriptionExemple
CheminChemin URL à matcher/ ou /api
ConteneurConteneur ciblemon-app
PortPort du conteneur3000

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 GatewayCorrespond à
/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 :

OptionChemin RequêteConteneur 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é :

  1. Correspondances exactes en premier
  2. Préfixes de chemin plus longs avant les plus courts
  3. Première route définie gagne en cas d'égalité de spécificité

États de le Gateway​

ÉtatDescription
CreatingLa gateway est en cours de provisionnement
ActiveLa gateway route le trafic
UpdatingChangement de configuration en cours
ErrorProblè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é​

  1. Vérifiez que le DNS est correctement configuré
  2. Vérifiez la propagation DNS (peut prendre jusqu'à 48 heures)
  3. Assurez-vous que le hostname correspond exactement à votre enregistrement DNS
  4. Attendez 5-10 minutes après le changement DNS
# Vérifier la configuration DNS
dig api.votredomaine.com

Gateway Ne Répond Pas​

  1. Vérifiez que le DNS pointe vers le bon endpoint
  2. Vérifiez le statut du certificat SSL
  3. Vérifiez qu'au moins un listener est configuré
  4. 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

Prochaines Étapes​