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

# Namestitev komponente HTML5 Gateway Docker

## Uvoz slike Docker

Preden lahko ustvarite vsebnik HTML5 Gateway Docker, morate uvoziti sliko Docker. To naredite tako, da zaženete lupino, v kateri so vam na voljo ukazi Docker in datoteka `cleanroom-html5-4.6.1-33-v2.tgz`. V lupini zaženite naslednji ukaz in prilagodite pot do datoteke `TGZ`, če ta ni v trenutni mapi:

```
1
```

Nato z naslednjim ukazom preverite, ali je bil uvoz uspešen:

```
1
```

Pričakovani izpis je naslednji. Če ni tak, uvoz ni uspel:

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

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

## Konfiguracija vsebnika

### Okoljske spremenljivke

#### Spremenljivke za uvedbo s pairingom

| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
| `ENV_MEDIATION` | DA |  | Uporablja se za povezavo prek pairinga. Navaja ime DNS ali naslov IP za povezavo s spletnim vmesnikom platforme CyberElements Bastion. |
| `ENV_TOKEN` | DA |  | Uporablja se za povezavo s pairingom. Navedba tokena pairinga, ki se uporabi za povezavo s storitvijo Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NE | `false` | Uporablja se za povezave prek pairinga. Določa, ali se onemogoči preverjanje spletnega potrdila storitve Mediation Controller; uporabno s platformo CyberElements Bastion pri dostopu prek naslova IP ali kadar spletnega potrdila ne priznavajo privzeti javni overitelji potrdil. Sprejete vrednosti: `true` ali `false`. |

#### Spremenljivke za ročno uvedbo

| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | DA |  | Uporablja se za povezavo z ročno konfiguracijo. Ime datoteke potrdila za povezavo s komponento SSL Router. |
| `ENV_GW_CERT_PASSWORD` | DA |  | Uporablja se za povezavo z ročno konfiguracijo. Geslo datoteke potrdila za povezavo s komponento SSL Router. |
| `ENV_SSL_ROUTER_IP` | DA |  | Uporablja se za povezavo z ročno konfiguracijo. Naslov IP ali ime DNS komponente SSL Router, s katero se bo povezala komponenta HTML5 Gateway. |
| `ENV_SSL_ROUTER_PORT` | NE | `443` | Uporablja se za povezavo z ročno konfiguracijo. Vrata komponente SSL Router, s katero se bo povezala komponenta HTML5 Gateway. |

#### Razne spremenljivke

| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NE | `false` | Onemogočanje storitve `rsyslog`. Sprejete vrednosti: `true` ali `false`. |

### Nosilci

| Nosilec | Opomba |
|---|---|
| `/etc/ipdiva/` | Nosilec s konfiguracijo komponente HTML5 Gateway. Priporočamo, da ga vpnete v imenovani nosilec ali v datotečni sistem gostiteljskega računalnika. |
| `/opt/certificates/` | Nosilec s potrdilom ali potrdili komponente HTML5 Gateway pri konfiguraciji brez pairinga. |
| `/var/log/` | Nosilec z dnevniki komponente HTML5 Gateway. |

### Vrata

| Vrata | Opomba |
|---|---|
| `8080` | Vrata za poslušanje storitve HTML5. |

## Uvedba komponente HTML5 Gateway Docker

### Uvedba s pairingom

> **Predpogoji**
>
> Pred uvedbo komponente HTML5 Gateway Docker morate [pridobiti token pairinga](https://docs.cyberelements.io/bastion/4.6/sl/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).

Spodaj opisana uvedba bo uporabila vse razpoložljive nosilce (razen `/opt/certificates/`, ki v tem kontekstu ni uporaben) in izpostavila vsa vrata.
Nosilci bodo vpeti v datotečni sistem gostiteljskega računalnika na lokaciji `HTML5_GATEWAY_REP`. Na tej lokaciji so naslednje podmape:

- config
- log

Spremenljivke za naslednje ukaze lahko prilagodite:

| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
|  | `DOCKER_NAME` | Ime vsebnika Docker. |
|  | `HTML5_GATEWAY_REP` | Lokacija v datotečnem sistemu, kamor bodo vpeti nosilci. |
|  | `ENV_MEDIATION_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_NO_CHECK_CERT`. |

Ustvarite drevo imenikov, potrebno za vpenjanje nosilcev v datotečni sistem:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

In na koncu zaženite nov vsebnik:

**Bash**

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

**PowerShell**

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

Dnevnike vsebnika si lahko ogledate z naslednjim ukazom:

```
1
```

### Ročna uvedba

> **Predpogoji**
>
> Pred uvedbo komponente HTML5 Gateway Docker morate imeti potrdilo, ki ga zahteva komponenta HTML5 Gateway.

> **Gesla, vidna z ukazom `docker inspect`**
>
> Okoljske spremenljivke vsebnika, vključno z gesli potrdil, lahko prebere vsak, ki sme na strežniku Docker zagnati `docker inspect`. Zato je priporočljivo uporabiti [uvedbo s pairingom](#deployment-with-pairing), ki ne uporablja nobenega gesla potrdila.

Spodaj opisana uvedba bo uporabila vse razpoložljive nosilce in izpostavila vsa vrata.
Nosilci bodo vpeti v datotečni sistem gostiteljskega računalnika na mestu `MANUAL_REP`. Na tem mestu so naslednji podimeniki:

- config
- log
- certificates

Spremenljivke za naslednje ukaze lahko prilagodite:

| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
|  | `MANUAL_NAME` | Ime vsebnika Docker. |
|  | `MANUAL_REP` | Mesto v datotečnem sistemu, kamor se vpnejo nosilci. |
|  | `ENV_GW_CERT_NAME_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_SSL_ROUTER_PORT`. |

Ustvarite drevo imenikov, potrebno za vpenjanje nosilcev v datotečni sistem:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Nato potrdila za komponento HTML5 Gateway in storitev snemanja postavite v `MANUAL_REP/certificates`.

Da se gesla potrdil ne shranijo v zgodovino lupine, jih vnesite v okoljske spremenljivke trenutne seje (vnos ni prikazan):

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Na koncu zaženite nov vsebnik:

**Bash**

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

**PowerShell**

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

Ko se vsebnik zažene, odstranite te spremenljivke iz seje:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Dnevnike vsebnika si lahko ogledate z naslednjim ukazom:

```
1
```

## Konfiguracija storitve Mediation Controller

Da bo novi HTML5 Gateway Docker deloval, morate prek SSH ali dostopa do konzole z dovoljenji `root` konfigurirati še strežnik Mediation Controller.

Ta zadnja nastavitev je potrebna, da lahko storitev Mediation Controller komunicira s storitvijo HTML5.
Ta konfiguracija pa se razlikuje glede na lokacijo komponente HTML5 Gateway Docker:

**Nameščena v DMZ**

> Splošni diagram je naslednji:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         HTML5(HTML5 Gateway Docker)
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         GW(Edge Gateway)
>     end
>
>
>     MED -.-> |Povezava s storitvijo HTML5 ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     MED ~~~ GW
>     GW --> |TLS Tunnel| MED
>     GW ~~~ MED
>
>     linkStyle 0 stroke:#d22,color;
> ```
>
> V tem kontekstu je treba spodnje informacije dodati v datoteko `/etc/ipdiva/httpd/commonParameters.extra.conf` ali to datoteko ustvariti.
> Nastavitve lahko prilagodite:
>
> | Vrednost po meri | Spremenljivka | Komentar |
> |---|---|---|
> |  | `HTML5_URL_DMZ` | URL, konfiguriran ob deklaraciji komponente HTML5 Gateway v skrbniški konzoli. |
> |  | `HTML5_IP_DMZ` | Ime DNS ali naslov IP strežnika Docker, na katerem je aktivna komponenta HTML5 Gateway Docker. |
> |  | `HTML5_PORT_DMZ` | Vrata, ki jih strežnik Docker objavi za komponento HTML5 Gateway Docker. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> ```

**Nameščena v omrežju LAN, dostopnem prek komponente Edge Gateway**

> Splošni diagram je naslednji:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         HTML5(HTML5 Gateway Docker)
>         GW(Edge Gateway)
>     end
>
>
>     MED -.- | Povezava s storitvijo HTML5 ; prek tunela TLS| GW -.-> |Povezava s storitvijo HTML5 ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     GW --> |TLS Tunnel| MED
>
>     linkStyle 0,1 stroke:#d22,color;
> ```
>
> V tem kontekstu je treba spodnje informacije dodati v datoteko `/etc/ipdiva/httpd/commonParameters.extra.conf` ali to datoteko ustvariti.
> Nastavitve lahko prilagodite:
>
> | Vrednost po meri | Spremenljivka | Komentar |
> |---|---|---|
> |  | `HTML5_URL_LAN` | URL, konfiguriran ob deklaraciji komponente HTML5 Gateway v skrbniški konzoli. |
> |  | `GW_NAME_LAN` | Ime komponente Edge Gateway, uporabljene za povezavo s storitvijo HTML5. Znak navpične črte na koncu vrstice **je treba ohraniti**. |
> |  | `ORGANIZATION_NAME_LAN` | Ime organizacije, s katero se povezuje komponenta Edge Gateway. |
> |  | `HTML5_IP_LAN` | Ime DNS ali naslov IP strežnika Docker, na katerem je aktivna komponenta HTML5 Gateway Docker. |
> |  | `HTML5_PORT_LAN` | Vrata, ki jih strežnik Docker objavi za komponento HTML5 Gateway Docker. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> ```
>
> > **Nasvet**
> >
> > To konfiguracijo lahko uporabite tudi v naslednjem primeru, ko se komponenti Edge Gateway Docker in HTML5 Gateway Docker izvajata v istem omrežju Docker:
> >
> > ```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 -.- | Povezava s storitvijo HTML5 ; prek tunela TLS| GW -.-> |Povezava s storitvijo HTML5 ; TCP 8080 prek omrežja Docker| HTML5
> >     HTML5 --> |TLS Tunnel| MED
> >     GW --> |TLS Tunnel| MED
> >
> >     linkStyle 0,1 stroke:#d22,color;
> > ```
> >
> > > **Primer**
> > >
> > > V tem primeru bomo na istem strežniku Docker uvedli komponenti Edge Gateway in HTML5 Gateway.
> > >
> > > Infrastruktura, uporabljena v primeru, je naslednja:
> > >
> > > - Strežnik Mediation Controller
> > >     - Spletni naslov IP: `10.0.10.10`
> > >     - Ime organizacije: `my-organization-name`
> > >     - Token za Edge Gateway: `YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH`
> > >     - Token za HTML5 Gateway: `ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF`
> > >     - URL za dostop do storitve HTML5: `HTML5_DOCKER`
> > > - Strežnik Docker
> > >     - Ime omrežja Docker: `cyberelements-cleanroom-network`
> > >     - Edge Gateway
> > >         - Ime: `my-edge-gateway-docker`
> > >         - Korenska lokacija v datotečnem sistemu: `/opt/my-edge-gateway-docker`
> > >     - HTML5 Gateway
> > >         - Ime: `my-html5-gateway-docker`
> > >         - Korenska lokacija v datotečnem sistemu: `/opt/my-html5-gateway-docker`
> > >
> > > Najprej morate na strežniku Docker ustvariti drevesno strukturo map za vpenjanje nosilcev Docker:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > ```
> > >
> > > Nato ustvarite omrežje Docker vrste `bridge`, da lahko vsebnika komunicirata med seboj:
> > >
> > > ```
> > > 1
> > > ```
> > >
> > > Nato zaženite vsebnik Edge Gateway. Upoštevajte, da primer vzpostavi povezavo prek pairinga z dostopom do storitve Mediation Controller prek njenega naslova IP in brez preverjanja potrdila. Poleg tega je dodan parameter `--network`, ki določa uporabo prej ustvarjenega omrežja Docker:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > ```
> > >
> > > Nato zaženite vsebnik HTML5 Gateway. Upoštevajte, da primer vzpostavi povezavo prek pairinga z dostopom do storitve Mediation Controller prek njenega naslova IP in brez preverjanja potrdila. Poleg tega je dodan parameter `--network`, ki določa uporabo prej ustvarjenega omrežja Docker, in ker bo dostop do storitve HTML5 potekal prek omrežja Docker, objava vrat 8080 ni potrebna:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > 7
> > > 8
> > > ```
> > >
> > > Na koncu morate konfigurirati datoteko `/etc/ipdiva/httpd/commonParameters.extra.conf` na strežniku ali strežnikih Mediation Controller. Dodati je treba naslednji razdelek:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > 14
> > > 15
> > > 16
> > > 17
> > > 18
> > > 19
> > > 20
> > > 21
> > > ```

Preden uporabite nove nastavitve, morate preveriti, da nova konfiguracija ne povzroča blokirajočih napak za spletni strežnik Apache2.
To storite tako, da zaženete naslednji ukaz:

```
1
```

Če je rezultat `Syntax OK`, lahko spremembe uveljavite s spodnjim ukazom. V nasprotnem primeru preverite konfiguracijo svoje datoteke `/etc/ipdiva/httpd/commonParameters.extra.conf`.

```
1
```
