[Documentation] Commandes Celery about geonature HOT 5 OPEN

Oui pour parler de Celery dans la partie "Supervision des services" de la doc de GeoNature.
Pas pour ajouter de la doc de développement de GeoNature dans les README de modules, car ensuite c'est vite plus à jour, etc...
Privilégier de la mettre dans la doc de développement de GeoNature, car c'est un sujet global, des commandes de GeoNature et pas spécifique à ces modules.

from geonature.

Les administrateurs lambda ne sont pas censés devoir connaitre le fonctionnement ni avoir à lancer Celery.
Dans le module Export, après installation du module, ils doivent juste redémarrer les services pour prendre en compte les nouvelles taches déclarées par l'Export, mais selon moi, ils n'ont pas besoin de lancer Celery, au-delà de la doc existante sur l'installation du module.
Ou alors, j'ai raté quelque chose ?

from geonature.

Du côté administrateur, je rejoins @camillemonchicourt, il n'y a pas besoin d'expliquer le fonctionnement de Celery, toutefois, il peut être intéressant de mentionner comment démarrer le geonature-worker ? Peut-être compléter cette section ? https://docs.geonature.fr/admin-manual.html?highlight=geonature+worker#exploitation

Pour le lancement de celery en mode-dev, je suis pour 👍 Même si, on peut le deviner en fouillant dans la déclaration du service, ça peut faire gagner du temps !

Pour l'export, le lancement du worker Celery est indiqué dans la documentation https://github.com/PnX-SI/gn_module_export/blob/master/README.md#installation-du-module .

from geonature.

Il m'est arrivé d'avoir un dysfonctionnement inexpliqué d'un import ou d'un export. En fait le worker était en rade. Et c'est très silencieux comme disfonctionnement. On peut le savoir en consultant le statut du worker.
Mais effectivement, pour faire ça, il faut avoir accès au serveur en ligne de commande.
Je pense qu'il n'est inutile d'expliquer comment consulter le statut et démarrer ou redémarrer le worker si besoin.
A noter :
Il y a deux niveaux d'administrateur. Celui qui gère GN via l'interface avec des droits admin et celui qui a un accès root au serveur.
Parfois c'est la même personne, parfois ce sont 2 personnes différentes. Quand on parle d'administrateur, il faut avoir cette distinction en tête.

from geonature.

Merci pour vos retours rapides,

Concernant le Manuel Administrateur, on pourrait rajouter ceci dans la section Supervision des services :

• Vérifier que le worker Celery tourne pour éxecuter les tâches asynchrones (génération des imports et des exports) : sudo systemctl status geonature-worker. Le lancer avec sudo systemctl restart geonature-worker si ce n'est pas le cas.

Je rajouterai dans la section Commandes d'installation du README du module Export, et dans la section Installation du module du README du module Import :

"Si vous installez le module en mode développement et que vous n'avez pas installé systemd, il vous faudra lancer Celery avec cette commande : celery -A geonature.celery_app:app worker."

from geonature.