Mit der Kommandozeile verwalten

Ein paar Betreiberaufgaben leben auf der Kommandozeile statt in der Web-App. Diese Seite listet die Artisan-Befehle auf, die du beim Betrieb einer Instanz tatsächlich brauchen könntest, mit einem Verweis auf die ausführlichere Seite zu jedem davon.

Bei einer Docker-Installation führst du jeden Befehl über den Web-Container aus:

docker compose exec app php artisan <command>

Alltäglicher Betrieb

Instanzadministration gewähren oder entziehen

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

Gewährt (oder entzieht) das serverweite Administrator-Flag für den Benutzer mit dieser E-Mail-Adresse. So wird der erste Administrator nach der Installation eingerichtet. Siehe Instanzadministrator-Zugriff gewähren.

Einen Webhook-Endpunkt erstellen

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

Registriert einen Webhook-Endpunkt für einen Benutzer und gibt dessen ID und Signaturschlüssel aus. Benutzer können das auch selbst aus ihren Profileinstellungen heraus tun. Beachte, dass momentan noch kein Anwendungsereignis Webhooks auslöst, siehe Webhooks.

Den Fotosuche-Index neu aufbauen

php artisan photos:rebuild-search-index

Baut den Suchindex hinter der Fotobibliothek neu auf und füllt fehlende Bildabmessungen nach. Führe ihn einmal aus, nachdem du auf eine Version aktualisiert hast, die den Fotobildschirm einführt. Er kann jederzeit gefahrlos erneut ausgeführt werden, überspringt Fotos, deren Dateien fehlen, und ändert sonst nichts. Siehe Deine Instanz aktualisieren.

Den Kontosuche-Index neu aufbauen

php artisan search:rebuild-index

Baut den Index hinter der kontoweiten Suche neu auf, über Objekte, Sammlungen, Exemplare, Fotos, Leihgaben, Standorte, Sets, Reihen, Kategorien, Schlagwörter und Dokumente hinweg. Führe ihn einmal aus, nachdem du auf eine Version aktualisiert hast, die die Suche einführt: Die Migration legt die Tabelle an, gefüllt wird sie aber nur hiervon. Mit --type=item baust du nur eine Art von Datensatz neu auf. Er kann jederzeit gefahrlos erneut ausgeführt werden und ist auch die Abhilfe, falls der Index abdriftet. Siehe Das ganze Konto durchsuchen.

Den Cloudflare-Cache leeren

php artisan kollek:purge-cloudflare-cache

Verwirft alle öffentlichen Seiten, die Cloudflare vorhält und sonst sieben Tage lang aus seinem Cache ausliefert. Nichts geht verloren: jede Seite wird beim nächsten Besuch neu gerendert. Der Befehl braucht CLOUDFLARE_API_TOKEN und CLOUDFLARE_ZONE_ID und sagt es, wenn sie fehlen. Denselben Knopf gibt es im Panel, beschrieben in Das Instanzadministrationspanel.

Ein Sprachgebiet für die Übersetzung anlegen

php artisan kollek:localize fr_FR

Extrahiert jeden übersetzbaren String der Anwendung und gleicht ihn mit der JSON-Datei des Sprachgebiets unter lang/ ab. Siehe Eine Sprache hinzufügen.

Nur für die Entwicklung

Es gibt zwei weitere Befehle im Code, und keiner davon gehört auf eine Produktivinstanz. kollek:bruno setzt die Datenbank mit Seed-Daten für das Testen von API-Clients zurück, was echte Daten zerstören würde, und kollek:sync-skills pflegt das eigene Tooling des Projekts. Als Betreiber kannst du beide ignorieren.

Wie es weitergeht

• Richte deinen Administrator ein in Instanzadministrator-Zugriff gewähren.
• Halte die Instanz aktuell mit Deine Instanz aktualisieren.
• Übersetze die Oberfläche in Eine Sprache hinzufügen.