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

# Suiteáil na comhpháirte Edge Gateway Docker

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

Sula mbeidh tú in ann coimeádán Edge 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-gateway-4.6.1-33-v4.tgz`. Ón mblaosc, rith an t-ordú seo a leanas, agus coigeartaigh an chonair 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 (d'fhéadfadh an t-aitheantóir SHA256 a bheith difriúil ag brath ar an gcóras oibriúcháin ar a bhfuil Docker suiteáilte; is ó Debian 13 na samplaí). 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
> 74
> 75
> 76
> 77
> 78
> 79
> 80
> 81
> 82
> 83
> ```

## 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. Ainm DNS nó 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_CARE_CERT_NAME` | NÍL | Luach `ENV_GW_CERT_NAME` | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Ainm an chomhaid deimhnithe don tseirbhís taifeadta. |
| `ENV_CARE_CERT_PASSWORD` | NÍL | Luach `ENV_GW_CERT_PASSWORD` | Úsáidtear é le haghaidh ceangail le cumraíocht láimhe. Pasfhocal chomhad deimhnithe na seirbhíse taifeadta. |
| `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 Edge 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 Edge 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`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NÍL | `false` | Cumasaíonn sé socruithe Kerberos chun ligean d'fheidhmchláir RDP fíordheimhniú sa mhód gan ghníomhaire trí Kerberos. Luachanna a nglactar leo: `true` nó `false`. Más `false` é, déanfar neamhaird de na hathróga Kerberos eile. |
| `ENV_KERBEROS_DEFAULT_REALM` | TÁ (má tá cumraíocht Kerberos cumasaithe) |  | Ainm na ríochta Kerberos. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | TÁ (má tá cumraíocht Kerberos cumasaithe) |  | Ainm an fhearainn Kerberos. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | TÁ (má tá cumraíocht Kerberos cumasaithe) |  | Seoladh ceangail chuig an rialaitheoir Kerberos. |

### Imleabhair

| Imleabhar | Trácht |
|---|---|
| `/etc/ipdiva/` | Imleabhar cumraíochta na comhpháirte Edge 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 Edge Gateway i gcumraíocht gan phéireáil. |
| `/var/lib/ipdiva/carerecord/archives/` | Imleabhar ina bhfuil na cartlanna grafacha. Molaimid é a fheistiú ar imleabhar ainmnithe nó ar chóras comhad an óstríomhaire. |
| `/var/ipdiva/care/sshrecord/` | Imleabhar ina bhfuil na cartlanna SSH. Molaimid é a fheistiú ar imleabhar ainmnithe nó ar chóras comhad an óstríomhaire. |
| `/var/log/` | Imleabhar ina bhfuil logaí na comhpháirte Edge Gateway. |

### Poirt

| Port | Trácht |
|---|---|
| `2222` (nó aon phort eile atá ar fáil a roghnaíonn an riarthóir) | Port éisteachta na seirbhíse rochtana dírí SSH/SFTP. |
| `3389` | Port éisteachta na seirbhíse rochtana dírí RDP. |
| `8443` | Port éisteachta na seirbhíse taifeadta, le nochtadh nuair a úsáidtear an gníomhaire taifeadta do Windows. |

## Imscaradh na comhpháirte Edge Gateway Docker

### Imscaradh le péireáil

> **Réamhriachtanais**
>
> Sula n-imscarann tú an chomhpháirt Edge 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/).

Ú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 `EDGE_GATEWAY_REP`. Laistigh den láthair seo tá na fochomhadlanna seo a leanas:

- config
- graphical_archives
- ssh_archives
- 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. |
|  | `EDGE_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`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

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

**Bash**

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

**PowerShell**

> ```
> 1
> ```

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

**Bash**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> ```

**PowerShell**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> ```

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 Edge Gateway Docker, ní mór na deimhnithe riachtanacha a bheith agat don chomhpháirt Edge Gateway agus don tseirbhís taifeadta.

> **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
- graphical_archives
- ssh_archives
- 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_CARE_CERT_NAME_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_CARE_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`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Luach na [hathróige timpeallachta](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

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

**Bash**

> ```
> 1
> 2
> 3
> 4
> 5
> ```

**PowerShell**

> ```
> 1
> ```

Ansin, cuir na deimhnithe don chomhpháirt Edge Gateway agus don tseirbhís taifeadta sa chomhadlann `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
> 3
> ```

**PowerShell**

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

Ar deireadh, tosaigh coimeádán nua:

**Bash**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```

**PowerShell**

> ```
>  1
>  2
>  3
>  4
>  5
>  6
>  7
>  8
>  9
> 10
> 11
> 12
> 13
> 14
> 15
> 16
> 17
> 18
> 19
> 20
> ```

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
```
