Astral 360 WSA — Accélérateur de sites

Configuration du module

Mise à jour automatique, tailles de cache par zone, choix de la branche de release.

La page Module Configuration regroupe les paramètres globaux du module WSA — comportement de mise à jour, ressources allouées aux différentes zones de cache, et niveau de stabilité des versions installées.

Accès : Barre latérale → Module Configuration.

💡 Tous les paramètres de cette page s'appliquent à l'ensemble du serveur (tous les comptes cPanel). Pour des ajustements par compte, voir Account Inventory.

Page Configuration du module dans WHM

1. Vue d'ensemble

La page contient 5 paramètres organisés verticalement :

   ┌──────────────────────────────────────────────────────┐
   │  Module Configuration                                │
   ├──────────────────────────────────────────────────────┤
   │                                                      │
   │  Auto Update                                  [On]   │
   │  Allow WSA to install minor updates                  │
   │  automatically.                                      │
   │                                                      │
   ├──────────────────────────────────────────────────────┤
   │  Dynamic Cache Size           (Default: 512 MB)      │
   │  Memory budget for the dynamic content zone          │
   │                                       [ 512 MB ] ↺   │
   ├──────────────────────────────────────────────────────┤
   │  CSS / JS Cache Size          (Default: 512 MB)      │
   │  Memory budget for static text assets                │
   │                                       [ 512 MB ] ↺   │
   ├──────────────────────────────────────────────────────┤
   │  Media Cache Size             (Default: 1024 MB)     │
   │  Memory budget for images, fonts, media              │
   │                                      [ 1024 MB ] ↺   │
   ├──────────────────────────────────────────────────────┤
   │  Release Tier                 (Default: stable)      │
   │  Which channel of WSA this server tracks             │
   │  [ Stable · 2.2.0 | Current | Edge | Dev ]      ↺    │
   ├──────────────────────────────────────────────────────┤
   │  Changes apply on save. A rebuild may be required    │
   │  for size changes to take effect.                    │
   │                            [ Cancel ]  [ Save ]      │
   └──────────────────────────────────────────────────────┘

Chaque ligne suit le même schéma :

  • Titre du paramètre.
  • (Default: ...) — indication de la valeur par défaut, en petite police grise.
  • Description courte sous le titre.
  • Contrôle à droite (toggle, champ numérique, ou segmenté).
  • Bouton ↺ (undo) — visible uniquement quand la valeur est modifiée ; restaure la valeur par défaut en un clic.

2. Auto Update

   Auto Update                                      [ON]
   Allow WSA to install minor updates automatically.

Champ POST : autoupdate Valeurs : 0 (Off) ou 1 (On) Défaut : 1 (On)

2.1 Effet

Quand On, le module WSA vérifie quotidiennement la dernière version disponible sur sa branche de release (voir §5 Release Tier ci-dessous) et l'installe automatiquement en arrière-plan.

La mise à jour automatique :

  • Tourne via une tâche cron interne (checkModule, intervalle 3600 s).
  • Télécharge la nouvelle version dans un dossier temporaire.
  • Remplace atomiquement le code source.
  • Exécute post_update.php pour les migrations nécessaires.
  • Recharge nginx.
  • N'interrompt aucun site en cours.

2.2 Quand désactiver

  • Environnements certifiés où chaque mise à jour doit passer par une validation manuelle.
  • Sites critiques où l'opérateur préfère contrôler le timing précis (par exemple, éviter une mise à jour en pleine période de pointe e-commerce).
  • Tests sur un serveur de staging avant de propager à la prod.

2.3 Quand laisser activé (recommandé)

Pour la majorité des serveurs en production. Les releases Stable sont testées avant publication, et les correctifs de sécurité (par exemple CVE nginx) sont livrés rapidement par ce canal.

3. Dynamic Cache Size

   Dynamic Cache Size                   (Default: 512 MB)
   Memory budget for the dynamic content zone
   (HTML, API responses).                  [ 512 MB ]  ↺

Champ POST : dynamicSize Valeur : entier (MB) Défaut : 512

3.1 Effet

Taille maximale (en mégaoctets) de la zone de cache dédiée au contenu dynamique — pages PHP/HTML, JSON, API, authentification.

Quand la limite est atteinte, nginx évince les entrées les moins récemment utilisées (LRU) pour faire de la place.

3.2 Recommandations par profil de serveur

Type de serveur Taille recommandée
Petit hébergement (< 50 comptes, sites légers) 256–512 MB
Hébergement moyen (50–200 comptes WordPress) 512–1024 MB
Hébergement gros (200+ comptes, e-commerce) 1024–4096 MB
Serveur dédié à un seul site très traffic 2048–8192 MB

3.3 Effets d'un changement

  • Augmenter la taille : plus de hits, moins d'évictions. Améliore le taux de cache hit.
  • Diminuer la taille : libère du disque. Peut augmenter le taux de cache miss et donc la charge Apache.

⚠️ Une modification de cette valeur nécessite une reconstruction nginx pour être effective (le max_size est émis dans la directive proxy_cache_path du fichier nginx principal). Une bannière jaune le rappelle après l'enregistrement.

4. CSS / JS Cache Size

   CSS / JS Cache Size                  (Default: 512 MB)
   Memory budget for static text assets —
   minified CSS, JS bundles.               [ 512 MB ]  ↺

Champ POST : staticSize Valeur : entier (MB) Défaut : 512

4.1 Effet

Taille maximale de la zone de cache dédiée aux fichiers texte statiques : feuilles de style, scripts JavaScript, fichiers JSON statiques.

4.2 Recommandations

Type de serveur Taille recommandée
Sites moderne avec frameworks JS (React, Vue, Angular) 512–1024 MB
Sites WordPress / Joomla / Drupal classiques 256–512 MB
Sites statiques 128–256 MB

Cette zone tend à se remplir lentement et à offrir un excellent taux de hit car les fichiers CSS/JS ne changent que rarement (quand un thème ou un plugin est mis à jour).

5. Media Cache Size

   Media Cache Size                     (Default: 1024 MB)
   Memory budget for images, fonts and other
   binary media.                          [ 1024 MB ]  ↺

Champ POST : mediaSize Valeur : entier (MB) Défaut : 1024

5.1 Effet

Taille maximale de la zone de cache dédiée aux médias binaires : images (PNG, JPG, WebP, AVIF), polices (WOFF2, WOFF), vidéos, PDF, archives téléchargeables.

C'est généralement la plus grosse zone car les médias représentent la majeure partie du poids d'une page web moderne.

5.2 Recommandations

Type de serveur Taille recommandée
Petit hébergement 512–1024 MB
Hébergement moyen 1024–2048 MB
Hébergement gros (e-commerce, médias) 2048–8192 MB
Sites lourds en vidéo / téléchargements 8192+ MB

5.3 Calcul de référence

Estimation grossière : taille moyenne d'une page × nombre de pages uniques × 1.5. Pour un site WordPress moyen, environ 200 pages uniques × 3 MB de médias par page = 600 MB.

6. Release Tier

   Release Tier                       (Default: stable)
   Which channel of WSA this server tracks for updates.
   [ Stable · 2.2.0 | Current · 2.2.1 | Edge · 2.3.0 | Dev ] ↺

Champ POST : moduleTier Valeurs : stable, current, edge, dev Défaut : stable

6.1 Les quatre canaux

Canal Public cible Risque Fréquence des mises à jour
Stable Production. Versions ayant traversé current et edge sans incident. Très faible. Mensuelle ou trimestrielle.
Current Production légèrement plus à jour. Versions stables récemment publiées. Faible. Quelques fois par mois.
Edge Beta. Pour serveurs de test ou évaluation avant publication officielle. Modéré — possibles bugs résiduels. Hebdomadaire à bi-mensuelle.
Dev Développement actif. Réservé à l'équipe Astral Internet. Élevé — instable. Quotidienne.

À droite de chaque option, le numéro de version actuellement publié sur ce canal est affiché si disponible (par exemple, Stable · 2.2.0).

6.2 Effet du changement

Quand vous changez de canal et enregistrez :

  • Le module met à jour son fichier de configuration interne.
  • À la prochaine vérification de mise à jour (automatique quotidienne, ou manuelle via Update WSA), il télécharge la dernière version du nouveau canal.
  • Si le nouveau canal a une version plus récente, le module se met à jour.
  • Si le nouveau canal a une version plus ancienne, aucun downgrade automatique n'est effectué — vous restez sur la version installée.

6.3 Recommandations

  • Production normale : stable.
  • Pour bénéficier des dernières fonctionnalités sans attendre : current.
  • Pour tester en amont (serveur de staging) : edge.
  • Astral team uniquement : dev.

⚠️ Passer de stable à edge peut installer une beta non-testée au prochain auto-update. Faire une sauvegarde avant de basculer sur un serveur de production.

   Changes apply on save. A rebuild may be required
   for size changes to take effect.
                                    [ Cancel ]  [ Save changes ]

7.1 Bouton Cancel

Annule toutes les modifications non sauvegardées et retourne au tableau de bord. Aucune confirmation demandée — les valeurs non enregistrées sont simplement perdues.

7.2 Bouton Save changes

Sauvegarde toutes les valeurs modifiées :

  1. Validation côté client — chaque champ numérique est contrôlé (entier positif, dans la plage attendue). Si une erreur est détectée, une bordure rouge l'indique et la sauvegarde est bloquée.
  2. POST vers le dispatcher WHM — mod-action=save-mod- setting.
  3. Validation côté serveur — double-check des valeurs (les méthodes wsa::Set* valident à nouveau).
  4. Écriture en base SQLite des nouvelles valeurs.
  5. Reconstruction nginx si le moduleTier a changé (lance wsa --update --verbose streamé).
  6. Bannière de succès sur la page rafraîchie, listant les options modifiées.

7.3 Champs requérant un rebuild

Champ Impact
Auto Update Aucun rebuild nécessaire. Effet immédiat.
Dynamic Cache Size Rebuild nécessaire pour appliquer la nouvelle taille.
CSS/JS Cache Size Rebuild nécessaire.
Media Cache Size Rebuild nécessaire.
Release Tier Aucun rebuild nginx, mais déclenche une vérification de mise à jour.

Si vous avez changé une taille, exécutez ensuite Rebuild Nginx conf depuis le tableau de bord pour appliquer la nouvelle configuration.

8. Architecture interne (informatif)

Pour les administrateurs curieux, les paramètres sont persistés dans la base SQLite /etc/wsa/conf/wsa.sqlite, table options :

Clé SQLite Type Source UI
autoupdate string (0/1) Auto Update toggle
dynamic_cache_size int (MB) Dynamic Cache Size
cssjs_cache_size int (MB) CSS/JS Cache Size
other_cache_size int (MB) Media Cache Size
update_branch string Release Tier

Une intervention manuelle est possible via :

sqlite3 /etc/wsa/conf/wsa.sqlite \
    "UPDATE options SET value='1024' WHERE option='dynamic_cache_size';"

…mais fortement déconseillée : les valeurs ne sont alors plus en sync avec ce que l'UI affiche, et une reconstruction nginx est requise pour appliquer le changement.

9. Pour aller plus loin