IRIS Installation (Docker): Unterschied zwischen den Versionen

Aus Wiki - Heidler Strichcode GmbH
Zur Navigation springen Zur Suche springen
Zeile 48: Zeile 48:
  
 
==== Container aus Image erstellen ====
 
==== Container aus Image erstellen ====
 
===== Option 1 - Integrierter HTTPS Server =====
 
Es wird der interne HTTPS-Server innerhalb des Docker-Containers verwendet
 
docker create --name iris --network bridge --hostname iris --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
 
 
===== Option 2 - Externer Reverse Proxy =====
 
Ein externer Reverse Proxy wird verwendet, nimmt alle externen Anfragen entgegen, und gibt diese an den Docker-Container an Port 8080 weiter
 
 
  docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
 
  docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
  
Zeile 66: Zeile 59:
 
  docker logs iris
 
  docker logs iris
  
 +
==== Reverse Proxy konfigurieren ====
 +
Es muss ein bereits mit HTTPS konfigurierter Reverse Proxy eingerichtet sein.
 +
 +
Wir können den SSL-Config Generator von Mozilla hierfür empfehlen: https://ssl-config.mozilla.org/
 +
 +
IRIS kann auch mit HTTP/2 betrieben und richtet sich bei den meisten Konfigurationen an die Vorgabe von nginx.
 +
 +
 +
Bitte prüfen Sie vor der Konfiguration der Verknüpfung von nginx -> iris, ob eine gültige HTTPS Verbindung mit einer statischen Seite hergestellt werden kann.
 +
 +
 +
Danach können Sie den "location /" Eintrag wie folgt abändern.<blockquote> <code>   location / {</code>
 +
 +
<code>       proxy_pass      <nowiki>https://localhost:8080</nowiki>;</code>
 +
 +
<code>       proxy_read_timeout               300;</code>
 +
 +
<code>       proxy_connect_timeout            300;</code>
 +
 +
<code>       proxy_set_header                 X-Real-IP                                       $remote_addr;</code>
 +
 +
<code>       proxy_set_header                 X-Forwarded-For                                 $proxy_add_x_forwarded_for;</code>
 +
 +
<code>       proxy_set_header                 Host                                            $host;</code>
 +
 +
<code>       proxy_ssl_verify                 off;</code>
 +
 +
<code>   }</code></blockquote>
  
  
Zeile 92: Zeile 113:
  
 
==== Neuen IRIS Container mit neuer Version erstellen ====
 
==== Neuen IRIS Container mit neuer Version erstellen ====
 
===== Option 1 - Integrierter HTTPS Server =====
 
Es wird der interne HTTPS-Server innerhalb des Docker-Containers verwendet
 
docker create --name iris --network bridge --hostname iris --publish 80:80 --publish 443:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
 
 
===== Option 2 - Externer Reverse Proxy =====
 
Ein externer Reverse Proxy wird verwendet, nimmt alle externen Anfragen entgegen, und gibt diese an den Docker-Container an Port 8080 weiter
 
 
  docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
 
  docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X
  

Version vom 25. Januar 2023, 17:13 Uhr

Hinweise

IRIS Version

Im folgenden Text finden Sie viele Befehle, die die aktuelle Version von IRIS enthalten.

Bitte ersetzen Sie die Version durch die jeweils verfügbare aktuellste Version von IRIS.


Beispiel:

docker load -i iris-1.X.X.tar.gz

zu

docker load -i iris-1.0.8.tar.gz

bzw. die jeweils aktuellste Version

Docker auf Linux

Diese Beschreibung nimmt eine Installation von Docker auf Linux an.

Für andere Betriebssysteme müssen die Befehle oder Schritte entsprechend abgeändert werden.

Üblicherweise sind für Docker-Installationen auf Linux Admin-Berechtigungen erforderlich.

Die meisten Befehle benötigen deshalb ein "sudo" davor oder müssen als root User ausgeführt werden.


Erstinstallation

Herunterladen / Kopieren von IRIS

Sie erhalten den Downloadlink von IRIS von unserem Support


Zum Hochladen des Container-Images können Sie die Datei per scp in das Home-Verzeichnis des Docker-Hosts hochladen:

scp iris-1.X.X.tar.gz <Benutzername>@<Servername>:~/


Alternativ direkt über den Downloadlink auf der Maschine herunterladen:

wget <Downloadlink>

IRIS Docker Image laden

docker load -i iris-1.X.X.tar.gz

Volumes und Netzwerke vorbereiten

docker volume create hsc-db
docker volume create hsc-config
docker network create hsc-network

Container aus Image erstellen

docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X

Netzwerk verbinden

docker network connect hsc-network iris

Container starten

docker start iris

Logs des Containers prüfen

docker logs iris

Reverse Proxy konfigurieren

Es muss ein bereits mit HTTPS konfigurierter Reverse Proxy eingerichtet sein.

Wir können den SSL-Config Generator von Mozilla hierfür empfehlen: https://ssl-config.mozilla.org/

IRIS kann auch mit HTTP/2 betrieben und richtet sich bei den meisten Konfigurationen an die Vorgabe von nginx.


Bitte prüfen Sie vor der Konfiguration der Verknüpfung von nginx -> iris, ob eine gültige HTTPS Verbindung mit einer statischen Seite hergestellt werden kann.


Danach können Sie den "location /" Eintrag wie folgt abändern.

   location / {

       proxy_pass      https://localhost:8080;

       proxy_read_timeout               300;

       proxy_connect_timeout            300;

       proxy_set_header                 X-Real-IP                                       $remote_addr;

       proxy_set_header                 X-Forwarded-For                                 $proxy_add_x_forwarded_for;

       proxy_set_header                 Host                                            $host;

       proxy_ssl_verify                 off;

   }


Updates

Herunterladen / Kopieren von IRIS

Sie erhalten den Downloadlink von IRIS von unserem Support


Zum Hochladen des Container-Images können Sie die Datei per scp in das Home-Verzeichnis des Docker-Hosts hochladen:

scp iris-1.X.X.tar.gz <Benutzername>@<Servername>:~/


Alternativ direkt über den Downloadlink auf der Maschine herunterladen:

wget <Downloadlink>

Docker Image laden

docker load -i iris-1.X.X.tar.gz

IRIS stoppen

Achtung: Ab hier ist IRIS für ca. 1 Minute nicht erreichbar

sudo docker stop iris

IRIS Container löschen

sudo docker rm iris

Neuen IRIS Container mit neuer Version erstellen

docker create --name iris --network bridge --hostname iris --publish 127.0.0.1:8080:443 --volume hsc-db:/var/lib/mysql --volume hsc-config:/etc/heidler --restart unless-stopped iris:1.X.X

Netzwerk verbinden

docker network connect hsc-network iris

Container starten

docker start iris

Altes Container-Image entfernen

Achtung! Im folgenden Befehl die Version 1.X.X durch die vorherige (nicht aktuelle) Version von IRIS ersetzen

docker image rm iris:1.X.X