Aller au contenu

Réseautage et répartition de charge Mis à jour le 2026-05-29

Répartiteur NGINX

Déployer et configurer NGINX comme répartiteur au niveau environnement sur Stack Harbor PaaS — fonctions, comportements par défaut, prise en charge HTTP/3 et ajout à une topologie.

NGINX est le répartiteur de charge par défaut au niveau environnement sur Stack Harbor PaaS. Il s’agit d’un serveur open-source TCP/UDP, HTTP et proxy inverse, qui couvre l’essentiel des besoins de répartition de base : distribution Couche 7, mise en cache, proxy inverse et terminaison TLS.

La pile de répartiteur NGINX sur la plateforme est prête pour HTTP/3 par défaut. Pour servir une requête en HTTP/3 de bout en bout, vous devez aussi attacher une IP publique au répartiteur afin que la requête contourne le Shared Load Balancer.

Ce que NGINX vous donne sur la plateforme

  • proxy TCP et UDP générique
  • service de fichiers statiques et auto-indexation de répertoire
  • proxy inverse accéléré avec cache
  • règles de redirection 3xx-5xx
  • terminaison TLS avec prise en charge SNI
  • contrôle d’accès (auth, règles d’IP), tolérance de panne sur un pool amont
  • prise en charge HTTP/3 (depuis 1.16.1) quand une IP publique est attachée

Pour la majorité des applications, choisir NGINX comme répartiteur est l’appel le plus simple — scalable, sûr, bien documenté et économe en ressources.

Ajouter NGINX à un environnement

Vous pouvez ajouter NGINX dans la topologie à la création d’un environnement, ou le superposer à une topologie existante :

  1. Dans le tableau de bord, ouvrez l’assistant de topologie pour un nouvel environnement (New Environment) ou la vue topologie d’un environnement existant.
  2. Sous la section Balancing, choisissez NGINX.
  3. Définissez les ressources du répartiteur : cloudlets / limites de mise à l’échelle, espace disque, IP publique si désirée.
  4. Ajoutez le reste de l’environnement — serveurs d’application, bases de données, caches.
  5. Cliquez sur Create (ou Apply lors d’une édition).

Quand le répartiteur est créé en même temps qu’un ou plusieurs serveurs d’application, la plateforme câble le bloc upstream pour vous. Les requêtes au répartiteur sont distribuées sur le palier applicatif sans configuration manuelle.

Ajouter NGINX devant un seul serveur applicatif

Vous n’avez pas besoin d’un palier multi-nœuds pour bénéficier de NGINX. Ajoutez un répartiteur NGINX unique devant un serveur applicatif unique quand vous voulez :

  • la terminaison TLS sur un nœud dédié (gestion de certificat propre)
  • du contrôle d’accès par IP ou une authentification HTTP en bordure
  • la mise en cache de réponses statiques ou dynamiques cacheables
  • un endpoint unique que vous pourrez mettre à l’échelle derrière plus tard sans changer l’URL utilisée par les clients

Sélectionnez le bloc Balancing du serveur applicatif dans l’assistant de topologie et choisissez NGINX. La plateforme met en place l’upstream pointant vers le backend unique ; quand vous mettrez le palier à l’échelle plus tard, les nouvelles répliques rejoindront le pool automatiquement.

Suite

Une fois le répartiteur en place, la référence opérationnelle est le document Configuration du répartiteur NGINX — disposition des fichiers, où éditer, ce qui est écrasé lors d’une mise à jour plateforme.

Pour verrouiller le répartiteur par authentification, règles d’IP ou les deux, voir Sécurité de base avec le répartiteur NGINX.

Voir aussi