Kihagyás

A HTML5 Gateway Docker telepítése

A Docker-rendszerkép importálása

Mielőtt létrehozhatna egy HTML5 Gateway Docker konténert, importálnia kell a Docker-rendszerképet. Ehhez nyisson meg egy rendszerhéjat, amelyből elérhetők a Docker-parancsok, valamint a cleanroom-html5-4.6.1-33-v2.tgz fájl. A rendszerhéjban futtassa a következő parancsot, és ha a TGZ fájl nem az aktuális könyvtárban található, módosítsa az elérési útját:

1
docker load --input cleanroom-html5-4.6.1-33-v2.tgz

Ezután ellenőrizze az importálás sikerességét a következő paranccsal:

1
docker inspect --type=image cleanroom-html5:4.6.1-33-v2

A várt kimenet a következő. Ha nem ezt kapja, az importálás sikertelen volt:

1
2
3
4
5
6
[
    {
        "Id": "sha256:16ae07f1604409f6b092a8a2944e69b3db458a04dbbab6ffc3f945c253c82cee",
        "RepoTags": [
            "cleanroom-html5:4.6.1-33-v2"
        ],
Teljes kimenet 
 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
[
    {
        "Id": "sha256:16ae07f1604409f6b092a8a2944e69b3db458a04dbbab6ffc3f945c253c82cee",
        "RepoTags": [
            "cleanroom-html5:4.6.1-33-v2"
        ],
        "RepoDigests": [],
        "Parent": "",
        "Comment": "buildkit.dockerfile.v0",
        "Created": "2025-08-27T11:35:33.014244258+02:00",
        "DockerVersion": "",
        "Author": "",
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 781097647,
        "GraphDriver": {
            "Data": {
                "LowerDir": "/var/lib/docker/overlay2/aa079416d669709486e3fd3dfefcff51acb3905ffcca7e6e428630d1a499e669/diff:/var/lib/docker/overlay2/da9f43ee88f5961a157af404be018fc7c3f5185a798b26911e38118d83830de7/diff:/var/lib/docker/overlay2/28efb3982392e95711e849cb90985fd534cd6273f4dec758463f98b41a432e93/diff:/var/lib/docker/overlay2/44a3abed0a932259b79c9e5e273749cc06bd8aca7d3adbfd1753a7b053dcae2f/diff:/var/lib/docker/overlay2/e3dfd4c7c4fe568ef731bd91314e69cc5c807ce717d5f4ea94f0d02cc11e70c5/diff:/var/lib/docker/overlay2/5acf2b56871d2537d95b9981c0498e16723a9eca20827f550366b48d8acf508f/diff:/var/lib/docker/overlay2/c732cd17c6501229b3a12c488d7f4c26f8634329211cac54ff1cf0d53055421f/diff:/var/lib/docker/overlay2/fd61cbda2a5e9a578c5a8eea67b63df3d31642588be3b6f2f7ebe6e10964f745/diff",
                "MergedDir": "/var/lib/docker/overlay2/b9c8170b6a9ed8e7c84a9ba208cd6e4b25e88d1dad42cd72b0e1178da62a46d4/merged",
                "UpperDir": "/var/lib/docker/overlay2/b9c8170b6a9ed8e7c84a9ba208cd6e4b25e88d1dad42cd72b0e1178da62a46d4/diff",
                "WorkDir": "/var/lib/docker/overlay2/b9c8170b6a9ed8e7c84a9ba208cd6e4b25e88d1dad42cd72b0e1178da62a46d4/work"
            },
            "Name": "overlay2"
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:4668f0f488e5ad4494fadff56ad585c514794b3a293e5e8d006410de9da08155",
                "sha256:782f6c5256575fbef0e518a1a1ce9188c457f1a0e9b88b733ed672f6e1be482d",
                "sha256:e09fd3e10e878ef6c812ccde0fa55b66cf4b9b593cf182c2760fec73649968c2",
                "sha256:e51c952c7bd89e0a3188c683d689eed81444d5513c14251f4b21cb9fd056d27d",
                "sha256:233ff67db52988898e3c1b4c2573b86c1c0c50d23f1f4b2365e3fc51abedbf9f",
                "sha256:f832eee42398852cab80a9a45138bf076d63ebbe153263fd8cf66857a0833d02",
                "sha256:f59f79d19c38ae4863b81774ad1d98030370c64e17013eb786da7b727bf2b41b",
                "sha256:0caeed550a29dbb274781e78bbe910fa5ccfdc90119cb4f9e3c815feff5a70b9",
                "sha256:21313651aa44ac0f5dd459a94be172b003b68f81b0db945c24a7ada5c21799e3"
            ]
        },
        "Metadata": {
            "LastTagTime": "0001-01-01T00:00:00Z"
        },
        "Config": {
            "Cmd": null,
            "Entrypoint": [
                "/entrypoint.sh"
            ],
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "DEBIAN_FRONTEND=noninteractive",
                "IMAGE_BUILD_DATE=20250827T112940",
                "IMAGE_BUILD_VERSION=4.6.1-33-v2",
                "IMAGE_IPDIPC=IPC-53702"
            ],
            "ExposedPorts": {
                "8080/tcp": {},
                "8090/tcp": {}
            },
            "Labels": {
                "maintainer": "contact@systancia.com",
                "org.label-schema.build-date": "20250827T112940",
                "org.label-schema.description": "Systancia Cleanroom Gateway",
                "org.label-schema.name": "Systancia Cleanroom 4.6.1-33-v2 HTML5 Server",
                "org.label-schema.url": "http://systancia.com/",
                "org.label-schema.vendor": "Systancia",
                "version": "4.6.1-33-v2"
            },
            "OnBuild": null,
            "User": "root",
            "Volumes": null,
            "WorkingDir": ""
        }
    }
]

A konténer konfigurálása

Környezeti változók

Változók pairinggel történő üzembe helyezéshez

Név Kötelező Alapértelmezett érték Megjegyzés
ENV_MEDIATION IGEN Pairing alapú kapcsolódáshoz használatos.
Megadja a CyberElements Bastion platform webes felületéhez való csatlakozáshoz használt DNS-nevet vagy IP-címet.
ENV_TOKEN IGEN Pairing alapú kapcsolathoz használatos.
A Mediation Controller szolgáltatáshoz való csatlakozáshoz használandó pairing token megadása.
ENV_NO_CHECK_CERT NEM false Pairing alapú kapcsolódásokhoz használatos.
Kikapcsolja-e a Mediation Controller webes tanúsítványának ellenőrzését; a CyberElements Bastion esetében hasznos, ha az elérés IP-címen keresztül történik, vagy ha a webes tanúsítványt nem ismerik el az alapértelmezett nyilvános hitelesítésszolgáltatók.
Elfogadott értékek: true vagy false.

Változók manuális üzembe helyezéshez

Név Kötelező Alapértelmezett érték Megjegyzés
ENV_GW_CERT_NAME IGEN Manuális konfigurációjú kapcsolathoz használatos.
Az SSL Router komponenshez való csatlakozáshoz használt tanúsítványfájl neve.
ENV_GW_CERT_PASSWORD IGEN Manuális konfigurációjú kapcsolathoz használatos.
Az SSL Router komponenshez való csatlakozáshoz használt tanúsítványfájl jelszava.
ENV_SSL_ROUTER_IP IGEN Manuális konfigurációval történő kapcsolódáshoz használatos.
Annak az SSL Router komponensnek az IP-címe vagy DNS-neve, amelyhez a HTML5 Gateway csatlakozik.
ENV_SSL_ROUTER_PORT NEM 443 Manuális konfigurációval történő kapcsolódáshoz használatos.
Annak az SSL Router komponensnek a portja, amelyhez a HTML5 Gateway csatlakozik.

Egyéb változók

Név Kötelező Alapértelmezett érték Megjegyzés
ENV_DISABLE_RSYSLOG NEM false Az rsyslog szolgáltatás kikapcsolása.
Elfogadott értékek: true vagy false.

Kötetek

Kötet Megjegyzés
/etc/ipdiva/ A HTML5 Gateway konfigurációs kötete.
Javasoljuk, hogy elnevezett kötetre vagy a gazdagép fájlrendszerére csatlakoztassa.
/opt/certificates/ A HTML5 Gateway tanúsítványát vagy tanúsítványait tartalmazó kötet pairing nélküli konfiguráció esetén.
/var/log/ A HTML5 Gateway naplóit tartalmazó kötet.

Portok

Port Megjegyzés
8080 A HTML5-szolgáltatás figyelő portja.

A HTML5 Gateway Docker üzembe helyezése

Üzembe helyezés pairinggel

Előfeltételek

A HTML5 Gateway Docker üzembe helyezése előtt be kell szereznie egy pairing tokent.

Az alább ismertetett üzembe helyezés az összes elérhető kötetet használja (kivéve az ebben a környezetben nem hasznos /opt/certificates/ kötetet), és az összes portot elérhetővé teszi.
A kötetek a gazdagép fájlrendszerében, a HTML5_GATEWAY_REP helyen lesznek csatlakoztatva. Ezen a helyen belül a következő alkönyvtárak találhatók:

  • config
  • log

A következő parancsok változóit testre szabhatja:

Egyéni érték Változó Megjegyzés
DOCKER_NAME A Docker-konténer neve.
HTML5_GATEWAY_REP A kötetek csatlakoztatási helye a fájlrendszerben.
ENV_MEDIATION_VALUE Az ENV_MEDIATION környezeti változó értéke.
ENV_TOKEN_VALUE Az ENV_TOKEN környezeti változó értéke.
ENV_NO_CHECK_CERT_VALUE Az ENV_NO_CHECK_CERT környezeti változó értéke.

Hozza létre a kötetek fájlrendszerre csatlakoztatásához szükséges könyvtárszerkezetet:

1
2
mkdir -p HTML5_GATEWAY_REP/config
mkdir HTML5_GATEWAY_REP/log

1
New-Item -ItemType Directory -Force -Path "HTML5_GATEWAY_REP\config", "HTML5_GATEWAY_REP\log"

Végül pedig indítson el egy új konténert:

1
2
3
4
5
6
7
8
docker run -d --restart unless-stopped --name "DOCKER_NAME" \
-e ENV_MEDIATION="ENV_MEDIATION_VALUE" \
-e ENV_TOKEN="ENV_TOKEN_VALUE" \
-e ENV_NO_CHECK_CERT="ENV_NO_CHECK_CERT_VALUE" \
-v "HTML5_GATEWAY_REP/config/:/etc/ipdiva/:rw" \
-v "HTML5_GATEWAY_REP/log/:/var/log/:rw" \
-p 8080:8080 \
cleanroom-html5:4.6.1-33-v2

1
2
3
4
5
6
7
8
docker run -d --restart unless-stopped --name "DOCKER_NAME" `
-e "ENV_MEDIATION=ENV_MEDIATION_VALUE" `
-e "ENV_TOKEN=ENV_TOKEN_VALUE" `
-e "ENV_NO_CHECK_CERT=ENV_NO_CHECK_CERT_VALUE" `
-v "HTML5_GATEWAY_REP\config:/etc/ipdiva/:rw" `
-v "HTML5_GATEWAY_REP\log:/var/log/:rw" `
-p 8080:8080 `
cleanroom-html5:4.6.1-33-v2

A konténer naplói a következő paranccsal tekinthetők meg:

1
docker logs -f DOCKER_NAME

Manuális üzembe helyezés

Előfeltételek

A HTML5 Gateway Docker üzembe helyezése előtt rendelkeznie kell a HTML5 Gateway komponenshez szükséges tanúsítvánnyal.

A docker inspect paranccsal látható jelszavak

Egy konténer környezeti változói – a tanúsítványjelszavakat is beleértve – bárki számára olvashatók maradnak, aki futtathatja a docker inspect parancsot a Docker-kiszolgálón. Ezért a pairinggel történő üzembe helyezést célszerű előnyben részesíteni, mivel az nem használ tanúsítványjelszót.

Az alább ismertetett üzembe helyezés az összes elérhető kötetet használja, és az összes portot elérhetővé teszi.
A kötetek a gazdagép fájlrendszerébe, a MANUAL_REP helyre lesznek csatlakoztatva. Ezen a helyen a következő alkönyvtárak találhatók:

  • config
  • log
  • certificates

A következő parancsok változóit testre szabhatja:

Egyéni érték Változó Megjegyzés
MANUAL_NAME A Docker-konténer neve.
MANUAL_REP A fájlrendszer azon helye, ahová a kötetek csatlakoztatva lesznek.
ENV_GW_CERT_NAME_VALUE Az ENV_GW_CERT_NAME környezeti változó értéke.
ENV_SSL_ROUTER_IP_VALUE Az ENV_SSL_ROUTER_IP környezeti változó értéke.
ENV_SSL_ROUTER_PORT_VALUE Az ENV_SSL_ROUTER_PORT környezeti változó értéke.

Hozza létre a kötetek fájlrendszerre csatlakoztatásához szükséges könyvtárszerkezetet:

1
2
3
mkdir -p MANUAL_REP/config
mkdir MANUAL_REP/log
mkdir MANUAL_REP/certificates

1
New-Item -ItemType Directory -Force -Path "MANUAL_REP\config", "MANUAL_REP\log", "MANUAL_REP\certificates"

Ezután helyezze el a HTML5 Gateway és a rögzítési szolgáltatás tanúsítványait a MANUAL_REP/certificates könyvtárban.

Annak érdekében, hogy a tanúsítványjelszavak ne kerüljenek be a parancshéj előzményeibe, adja meg őket az aktuális munkamenet környezeti változóiban (a bevitt szöveg nem jelenik meg):

1
2
read -rsp "HTML5 Gateway certificate password: " ENV_GW_CERT_PASSWORD; echo
export ENV_GW_CERT_PASSWORD

1
$env:ENV_GW_CERT_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host -AsSecureString "HTML5 Gateway certificate password")).Password

Végül indítson el egy új konténert:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
docker run -d --restart unless-stopped --name "MANUAL_NAME" \
-e ENV_GW_CERT_NAME="ENV_GW_CERT_NAME_VALUE" \
-e ENV_GW_CERT_PASSWORD \
-e ENV_SSL_ROUTER_IP="ENV_SSL_ROUTER_IP_VALUE" \
-e ENV_SSL_ROUTER_PORT="ENV_SSL_ROUTER_PORT_VALUE" \
-v "MANUAL_REP/config/:/etc/ipdiva/:rw" \
-v "MANUAL_REP/log/:/var/log/:rw" \
-v "MANUAL_REP/certificates/:/opt/certificates/:ro" \
-p 8080:8080 \
cleanroom-html5:4.6.1-33-v2

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
docker run -d --restart unless-stopped --name "MANUAL_NAME" `
-e "ENV_GW_CERT_NAME=ENV_GW_CERT_NAME_VALUE" `
-e ENV_GW_CERT_PASSWORD `
-e "ENV_SSL_ROUTER_IP=ENV_SSL_ROUTER_IP_VALUE" `
-e "ENV_SSL_ROUTER_PORT=ENV_SSL_ROUTER_PORT_VALUE" `
-v "MANUAL_REP\config:/etc/ipdiva/:rw" `
-v "MANUAL_REP\log:/var/log/:rw" `
-v "MANUAL_REP\certificates:/opt/certificates/:ro" `
-p 8080:8080 `
cleanroom-html5:4.6.1-33-v2

Miután a konténer elindult, távolítsa el ezeket a változókat a munkamenetből:

1
unset ENV_GW_CERT_PASSWORD

1
Remove-Item Env:ENV_GW_CERT_PASSWORD

A konténer naplói a következő paranccsal tekinthetők meg:

1
docker logs -f MANUAL_NAME

A Mediation Controller konfigurálása

Ahhoz, hogy az új HTML5 Gateway Docker működőképes legyen, még konfigurálni kell a Mediation Controller kiszolgálót SSH- vagy konzolos hozzáféréssel és root engedélyekkel.

Erre az utolsó beállításra azért van szükség, hogy a Mediation Controller kommunikálni tudjon a HTML5-szolgáltatással.
Ez a konfiguráció azonban a HTML5 Gateway Docker elhelyezkedésétől függően eltérő:

Az átfogó ábra a következő:

flowchart LR
    subgraph DMZ
        direction TB
        HTML5(HTML5 Gateway Docker)
        MED(Mediation Controller)
    end

    subgraph LAN
        GW(Edge Gateway)
    end


    MED -.-> |Kapcsolat a HTML5 szolgáltatással ; TCP 8080| HTML5
    HTML5 --> |TLS Tunnel| MED
    MED ~~~ GW
    GW --> |TLS Tunnel| MED
    GW ~~~ MED

    linkStyle 0 stroke:#d22,color;
Hold "Ctrl" to enable pan & zoom

Ebben az esetben az alább megadott információkat hozzá kell adni az /etc/ipdiva/httpd/commonParameters.extra.conf fájlhoz, vagy létre kell hozni a fájlt.
A beállítások testre szabhatók:

Egyéni érték Változó Megjegyzés
HTML5_URL_DMZ A HTML5 Gateway felügyeleti konzolon való deklarálásakor konfigurált URL-cím.
HTML5_IP_DMZ Annak a Docker-kiszolgálónak a DNS-neve vagy IP-címe, amelyen a HTML5 Gateway Docker fut.
HTML5_PORT_DMZ A Docker-kiszolgáló által a HTML5 Gateway Docker számára közzétett port. 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
<Location /HTML5_URL_DMZ/>
    Order allow,deny
    Allow from all
    ProxyPass http://HTML5_IP_DMZ:HTML5_PORT_DMZ/systanciaHTML5-6.0/ flushpackets=on
    ProxyPassReverse http://HTML5_IP_DMZ:HTML5_PORT_DMZ
</Location>

<Location /HTML5_URL_DMZ/websocket-tunnel>
    Order allow,deny
    Allow from all
    ProxyPass ws://HTML5_IP_DMZ:HTML5_PORT_DMZ/systanciaHTML5-6.0/websocket-tunnel
    ProxyPassReverse ws://HTML5_IP_DMZ:HTML5_PORT_DMZ/systanciaHTML5-6.0/websocket-tunnel
</Location>

Az átfogó ábra a következő:

flowchart LR
    subgraph DMZ
        direction TB
        MED(Mediation Controller)
    end

    subgraph LAN
        HTML5(HTML5 Gateway Docker)
        GW(Edge Gateway)
    end


    MED -.- | Kapcsolat a HTML5 szolgáltatással ; TLS-alagúton keresztül| GW -.-> |Kapcsolat a HTML5 szolgáltatással ; TCP 8080| HTML5
    HTML5 --> |TLS Tunnel| MED
    GW --> |TLS Tunnel| MED

    linkStyle 0,1 stroke:#d22,color;
Hold "Ctrl" to enable pan & zoom

Ebben az esetben az alább megadott információkat hozzá kell adni az /etc/ipdiva/httpd/commonParameters.extra.conf fájlhoz, vagy létre kell hozni a fájlt.
A beállítások testre szabhatók:

Egyéni érték Változó Megjegyzés
HTML5_URL_LAN A HTML5 Gateway felügyeleti konzolon való deklarálásakor konfigurált URL-cím.
GW_NAME_LAN A HTML5-szolgáltatáshoz való csatlakozáshoz használt Edge Gateway komponens neve. A sor végén lévő függőleges vonal karaktert meg kell tartani.
ORGANIZATION_NAME_LAN Annak a szervezetnek a neve, amelyhez az Edge Gateway csatlakozik.
HTML5_IP_LAN Annak a Docker-kiszolgálónak a DNS-neve vagy IP-címe, amelyen a HTML5 Gateway Docker fut.
HTML5_PORT_LAN A Docker-kiszolgáló által a HTML5 Gateway Docker számára közzétett port. 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
<Location /HTML5_URL_LAN/>
    Order allow,deny
    Allow from all
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-IPdiva-Gateway GW_NAME_LAN|
    RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME_LAN
    RequestHeader set X-IPdiva-Service HTML5_IP_LAN:HTML5_PORT_LAN

    ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /HTML5_URL_LAN/websocket-tunnel>
    Order allow,deny
    Allow from all
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-IPdiva-Gateway GW_NAME_LAN|
    RequestHeader set X-IPdiva-Orgname ORGANIZATION_NAME_LAN
    RequestHeader set X-IPdiva-Service HTML5_IP_LAN:HTML5_PORT_LAN

    ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Tipp

Ez a konfiguráció abban az esetben is használható, amikor egy Docker Edge Gateway és egy Docker HTML5 Gateway ugyanabban a Docker-hálózatban fut:

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 -.- | Kapcsolat a HTML5 szolgáltatással ; TLS-alagúton keresztül| GW -.-> |Kapcsolat a HTML5 szolgáltatással ; TCP 8080 a Docker-hálózaton keresztül| HTML5
    HTML5 --> |TLS Tunnel| MED
    GW --> |TLS Tunnel| MED

    linkStyle 0,1 stroke:#d22,color;
Hold "Ctrl" to enable pan & zoom
Példa

Ebben a példában egy Edge Gateway és egy HTML5 Gateway komponenst helyezünk üzembe ugyanazon a Docker-kiszolgálón.

A példához használt infrastruktúra a következő:

  • Mediation Controller kiszolgáló
    • Webes IP-cím: 10.0.10.10
    • A szervezet neve: my-organization-name
    • Token az Edge Gateway komponenshez: YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH
    • Token a HTML5 Gateway komponenshez: ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF
    • A HTML5-szolgáltatás eléréséhez használt URL-cím: HTML5_DOCKER
  • Docker-kiszolgáló
    • Docker-hálózat neve: cyberelements-cleanroom-network
    • Edge Gateway
      • Név: my-edge-gateway-docker
      • Gyökérhely a fájlrendszerben: /opt/my-edge-gateway-docker
    • HTML5 Gateway
      • Név: my-html5-gateway-docker
      • Gyökérhely a fájlrendszerben: /opt/my-html5-gateway-docker

Először a Docker-kiszolgálón létre kell hoznia a Docker-kötetek csatlakoztatásához szükséges könyvtárszerkezetet:

1
2
3
4
5
6
mkdir -p /opt/my-edge-gateway-docker/config
mkdir /opt/my-edge-gateway-docker/graphical_archives
mkdir /opt/my-edge-gateway-docker/ssh_archives
mkdir /opt/my-edge-gateway-docker/log
mkdir -p /opt/my-html5-gateway-docker/config
mkdir /opt/my-html5-gateway-docker/log

Ezután hozzon létre egy bridge típusú Docker-hálózatot, hogy a két konténer kommunikálni tudjon egymással:

1
docker network create -d bridge cyberelements-cleanroom-network

Ezután indítsa el az Edge Gateway konténert. Vegye figyelembe, hogy a példában a kapcsolat pairing segítségével jön létre, a Mediation Controller elérése annak IP-címén keresztül történik, tanúsítvány-ellenőrzés nélkül. Emellett a --network paraméter is hozzá van adva a korábban létrehozott Docker-hálózat használatának megadásához: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
docker run -d --restart unless-stopped --name "my-edge-gateway-docker" \
-e ENV_MEDIATION="10.0.10.10" \
-e ENV_TOKEN="YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH" \
-e ENV_NO_CHECK_CERT="true" \
-v "/opt/my-edge-gateway-docker/config/:/etc/ipdiva/:rw" \
-v "/opt/my-edge-gateway-docker/graphical_archives/:/var/lib/ipdiva/carerecord/archives/:rw" \
-v "/opt/my-edge-gateway-docker/ssh_archives/:/var/ipdiva/care/sshrecord/:rw" \
-v "/opt/my-edge-gateway-docker/log/:/var/log/:rw" \
-p 2222:2222 \
-p 3389:3389 \
-p 8443:8443 \
--network="cyberelements-cleanroom-network" \
cleanroom-gateway:4.6.1-33-v2

Ezután indítsa el a HTML5 Gateway konténert. Vegye figyelembe, hogy a példában a kapcsolat pairing segítségével jön létre, a Mediation Controller elérése annak IP-címén keresztül történik, tanúsítvány-ellenőrzés nélkül. Emellett a --network paraméter is hozzá van adva a korábban létrehozott Docker-hálózat használatának megadásához, és mivel a HTML5-szolgáltatás elérése a Docker-hálózaton keresztül történik, a 8080-as port közzététele nem szükséges: 

1
2
3
4
5
6
7
8
docker run -d --restart unless-stopped --name "my-html5-gateway-docker" \
-e ENV_MEDIATION="10.0.10.10" \
-e ENV_TOKEN="ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF" \
-e ENV_NO_CHECK_CERT="true" \
-v "/opt/my-html5-gateway-docker/config/:/etc/ipdiva/:rw" \
-v "/opt/my-html5-gateway-docker/log/:/var/log/:rw" \
--network="cyberelements-cleanroom-network" \
cleanroom-html5:4.6.1-33-v2

Végül konfigurálni kell a Mediation Controller kiszolgáló(k) /etc/ipdiva/httpd/commonParameters.extra.conf fájlját. A következő szakaszt kell hozzáadni:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
<Location /HTML5_DOCKER/>
    Order allow,deny
    Allow from all
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-IPdiva-Gateway my-edge-gateway-docker|
    RequestHeader set X-IPdiva-Orgname my-organization-name
    RequestHeader set X-IPdiva-Service my-html5-gateway-docker:8080

    ProxyPass http://127.0.0.1:9016/systanciaHTML5-6.0/ flushpackets=on
</Location>

<Location /HTML5_DOCKER/websocket-tunnel>
    Order allow,deny
    Allow from all
    RequestHeader set X-Forwarded-Proto "https"
    RequestHeader set X-IPdiva-Gateway my-edge-gateway-docker|
    RequestHeader set X-IPdiva-Orgname my-organization-name
    RequestHeader set X-IPdiva-Service my-html5-gateway-docker:8080

    ProxyPass ws://127.0.0.1:9016/systanciaHTML5-6.0/websocket-tunnel
</Location>

Az új beállítások alkalmazása előtt ellenőriznie kell, hogy az új konfiguráció nem okoz-e blokkoló hibát az Apache2 webkiszolgálóban.
Ehhez futtassa a következő parancsot:

1
apache2ctl configtest

Ha a válasz Syntax OK, a módosítások az alábbi paranccsal alkalmazhatók. Ellenkező esetben ellenőrizze az /etc/ipdiva/httpd/commonParameters.extra.conf fájl konfigurációját.

1
systemctl reload apache2