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

# HTML5 Gateway Docker versiooni installimine

## Dockeri kujutise importimine

Enne HTML5 Gateway Docker konteineri loomist peate importima Dockeri kujutise. Selleks avage kest, kus teil on saadaval Dockeri käsud ja fail `cleanroom-html5-4.6.1-33-v2.tgz`. Käivitage kestas järgmine käsk, kohandades `TGZ`-faili teed, kui see pole praeguses kataloogis:

```
1
```

Seejärel kontrollige järgmise käsuga, kas importimine õnnestus:

```
1
```

Oodatav väljund on järgmine. Kui see nii pole, on importimine nurjunud:

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

> **Täielik väljund**
>
> ```
>  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
> ```

## Konteineri konfiguratsioon

### Keskkonnamuutujad

#### Muutujad pairingu abil juurutamiseks

| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
| `ENV_MEDIATION` | JAH |  | Kasutatakse pairingu ühenduse jaoks. Näitab DNS-nime või IP-aadressi CyberElements Bastion platvormi veebiliidesega ühenduse loomiseks. |
| `ENV_TOKEN` | JAH |  | Kasutatakse pairingu ühenduse puhul. Näitab pairingu tokenit, mida kasutatakse Mediation Controller teenusega ühenduse loomiseks. |
| `ENV_NO_CHECK_CERT` | EI | `false` | Kasutatakse pairingu ühenduste jaoks. Kas Mediation Controller serveri veebisertifikaadi kontroll välja lülitada või mitte; kasulik CyberElements Bastion lahenduse puhul, kui juurdepääs toimub IP-aadressi kaudu või kui veebisertifikaat pole vaikimisi avalike sertifitseerimisasutuste tunnustatud sertifikaat. Aktsepteeritud väärtused: `true` või `false`. |

#### Muutujad käsitsi juurutamiseks

| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | JAH |  | Kasutatakse käsitsi konfigureeritud ühenduse puhul. SSL Router teenusega ühenduse loomiseks kasutatava sertifikaadifaili nimi. |
| `ENV_GW_CERT_PASSWORD` | JAH |  | Kasutatakse käsitsi konfigureeritud ühenduse puhul. SSL Router teenusega ühenduse loomiseks kasutatava sertifikaadifaili parool. |
| `ENV_SSL_ROUTER_IP` | JAH |  | Kasutatakse käsitsi konfigureeritud ühenduse jaoks. Selle SSL Router komponendi IP-aadress või DNS-nimi, millega HTML5 Gateway ühenduse loob. |
| `ENV_SSL_ROUTER_PORT` | EI | `443` | Kasutatakse käsitsi konfigureeritud ühenduse jaoks. Selle SSL Router komponendi port, millega HTML5 Gateway ühenduse loob. |

#### Muud muutujad

| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | EI | `false` | Teenuse `rsyslog` väljalülitamine. Aktsepteeritud väärtused: `true` või `false`. |

### Köited

| Köide | Kommentaar |
|---|---|
| `/etc/ipdiva/` | HTML5 Gateway komponendi konfiguratsiooniköide. Soovitame selle ühendada nimega köitesse või hostarvuti failisüsteemi. |
| `/opt/certificates/` | Köide, mis sisaldab HTML5 Gateway komponendi sertifikaati või sertifikaate, kui konfigureerimine toimub ilma pairinguta. |
| `/var/log/` | Köide, mis sisaldab HTML5 Gateway komponendi logisid. |

### Pordid

| Port | Kommentaar |
|---|---|
| `8080` | HTML5-teenuse kuulamisport. |

## HTML5 Gateway Docker versiooni juurutamine

### Juurutamine pairingu abil

> **Eeltingimused**
>
> Enne HTML5 Gateway Docker versiooni juurutamist peate [hankima pairingu tokeni](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).

Allpool kirjeldatud juurutamine kasutab kõiki saadaolevaid köiteid (välja arvatud `/opt/certificates/`, millest selles kontekstis kasu pole) ja avaldab kõik pordid.
Köited ühendatakse hostarvuti failisüsteemi asukohas `HTML5_GATEWAY_REP`. Selles asukohas on järgmised alamkataloogid:

- config
- log

Järgmiste käskude muutujaid saate kohandada:

| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
|  | `DOCKER_NAME` | Dockeri konteineri nimi. |
|  | `HTML5_GATEWAY_REP` | Failisüsteemi asukoht, kuhu köited ühendatakse. |
|  | `ENV_MEDIATION_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_MEDIATION` väärtus. |
|  | `ENV_TOKEN_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_TOKEN` väärtus. |
|  | `ENV_NO_CHECK_CERT_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_NO_CHECK_CERT` väärtus. |

Looge kataloogipuu, mis on vajalik köidete ühendamiseks failisüsteemi:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Lõpuks käivitage uus konteiner:

**Bash**

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

**PowerShell**

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

Konteineri logisid saab vaadata järgmise käsuga:

```
1
```

### Käsitsi juurutamine

> **Eeltingimused**
>
> Enne HTML5 Gateway Docker versiooni juurutamist peab teil olema HTML5 Gateway komponendi jaoks nõutav sertifikaat.

> **Paroolid on nähtavad käsuga `docker inspect`**
>
> Konteineri keskkonnamuutujad, sh sertifikaatide paroolid, jäävad loetavaks kõigile, kellel on lubatud Dockeri serveris käivitada käsku `docker inspect`. Seetõttu tuleks eelistada [pairingu abil juurutamist](#deployment-with-pairing), mis ei kasuta sertifikaadi parooli.

Allpool kirjeldatud juurutamine kasutab kõiki saadaolevaid köiteid ja avab kõik pordid.
Köited ühendatakse hostarvuti failisüsteemi asukohta `MANUAL_REP`. Selles asukohas on järgmised alamkaustad:

- config
- log
- certificates

Järgmiste käskude muutujaid saate kohandada:

| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
|  | `MANUAL_NAME` | Dockeri konteineri nimi. |
|  | `MANUAL_REP` | Failisüsteemi asukoht, kuhu köited ühendatakse. |
|  | `ENV_GW_CERT_NAME_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_GW_CERT_NAME` väärtus. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_SSL_ROUTER_IP` väärtus. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_SSL_ROUTER_PORT` väärtus. |

Looge kataloogipuu, mis on vajalik köidete ühendamiseks failisüsteemi:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Seejärel paigutage HTML5 Gateway komponendi ja salvestusteenuse sertifikaadid kataloogi `MANUAL_REP/certificates`.

Et sertifikaatide paroolid kesta ajalukku ei jääks, sisestage need praeguse seansi keskkonnamuutujatesse (sisestust ei kuvata):

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Lõpuks käivitage uus konteiner:

**Bash**

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

**PowerShell**

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

Kui konteiner on käivitunud, eemaldage need muutujad seansist:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Konteineri logisid saab vaadata järgmise käsuga:

```
1
```

## Mediation Controller serveri konfigureerimine

Selleks et uus HTML5 Gateway Docker oleks töövalmis, tuleb Mediation Controller server veel konfigureerida SSH- või konsoolijuurdepääsu kaudu `root`-lubadega.

See viimane säte on vajalik, et lubada Mediation Controller serveril HTML5-teenusega suhelda.
See konfiguratsioon erineb aga olenevalt HTML5 Gateway Docker versiooni asukohast:

**Paigutatud DMZ-võrku**

> Üldine skeem on järgmine:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         HTML5(HTML5 Gateway Docker)
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         GW(Edge Gateway)
>     end
>
>
>     MED -.-> |Ühendus HTML5-teenusega ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     MED ~~~ GW
>     GW --> |TLS Tunnel| MED
>     GW ~~~ MED
>
>     linkStyle 0 stroke:#d22,color;
> ```
>
> Selles kontekstis tuleb allpool toodud teave lisada faili `/etc/ipdiva/httpd/commonParameters.extra.conf` või see fail luua.
> Sätteid saab kohandada:
>
> | Kohandatud väärtus | Muutuja | Kommentaar |
> |---|---|---|
> |  | `HTML5_URL_DMZ` | URL, mis konfigureeriti HTML5 Gateway komponendi deklareerimisel halduskonsoolis. |
> |  | `HTML5_IP_DMZ` | Selle Dockeri serveri DNS-nimi või IP-aadress, millel HTML5 Gateway Docker on aktiivne. |
> |  | `HTML5_PORT_DMZ` | Port, mille Dockeri server HTML5 Gateway Docker versiooni jaoks avaldab. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> ```

**Paigutatud LAN-võrku, millele Edge Gateway komponent pääseb juurde**

> Üldine skeem on järgmine:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         HTML5(HTML5 Gateway Docker)
>         GW(Edge Gateway)
>     end
>
>
>     MED -.- | Ühendus HTML5-teenusega ; TLS-tunneli kaudu| GW -.-> |Ühendus HTML5-teenusega ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     GW --> |TLS Tunnel| MED
>
>     linkStyle 0,1 stroke:#d22,color;
> ```
>
> Selles kontekstis tuleb allpool toodud teave lisada faili `/etc/ipdiva/httpd/commonParameters.extra.conf` või see fail luua.
> Sätteid saab kohandada:
>
> | Kohandatud väärtus | Muutuja | Kommentaar |
> |---|---|---|
> |  | `HTML5_URL_LAN` | URL, mis konfigureeriti HTML5 Gateway komponendi deklareerimisel halduskonsoolis. |
> |  | `GW_NAME_LAN` | HTML5-teenusega ühenduse loomiseks kasutatava Edge Gateway komponendi nimi. Rea lõpus olev püstkriips **tuleb säilitada**. |
> |  | `ORGANIZATION_NAME_LAN` | Selle organisatsiooni nimi, millega Edge Gateway ühenduse loob. |
> |  | `HTML5_IP_LAN` | Selle Dockeri serveri DNS-nimi või IP-aadress, millel HTML5 Gateway Docker on aktiivne. |
> |  | `HTML5_PORT_LAN` | Port, mille Dockeri server HTML5 Gateway Docker versiooni jaoks avaldab. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> ```
>
> > **Näpunäide**
> >
> > Seda konfiguratsiooni saab kasutada ka järgmises olukorras, kus Edge Gateway Docker ja HTML5 Gateway Docker töötavad samas Dockeri võrgus:
> >
> > ```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 -.- | Ühendus HTML5-teenusega ; TLS-tunneli kaudu| GW -.-> |Ühendus HTML5-teenusega ; TCP 8080 Dockeri võrgu kaudu| HTML5
> >     HTML5 --> |TLS Tunnel| MED
> >     GW --> |TLS Tunnel| MED
> >
> >     linkStyle 0,1 stroke:#d22,color;
> > ```
> >
> > > **Näide**
> > >
> > > Selles näites juurutame samasse Dockeri serverisse Edge Gateway komponendi ja HTML5 Gateway komponendi.
> > >
> > > Näites kasutatud infrastruktuur on järgmine:
> > >
> > > - Mediation Controller server
> > >     - Veebi-IP-aadress: `10.0.10.10`
> > >     - Organisatsiooni nimi: `my-organization-name`
> > >     - Edge Gateway komponendi token: `YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH`
> > >     - HTML5 Gateway komponendi token: `ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF`
> > >     - HTML5-teenusele juurdepääsu URL: `HTML5_DOCKER`
> > > - Dockeri server
> > >     - Dockeri võrgu nimi: `cyberelements-cleanroom-network`
> > >     - Edge Gateway
> > >         - Nimi: `my-edge-gateway-docker`
> > >         - Juurasukoht failisüsteemis: `/opt/my-edge-gateway-docker`
> > >     - HTML5 Gateway
> > >         - Nimi: `my-html5-gateway-docker`
> > >         - Juurasukoht failisüsteemis: `/opt/my-html5-gateway-docker`
> > >
> > > Esmalt peate Dockeri serveris looma Dockeri köidete ühendamiseks kataloogistruktuuri:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > ```
> > >
> > > Seejärel looge `bridge`-tüüpi Dockeri võrk, et kaks konteinerit saaksid omavahel suhelda:
> > >
> > > ```
> > > 1
> > > ```
> > >
> > > Järgmiseks käivitage Edge Gateway konteiner. Pange tähele, et näites luuakse ühendus pairingu abil, juurdepääsuga Mediation Controller serverile selle IP-aadressi kaudu ja ilma sertifikaadikontrollita. Lisaks lisatakse parameeter `--network`, et määrata eelnevalt loodud Dockeri võrgu kasutamine:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > ```
> > >
> > > Järgmiseks käivitage HTML5 Gateway konteiner. Pange tähele, et näites luuakse ühendus pairingu abil, juurdepääsuga Mediation Controller serverile selle IP-aadressi kaudu ja ilma sertifikaadikontrollita. Lisaks lisatakse parameeter `--network`, et määrata eelnevalt loodud Dockeri võrgu kasutamine, ja kuna juurdepääs HTML5-teenusele toimub Dockeri võrgu kaudu, pole pordi 8080 avaldamine vajalik:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > 7
> > > 8
> > > ```
> > >
> > > Lõpuks tuleb Mediation Controller serveri(te)s konfigureerida fail `/etc/ipdiva/httpd/commonParameters.extra.conf`. Lisada tuleks järgmine jaotis:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > 14
> > > 15
> > > 16
> > > 17
> > > 18
> > > 19
> > > 20
> > > 21
> > > ```

Enne uute sätete rakendamist peate kontrollima, et uus konfiguratsioon ei põhjusta veebiserverile Apache2 blokeerivaid tõrkeid.
Selleks käivitage järgmine käsk:

```
1
```

Kui tagastatakse `Syntax OK`, saab muudatused rakendada alloleva käsuga. Vastasel juhul kontrollige oma faili `/etc/ipdiva/httpd/commonParameters.extra.conf` konfiguratsiooni.

```
1
```
