Installieren des HTML5-Gateway-Dockers¶
Importieren des Docker-Bildes¶
Bevor Sie einen HTML5-Gateway-Docker-Container erstellen können, müssen Sie das Docker-Image importieren. Um dies zu tun, starten Sie eine Shell, aus der die Docker-Befehle verfügbar sind, sowie die Datei cleanroom-html5-4.6.1-33-v2.tgz. Aus der Shell laufen Sie den folgenden Befehl aus und passen den Pfad zur Datei TGZ an, wenn sie nicht im aktuellen Verzeichnis ist:
1 | |
Dann überprüfen Sie, ob der Import erfolgreich war, mit dem folgenden Befehl:
1 | |
Die erwartete Produktion ist wie folgt: Wenn dies nicht der Fall ist, ist der Import gescheitert:
1 2 3 4 5 6 | |
Vollständige Ausgabe
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 | |
Konfiguration des Behälters¶
Umweltvariablen¶
Variablen für die Bereitstellung durch Paarung¶
| Name | Pflicht | Standardwert | Kommentar |
|---|---|---|---|
ENV_MEDIATION |
JA | Für die Paarung von Verbindungen verwendet. Zeigt den DNS-Namen oder die IP-Adresse an, um eine Verbindung zur Web-Schnittstelle einer ** Cyber** Elemente Cleanroom Plattform herzustellen. |
|
ENV_TOKEN |
JA | Für die Verbindung zum Pairing verwendet. Angabe des Pairing-Token, der für die Verbindung zum Mediation Controller verwendet wird. |
|
ENV_NO_CHECK_CERT |
NO | false |
Für die Paarung von Verbindungen verwendet. Die Prüfung von Mediation Controller Webzertifikaten kann deaktiviert werden, nützlich bei ** Cyber** Elementen Cleanroom beim Zugriff über IP-Adresse oder wenn das Webzertifikat nicht von den standardmäßigen öffentlichen Zertifizierungsbehörden anerkannt wird. Akzeptierte Werte: true oder false. |
Variablen für manuelle Bereitstellung¶
| Name | Pflicht | Standardwert | Kommentar |
|---|---|---|---|
ENV_GW_CERT_NAME |
JA | Für die Verbindung mit der manuellen Konfiguration verwendet. Name der Zertifikatsdatei für die Verbindung mit dem SSL-Router. |
|
ENV_GW_CERT_PASSWORD |
JA | Für die Verbindung mit manueller Konfiguration verwendet. Passwort für die Zertifikatsdatei für die Verbindung zum SSL-Router. |
|
ENV_SSL_ROUTER_IP |
JA | Für die Verbindung mit manueller Konfiguration verwendet. IP-Adresse oder DNS-Name des SSL-Routers, mit dem sich das HTML5-Gateway verbinden wird. |
|
ENV_SSL_ROUTER_PORT |
NEIN | 443 |
Für die Verbindung mit manueller Konfiguration verwendet. Port des SSL-Routers, mit dem sich das HTML5-Gateway verbindet. |
Verschiedene Variablen¶
| Name | Pflicht | Standardwert | Kommentar |
|---|---|---|---|
ENV_DISABLE_RSYSLOG |
NO | false |
Deaktivierung des Dienstes rsyslogAkzeptierte Werte: true oder false |
Volumen¶
| Volumen | Kommentar |
|---|---|
/etc/ipdiva/ |
HTML5 Gateway-Konfigurationsvolumen. Wir empfehlen, es auf einem benannten Volumen oder auf dem Dateisystem des Host-Computers zu montieren. |
/opt/certificates/ |
Volumen mit dem HTML5-Gateway-Zertifikat (s) bei der Konfiguration ohne Paarung. |
/var/log/ |
Volumen mit den HTML5-Gateway-Logs. |
Häfen¶
| Hafen | Kommentar |
|---|---|
8080 |
HTML5-Dienst-Listening-Port. |
Einführung des HTML5-Gateway-Dockers¶
Einsatz mit Paarung¶
Voraussetzungen
Bevor Sie den HTML5-Gateway-Docker bereitstellen, müssen Sie einen Pairing-Token erhalten.
Die unten beschriebene Bereitstellung nutzt alle verfügbaren Volumina (außer /opt/certificates/, die in diesem Zusammenhang nicht nützlich ist) und stellt alle Ports offen.
Die Volumes werden auf dem Dateisystem des Host-Computers mit dem Standort HTML5_GATEWAY_REP montiert. Innerhalb dieses Standorts befinden sich die folgenden Unterverzeichnisse:
- config
- Log
Sie können die Variablen für die folgenden Befehle anpassen:
| Benutzerdefinierter Wert | Variable | Kommentar |
|---|---|---|
DOCKER_NAME |
Name des Docker-Containers. | |
HTML5_GATEWAY_REP |
Ort im Dateisystem, an dem die Bände angebracht werden sollen. | |
ENV_MEDIATION_VALUE |
Wert der ENV_MEDIATION Umweltvariablen |
|
ENV_TOKEN_VALUE |
Wert der ENV_TOKEN Umweltvariablen |
|
ENV_NO_CHECK_CERT_VALUE |
Wert der ENV_NO_CHECK_CERT Umweltvariablen |
Erstellen des Verzeichnisbaums, der für das Montieren von Volumina auf dem Dateisystem erforderlich ist:
1 2 | |
Und schließlich, einen neuen Behälter starten:
1 2 3 4 5 6 7 8 | |
Die Containerprotokolle können mit dem folgenden Befehl eingesehen werden:
1 | |
Manuelle Bereitstellung¶
Voraussetzungen
Bevor Sie den HTML5 Gateway Docker bereitstellen, müssen Sie über das für den HTML5 Gateway erforderliche Zertifikat verfügen.
Die nachstehend beschriebene Bereitstellung wird alle verfügbaren Mengen nutzen und alle Häfen freilegen.
Die Volumes werden auf dem Dateisystem des Host-Computers mit dem Standort MANUAL_REP montiert. Innerhalb dieses Standorts befinden sich die folgenden Unterverzeichnisse:
- config
- Log
- Bescheinigungen
Sie können die Variablen für die folgenden Befehle anpassen:
| Benutzerdefinierter Wert | Variable | Kommentar |
|---|---|---|
MANUAL_NAME |
Name des Docker-Containers. | |
MANUAL_REP |
Ort im Dateisystem, an dem die Bände angebracht werden sollen. | |
ENV_GW_CERT_NAME_VALUE |
Wert der ENV_GW_CERT_NAME Umweltvariablen |
|
ENV_GW_CERT_PASSWORD_VALUE |
Wert der ENV_GW_CERT_PASSWORD Umweltvariablen |
|
ENV_SSL_ROUTER_IP_VALUE |
Wert der ENV_SSL_ROUTER_IP Umweltvariablen |
|
ENV_SSL_ROUTER_PORT_VALUE |
Wert der ENV_SSL_ROUTER_PORT Umweltvariablen |
Erstellen des Verzeichnisbaums, der für das Montieren von Volumina auf dem Dateisystem erforderlich ist:
1 2 3 | |
Anschließend werden die Zertifikate für das HTML5-Gateway und den Aufzeichnungsdienst in MANUAL_REP/certificates platziert.
Schließlich wird ein neuer Container gestartet:
1 2 3 4 5 6 7 8 9 10 | |
Die Containerprotokolle können mit dem folgenden Befehl eingesehen werden:
1 | |
Konfiguration des Mediation Controller¶
Damit der neue HTML5-Gateway-Docker einsatzbereit ist, muss der Mediation Controller-Server noch über SSH- oder Konsolenzugriff und root-Berechtigungen konfiguriert werden.
Diese letzte Einstellung ist erforderlich, damit der Mediation Controller mit dem HTML5-Dienst kommunizieren kann.
Diese Konfiguration variiert jedoch je nach Standort des HTML5-Gateway-Dockers:
Das Gesamtdiagramm ist wie folgt:
flowchart LR
subgraph DMZ
direction TB
HTML5(HTML5 Gateway Docker)
MED(Mediation Controller)
end
subgraph LAN
GW(Edge Gateway)
end
MED -.-> |Connection to HTML5 service ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
MED ~~~ GW
GW --> |TLS Tunnel| MED
GW ~~~ MED
linkStyle 0 stroke:#d22,color;
In diesem Zusammenhang ist es notwendig, die nachstehenden Angaben in die /etc/ipdiva/httpd/commonParameters.extra.conf-Datei einzufügen oder diese zu erstellen.
Die Einstellungen können angepasst werden:
| Benutzerdefinierter Wert | Variable | Kommentar |
|---|---|---|
HTML5_URL_DMZ |
URL konfiguriert, wenn das HTML5-Gateway in der Verwaltungskonsole deklariert wird. | |
HTML5_IP_DMZ |
DNS-Name oder IP-Adresse des Docker-Servers, auf dem der HTML5-Gateway-Docker aktiv ist. | |
HTML5_PORT_DMZ |
Port, der vom Docker-Server für den HTML5-Gateway-Docker veröffentlicht wurde. |
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Das Gesamtdiagramm ist wie folgt:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
HTML5(HTML5 Gateway Docker)
GW(Edge Gateway)
end
MED -.- | Connection to HTML5 service ; through TLS Tunnel| GW -.-> |Connection to HTML5 service ; TCP 8080| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
In diesem Zusammenhang ist es notwendig, die nachstehenden Angaben in die /etc/ipdiva/httpd/commonParameters.extra.conf-Datei einzufügen oder diese zu erstellen.
Die Einstellungen können angepasst werden:
| Benutzerdefinierter Wert | Variable | Kommentar |
|---|---|---|
HTML5_URL_LAN |
URL konfiguriert, wenn das HTML5-Gateway in der Verwaltungskonsole deklariert wird. | |
GW_NAME_LAN |
Name des Edge Gateway, der zur Verbindung mit dem HTML5-Dienst verwendet wird. Das Pipekennzeichen am Ende der Zeile ** muss ** bleiben. | |
ORGANIZATION_NAME_LAN |
Name der Organisation, mit der die Edge Gateway verbunden ist. | |
HTML5_IP_LAN |
DNS-Name oder IP-Adresse des Docker-Servers, auf dem der HTML5-Gateway-Docker aktiv ist. | |
HTML5_PORT_LAN |
Port, der vom Docker-Server für den HTML5-Gateway-Docker veröffentlicht wurde. |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Tip
Diese Konfiguration kann auch in der folgenden Situation verwendet werden, in der ein Docker Edge Gateway und ein Docker HTML5-Gateway im selben Docker-Netzwerk ausgeführt werden:
flowchart LR
subgraph DMZ
direction TB
MED(Mediation Controller)
end
subgraph LAN
subgraph docker[Docker Server]
HTML5([HTML5 Gateway Docker])
GW([Edge Gateway])
end
end
MED -.- | Connection to HTML5 service ; through TLS Tunnel| GW -.-> |Connection to HTML5 service ; TCP 8080 through Docker network| HTML5
HTML5 --> |TLS Tunnel| MED
GW --> |TLS Tunnel| MED
linkStyle 0,1 stroke:#d22,color;
Beispiel
In diesem Beispiel werden wir ein Edge Gateway und ein HTML5-Gateway auf demselben Docker-Server bereitstellen.
Die für das Beispiel verwendete Infrastruktur ist wie folgt:
- Server Mediation Controller
- Web-IP-Adresse:
10.0.10.10 - Name der Organisation:
my-organization-name - Token für Edge Gateway:
YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH - Token für das HTML5-Gateway:
ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF - URL für den Zugriff auf den HTML5-Dienst:
HTML5_DOCKER
- Web-IP-Adresse:
- Docker-Server
- Name des Dockernetzwerks:
cyberelements-cleanroom-network - Edge Gateway
- Name:
my-edge-gateway-docker - Stammort im Dateisystem:
/opt/my-edge-gateway-docker
- Name:
- HTML5 Gateway
- Name:
my-html5-gateway-docker - Stammort im Dateisystem:
/opt/my-html5-gateway-docker
- Name:
- Name des Dockernetzwerks:
Zunächst müssen Sie auf dem Docker-Server die Baumstruktur für die Montage der Docker-Volumes erstellen:
1 2 3 4 5 6 | |
Dann erstellen Sie eine bridge Typ Docker-Netzwerk, so dass die beiden Container miteinander kommunizieren können:
1 | |
Als nächstes starten Sie die Edge Gateway Die Datenbank ist in der Regel mit einem Mediation Controller Die Daten werden über die IP-Adresse und ohne Zertifikatsprüfung --network Der Parameter wird hinzugefügt, um die Verwendung des zuvor erstellten Docker-Netzwerks zu spezifizieren:
1 2 3 4 5 6 7 8 9 10 11 12 13 | |
Als nächstes starten Sie den HTML5-Gateway-Container. Beachten Sie, dass das Beispiel eine Verbindung durch Paarung herstellt, wobei der Zugriff auf Mediation Controller über seine IP-Adresse erfolgt und keine Zertifikatsprüfung hinzugefügt wird. Darüber hinaus wird der Parameter --network hinzugefügt, um die Verwendung des zuvor erstellten Docker-Netzwerks zu spezifizieren, und da der Zugriff auf den HTML5-Dienst über das Docker-Netzwerk erfolgt, ist der Veröffentlichungsport 8080 nicht erforderlich:
1 2 3 4 5 6 7 8 | |
Schließlich muss die /etc/ipdiva/httpd/commonParameters.extra.conf Datei auf dem Mediation Controller Server (s) konfiguriert werden.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | |
Bevor Sie die neuen Einstellungen anwenden, müssen Sie überprüfen, ob die neue Konfiguration keine Blockierungsfehler für den Apache2-Webserver verursacht.
Hierzu führen Sie den folgenden Befehl aus:
1 | |
Wenn die Rücksendung Syntax OK Wenn Sie die Änderungen nicht vornehmen können, können Sie die Änderungen mit dem folgenden Befehl vornehmen. /etc/ipdiva/httpd/commonParameters.extra.conf - Ich habe ihn.
1 | |