Clustraly
Cocon sémantique & topic clusters

Vos builds avancent tout seuls : configuration du déclencheur worker (cron système + token web-cron)

Configuration du déclencheur worker (cron système + token web-cron) est une fonctionnalité du module Cocon sémantique & topic clusters de Clustraly. La configuration du déclencheur worker relie un cron système ou une URL web-cron sécurisée par token au scheduler, qui fait avancer vos builds automatiquement.

Le worker cocon_build se replanifie tout seul — encore faut-il lui donner un battement. Reliez-le à un cron système ou à une URL web-cron secrète : vos cartes topiques se construisent sans que vous restiez devant l'écran.

Le worker garde le rythme

Vos builds avancent, tick après tick

Le worker cocon_build se remet en file tout seul, mais il lui faut un déclencheur pour repartir. Ce déclencheur donne ce battement : à chaque passage, il exécute le tick du scheduler, qui reprend le prochain job en file et pousse votre carte vers l'état prêt.

Résultat : qu'il s'agisse d'une petite carte ou d'un très grand graphe, le build résumable progresse en arrière-plan, sans requête HTTP à garder ouverte ni intervention de votre part.

  • Exécute le tick du scheduler à chaque passage
  • Reprend le prochain job en file automatiquement
  • Aucune requête HTTP à garder ouverte
Deux options, clé en main

Cron système ou URL web-cron : vous choisissez

Option A — un crontab système appelle la commande exacte « php bin/console cron:run ». Aucun token requis en CLI.

Option B — une URL web-cron secrète « /cron/run?token=… » que vous branchez sur n'importe quel planificateur externe. L'écran affiche les instructions de chaque option, prêtes à copier.

  • Option A : crontab appelant php bin/console cron:run
  • Option B : URL secrète /cron/run?token=…
  • Instructions affichées avec bouton de copie
Le token, sous votre main

Générez, faites tourner, désactivez le token web-cron

Un clic génère le token web-cron et son URL. Besoin de le renouveler ? La rotation produit un nouveau token et remplace l'ancien lien. Vous n'utilisez pas l'URL publique ? Désactivez le token d'un geste.

L'endpoint accepte soit le CRON_TOKEN de votre fichier .env, soit le web_token stocké en base : à vous de décider quelle clé fait autorité.

  • Génération et rotation du token en un clic
  • Désactivation complète du token web-cron
  • Accepte le CRON_TOKEN (.env) ou le web_token (base)
Adapté à votre hébergement

Le bon déclencheur pour chaque environnement

Serveur avec accès shell et crontab ? Partez sur l'Option A et son appel CLI, sans jamais exposer de token. Hébergement managé ou plateforme sans cron natif ? L'URL web-cron secrète se branche sur un planificateur externe.

Vous restez maître du mode qui colle à votre infrastructure, et vous en changez quand elle évolue.

  • Serveur avec crontab → commande CLI, sans token
  • Plateforme sans cron natif → URL web-cron secrète
  • Vous basculez d'une option à l'autre à tout moment
Garde-fous

Un déclencheur atteignable, mais verrouillé

L'URL /cron/run est publique, sa clé ne l'est pas. La comparaison du token passe par hash_equals, la rotation coupe l'ancien lien, et la désactivation ferme entièrement la porte. En mode CLI, aucun token ne circule.

La configuration elle-même reste sur l'écran admin protégé de la file de builds : c'est vous qui ouvrez ou fermez l'accès.

  • Comparaison du token via hash_equals
  • Rotation et désactivation quand vous le décidez
  • Zéro token exposé en mode CLI
  • Réglage réservé à l'admin de la file de builds
Pourquoi ça compte

L'IA propose, vous décidez — même pour le déclencheur

Clustraly prépare la commande, le token et l'URL prêts à copier. À vous de choisir le mode qui correspond à votre serveur, et de couper l'accès dès que vous le souhaitez.

FAQ

Questions fréquentes

Faut-il un token pour le cron système ?
Non. La commande CLI « php bin/console cron:run » s'exécute sans token. Le token web-cron ne sert qu'à l'URL publique /cron/run, utile quand vous n'avez pas d'accès crontab.
Que se passe-t-il quand je fais tourner (rotate) le token ?
La rotation génère un nouveau token et son URL, et remplace l'ancien lien. Pensez à mettre à jour votre planificateur externe avec la nouvelle URL copiée.
Comment l'URL web-cron reste-t-elle sécurisée ?
Le token est comparé via hash_equals, l'endpoint accepte soit le CRON_TOKEN du .env soit le web_token en base, et vous pouvez le désactiver à tout moment depuis l'écran de la file de builds.
Le déclencheur construit-il l'arbre lui-même ?
Non. Il exécute le tick du scheduler, qui reprend le prochain job en file. C'est le worker cocon_build qui étend la carte, de façon résumable et checkpointée.
Prêt à commencer ?

Branchez le déclencheur, laissez vos cocons se construire

Choisissez le cron système ou l'URL web-cron, copiez les instructions fournies, et vos cartes topiques avancent d'elles-mêmes. Vous gardez la main sur le token : générez-le, faites-le tourner ou coupez-le quand vous voulez.