Administrer avec la ligne de commande

Quelques tâches d'opérateur vivent sur la ligne de commande plutôt que dans l'application web. Cette page liste les commandes artisan dont vous pourriez réellement avoir besoin en exploitant une instance, avec un renvoi vers la page plus complète pour chacune.

Sur une installation Docker, exécutez chaque commande à travers le conteneur web :

docker compose exec app php artisan <command>

Fonctionnement au quotidien

Accorder ou révoquer l'administration de l'instance

php artisan kollek:make-instance-administrator you@example.com
php artisan kollek:make-instance-administrator you@example.com --revoke

Accorde (ou retire) le drapeau d'administrateur à l'échelle du serveur pour l'utilisateur ayant cette adresse e-mail. C'est ainsi que le premier administrateur est amorcé après l'installation. Voyez Accorder l'accès administrateur de l'instance.

Créer un point de terminaison webhook

php artisan kollek:create-webhook-endpoint you@example.com https://example.com/hooks --label="My receiver"

Enregistre un point de terminaison webhook pour un utilisateur et affiche son identifiant et son secret de signature. Les utilisateurs peuvent aussi faire cela eux-mêmes depuis les paramètres de leur profil. Notez qu'aucun événement applicatif ne déclenche encore de webhooks ; voyez Webhooks.

Reconstruire l'index de recherche des photos

php artisan photos:rebuild-search-index

Reconstruit l'index de recherche derrière la bibliothèque de photos et comble les dimensions d'image manquantes. Exécutez-la une fois après une mise à jour vers une version qui introduit l'écran des photos. Elle peut être exécutée à nouveau à tout moment sans risque ; elle ignore les photos dont les fichiers sont manquants et ne change rien d'autre. Voyez Mettre à jour votre instance.

Reconstruire l'index de recherche du compte

php artisan search:rebuild-index

Reconstruit l'index derrière la recherche à l'échelle du compte : objets, collections, exemplaires, photos, prêts, lieux, séries à compléter, sagas, catégories, étiquettes et documents. Exécutez-la une fois après une mise à jour vers une version qui introduit la recherche : la migration crée la table, mais seule cette commande la remplit. Passez --type=item pour ne reconstruire qu'un seul type de fiche. Elle peut être exécutée à nouveau à tout moment sans risque, et c'est aussi le remède si l'index dérive. Voyez Chercher dans tout votre compte.

Purger le cache Cloudflare

php artisan kollek:purge-cloudflare-cache

Supprime toutes les pages publiques que Cloudflare conserve, sinon servies depuis son cache pendant sept jours. Rien n'est perdu : chaque page est rendue à nouveau à la prochaine visite. La commande a besoin de CLOUDFLARE_API_TOKEN et de CLOUDFLARE_ZONE_ID, et le dit quand ils manquent. Le même bouton existe dans le panneau, décrit dans Le panneau d'administration de l'instance.

Amorcer une locale pour la traduction

php artisan kollek:localize fr_FR

Extrait chaque chaîne traduisible de l'application et la synchronise dans le fichier JSON de la locale. Voyez Ajouter une langue.

Réservé au développement

Deux autres commandes existent dans le code source, et aucune n'a sa place sur une instance de production. kollek:bruno réinitialise la base de données avec des données de départ pour les tests de client API, ce qui détruirait de vraies données, et kollek:sync-skills maintient l'outillage propre au projet. Vous pouvez ignorer les deux en tant qu'opérateur.

Et ensuite

• Amorcez votre administrateur dans Accorder l'accès administrateur de l'instance.
• Gardez l'instance à jour avec Mettre à jour votre instance.
• Traduisez l'interface dans Ajouter une langue.