... | ... | @@ -5,12 +5,14 @@ |
|
|
## Docker Schnellstart
|
|
|
Dies ermöglicht das schnelle Aufsetzen einer lokalen Demoversion. Der Docker Container enthält einen [Apache](https://httpd.apache.org/) Webserver, installiert alle notwendigen Abhängigkeiten und legt die notwendigen Ordnerstrukturen an.
|
|
|
|
|
|
Die folgenden Schritte müssen ausgeführt werden:
|
|
|
|
|
|
1. Das Repository mit Git klonen oder ein Release herunterladen (siehe [Releases](https://zivgitlab.uni-muenster.de/secdoc/secdoc/-/releases)) und entpacken.
|
|
|
|
|
|
```bash
|
|
|
git clone https://zivgitlab.uni-muenster.de/secdoc/secdoc.git
|
|
|
# Oder
|
|
|
wget -O https://zivgitlab.uni-muenster.de/secdoc/secdoc/-/archive/v1.5.2/secdoc-v1.5.2.zip secdoc.zip
|
|
|
wget -O https://zivgitlab.uni-muenster.de/secdoc/secdoc/-/archive/v1.8.1/secdoc-v1.8.1.zip secdoc.zip
|
|
|
unzip secdoc.zip
|
|
|
```
|
|
|
2. Docker Container bauen und starten.
|
... | ... | @@ -29,15 +31,22 @@ docker container rm secdoc-app |
|
|
```
|
|
|
### Docker Produktivinstallation
|
|
|
|
|
|
Um die Konfigurationen und die Datenbank persistent zu speichern, müssen diese aus dem Docker-Container ausgelagert werden. Hierfür können die folgenden Befehle zum Starten des Containers genutzt werden. Der Startbefehl bildet den Container-internen Ordner `/var/www/secdoc`, welcher die Konfiguration, die Datenbank und gespeicherte PDFs enthält, auf den Host-Ordner `/data/secdoc` ab. So bleiben die Daten lokal in `/data/secdoc` erhalten, selbst wenn der Container gelöscht wird.
|
|
|
Um die Konfigurationen und die Datenbank persistent zu speichern, müssen diese aus dem Docker-Container ausgelagert werden. Hierfür können die folgenden Befehle zum Starten des Containers genutzt werden. Der Startbefehl bildet den Container-internen Ordner `/var/www/secdoc`, welcher die Konfiguration, die Datenbank und gespeicherte PDFs enthält, auf den Host-Ordner `/data/secdoc` ab. So bleiben die Daten lokal in `/data/secdoc` erhalten, selbst wenn der Container gelöscht wird. Der Pfad auf dem Host-System kann natürlich beliebig gewählt werden.
|
|
|
|
|
|
```bash
|
|
|
# Notwendige Ordnerstruktur anlegen
|
|
|
mkdir /data/secdoc /data/secdoc/PDF /data/secdoc/sessions /data/secdoc/inc
|
|
|
|
|
|
# Die Demo-Datenbank und Konfiguration kopieren
|
|
|
cp assets/ajax/secdoc.conf.php /data/secdoc/secdoc.conf.php
|
|
|
cp assets/demo.db /data/secdoc/demo.db
|
|
|
|
|
|
# Container starten
|
|
|
docker run -d -p 127.0.0.1:80:80 --name secdoc-app --volume=/data/secdoc:/var/www/secdoc secdoc
|
|
|
|
|
|
# Den Besitzer und die Rechte der Ordner anpassen
|
|
|
docker exec secdoc-app chmod -R 755 /var/www/secdoc
|
|
|
docker exec secdoc-app chown -R www-data /var/www/secdoc
|
|
|
docker run -d -p 127.0.0.1:80:80 --name secdoc-app --volume=/data/secdoc:/var/www/secdoc secdoc
|
|
|
```
|
|
|
|
|
|
Zum erneuten Starten des Containers genügt der Aufruf von `docker run -d -p 127.0.0.1:80:80 --name secdoc-app --volume=/data/secdoc:/var/www/secdoc secdoc`. Konfigurationen können lokal in der Datei `/data/secdoc/secdoc.conf.php` vorgenommen werden und werden automatisch eingebunden.
|
... | ... | @@ -59,7 +68,7 @@ Auf dem Webserver müssen folgende Abhängigkeiten installiert sein: |
|
|
cd /var/www/html
|
|
|
git clone https://zivgitlab.uni-muenster.de/secdoc/secdoc.git
|
|
|
# Oder
|
|
|
wget -O https://zivgitlab.uni-muenster.de/secdoc/secdoc/-/archive/v1.5.2/secdoc-v1.5.2.zip secdoc.zip
|
|
|
wget -O https://zivgitlab.uni-muenster.de/secdoc/secdoc/-/archive/v1.8.1/secdoc-v1.8.1.zip secdoc.zip
|
|
|
unzip secdoc.zip
|
|
|
```
|
|
|
|
... | ... | @@ -87,4 +96,4 @@ chmod -R 755 $SDPATH |
|
|
|
|
|
4. SecDoc sollte nun im Demo-Modus auf dem Webserver verfügbar sein und es kann mit der Konfiguration fortgefahren werden.
|
|
|
|
|
|
> :warning: **Achtung:** Wenn keine weitere Konfiguration vorgenommen wird, muss das Installationsskript [install.php](https://zivgitlab.uni-muenster.de/secdoc/secdoc/-/blob/master/install.php) unbedingt gelöscht oder unbrauchbar gemacht werden (z.B. durch Umbennenung), da es keinen Zugriffsschutz besitzt! |
|
|
\ No newline at end of file |
|
|
> :warning: **Achtung:** Sobald keine weitere Konfiguration vorgenommen wird, muss das Installationsskript [install.php](https://zivgitlab.uni-muenster.de/secdoc/secdoc/-/blob/master/install.php) unbedingt gelöscht oder unbrauchbar gemacht werden (z.B. durch Umbennenung), da es keinen Zugriffsschutz besitzt! |
|
|
\ No newline at end of file |