5.1 KiB
Ein Projekt anbinden
Zuständigkeiten und Voraussetzungen
Gitea startet das veröffentlichte Werkzeug-Image auf einem Docker-fähigen Runner. Das Projekt beschreibt den Zusammenbau und die Prüfungen seines Pakets. Der Manager übernimmt den allgemeinen Dateideploy nach Strato. Es gibt keinen zusätzlichen Dienst, Port oder API-Aufruf.
Das aktuelle Image enthält PHP 8.4, Composer 2, Node 22/npm, Python 3, Git, SSH, curl und tar. Projekte mit weiteren Werkzeugen oder anderen Hauptversionen sind nicht automatisch unterstützt: zuerst eine passende versionierte Werkzeugumgebung bereitstellen. Vertrag 1 unterstützt Git-Archive ohne Symlinks; Git-Submodule/LFS-Inhalte werden nicht automatisch materialisiert.
Vorgehen
pipeline.tomlnach dem Beispiel im README anlegen.managerauf die bereitgestellte Version setzen, eindeutigen Projektnamen wählen.prepare: Abhängigkeiten gemäß Lockdateien installieren, externe Quellen reproduzierbar beziehen, Dateien zusammenstellen. Befehle laufen im temporären Export des Git-Commits.test: mindestens einen sinnvollen Testbefehl definieren. Ein Fehler verhindert Paket und Upload. Testdatenbanken vom Server trennen.finalize: Entwicklungsabhängigkeiten entfernen und das Laufzeitpaket fertigstellen. FeWo entfernt hier zusätzliche Sprach-/Dokumentationsdateien wegen Stratos Dateilimit.excludeundrequired: Paket begrenzen und Laufzeit-Pflichtdateien prüfen. Wörtliche relative Pfade verwenden, keine Wildcards..env,.env.*und.gitwerden automatisch ausgeschlossen; sonstige Geheimnisdateien zusätzlich ausschließen und möglichst nie committen.remote.publicauf das öffentliche Verzeichnis setzen.remote.sharedordnet persistente Zielpfade Quellen unter<target>/shared/zu. Diese Quellen müssen vorher existieren. Zu verlinkende Ziele aus dem Paket ausschließen.remote.backupsichert beispielsweise die Datenbank in den persistenten Speicher.remote.activateführt benötigte Migrationen/Cache-Kommandos aus. Hooks sind Argumentlisten;@phpsteht für die PHP-CLI auf Strato. Implizite Shell-Auswertung findet nicht statt; notwendige Shell-Skripte ausdrücklich aufrufen.- Staging-Ziel mit relativem Webspace-Pfad, Branch, HTTPS-URL und geeignetem
health_patheinrichten. Standard ist/up; statische Anwendungen und andere Frameworks müssen den Pfad passend setzen. Healthcheck erwartet HTTP 200, kein projektspezifisches Antwortschema. - Produktion zunächst mit
enabled = falsesperren. Für den vereinbarten Ablaufrequire_merge = trueundsource_branch = "develop"setzen. Code-Rollback ersetzt keine Planung kompatibler Datenbankmigrationen. - Gitea-Secrets anlegen:
DEPLOY_HOST,DEPLOY_USER,DEPLOY_SSH_KEY,DEPLOY_KNOWN_HOSTS; optionalDEPLOY_PORT. Geprüften Hostschlüssel verwenden. Der private Schlüssel gehört ausschließlich in das Secret. examples/gitea-deploy.ymlins Projekt nach.gitea/workflows/deploy.ymlübernehmen und Image-Version, Runner sowie Pfade prüfen..pipeline/in.gitignoreaufnehmen.- Konfiguration mit
pipeline-manager checkprüfen, aufdeveloppushen, Gitea-Lauf bis einschließlich Deployment verfolgen. Danach tatsächlichen Server-Commit, Backup und Website prüfen. Erst dann die Anbindung als erprobt dokumentieren.
Referenz FeWo-Stommer
- Repository: https://gitea.stommer.de/Lars/fewo-stommer, Branch
develop. pipeline.toml: Composer mit Testabhängigkeiten, npm/Vite, temporäre Test-Konfiguration, Feature-Tests auf SQLite im Speicher; anschließend Composer ohne Entwicklungsabhängigkeiten und Paketbereinigung.- PDF-Tests laufen direkt mit
php -d memory_limit=512M vendor/bin/phpunit --testsuite=Feature --no-progress. Das Standardlimit des PHP-Images (128 MB) war zu klein. - Persistent:
.env,storage,public/storage; Backup-Hookartisan backup:database; Aktivierung mit Migrationen und Laravel-/Filament-Caches. - Staging:
test.fewo-stommer.de/, https://stommer.info, PHP/opt/RZphp84/bin/php-cli. - Produktion:
prod.fewo-stommer.de/, gesperrt. Die bestehende WordPress-Installation darf nicht überschrieben werden. - Exakte Laufnachweise stehen in
docs/BETRIEB.md.
Beispiel KarateWiki: geplante Anbindung
Dies ist ein Entwurf, noch kein getestetes Profil. Das Gitea-Projekt kann die festgelegte MediaWiki-Version aus einer externen Quelle mit Prüfsumme bzw. festem Commit beziehen und mit versionierten Erweiterungen sowie nicht geheimen Konfigurationsvorlagen kombinieren. Herkunft und Version aller Bestandteile müssen im Projekt nachvollziehbar bleiben. Die allgemeinen Paket-/Übertragungsschritte ändern sich dadurch nicht.
Vor Umsetzung sind die tatsächliche MediaWiki-Version, Erweiterungen, benötigte PHP-Erweiterungen, Tests und Wartungskommandos zu ermitteln. Uploads und geheime lokale Konfiguration gehören in shared. Datenbank-Backup, Wartungsfenster, Schema-Aktualisierung und ein möglicher Wiederherstellungsweg müssen projektspezifisch festgelegt werden. Keine FeWo-Artisan-Befehle übernehmen. Der öffentliche Verzeichnispfad muss zum zusammengestellten Paket passen; Dateien außerhalb dieses Pfads sind über den Manager-Zugang gesperrt.