| <!DOCTYPE html SYSTEM "about:legacy-compat"> | |
| <html lang="fr"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8"> | |
| <meta content="width=device-width, initial-scale=1" name="viewport"> | |
| <!-- | |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX | |
| This file is generated from xml source: DO NOT EDIT | |
| XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX | |
| --> | |
| <title>mod_systemd - Serveur HTTP Apache Version 2.5</title> | |
| <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet"> | |
| <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size"> | |
| <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css"> | |
| <script src="../style/scripts/prettify.min.js"> | |
| </script> | |
| <link href="../images/favicon.png" rel="shortcut icon"></head> | |
| <body> | |
| <div id="page-header"> | |
| <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p> | |
| <p class="apache">Serveur HTTP Apache Version 2.5</p> | |
| <img alt="" src="../images/feather.png"></div> | |
| <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div> | |
| <div id="path"> | |
| <a href="https://www.apache.org/">Apache</a> > <a href="https://httpd.apache.org/">Serveur HTTP</a> > <a href="https://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div> | |
| <div id="page-content"> | |
| <div id="preamble"><h1>Module Apache mod_systemd</h1> | |
| <button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button> | |
| <div class="toplang"> | |
| <p><span>Langues Disponibles: </span><a href="../en/mod/mod_systemd.html" hreflang="en" rel="alternate" title="English"> en </a> | | |
| <a href="../fr/mod/mod_systemd.html" title="Français"> fr </a></p> | |
| </div> | |
| <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Fournit un support amélioré pour l'intégration de systemd</td></tr> | |
| <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr> | |
| <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>systemd_module</td></tr> | |
| <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_systemd.c</td></tr> | |
| <tr><th><a href="module-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.42 du serveur HTTP Apache</td></tr></table> | |
| <h3>Sommaire</h3> | |
| <p>Ce module implémente le support de l'intégration de systemd. Il permet | |
| d'utiliser httpd en temps que service avec le paramètre de systemd | |
| <code>Type=notify</code> ou <code>Type=notify-reload</code> (voir la page de | |
| manuel <a href="https://www.freedesktop.org/software/systemd/man/systemd.service.html">systemd.service(5)</a> | |
| pour plus de détails). Le module est activé s'il est chargé.</p> | |
| <div class="example"><h3>Exemple basique d'unité de service systemd (à étoffer pour un système en | |
| production)</h3><pre>[Unit] | |
| Description=The Apache HTTP Server | |
| After=network.target | |
| [Service] | |
| Type=notify | |
| ExecStart=/usr/local/apache2/bin/httpd -D FOREGROUND -k start | |
| ExecReload=/usr/local/apache2/bin/httpd -k graceful | |
| KillMode=mixed | |
| [Install] | |
| WantedBy=multi-user.target</pre></div> | |
| <p>Si vous utilisez <code>ExecStop</code> et/ou <code>KillMode</code>, vous | |
| devez prêter une attention particulière à leur configuration pour ce service. | |
| Si elle est présente, une commande <code>ExecStop</code> doit être une | |
| <em>operation synchrone</em> qui se termine elle-même en même temps que le | |
| démon. Cette condition n'est pas satisfaite si vous exécutez la commande | |
| <code>httpd -k stop</code> de manière <em>asynchrone</em>, car elle initie | |
| l'arrêt du démon. L'exemple ci-dessus utilise <code>KillMode=mixed</code> | |
| afin que systemd envoie <code>SIGTERM</code> au processus parent (et | |
| seulement à ce dernier) pour lui indiquer qu'il doit s'arrêter. Les processus | |
| encore en cours d'exécution après un temps égal à <code>TimeoutStopSec</code> | |
| recevront alors le signal <code>SIGKILL</code>. Voir <a href="https://www.freedesktop.org/software/systemd/man/systemd.kill.html">systemd.kill(5)</a> | |
| pour plus d'informations.</p> | |
| <p>À partir de la version 253 de systemd, un gestionnaire de service fournit | |
| <code>Type=notify-reload</code> qu’il est préférable d’utiliser. Avec | |
| <code>Type=notify</code>, <code>systemctl reload</code> quitte dès que la | |
| commande <code>ExecReload</code> a envoyé son signal, ce qui se produit avant | |
| que la nouvelle configuration n’ait été lue, et elle indique une exécution | |
| réussie quoi qu’il se passe au cours du redémarrage suivant. | |
| <code>Type=notify-reload</code>, quant à lui, maintien le rechargement ouvert | |
| jusqu’à ce que le serveur indique qu’il a terminé, de sorte que la commande | |
| attende que la nouvelle configuration soit prise en compte, et échoue si ce | |
| n’est pas le cas. mod_systemd envoie la notification <code>RELOADING=1</code> | |
| que le protocole attend pendant la lecture de la configuration, estampillée | |
| de l’étiquette <code>MONOTONIC_USEC</code> requise par le gestionnaire de | |
| services, et <code>READY=1</code> quand elle a été chargée.</p> | |
| <div class="example"><h3>Un exemple d’unité de service qui recharge de manière synchrone</h3><pre>[Service] | |
| Type=notify-reload | |
| ReloadSignal=SIGCONT | |
| ExecStart=/usr/local/apache2/bin/httpd -D FOREGROUND -k start | |
| ExecReload=/usr/local/apache2/bin/httpd -k graceful | |
| KillMode=mixed</pre></div> | |
| <p>Le gestionnaire de service exécute tout d’abord <code>ExecReload</code>, | |
| puis n’envoie le signal spécifié par <code>ReloadSignal</code> que lorsque la | |
| commande a quitté avec succès. Conserver <code>ExecReload</code> rend le | |
| rechargement de la configuration sûr : <code>httpd -k graceful</code> analyse | |
| la nouvelle configuration dans un processus qui lui est propre et quitte sans | |
| rien signaler si l’analyse échoue ; dans ce cas, le rechargement de la | |
| configuration échoue et le serveur en cours d’exécution continue avec la | |
| configuration qu’il utilise déjà. Omettre <code>ExecReload</code> et laisser | |
| le gestionnaire de service informer le serveur directement empêche cette | |
| vérification : le processus parent en cours d’exécution lit la nouvelle | |
| configuration lui-même, et une configuration dont l’analyse échoue le fait | |
| quitter, ce qui arrête le serveur.</p> | |
| <p>Le signal envoyé une fois <code>ExecReload</code> exécutée est alors | |
| redondant ; <code>ReloadSignal</code> devrait donc en spécifier un dont | |
| httpd ne tient pas compte, tel que <code>SIGCONT</code>. Il est important | |
| qu’il soit défini : le signal par défaut est <code>SIGHUP</code> que httpd | |
| interprète comme un redémarrage <em>forcé</em> en fermant les connexions | |
| qu’un redémarrage est censé préserver. Une unité qui utilise | |
| <code>ExecReload</code> doit définir <code>ReloadSignal=SIGUSR1</code>, le | |
| signal avec lequel httpd redémarre en douceur.</p> | |
| <p>L’activation du socket de systemd est prise en charge si httpd a été | |
| construit en ce sens. Chaque port spécifié par la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> doit alors avoir été indiqué par | |
| systemd ; tout port qui ne l’a pas été générera une erreur de configuration | |
| fatale et httpd ne l’ouvrira pas pour lui-même. L’activation du socket n’est | |
| utilisée que si ce module est chargé ; il peut donc être construit et gardé | |
| inutilisé.</p> | |
| <p><code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> est activé par défaut | |
| si le module est chargé. Si <code class="directive"><a href="../mod/core.html#extendedstatus">ExtendedStatus</a></code> n'est pas explicitement désactivé | |
| dans le fichier de configuration, les statistiques à propos de la charge et | |
| des requêtes pendant l'exécution apparaîtront dans la sortie de la commande | |
| <code>systemctl status</code>.</p> | |
| <p>systemd watchdog est pris en charge. Si l’unité de service définit | |
| <code>WatchdogSec=</code>, le processus parent envoie la notification de | |
| persistance qui informe systemd que le serveur est encore en vie ; un | |
| serveur qui cesse de l’envoyer est arrêté et redémarré avec une définition | |
| de <code>Restart=</code> appropriée. La notification est envoyée pendant la | |
| lecture de la configuration et à nouveau une fois qu’elle a été chargée, de | |
| sorte qu’un rechargement soit pris en compte périodiquement par le processus | |
| parent pendant l’exécution du serveur.</p> | |
| <p>Cette notification périodique est envoyée environ toutes les dix | |
| secondes, ce qui correspond à la périodicité avec laquelle le processus | |
| parent exécute le programme d’accroche à partir duquel elle est envoyée. Une | |
| valeur de <code>WatchdogSec=</code> inférieure à deux fois cette période ne | |
| conviendrait pas, car systemd arrêterait un serveur qui fonctionne | |
| normalement ; un tel réglage est signalé sous forme d’avertissement au | |
| démarrage. Utilisez une valeur d’au moins 20 secondes pour | |
| <code>WatchdogSec=</code>.</p> | |
| <div class="example"><h3>Ajouter une supervision watchdog à une des unités ci-avant</h3><pre>[Service] | |
| WatchdogSec=30 | |
| Restart=on-failure</pre></div> | |
| </div> | |
| <div id="quickview"><h3 class="directives">Directives</h3> | |
| <p>Ce module ne fournit aucune directive.</p> | |
| <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_systemd">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_systemd">Signaler un bug</a></li></ul></div> | |
| </div> | |
| <div class="bottomlang"> | |
| <p><span>Langues Disponibles: </span><a href="../en/mod/mod_systemd.html" hreflang="en" rel="alternate" title="English"> en </a> | | |
| <a href="../fr/mod/mod_systemd.html" title="Français"> fr </a></p> | |
| </div><div id="footer"> | |
| <p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autorisé sous <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> | |
| <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script><!--//--><![CDATA[//><!-- | |
| if (typeof(prettyPrint) !== 'undefined') { | |
| prettyPrint(); | |
| } | |
| var langToggle = document.querySelector('.lang-toggle'); | |
| var topLang = document.querySelector('.toplang'); | |
| if (langToggle && topLang) { | |
| langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); }); | |
| } | |
| var qv = document.getElementById('quickview'); | |
| if (qv) { | |
| document.body.appendChild(qv); | |
| var qvBtn = document.createElement('button'); | |
| qvBtn.className = 'qv-toggle'; | |
| qvBtn.setAttribute('aria-label', 'Toggle page navigation'); | |
| qvBtn.innerHTML = '☰'; | |
| document.body.appendChild(qvBtn); | |
| qvBtn.addEventListener('click', function() { | |
| var isOpen = qv.classList.toggle('open'); | |
| if (isOpen) { | |
| qv.style.top = window.scrollY + 10 + 'px'; | |
| } | |
| }); | |
| window.addEventListener('scroll', function() { qv.classList.remove('open'); }); | |
| } | |
| //--><!]]></script> | |
| </body></html> |