alf.io Download - Download des alf.io Quellcodes

alf.io

JAVA-Quellcode

2.0-M5

Herunterladen

alf.io

Das Open-Source-Ticketreservierungssystem.

Alf.io ([ˈalfjo]) ist ein kostenloses Open-Source-Anwesenheitsmanagementsystem für Veranstaltungen, das für Veranstalter entwickelt wurde, denen Datenschutz, Sicherheit und faire Preispolitik für ihre Kunden am Herzen liegen.

Inhaltsverzeichnis

Voraussetzungen
Federprofile
Im Entwicklungsmodus ausführen
Beitrag zu alf.io
Überprüfen Sie die zu aktualisierenden Abhängigkeiten
Ausführen von Docker-Containern
Mitwirkende

Voraussetzungen

Sie sollten Java Version 17 (z. B. Oracle, OpenJDK oder eine andere Distribution) installiert haben, um alf.io zu erstellen und auszuführen. Bitte beachten Sie, dass für den Build-Prozess das JDK erforderlich ist.

Postgresql-Version 10 oder höher.

Darüber hinaus sollte der Datenbankbenutzer, der die Tabellen erstellt und verwendet, kein „SUPERUSER“ sein, da sonst die Überprüfungen der Zeilensicherheitsrichtlinie nicht angewendet werden.

Notiz

Da die Arbeit an Alf.io v2 begonnen hat, enthält dieser Zweig möglicherweise instabilen und ungetesteten Code. Wenn Sie alf.io selbst erstellen und bereitstellen möchten, beginnen Sie bitte mit einer veröffentlichten Version.

Federprofile

Es gibt folgende Federprofile

dev : Dev-Modus aktivieren
spring-boot : hinzugefügt, wenn es von spring-boot gestartet wird
demo : Aktivieren Sie den Demomodus. Die Konten für den Administrator werden im Handumdrehen erstellt
disable-jobs : Jobs deaktivieren
jdbc-session : Behalten Sie die Benutzersitzung in der Datenbank bei

Im Entwicklungsmodus ausführen

Gradle-Build

Dieser Build enthält eine Kopie des Gradle-Wrappers. Sie müssen Gradle nicht auf Ihrem System installiert haben, um das Projekt zu erstellen. Führen Sie beispielsweise einfach den Wrapper zusammen mit der entsprechenden Aufgabe aus

 ./gradlew clean

Laufen mit mehreren Profilen

Sie müssen in der Befehlszeile eine Projekteigenschaft angeben, z

 ./gradlew -Pprofile=dev :bootRun

Für die lokale Aufgabe „bootRun“ gelten folgende Voraussetzungen:

eine PostgreSQL-Instanz (Version 10 oder höher), die auf localhost:5432 läuft
ein Postgres- Benutzer mit einem Passwort: Passwort
eine Datenbank namens alfio

 docker run -d --name alfio-db -p 5432:5432 -e POSTGRES_PASSWORD=password -e POSTGRES_DB=alfio --restart unless-stopped postgres

Nach dem Start erstellt alf.io alle erforderlichen Tabellen in der Datenbank und ist unter http://localhost:8080/admin verfügbar. Sie können sich mit dem Standardbenutzernamen admin und dem auf der Konsole ausgedruckten Passwort anmelden.

Sie können eine Liste aller unterstützten Gradle-Aufgaben erhalten, indem Sie ausführen

 ./gradlew tasks --all

Sie können zusätzliche Systemeigenschaften konfigurieren (falls Sie diese benötigen), indem Sie die folgende Datei erstellen und darin eine Eigenschaft pro Zeile einfügen:

 vi custom.jvmargs

Bitte beachten Sie, dass diese Datei von Git automatisch ignoriert wird, da sie vertrauliche Informationen enthalten kann (z. B. den privaten API-Schlüssel von Google Maps).

Zum Debuggen

Fügen Sie eine neue Zeile mit: -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005 in custom.jvmargs hinzu

Beitrag zu alf.io

Das Importieren des Gradle-Projekts in Intellij und Eclipse funktioniert beide.

Hinweise :

Dieses Projekt verwendet Project Lombok. Für die Integration in Ihre IDE müssen Sie das entsprechende Lombok-Plugin installieren.
Dieses Projekt verwendet TestContainer, um Integrationstests mit einer echten PostgreSQL-Datenbank durchzuführen. Bitte stellen Sie sicher, dass Ihre Konfiguration ihren Anforderungen entspricht

So konfigurieren Sie TestContainer mit Podman (Fedora 34)

Da TestContainer den Docker-Socket zur Verwaltung der Container erwarten, müssen Sie Folgendes tun (Einzelheiten siehe Originalausgabe):

Definieren Sie die 2 Umgebungen. Variable:

 export TESTCONTAINERS_RYUK_DISABLED=true
export DOCKER_HOST=unix:///run/user/1000/podman/podman.sock

Und in einer anderen Konsole ausführen:

 podman system service -t 0

Zu beachten:

Aus unbekanntem Grund schlagen Testcontainer fehl, wenn Podman die fehlenden Bilder zum ersten Mal herunterlädt. Führen Sie es ein weiteres Mal aus und es wird funktionieren.
Theoretisch sollte der Dienst mit der Systemd+Socket-Aktivierung automatisch starten, aber derzeit konnte ich ihn nicht zum Laufen bringen.

Überprüfen Sie die zu aktualisierenden Abhängigkeiten

./gradlew dependencyUpdates

Ausführen von Docker-Containern

Containerbilder sind unter https://hub.docker.com/r/alfio/alf.io/tags verfügbar.

alf.io kann auch mit Docker Compose ausgeführt werden ( Entwicklungsmodus ):

 docker-compose up

Das Ausführen von alf.io in der Produktion mit Docker Compose wird offiziell nicht unterstützt. Wenn Sie sich jedoch dazu entschließen, müssen Sie einige Änderungen vornehmen:

Kommentieren Sie den alfio -Dienst in der Datei docker-compose.yml aus
Überprüfen Sie den Benutzer und das Passwort für die Dienste in der .env Datei
Behandeln Sie die SSL-Terminierung (z. B. mit etwas wie tutum/haproxy ) 443 -> 8080

Testen Sie die alf.io-Anwendung

Überprüfen Sie die Alfio-Protokolle: docker logs alfio
Kopieren Sie das Administratorkennwort an einen sicheren Ort
Holen Sie sich die IP Ihres Docker-Containers: (nur auf Mac/Windows, unter Linux bindet der Proxy direkt an Ihre öffentliche IP)
- boot2docker IP auf Mac/Windows
Öffnen Sie den Browser unter: https://DOCKER_IP/admin
Geben Sie den Benutzer admin und das gerade kopierte Passwort ein

Generieren Sie eine neue Version des Docker-Images alfio/alf.io

Erstellen Sie eine Anwendung und eine Docker-Datei

 ./gradlew distribution

Alternativ können Sie Docker ( experimentell ) verwenden:

 docker run --rm -u gradle -v "$PWD":/home/gradle/project -w /home/gradle/project gradle:7.0.0-jdk11 gradle --no-daemon distribution -x test

Bitte beachten Sie, dass der obige Befehl im Moment den Build ausführt, ohne die automatisierten Tests auszuführen. Die Nutzung erfolgt auf eigene Gefahr.

Docker-Image erstellen:

 docker build -t alfio/alf.io ./build/dockerize

Über das enthaltene AppleWWDRCAG4.cer

Das Zertifikat unter src/main/resources/alfio/certificates/AppleWWDRCAG4.cer wurde für die https://github.com/ryantenney/passkit4j#usage-Funktionalität importiert. Es läuft am 12.10.2030 (JJJJ-MM-TT – Stand: https://www.apple.com/certificateauthority/) ab.

Mitwirkende

Code-Mitwirkende

Dieses Projekt existiert dank aller Menschen, die dazu beitragen.

Übersetzungsmitarbeiter (POEditor)

Ein großes Dankeschön geht auch an unsere Übersetzer, die uns bei POEditor unterstützen:

(Den vollständigen Namen/Profil zeigen wir nur, wenn wir hierfür eine ausdrückliche Einwilligung erhalten haben)

Sprache	Name	Github	Twitter
Niederländisch (nl)	Matthjis
Türkisch (tr)	Dilek
Spanisch (es)	Mario Varona	@mvarona	@MarioVarona
Spanisch (es)	Sergi Almar	@salmar	@sergialmar
Spanisch (es)	Jeremias
Bulgarisch (bg)	Martin Schekow	@Martin03	@MartensZone
Portugiesisch (pt)	Hugo
Schwedisch (sv)	Johan
Rumänisch (ro)	Daniel
Polnisch (pl)	Pawel
Dänisch (da)	Sune