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

# Suiteáil na comhpháirte HTML5 Gateway Docker

## An íomhá Docker a iompórtáil

Sula mbeidh tú in ann coimeádán HTML5 Gateway Docker a chruthú, ní mór duit an íomhá Docker a iompórtáil. Chuige sin, oscail blaosc ina bhfuil na horduithe Docker ar fáil duit, chomh maith leis an gcomhad `cleanroom-html5-4.6.1-33-v2.tgz`. Ón mblaosc, rith an t-ordú seo a leanas, agus coigeartaigh an cosán chuig an gcomhad `TGZ` mura bhfuil sé sa chomhadlann reatha:

```
1
```

Ansin seiceáil gur éirigh leis an iompórtáil leis an ordú seo a leanas:

```
1
```

Seo é an t-aschur a bhfuiltear ag súil leis. Mura amhlaidh atá, theip ar an iompórtáil:

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

> **Aschur iomlán**
>
> ```
>  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
> ```

## Cumraíocht an choimeádáin

### Athróga timpeallachta

#### Athróga le haghaidh imscartha trí phéireáil

| Ainm | Éigeantach | Luach réamhshocraithe | Trácht |
|---|---|---|---|
| `ENV_MEDIATION` | TÁ |  | Úsáidtear é le haghaidh ceangail trí phéireáil. Léiríonn sé an t-ainm DNS nó an seoladh IP chun ceangal le comhéadan gréasáin ardáin CyberElements Bastion. |
| `ENV_TOKEN` | TÁ |  | Úsáidtear é le haghaidh ceangail trí phéireáil. Léiríonn sé an comhartha péireála atá le húsáid chun ceangal leis an gcomhpháirt Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NÍL | `false` | Úsáidtear é le haghaidh ceangal trí phéireáil. Cé acu a dhíchumasaítear nó nach ndíchumasaítear an tseiceáil ar dheimhniú gréasáin na comhpháirte Mediation Controller; úsáideach le CyberElements Bastion nuair a fhaightear rochtain trí sheoladh IP nó nuair nach n-aithníonn na húdaráis deimhniúcháin phoiblí réamhshocraithe an deimhniú gréasáin. Luachanna a nglactar leo: `true` nó `false`. |

#### Athróga le haghaidh imscartha de láimh

| Ainm | Éigeantach | Luach réamhshocraithe | Trácht |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | TÁ |  | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Ainm an chomhaid deimhnithe chun ceangal leis an gcomhpháirt SSL Router. |
| `ENV_GW_CERT_PASSWORD` | TÁ |  | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Pasfhocal an chomhaid deimhnithe chun ceangal leis an gcomhpháirt SSL Router. |
| `ENV_SSL_ROUTER_IP` | TÁ |  | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Seoladh IP nó ainm DNS na comhpháirte SSL Router lena gceanglóidh an chomhpháirt HTML5 Gateway. |
| `ENV_SSL_ROUTER_PORT` | NÍL | `443` | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. An port ar an gcomhpháirt SSL Router lena gceanglóidh an chomhpháirt HTML5 Gateway. |

#### Athróga éagsúla

| Ainm | Éigeantach | Luach réamhshocraithe | Trácht |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NÍL | `false` | Díchumasú na seirbhíse `rsyslog`. Luachanna a nglactar leo: `true` nó `false`. |

### Imleabhair

| Imleabhar | Trácht |
|---|---|
| `/etc/ipdiva/` | Imleabhar cumraíochta na comhpháirte HTML5 Gateway. Molaimid é a fheistiú ar imleabhar ainmnithe nó ar chóras comhad an óstríomhaire. |
| `/opt/certificates/` | Imleabhar ina bhfuil deimhniú nó deimhnithe na comhpháirte HTML5 Gateway i gcumraíocht gan phéireáil. |
| `/var/log/` | Imleabhar ina bhfuil logaí na comhpháirte HTML5 Gateway. |

### Poirt

| Port | Trácht |
|---|---|
| `8080` | Port éisteachta na seirbhíse HTML5. |

## Imscaradh na comhpháirte HTML5 Gateway Docker

### Imscaradh le péireáil

> **Réamhriachtanais**
>
> Sula n-imscarann tú an chomhpháirt HTML5 Gateway Docker, ní mór duit [comhartha péireála a fháil](https://docs.cyberelements.io/bastion/4.6/ga/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/#__tabbed_1_2).

Úsáidfidh an t-imscaradh a thuairiscítear thíos na himleabhair go léir atá ar fáil (seachas `/opt/certificates/` nach bhfuil úsáideach sa chomhthéacs seo) agus nochtfaidh sé na poirt go léir.
Feisteofar na himleabhair ar chóras comhad an óstríomhaire ag an láthair `HTML5_GATEWAY_REP`. Laistigh den láthair seo tá na fochomhadlanna seo a leanas:

- config
- log

Is féidir leat na hathróga a shaincheapadh do na horduithe seo a leanas:

| Luach saincheaptha | Athróg | Nóta tráchta |
|---|---|---|
|  | `DOCKER_NAME` | Ainm an choimeádáin Docker. |
|  | `HTML5_GATEWAY_REP` | An láthair ar an gcóras comhad ar a bhfeisteofar na himleabhair. |
|  | `ENV_MEDIATION_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_NO_CHECK_CERT`. |

Cruthaigh an crann comhadlainne atá riachtanach chun imleabhair a fheistiú ar an gcóras comhad:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Agus ar deireadh, tosaigh coimeádán nua:

**Bash**

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

**PowerShell**

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

Is féidir logaí an choimeádáin a fheiceáil leis an ordú seo a leanas:

```
1
```

### Imscaradh de láimh

> **Réamhriachtanais**
>
> Sula n-imscarann tú an chomhpháirt HTML5 Gateway Docker, ní mór an deimhniú atá riachtanach don chomhpháirt HTML5 Gateway a bheith agat.

> **Pasfhocail infheicthe le `docker inspect`**
>
> Bíonn athróga timpeallachta coimeádáin, pasfhocail na ndeimhnithe san áireamh, inléite ag aon duine a bhfuil cead aige `docker inspect` a rith ar an bhfreastalaí Docker. Dá bhrí sin, is fearr an [t-imscaradh le péireáil](#deployment-with-pairing), nach n-úsáideann aon phasfhocal deimhnithe.

Úsáidfidh an t-imscaradh a thuairiscítear thíos na himleabhair uile atá ar fáil agus nochtfaidh sé na poirt uile.
Feisteofar na himleabhair ar chóras comhad an ríomhaire óstaigh sa láthair `MANUAL_REP`. Sa láthair seo, tá na fochomhadlanna seo a leanas:

- config
- log
- certificates

Is féidir leat na hathróga a shaincheapadh do na horduithe seo a leanas:

| Luach saincheaptha | Athróg | Nóta tráchta |
|---|---|---|
|  | `MANUAL_NAME` | Ainm an choimeádáin Docker. |
|  | `MANUAL_REP` | Láthair ar an gcóras comhad ina bhfeisteofar na himleabhair. |
|  | `ENV_GW_CERT_NAME_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_SSL_ROUTER_PORT`. |

Cruthaigh an crann comhadlainne atá riachtanach chun imleabhair a fheistiú ar an gcóras comhad:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Ansin cuir deimhnithe na comhpháirte HTML5 Gateway agus na seirbhíse taifeadta in `MANUAL_REP/certificates`.

Ionas nach gcoimeádfar pasfhocail na ndeimhnithe i stair na blaoisce, iontráil iad in athróga timpeallachta den seisiún reatha (ní thaispeántar an t-ionchur):

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Ar deireadh, tosaigh coimeádán nua:

**Bash**

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

**PowerShell**

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

Nuair a bheidh an coimeádán tosaithe, bain na hathróga seo den seisiún:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Is féidir logaí an choimeádáin a fheiceáil leis an ordú seo a leanas:

```
1
```

## Cumraíocht na comhpháirte Mediation Controller

Le go mbeidh an chomhpháirt nua HTML5 Gateway Docker in ann feidhmiú, ní mór an freastalaí Mediation Controller a chumrú fós trí rochtain SSH nó consóil agus le ceadanna `root`.

Tá an socrú deireanach seo riachtanach chun go mbeidh an chomhpháirt Mediation Controller in ann cumarsáid a dhéanamh leis an tseirbhís HTML5.
Mar sin féin, braitheann an chumraíocht seo ar láthair na comhpháirte HTML5 Gateway Docker:

**Curtha sa DMZ**

> Seo a leanas an léaráid fhoriomlán:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         HTML5(HTML5 Gateway Docker)
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         GW(Edge Gateway)
>     end
>
>
>     MED -.-> |Ceangal leis an tseirbhís HTML5 ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     MED ~~~ GW
>     GW --> |TLS Tunnel| MED
>     GW ~~~ MED
>
>     linkStyle 0 stroke:#d22,color;
> ```
>
> Sa chomhthéacs seo, beidh gá an fhaisnéis thíos a chur leis an gcomhad `/etc/ipdiva/httpd/commonParameters.extra.conf`, nó an comhad sin a chruthú.
> Is féidir na socruithe a shaincheapadh:
>
> | Luach saincheaptha | Athróg | Nóta tráchta |
> |---|---|---|
> |  | `HTML5_URL_DMZ` | An URL a cumraíodh nuair a fógraíodh an chomhpháirt HTML5 Gateway sa chonsól riaracháin. |
> |  | `HTML5_IP_DMZ` | Ainm DNS nó seoladh IP an fhreastalaí Docker ar a bhfuil an chomhpháirt HTML5 Gateway Docker gníomhach. |
> |  | `HTML5_PORT_DMZ` | An port a fhoilsíonn an freastalaí Docker don chomhpháirt HTML5 Gateway Docker. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> ```

**Curtha sa LAN agus inrochtana trí chomhpháirt Edge Gateway**

> Seo a leanas an léaráid fhoriomlán:
>
> ```mermaid
> flowchart LR
>     subgraph DMZ
>         direction TB
>         MED(Mediation Controller)
>     end
>
>     subgraph LAN
>         HTML5(HTML5 Gateway Docker)
>         GW(Edge Gateway)
>     end
>
>
>     MED -.- | Ceangal leis an tseirbhís HTML5 ; trí thollán TLS| GW -.-> |Ceangal leis an tseirbhís HTML5 ; TCP 8080| HTML5
>     HTML5 --> |TLS Tunnel| MED
>     GW --> |TLS Tunnel| MED
>
>     linkStyle 0,1 stroke:#d22,color;
> ```
>
> Sa chomhthéacs seo, beidh gá an fhaisnéis thíos a chur leis an gcomhad `/etc/ipdiva/httpd/commonParameters.extra.conf`, nó an comhad sin a chruthú.
> Is féidir na socruithe a shaincheapadh:
>
> | Luach saincheaptha | Athróg | Nóta tráchta |
> |---|---|---|
> |  | `HTML5_URL_LAN` | An URL a cumraíodh nuair a fógraíodh an chomhpháirt HTML5 Gateway sa chonsól riaracháin. |
> |  | `GW_NAME_LAN` | Ainm na comhpháirte Edge Gateway a úsáidtear chun ceangal leis an tseirbhís HTML5. Ní mór an carachtar píopa ag deireadh na líne **a choinneáil**. |
> |  | `ORGANIZATION_NAME_LAN` | Ainm na heagraíochta lena gceanglaíonn an chomhpháirt Edge Gateway. |
> |  | `HTML5_IP_LAN` | Ainm DNS nó seoladh IP an fhreastalaí Docker ar a bhfuil an chomhpháirt HTML5 Gateway Docker gníomhach. |
> |  | `HTML5_PORT_LAN` | An port a fhoilsíonn an freastalaí Docker don chomhpháirt HTML5 Gateway Docker. |
>
> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> 21
> ```
>
> > **Leid**
> >
> > Is féidir an chumraíocht seo a úsáid freisin sa chás seo a leanas, ina bhfuil comhpháirt Edge Gateway Docker agus comhpháirt HTML5 Gateway Docker ag rith sa líonra Docker céanna:
> >
> > ```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 -.- | Ceangal leis an tseirbhís HTML5 ; trí thollán TLS| GW -.-> |Ceangal leis an tseirbhís HTML5 ; TCP 8080 trí líonra Docker| HTML5
> >     HTML5 --> |TLS Tunnel| MED
> >     GW --> |TLS Tunnel| MED
> >
> >     linkStyle 0,1 stroke:#d22,color;
> > ```
> >
> > > **Sampla**
> > >
> > > Sa sampla seo, imscarfaimid comhpháirt Edge Gateway agus comhpháirt HTML5 Gateway ar an bhfreastalaí Docker céanna.
> > >
> > > Seo a leanas an bonneagar a úsáidtear don sampla:
> > >
> > > - Freastalaí Mediation Controller
> > >     - Seoladh IP gréasáin: `10.0.10.10`
> > >     - Ainm na heagraíochta: `my-organization-name`
> > >     - Comhartha don chomhpháirt Edge Gateway: `YJ5N-JN05-N5LS-N26H-7JHA-HZ9R-BGJF-MAVH`
> > >     - Comhartha don chomhpháirt HTML5 Gateway: `ATCW-OMVR-0RY4-LW1M-D9G9-H5VF-WPX5-YCXF`
> > >     - URL chun rochtain a fháil ar an tseirbhís HTML5: `HTML5_DOCKER`
> > > - Freastalaí Docker
> > >     - Ainm an líonra Docker: `cyberelements-cleanroom-network`
> > >     - Edge Gateway
> > >         - Ainm: `my-edge-gateway-docker`
> > >         - Láthair fhréimhe ar an gcóras comhad: `/opt/my-edge-gateway-docker`
> > >     - HTML5 Gateway
> > >         - Ainm: `my-html5-gateway-docker`
> > >         - Láthair fhréimhe ar an gcóras comhad: `/opt/my-html5-gateway-docker`
> > >
> > > Ar dtús, ar an bhfreastalaí Docker, ní mór duit an struchtúr crainn a chruthú chun na himleabhair Docker a fheistiú:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > ```
> > >
> > > Ansin cruthaigh líonra Docker den chineál `bridge` ionas gur féidir leis an dá choimeádán cumarsáid a dhéanamh lena chéile:
> > >
> > > ```
> > > 1
> > > ```
> > >
> > > Ansin, tosaigh coimeádán na comhpháirte Edge Gateway. Tabhair faoi deara go mbunaíonn an sampla ceangal trí phéireáil, le rochtain ar an gcomhpháirt Mediation Controller trína seoladh IP agus gan seiceáil deimhnithe. Ina theannta sin, cuirtear an paraiméadar `--network` leis chun úsáid an líonra Docker a cruthaíodh roimhe seo a shonrú:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > ```
> > >
> > > Ansin, tosaigh coimeádán na comhpháirte HTML5 Gateway. Tabhair faoi deara go mbunaíonn an sampla ceangal trí phéireáil, le rochtain ar an gcomhpháirt Mediation Controller trína seoladh IP agus gan seiceáil deimhnithe. Ina theannta sin, cuirtear an paraiméadar `--network` leis chun úsáid an líonra Docker a cruthaíodh roimhe seo a shonrú, agus ós rud é go rachaidh an rochtain ar an tseirbhís HTML5 tríd an líonra Docker, níl gá port 8080 a fhoilsiú:
> > >
> > > ```
> > > 1
> > > 2
> > > 3
> > > 4
> > > 5
> > > 6
> > > 7
> > > 8
> > > ```
> > >
> > > Ar deireadh, ní mór an comhad `/etc/ipdiva/httpd/commonParameters.extra.conf` ar fhreastalaí nó ar fhreastalaithe Mediation Controller a chumrú. Ba cheart an chuid seo a leanas a chur leis:
> > >
> > > ```
> > >  1
> > >  2
> > >  3
> > >  4
> > >  5
> > >  6
> > >  7
> > >  8
> > >  9
> > > 10
> > > 11
> > > 12
> > > 13
> > > 14
> > > 15
> > > 16
> > > 17
> > > 18
> > > 19
> > > 20
> > > 21
> > > ```

Sula gcuireann tú na socruithe nua i bhfeidhm, ní mór duit a sheiceáil nach gcruthaíonn an chumraíocht nua aon earráid bhlocála don fhreastalaí gréasáin Apache2.
Chun é seo a dhéanamh, rith an t-ordú seo a leanas:

```
1
```

Más é `Syntax OK` an toradh, is féidir na hathruithe a chur i bhfeidhm leis an ordú thíos. Mura é, seiceáil cumraíocht do chomhaid `/etc/ipdiva/httpd/commonParameters.extra.conf`.

```
1
```
