> Source: https://docs.cyberelements.io/bastion/4.6/hu/Installation/Docker/HTML5Gateway/

# 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
```

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

```
1
```

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

```
1
2
3
4
5
6
```

> **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
> ```

## 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](https://docs.cyberelements.io/bastion/4.6/hu/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).

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ó](#environment-variables) értéke. |
|  | `ENV_TOKEN_VALUE` | Az `ENV_TOKEN` [környezeti változó](#environment-variables) értéke. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Az `ENV_NO_CHECK_CERT` [környezeti változó](#environment-variables) értéke. |

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

**Bash**

> ```
> 1
> 2
> ```

**PowerShell**

> ```
> 1
> ```

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

**Bash**

> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```

**PowerShell**

> ```
> 1
> 2
> 3
> 4
> 5
> 6
> 7
> 8
> ```

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

```
1
```

### 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](#deployment-with-pairing) 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ó](#environment-variables) értéke. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Az `ENV_SSL_ROUTER_IP` [környezeti változó](#environment-variables) értéke. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Az `ENV_SSL_ROUTER_PORT` [környezeti változó](#environment-variables) értéke. |

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

**Bash**

> ```
> 1
> 2
> 3
> ```

**PowerShell**

> ```
> 1
> ```

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):

**Bash**

> ```
> 1
> 2
> ```

**PowerShell**

> ```
> 1
> ```

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

**Bash**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> ```

**PowerShell**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> ```

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

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

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

```
1
```

## 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ő:

**A DMZ zónában elhelyezve**

> Az átfogó ábra a következő:
>
> ```mermaid
> 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;
> ```
>
> 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
> ```

**Edge Gateway komponensen keresztül elérhető LAN hálózatban elhelyezve**

> Az átfogó ábra a következő:
>
> ```mermaid
> 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;
> ```
>
> 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
> ```
>
> > **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:
> >
> > ```mermaid
> > 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;
> > ```
> >
> > > **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
> > > ```
> > >
> > > 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
> > > ```
> > >
> > > 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
> > > ```
> > >
> > > 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
> > > ```
> > >
> > > 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
> > > ```

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
```

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
```
