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

# HTML5 Gateway Docker įdiegimas

## Docker atvaizdo importavimas

Prieš kurdami HTML5 Gateway Docker konteinerį, turite importuoti Docker atvaizdą. Tam atidarykite apvalkalą, kuriame jums pasiekiamos Docker komandos ir failas `cleanroom-html5-4.6.1-33-v2.tgz`. Apvalkale paleiskite šią komandą, pakoreguodami kelią iki `TGZ` failo, jei jo nėra dabartiniame kataloge:

```
1
```

Tada šia komanda patikrinkite, ar importavimas pavyko:

```
1
```

Laukiama išvestis yra tokia. Jei taip nėra, importuoti nepavyko:

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

> **Visa išvestis**
>
> ```
>  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
> ```

## Konteinerio konfigūracija

### Aplinkos kintamieji

#### Kintamieji diegimui naudojant pairing

| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
| `ENV_MEDIATION` | TAIP |  | Naudojamas jungiantis per pairing. Nurodo DNS vardą arba IP adresą, skirtą prisijungti prie CyberElements Bastion platformos žiniatinklio sąsajos. |
| `ENV_TOKEN` | TAIP |  | Naudojama pairing ryšiui. Nurodo pairing tokeną, naudotiną jungiantis prie Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NE | `false` | Naudojamas jungiantis per pairing. Ar išjungti Mediation Controller žiniatinklio sertifikato tikrinimą; naudinga su CyberElements Bastion, kai jungiamasi per IP adresą arba kai žiniatinklio sertifikato nepripažįsta numatytosios viešosios sertifikavimo institucijos. Priimamos reikšmės: `true` arba `false`. |

#### Kintamieji rankiniam diegimui

| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | TAIP |  | Naudojama ryšiui su rankine konfigūracija. Sertifikato failo, skirto jungtis prie SSL Router, pavadinimas. |
| `ENV_GW_CERT_PASSWORD` | TAIP |  | Naudojama ryšiui su rankine konfigūracija. Sertifikato failo, skirto jungtis prie SSL Router, slaptažodis. |
| `ENV_SSL_ROUTER_IP` | TAIP |  | Naudojamas jungiantis su rankine konfigūracija. Komponento SSL Router, prie kurio jungsis HTML5 Gateway, IP adresas arba DNS vardas. |
| `ENV_SSL_ROUTER_PORT` | NE | `443` | Naudojamas jungiantis su rankine konfigūracija. Komponento SSL Router, prie kurio jungsis HTML5 Gateway, prievadas. |

#### Įvairūs kintamieji

| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NE | `false` | Paslaugos `rsyslog` išjungimas. Leistinos reikšmės: `true` arba `false`. |

### Tomai

| Tomas | Komentaras |
|---|---|
| `/etc/ipdiva/` | HTML5 Gateway konfigūracijos tomas. Rekomenduojame jį prijungti prie įvardytojo tomo arba pagrindinio kompiuterio failų sistemos. |
| `/opt/certificates/` | Tomas, kuriame yra HTML5 Gateway sertifikatas (-ai), kai konfigūruojama be pairing. |
| `/var/log/` | Tomas, kuriame yra HTML5 Gateway žurnalai. |

### Prievadai

| Prievadas | Komentaras |
|---|---|
| `8080` | HTML5 paslaugos klausymo prievadas. |

## HTML5 Gateway Docker diegimas

### Diegimas naudojant pairing

> **Būtinosios sąlygos**
>
> Prieš diegdami HTML5 Gateway Docker, turite [gauti pairing tokeną](https://docs.cyberelements.io/bastion/4.6/lt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).

Toliau aprašytam diegimui bus naudojami visi galimi tomai (išskyrus `/opt/certificates/`, kuris šiame kontekste nenaudingas) ir bus atverti visi prievadai.
Tomai bus prijungti prie pagrindinio kompiuterio failų sistemos vietoje `HTML5_GATEWAY_REP`. Šioje vietoje yra šie pakatalogiai:

- config
- log

Galite pritaikyti toliau pateiktų komandų kintamuosius:

| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
|  | `DOCKER_NAME` | Docker konteinerio pavadinimas. |
|  | `HTML5_GATEWAY_REP` | Failų sistemos vieta, kurioje bus prijungti tomai. |
|  | `ENV_MEDIATION_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_MEDIATION` reikšmė. |
|  | `ENV_TOKEN_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_TOKEN` reikšmė. |
|  | `ENV_NO_CHECK_CERT_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_NO_CHECK_CERT` reikšmė. |

Sukurkite katalogų medį, reikalingą tomams prijungti failų sistemoje:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Ir galiausiai paleiskite naują konteinerį:

**Bash**

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

**PowerShell**

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

Konteinerio žurnalus galima peržiūrėti naudojant šią komandą:

```
1
```

### Rankinis diegimas

> **Būtinosios sąlygos**
>
> Prieš diegdami HTML5 Gateway Docker, turite turėti HTML5 Gateway reikalingą sertifikatą.

> **Slaptažodžiai, matomi naudojant `docker inspect`**
>
> Konteinerio aplinkos kintamieji, įskaitant sertifikatų slaptažodžius, lieka perskaitomi kiekvienam, kam leidžiama vykdyti `docker inspect` Docker serveryje. Todėl pirmenybę reikėtų teikti [diegimui su pairing](#deployment-with-pairing), kuriam nereikia jokio sertifikato slaptažodžio.

Toliau aprašytas diegimas naudos visus galimus tomus ir atvers visus prievadus.
Tomai bus prijungti prie pagrindinio kompiuterio failų sistemos vietoje `MANUAL_REP`. Šioje vietoje yra šie pakatalogiai:

- config
- log
- certificates

Galite pritaikyti toliau pateiktų komandų kintamuosius:

| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
|  | `MANUAL_NAME` | Docker konteinerio pavadinimas. |
|  | `MANUAL_REP` | Failų sistemos vieta, kurioje prijungiami tomai. |
|  | `ENV_GW_CERT_NAME_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_GW_CERT_NAME` reikšmė. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_SSL_ROUTER_IP` reikšmė. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_SSL_ROUTER_PORT` reikšmė. |

Sukurkite katalogų medį, reikalingą tomams prijungti failų sistemoje:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Tada HTML5 Gateway ir įrašymo paslaugos sertifikatus įdėkite į `MANUAL_REP/certificates`.

Kad sertifikatų slaptažodžiai nebūtų išsaugoti apvalkalo istorijoje, įveskite juos į dabartinio seanso aplinkos kintamuosius (įvestis nerodoma):

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Galiausiai paleiskite naują konteinerį:

**Bash**

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

**PowerShell**

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

Kai konteineris bus paleistas, pašalinkite šiuos kintamuosius iš seanso:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Konteinerio žurnalus galima peržiūrėti naudojant šią komandą:

```
1
```

## Mediation Controller konfigūravimas

Kad naujasis HTML5 Gateway Docker veiktų, dar reikia sukonfigūruoti Mediation Controller serverį per SSH arba konsolės prieigą su `root` leidimais.

Šis paskutinis parametras būtinas, kad Mediation Controller galėtų palaikyti ryšį su HTML5 paslauga.
Tačiau ši konfigūracija skiriasi priklausomai nuo HTML5 Gateway Docker vietos:

**Esantis DMZ**

> Bendroji schema yra tokia:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         HTML5(HTML5 Gateway Docker)
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         GW(Edge Gateway)
>     end
>
>
>     MED -.-> |Ryšys su HTML5 paslauga ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     MED ~~~ GW
>     GW --> |TLS Tunnel| MED
>     GW ~~~ MED
>
>     linkStyle 0 stroke:#d22,color;
> ```
>
> Šiuo atveju reikės pridėti toliau pateiktą informaciją į failą `/etc/ipdiva/httpd/commonParameters.extra.conf` arba jį sukurti.
> Parametrus galima pritaikyti:
>
> | Pasirinktinė reikšmė | Kintamasis | Komentaras |
> |---|---|---|
> |  | `HTML5_URL_DMZ` | URL, sukonfigūruotas deklaruojant HTML5 Gateway administravimo konsolėje. |
> |  | `HTML5_IP_DMZ` | Docker serverio, kuriame veikia HTML5 Gateway Docker, DNS vardas arba IP adresas. |
> |  | `HTML5_PORT_DMZ` | Prievadas, kurį Docker serveris publikuoja HTML5 Gateway Docker. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> ```

**Esantis LAN, pasiekiamas per Edge Gateway**

> Bendroji schema yra tokia:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         HTML5(HTML5 Gateway Docker)
>         GW(Edge Gateway)
>     end
>
>
>     MED -.- | Ryšys su HTML5 paslauga ; per TLS tunelį| GW -.-> |Ryšys su HTML5 paslauga ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     GW --> |TLS Tunnel| MED
>
>     linkStyle 0,1 stroke:#d22,color;
> ```
>
> Šiuo atveju reikės pridėti toliau pateiktą informaciją į failą `/etc/ipdiva/httpd/commonParameters.extra.conf` arba jį sukurti.
> Parametrus galima pritaikyti:
>
> | Pasirinktinė reikšmė | Kintamasis | Komentaras |
> |---|---|---|
> |  | `HTML5_URL_LAN` | URL, sukonfigūruotas deklaruojant HTML5 Gateway administravimo konsolėje. |
> |  | `GW_NAME_LAN` | Edge Gateway, naudojamo prisijungti prie HTML5 paslaugos, pavadinimas. Vertikalios linijos simbolį eilutės pabaigoje **būtina palikti**. |
> |  | `ORGANIZATION_NAME_LAN` | Organizacijos, prie kurios jungiasi Edge Gateway, pavadinimas. |
> |  | `HTML5_IP_LAN` | Docker serverio, kuriame veikia HTML5 Gateway Docker, DNS vardas arba IP adresas. |
> |  | `HTML5_PORT_LAN` | Prievadas, kurį Docker serveris publikuoja HTML5 Gateway Docker. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> ```
>
> > **Patarimas**
> >
> > Šią konfigūraciją taip pat galima naudoti toliau nurodytu atveju, kai Docker Edge Gateway ir Docker HTML5 Gateway veikia tame pačiame Docker tinkle:
> >
> > ```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 -.- | Ryšys su HTML5 paslauga ; per TLS tunelį| GW -.-> |Ryšys su HTML5 paslauga ; TCP 8080 per Docker tinklą| HTML5
> >     HTML5 --> |TLS Tunnel| MED
> >     GW --> |TLS Tunnel| MED
> >
> >     linkStyle 0,1 stroke:#d22,color;
> > ```
> >
> > > **Pavyzdys**
> > >
> > > Šiame pavyzdyje tame pačiame Docker serveryje įdiegsime Edge Gateway ir HTML5 Gateway.
> > >
> > > Pavyzdyje naudojama infrastruktūra yra tokia:
> > >
> > > - Mediation Controller serveris
> > >     - Žiniatinklio IP adresas: `10.0.10.10`
> > >     - Organizacijos pavadinimas: `my-organization-name`
> > >     - Edge Gateway tokenas: `YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH`
> > >     - HTML5 Gateway tokenas: `ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF`
> > >     - URL, skirtas pasiekti HTML5 paslaugą: `HTML5_DOCKER`
> > > - Docker serveris
> > >     - Docker tinklo pavadinimas: `cyberelements-cleanroom-network`
> > >     - Edge Gateway
> > >         - Pavadinimas: `my-edge-gateway-docker`
> > >         - Šakninė vieta failų sistemoje: `/opt/my-edge-gateway-docker`
> > >     - HTML5 Gateway
> > >         - Pavadinimas: `my-html5-gateway-docker`
> > >         - Šakninė vieta failų sistemoje: `/opt/my-html5-gateway-docker`
> > >
> > > Pirmiausia Docker serveryje turite sukurti katalogų medį Docker tomams prijungti:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > ```
> > >
> > > Tada sukurkite `bridge` tipo Docker tinklą, kad abu konteineriai galėtų palaikyti ryšį tarpusavyje:
> > >
> > > ```
> > > 1
> > > ```
> > >
> > > Tada paleiskite Edge Gateway konteinerį. Atkreipkite dėmesį, kad pavyzdyje ryšys užmezgamas per pairing, Mediation Controller pasiekiamas per jo IP adresą, o sertifikatas netikrinamas. Be to, pridedamas parametras `--network`, nurodantis, kad naudojamas anksčiau sukurtas Docker tinklas:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > ```
> > >
> > > Tada paleiskite HTML5 Gateway konteinerį. Atkreipkite dėmesį, kad pavyzdyje ryšys užmezgamas per pairing, Mediation Controller pasiekiamas per jo IP adresą, o sertifikatas netikrinamas. Be to, pridedamas parametras `--network`, nurodantis, kad naudojamas anksčiau sukurtas Docker tinklas, o kadangi HTML5 paslauga bus pasiekiama per Docker tinklą, publikuoti prievado 8080 nebūtina:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > 7
> > > 8
> > > ```
> > >
> > > Galiausiai reikia sukonfigūruoti Mediation Controller serverio (-ių) failą `/etc/ipdiva/httpd/commonParameters.extra.conf`. Reikia pridėti šį skyrių:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > 14
> > > 15
> > > 16
> > > 17
> > > 18
> > > 19
> > > 20
> > > 21
> > > ```

Prieš pritaikydami naujus parametrus, turite patikrinti, ar nauja konfigūracija nesukelia jokių blokuojančių Apache2 žiniatinklio serverio klaidų.
Norėdami tai padaryti, vykdykite šią komandą:

```
1
```

Jei grąžinama `Syntax OK`, pakeitimus galima pritaikyti toliau pateikta komanda. Priešingu atveju patikrinkite savo failo `/etc/ipdiva/httpd/commonParameters.extra.conf` konfigūraciją.

```
1
```
