Docker-Einrichtung und Bereitstellung

Diese Anleitung erklärt, wie Sie die JudaicaLink-Projekte mit Docker und Docker Compose einrichten und bereitstellen. Diese Konfiguration ermöglicht das Ausführen aller Dienste in isolierten Containern für eine einfache Bereitstellung und Verwaltung.

Systemanforderungen

Stellen Sie sicher, dass Ihr System die folgenden Anforderungen erfüllt:

Docker: Neueste Version (Docker-Installationsanleitung)
Docker Compose: Neueste Version (Docker Compose Installationsanleitung)

Repository klonen

Zuerst das Haupt-Docker-Repository für JudaicaLink klonen:

git clone https://github.com/judaicalink/docker.git
cd docker

Einrichten der Umgebung

Erstellen Sie eine .env-Datei, um Umgebungsvariablen zu speichern:

cp .env.example .env
nano .env

Passen Sie die Variablen an Ihre Konfiguration an, einschließlich Datenbankzugangsdaten und Dienstkonfigurationen.

Docker-Container ausführen

Container erstellen und starten:

docker-compose up -d --build

Laufende Container überprüfen:

docker ps

Logs für Fehlerbehebung anzeigen:

docker-compose logs -f

In Docker Compose enthaltene Dienste

Die docker-compose.yml-Datei enthält die folgenden Dienste:

Django-Anwendung (JudaicaLink Labs & Pubby)
PostgreSQL (Datenbank-Backend für Django)
Solr (Volltextsuchmaschine)
Redis (Caching-Schicht für Django)
Apache Jena Fuseki (SPARQL-Endpunkt)
Nginx (Reverse Proxy zur Bereitstellung der Anwendung)

Verwaltung von Docker-Containern

Alle laufenden Container stoppen:

docker-compose down

Container neu starten:

docker-compose restart

Container nach Änderungen neu erstellen:

docker-compose up -d --build

Interaktion mit Diensten

Datenbankmigrationen ausführen

Django-Migrationen im Container ausführen:

docker-compose exec web python manage.py migrate

Statische Dateien sammeln

Statische Dateien für Django sammeln:

docker-compose exec web python manage.py collectstatic --noinput

Eine Bash-Shell innerhalb eines Containers ausführen

Eine Shell im Django-Container öffnen:

docker-compose exec web bash

Solr in Docker ausführen

Um auf das Solr-Admin-Panel zuzugreifen:

URL: http://localhost:8983/solr

Um einen neuen Solr-Kern zu erstellen:

docker-compose exec solr solr create -c judaicalink

Apache Jena Fuseki in Docker ausführen

Um auf die Fuseki-Weboberfläche zuzugreifen:

URL: http://localhost:3030

Um RDF-Daten in Fuseki zu laden:

curl -X POST --data-binary @data.rdf -H "Content-Type: application/rdf+xml" http://localhost:3030/ds/data

Nginx in Docker ausführen

Nginx dient als Reverse-Proxy für die Django-Anwendung. Um Nginx neu zu laden:

docker-compose exec nginx nginx -s reload

Überprüfen der Einrichtung

Nach der Bereitstellung überprüfen, ob die Dienste korrekt ausgeführt werden:

Django Application: http://localhost
SPARQL-Endpunkt (Fuseki): http://localhost:3030/ds
Solr-Admin-Oberfläche: http://localhost:8983/solr
Redis-Status:

docker-compose exec redis redis-cli ping

Fehlersuche & Unterstützung

Container startet nicht? Protokolle mit docker-compose logs -f überprüfen
Datenbankverbindungsfehler? Stellen Sie sicher, dass PostgreSQL im Container ausgeführt wird
Anwendung nicht erreichbar? Nginx-Einstellungen überprüfen und Dienste neu starten
Brauchen Sie Hilfe? Kontaktieren Sie uns unter https://labs.judaicalink.org/contact/

— Mit Docker ist die Bereitstellung und Verwaltung der JudaicaLink-Dienste einfach. 🚀