Solution de contournement pour la page de maintenance - est-ce possible ?

Soutien Installation
23

Haha, je suis ravi que tu aies posé la question, car je n’avais pas pris le temps d’expliquer cette partie (j’aurais dû – il y a beaucoup de choses à expliquer et Cloudflare est complexe !)

Lorsque la page de route des workers est configurée, chaque chargement d’image et chaque consultation de page sur le forum est acheminé via ce worker.

Le plan CDN gratuit de Cloudflare inclut une limite de 100 000 requêtes/jour sur une route de worker.

Ainsi, si vous avez un forum relativement actif, afin d’éviter d’atteindre la limite de votre offre gratuite en une seule journée, il est judicieux de ne pas la laisser activée en permanence. Il s’agit uniquement de la route du worker, et non de la page de maintenance – vous pouvez laisser la page de maintenance en place en permanence – elle n’est sollicitée que si vous avez activé la route du worker. Il s’agit simplement de l’étape 2 où vous avez assigné la route (ce qui est facile à configurer et à supprimer). À moins que vous n’utilisiez un plan payant de Cloudflare, il est donc de bonne pratique de ne l’activer que lorsque vous effectuez votre propre maintenance.

  1. Rendez-vous sur la page des routes des workers Cloudflare pour votre domaine et cliquez sur le bouton situé à droite de la route.

Screenshot 2026-08-01 at 5.06.14 PM
Screenshot 2026-08-01 at 5.06.14 PM1652×552 43.9 KB

  1. En bas de l’écran de modification, cliquez sur le bouton remove pour détacher la page du worker de la route.

Screenshot 2026-08-01 at 5.09.01 PM
Screenshot 2026-08-01 at 5.09.01 PM742×658 40.5 KB

  1. Ne vous inquiétez pas, le code du worker lui-même ne sera pas supprimé, uniquement la règle de routage. La prochaine fois que vous effectuerez une reconstruction / mise à jour, vous pourrez simplement la réajouter comme dans l’étape 2 ci-dessus.

Si vous utilisez un plan payant Cloudflare, alors vous n’avez rien à craindre. Cependant, dans ce cas, vous pouvez utiliser les pages d’erreur Cloudflare au lieu d’une page de worker… (ai-je déjà mentionné que Cloudflare est assez complexe ? LOL)

:warning: configuration avancée pour administrateur ci-dessous

Si l’on souhaite automatiser complètement ses mises à jour sur le plan gratuit, il faut utiliser un jeton API Cloudflare, son identifiant de zone et une commande curl pour obtenir l’identifiant de la route du worker. Ensuite, modifiez le script /root/update-web.sh avec quelques fonctionnalités supplémentaires pour activer et désactiver automatiquement la route du worker :

#!/bin/bash
cd /var/discourse

CF_TOKEN="votre_vrai_jeton_ici" #<---Jeton API Cloudflare
ZONE_ID="xxxx" #<---Depuis votre page de profil Cloudflare
ROUTE_ID="xxxx"
WORKER_NAME="ma-page-de-maintenance-site"

echo "➡️ Téléchargement des derniers scripts Docker Discourse..."
git pull

echo "➡️ Initialisation du nouveau conteneur web en arrière-plan..."
./launcher bootstrap web_only

if [ $? -eq 0 ]; then
    echo "✅ Initialisation réussie !"
    
    # Activer le Worker de Maintenance Cloudflare
    echo "🚧 Activation de la page de maintenance..."
    curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/workers/routes/$ROUTE_ID" \
         -H "Authorization: Bearer $CF_TOKEN" \
         -H "Content-Type: application/json" \
         --data '{"pattern":"*votre-site.com/*","script":"'$WORKER_NAME'"}' > /dev/null

    # Échanger les conteneurs (Fenêtre d'indisponibilité de 30 secondes)
    echo "🔄 Échange des conteneurs..."
    ./launcher destroy web_only && ./launcher start web_only
    
    # Désactiver le Worker de Maintenance Cloudflare
    echo "🌍 Désactivation de la page de maintenance..."
    curl -s -X PUT "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/workers/routes/$ROUTE_ID" \
         -H "Authorization: Bearer $CF_TOKEN" \
         -H "Content-Type: application/json" \
         --data '{"pattern":"*votre-site.com/*","script":null}' > /dev/null

    echo "🚀 Terminé ! Site mis à jour avec une indisponibilité invisible.
else
    echo "❌ Échec de l'initialisation ! Abandon de l'échange pour garder le site actuel en ligne."
fi

J’utilise la version précédente du script car je ne souhaite pas tout automatiser et j’aime être présent lors des mises à jour / reconstructions. J’ajoute simplement la route du worker juste avant de faire une mise à jour, puis je la supprime ensuite. Cela ne prend que quelques secondes.

Mes étapes générales sont :

  1. Ajouter la route du worker sur Cloudflare
  2. Se connecter en SSH à Hetzner
  3. Effectuer les mises à jour système (par exemple : sudo apt update && sudo apt upgrade -y, puis redémarrer le serveur si nécessaire)
  4. Se reconnecter en SSH si un redémarrage était nécessaire
  5. Exécuter ./update-web.sh
  6. Supprimer la route du worker sur Cloudflare