Nginx. Gérer le module

Cet article porte sur la gestion du module Nginx dans son ensemble : démarrage et arrêt du service, rechargement de la configuration, mise à jour et désinstallation du module. Les hôtes virtuels, les règles (location) et le SSL font l’objet d’un article à part : Nginx. Hôtes virtuels en mode constructeur.

Gérer le service

La page du module propose les actions suivantes sur le service Nginx :

• « Démarrer » — active le service s’il est arrêté.
• « Arrêter » — désactive le service. Tous les sites servis par ce Nginx cessent de répondre, et les visiteurs obtiennent une erreur de connexion.
• « Redémarrer » — arrête le service puis le relance aussitôt. Les connexions ouvertes sont interrompues. Pratique après une modification manuelle de la configuration, quand vous voulez repartir d’un service tout neuf.
• « Recharger la configuration » — applique la nouvelle configuration sans couper les connexions actives des clients. Pratique après une modification manuelle des configurations d’hôtes virtuels.

⚠️ Arrêter le service est risqué sur des sites en production

Tant que le service est arrêté, tous les sites servis par ce Nginx sont inaccessibles : les visiteurs voient une erreur de connexion. Prévoyez l’arrêt et le redémarrage pendant une fenêtre de maintenance.

Mettre à jour le module

Pour mettre le module à jour, ouvrez le menu d’actions du module et choisissez « Mettre à jour Nginx ». Le panneau BeAdmin vérifie si une nouvelle version existe et, le cas échéant, l’installe par-dessus la version actuelle. Les hôtes virtuels, les règles et les certificats SSL déjà émis sont conservés. Le service redémarre automatiquement après la mise à jour.

Pendant la mise à jour, les actions sur le service et les éléments de gestion du module sont indisponibles : attendez la fin du processus.

Désinstaller le module

Pour désinstaller le module, ouvrez le menu d’actions du module et choisissez « Désinstaller Nginx ». Le panneau BeAdmin vous demande de confirmer l’action dans une boîte de dialogue.

‼️ La désinstallation du module efface la configuration de Nginx

La désinstallation est irréversible : avec le module disparaissent tous les hôtes virtuels, les règles et les journaux de Nginx. Les certificats SSL Let’s Encrypt déjà émis et les fichiers des sites dans les répertoires DocumentRoot restent sur le disque, mais, sans les configurations d’hôtes virtuels du panneau, ils ne sont plus servis. Après une nouvelle installation du module, vous devrez recréer les hôtes virtuels et émettre de nouveau les certificats SSL.

Pour aller plus loin

• Nginx. Démarrage rapide — installation du module et premier site.
• Nginx. Hôtes virtuels en mode constructeur — ajout et modification des hôtes virtuels, des règles et du SSL.
• Résoudre les erreurs ACME lors de l’émission d’un certificat SSL — erreurs ACME courantes et comment les résoudre.