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

# HTML5 Gateway Docker instalēšana

## Docker attēla importēšana

Pirms varat izveidot HTML5 Gateway Docker konteineru, ir jāimportē Docker attēls. Lai to izdarītu, atveriet čaulu, kurā jums ir pieejamas Docker komandas, kā arī fails `cleanroom-html5-4.6.1-33-v2.tgz`. Čaulā izpildiet šo komandu, pielāgojot ceļu uz `TGZ` failu, ja tas neatrodas pašreizējā direktorijā:

```
1
```

Pēc tam ar šo komandu pārbaudiet, vai importēšana bija sekmīga:

```
1
```

Paredzamā izvade ir šāda. Ja tā nav, importēšana nav izdevusies:

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

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

## Konteinera konfigurācija

### Vides mainīgie

#### Mainīgie izvietošanai, izmantojot pairing

| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
| `ENV_MEDIATION` | JĀ |  | Tiek izmantots pairing savienojumam. Norāda DNS nosaukumu vai IP adresi savienojumam ar CyberElements Bastion platformas tīmekļa saskarni. |
| `ENV_TOKEN` | JĀ |  | Tiek izmantots pairing savienojumam. Norāda pairing marķieri, kas jāizmanto savienojumam ar Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NĒ | `false` | Tiek izmantots pairing savienojumiem. Norāda, vai atspējot Mediation Controller tīmekļa sertifikāta pārbaudi; noder ar CyberElements Bastion, ja piekļuve notiek, izmantojot IP adresi, vai ja tīmekļa sertifikāts nav sertifikāts, ko atpazīst noklusējuma publiskās sertificēšanas iestādes. Pieņemtās vērtības: `true` vai `false`. |

#### Mainīgie manuālai izvietošanai

| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | JĀ |  | Tiek izmantots savienojumam ar manuālu konfigurāciju. Sertifikāta faila nosaukums savienojumam ar SSL Router. |
| `ENV_GW_CERT_PASSWORD` | JĀ |  | Tiek izmantots savienojumam ar manuālu konfigurāciju. Sertifikāta faila parole savienojumam ar SSL Router. |
| `ENV_SSL_ROUTER_IP` | JĀ |  | Tiek izmantots savienojumam ar manuālu konfigurāciju. Komponenta SSL Router IP adrese vai DNS nosaukums, ar kuru izveidos savienojumu HTML5 Gateway. |
| `ENV_SSL_ROUTER_PORT` | NĒ | `443` | Tiek izmantots savienojumam ar manuālu konfigurāciju. Komponenta SSL Router ports, ar kuru izveidos savienojumu HTML5 Gateway. |

#### Dažādi mainīgie

| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NĒ | `false` | Pakalpojuma `rsyslog` atspējošana. Pieņemamās vērtības: `true` vai `false`. |

### Sējumi

| Sējums | Komentārs |
|---|---|
| `/etc/ipdiva/` | HTML5 Gateway konfigurācijas sējums. Ieteicams to uzstādīt nosauktā sējumā vai resursdatora failu sistēmā. |
| `/opt/certificates/` | Sējums, kurā ir HTML5 Gateway sertifikāts(-i), ja konfigurē bez pairing. |
| `/var/log/` | Sējums, kurā ir HTML5 Gateway žurnāli. |

### Porti

| Ports | Komentārs |
|---|---|
| `8080` | HTML5 pakalpojuma klausīšanās ports. |

## HTML5 Gateway Docker izvietošana

### Izvietošana, izmantojot pairing

> **Priekšnosacījumi**
>
> Pirms HTML5 Gateway Docker izvietošanas ir [jāiegūst pairing marķieris](https://docs.cyberelements.io/bastion/4.6/lv/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).

Tālāk aprakstītajā izvietošanā tiks izmantoti visi pieejamie sējumi (izņemot `/opt/certificates/`, kas šajā kontekstā nav noderīgs) un padarīti pieejami visi porti.
Sējumi tiks uzstādīti resursdatora failu sistēmā atrašanās vietā `HTML5_GATEWAY_REP`. Šajā atrašanās vietā ir šādi apakšdirektoriji:

- config
- log

Tālāk norādīto komandu mainīgos varat pielāgot:

| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
|  | `DOCKER_NAME` | Docker konteinera nosaukums. |
|  | `HTML5_GATEWAY_REP` | Atrašanās vieta failu sistēmā, kurā uzstādīt sējumus. |
|  | `ENV_MEDIATION_VALUE` | [Vides mainīgā](#environment-variables) `ENV_MEDIATION` vērtība. |
|  | `ENV_TOKEN_VALUE` | [Vides mainīgā](#environment-variables) `ENV_TOKEN` vērtība. |
|  | `ENV_NO_CHECK_CERT_VALUE` | [Vides mainīgā](#environment-variables) `ENV_NO_CHECK_CERT` vērtība. |

Izveidojiet direktoriju koku, kas nepieciešams sējumu piemontēšanai failu sistēmā:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Un visbeidzot palaidiet jaunu konteineru:

**Bash**

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

**PowerShell**

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

Konteinera žurnālus var skatīt, izmantojot šo komandu:

```
1
```

### Manuāla izvietošana

> **Priekšnosacījumi**
>
> Pirms HTML5 Gateway Docker izvietošanas jums ir jābūt HTML5 Gateway nepieciešamajam sertifikātam.

> **Paroles, kas redzamas ar `docker inspect`**
>
> Konteinera vides mainīgos, tostarp sertifikātu paroles, var nolasīt ikviens, kam Docker serverī ir atļauts izpildīt `docker inspect`. Tāpēc ieteicams izmantot [izvietošanu ar pairing](#deployment-with-pairing), kurai nav vajadzīga sertifikāta parole.

Tālāk aprakstītā izvietošana izmantos visus pieejamos sējumus un padarīs pieejamus visus portus.
Sējumi tiks pievienoti resursdatora failu sistēmā vietā `MANUAL_REP`. Šajā vietā atrodas šādas apakšmapes:

- config
- log
- certificates

Tālāk norādīto komandu mainīgos varat pielāgot:

| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
|  | `MANUAL_NAME` | Docker konteinera nosaukums. |
|  | `MANUAL_REP` | Vieta failu sistēmā, kur pievienot sējumus. |
|  | `ENV_GW_CERT_NAME_VALUE` | [Vides mainīgā](#environment-variables) `ENV_GW_CERT_NAME` vērtība. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | [Vides mainīgā](#environment-variables) `ENV_SSL_ROUTER_IP` vērtība. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | [Vides mainīgā](#environment-variables) `ENV_SSL_ROUTER_PORT` vērtība. |

Izveidojiet direktoriju koku, kas nepieciešams sējumu piemontēšanai failu sistēmā:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Pēc tam ievietojiet HTML5 Gateway un ierakstīšanas pakalpojuma sertifikātus direktorijā `MANUAL_REP/certificates`.

Lai sertifikātu paroles netiktu saglabātas čaulas vēsturē, ievadiet tās pašreizējās sesijas vides mainīgajos (ievadītais netiek rādīts):

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Visbeidzot palaidiet jaunu konteineru:

**Bash**

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

**PowerShell**

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

Kad konteiners ir palaists, noņemiet šos mainīgos no sesijas:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Konteinera žurnālus var skatīt, izmantojot šo komandu:

```
1
```

## Mediation Controller konfigurēšana

Lai jaunais HTML5 Gateway Docker būtu darbspējīgs, vēl ir jākonfigurē Mediation Controller serveris, izmantojot SSH vai konsoles piekļuvi un `root` atļaujas.

Šis pēdējais iestatījums ir nepieciešams, lai komponents Mediation Controller varētu sazināties ar HTML5 pakalpojumu.
Tomēr šī konfigurācija atšķiras atkarībā no HTML5 Gateway Docker atrašanās vietas:

**Novietots DMZ zonā**

> Vispārējā shēma ir šāda:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         HTML5(HTML5 Gateway Docker)
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         GW(Edge Gateway)
>     end
>
>
>     MED -.-> |Savienojums ar HTML5 pakalpojumu ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     MED ~~~ GW
>     GW --> |TLS Tunnel| MED
>     GW ~~~ MED
>
>     linkStyle 0 stroke:#d22,color;
> ```
>
> Šajā kontekstā tālāk sniegtā informācija būs jāpievieno failam `/etc/ipdiva/httpd/commonParameters.extra.conf` vai šis fails jāizveido.
> Iestatījumus var pielāgot:
>
> | Pielāgotā vērtība | Mainīgais | Komentārs |
> |---|---|---|
> |  | `HTML5_URL_DMZ` | URL, kas konfigurēts, deklarējot HTML5 Gateway administrēšanas konsolē. |
> |  | `HTML5_IP_DMZ` | Tā Docker servera DNS nosaukums vai IP adrese, kurā ir aktīvs HTML5 Gateway Docker. |
> |  | `HTML5_PORT_DMZ` | Ports, ko Docker serveris publicē HTML5 Gateway Docker vajadzībām. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> ```

**Novietots LAN tīklā, piekļūstams, izmantojot Edge Gateway**

> Vispārējā shēma ir šāda:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         HTML5(HTML5 Gateway Docker)
>         GW(Edge Gateway)
>     end
>
>
>     MED -.- | Savienojums ar HTML5 pakalpojumu ; caur TLS tuneli| GW -.-> |Savienojums ar HTML5 pakalpojumu ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     GW --> |TLS Tunnel| MED
>
>     linkStyle 0,1 stroke:#d22,color;
> ```
>
> Šajā kontekstā tālāk sniegtā informācija būs jāpievieno failam `/etc/ipdiva/httpd/commonParameters.extra.conf` vai šis fails jāizveido.
> Iestatījumus var pielāgot:
>
> | Pielāgotā vērtība | Mainīgais | Komentārs |
> |---|---|---|
> |  | `HTML5_URL_LAN` | URL, kas konfigurēts, deklarējot HTML5 Gateway administrēšanas konsolē. |
> |  | `GW_NAME_LAN` | Tā Edge Gateway nosaukums, ko izmanto savienojumam ar HTML5 pakalpojumu. Vertikālās joslas rakstzīme rindas beigās **ir jāsaglabā**. |
> |  | `ORGANIZATION_NAME_LAN` | Tās organizācijas nosaukums, ar kuru izveido savienojumu Edge Gateway. |
> |  | `HTML5_IP_LAN` | Tā Docker servera DNS nosaukums vai IP adrese, kurā ir aktīvs HTML5 Gateway Docker. |
> |  | `HTML5_PORT_LAN` | Ports, ko Docker serveris publicē HTML5 Gateway Docker vajadzībām. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> ```
>
> > **Padoms**
> >
> > Šo konfigurāciju var izmantot arī tālāk aprakstītajā situācijā, kad Docker Edge Gateway un Docker HTML5 Gateway darbojas vienā Docker tīklā:
> >
> > ```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 -.- | Savienojums ar HTML5 pakalpojumu ; caur TLS tuneli| GW -.-> |Savienojums ar HTML5 pakalpojumu ; TCP 8080 caur Docker tīklu| HTML5
> >     HTML5 --> |TLS Tunnel| MED
> >     GW --> |TLS Tunnel| MED
> >
> >     linkStyle 0,1 stroke:#d22,color;
> > ```
> >
> > > **Piemērs**
> > >
> > > Šajā piemērā mēs izvietosim Edge Gateway un HTML5 Gateway vienā Docker serverī.
> > >
> > > Piemērā izmantotā infrastruktūra ir šāda:
> > >
> > > - Mediation Controller serveris
> > >     - Tīmekļa IP adrese: `10.0.10.10`
> > >     - Organizācijas nosaukums: `my-organization-name`
> > >     - Edge Gateway marķieris: `YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH`
> > >     - HTML5 Gateway marķieris: `ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF`
> > >     - URL piekļuvei HTML5 pakalpojumam: `HTML5_DOCKER`
> > > - Docker serveris
> > >     - Docker tīkla nosaukums: `cyberelements-cleanroom-network`
> > >     - Edge Gateway
> > >         - Nosaukums: `my-edge-gateway-docker`
> > >         - Saknes atrašanās vieta failu sistēmā: `/opt/my-edge-gateway-docker`
> > >     - HTML5 Gateway
> > >         - Nosaukums: `my-html5-gateway-docker`
> > >         - Saknes atrašanās vieta failu sistēmā: `/opt/my-html5-gateway-docker`
> > >
> > > Vispirms Docker serverī ir jāizveido direktoriju struktūra Docker sējumu uzstādīšanai:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > ```
> > >
> > > Pēc tam izveidojiet `bridge` tipa Docker tīklu, lai abi konteineri varētu savstarpēji sazināties:
> > >
> > > ```
> > > 1
> > > ```
> > >
> > > Pēc tam startējiet Edge Gateway konteineru. Ņemiet vērā, ka piemērā savienojums tiek izveidots, izmantojot pairing, ar piekļuvi komponentam Mediation Controller, izmantojot tā IP adresi, un bez sertifikāta pārbaudes. Turklāt tiek pievienots parametrs `--network`, lai norādītu iepriekš izveidotā Docker tīkla izmantošanu:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > ```
> > >
> > > Pēc tam startējiet HTML5 Gateway konteineru. Ņemiet vērā, ka piemērā savienojums tiek izveidots, izmantojot pairing, ar piekļuvi komponentam Mediation Controller, izmantojot tā IP adresi, un bez sertifikāta pārbaudes. Turklāt tiek pievienots parametrs `--network`, lai norādītu iepriekš izveidotā Docker tīkla izmantošanu, un, tā kā piekļuve HTML5 pakalpojumam notiks caur Docker tīklu, porta 8080 publicēšana nav nepieciešama:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > 7
> > > 8
> > > ```
> > >
> > > Visbeidzot ir jākonfigurē fails `/etc/ipdiva/httpd/commonParameters.extra.conf` Mediation Controller serverī(-os). Jāpievieno šāda sadaļa:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > 14
> > > 15
> > > 16
> > > 17
> > > 18
> > > 19
> > > 20
> > > 21
> > > ```

Pirms jauno iestatījumu lietošanas jāpārbauda, vai jaunā konfigurācija neizraisa Apache2 tīmekļa servera bloķējošas kļūdas.
Lai to izdarītu, izpildiet šādu komandu:

```
1
```

Ja tiek atgriezts `Syntax OK`, izmaiņas var lietot ar tālāk norādīto komandu. Pretējā gadījumā pārbaudiet sava faila `/etc/ipdiva/httpd/commonParameters.extra.conf` konfigurāciju.

```
1
```
