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

# Installazzjoni tal-komponent Edge Gateway Docker

## Importazzjoni tal-immaġni Docker

Qabel ma tkun tista’ toħloq kontenitur Edge Gateway Docker, trid timporta l-immaġni Docker. Biex tagħmel dan, iftaħ shell li minnha jkollok disponibbli l-kmandi Docker, kif ukoll il-fajl `cleanroom-gateway-4.6.1-33-v4.tgz`. Mix-shell, ħaddem il-kmand li ġej, u aġġusta l-mogħdija għall-fajl `TGZ` jekk ma jkunx fil-folder kurrenti:

```
1
```

Imbagħad iċċekkja li l-importazzjoni rnexxiet bil-kmand li ġej:

```
1
```

L-output mistenni huwa kif ġej (l-ID SHA256 jista’ jvarja skont is-sistema operattiva li fuqha huwa installat Docker; l-eżempji huma minn Debian 13). Jekk dan ma jkunx il-każ, l-importazzjoni tkun falliet:

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

> **Output sħiħ**
>
> ```
>  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
> ```

## Konfigurazzjoni tal-kontenitur

### Varjabbli tal-ambjent

#### Varjabbli għall-iskjerament permezz ta’ pairing

| Isem | Obbligatorju | Valur default | Kumment |
|---|---|---|---|
| `ENV_MEDIATION` | IVA |  | Użat għall-konnessjoni permezz ta’ pairing. Isem DNS jew indirizz IP għall-konnessjoni mal-interfaċċa web ta’ pjattaforma CyberElements Bastion. |
| `ENV_TOKEN` | IVA |  | Użat għall-konnessjoni permezz ta’ pairing. Indikazzjoni tat-token tal-pairing li għandu jintuża għall-konnessjoni mas-servizz Mediation Controller. |
| `ENV_NO_CHECK_CERT` | LE | `false` | Użat għall-konnessjonijiet permezz ta’ pairing. Jekk il-verifika taċ-ċertifikat web tas-servizz Mediation Controller għandhiex tiġi diżattivata jew le; utli ma’ CyberElements Bastion meta l-aċċess isir permezz ta’ indirizz IP jew meta ċ-ċertifikat web mhuwiex ċertifikat rikonoxxut mill-awtoritajiet taċ-ċertifikazzjoni pubbliċi default. Valuri aċċettati: `true` jew `false`. |

#### Varjabbli għall-iskjerament manwali

| Isem | Obbligatorju | Valur default | Kumment |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | IVA |  | Użat għall-konnessjoni b’konfigurazzjoni manwali. Isem il-fajl taċ-ċertifikat għall-konnessjoni mal-komponent SSL Router. |
| `ENV_GW_CERT_PASSWORD` | IVA |  | Użat għall-konnessjoni b’konfigurazzjoni manwali. Il-password tal-fajl taċ-ċertifikat għall-konnessjoni mal-komponent SSL Router. |
| `ENV_CARE_CERT_NAME` | LE | Valur ta’ `ENV_GW_CERT_NAME` | Użat għall-konnessjoni b’konfigurazzjoni manwali. Isem il-fajl taċ-ċertifikat għas-servizz tar-reġistrazzjoni. |
| `ENV_CARE_CERT_PASSWORD` | LE | Valur ta’ `ENV_GW_CERT_PASSWORD` | Użat għall-konnessjoni b’konfigurazzjoni manwali. Il-password tal-fajl taċ-ċertifikat tas-servizz tar-reġistrazzjoni. |
| `ENV_SSL_ROUTER_IP` | IVA |  | Użat għall-konnessjoni b’konfigurazzjoni manwali. L-indirizz IP jew l-isem DNS tal-komponent SSL Router li miegħu se jikkonnettja l-komponent Edge Gateway. |
| `ENV_SSL_ROUTER_PORT` | LE | `443` | Użat għall-konnessjoni b’konfigurazzjoni manwali. Il-port fuq il-komponent SSL Router li miegħu se jikkonnettja l-komponent Edge Gateway. |

#### Varjabbli diversi

| Isem | Obbligatorju | Valur default | Kumment |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | LE | `false` | Diżattivazzjoni tas-servizz `rsyslog`. Valuri aċċettati: `true` jew `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | LE | `false` | Jattiva s-settings ta’ Kerberos biex jippermetti lill-applikazzjonijiet RDP jawtentikaw ruħhom f’modalità mingħajr aġent bl-użu ta’ Kerberos. Valuri aċċettati: `true` jew `false`. Jekk `false`, il-varjabbli l-oħra ta’ Kerberos jiġu injorati. |
| `ENV_KERBEROS_DEFAULT_REALM` | IVA (jekk il-konfigurazzjoni ta’ Kerberos hija attivata) |  | Isem ir-realm Kerberos. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | IVA (jekk il-konfigurazzjoni ta’ Kerberos hija attivata) |  | Isem id-dominju Kerberos. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | IVA (jekk il-konfigurazzjoni ta’ Kerberos hija attivata) |  | L-indirizz tal-konnessjoni mal-kontrollur Kerberos. |

### Volumi

| Volum | Kumment |
|---|---|
| `/etc/ipdiva/` | Volum tal-konfigurazzjoni tal-komponent Edge Gateway. Nirrakkomandaw li jiġi mmuntat fuq volum bl-isem jew fuq is-sistema tal-fajls tal-kompjuter ospitanti. |
| `/opt/certificates/` | Volum li fih iċ-ċertifikat jew iċ-ċertifikati tal-komponent Edge Gateway f’konfigurazzjoni mingħajr pairing. |
| `/var/lib/ipdiva/carerecord/archives/` | Volum li fih l-arkivji grafiċi. Nirrakkomandaw li jiġi mmuntat fuq volum bl-isem jew fuq is-sistema tal-fajls tal-kompjuter ospitanti. |
| `/var/ipdiva/care/sshrecord/` | Volum li fih l-arkivji SSH. Nirrakkomandaw li jiġi mmuntat fuq volum bl-isem jew fuq is-sistema tal-fajls tal-kompjuter ospitanti. |
| `/var/log/` | Volum li fih ir-reġistri tal-komponent Edge Gateway. |

### Portijiet

| Port | Kumment |
|---|---|
| `2222` (jew kwalunkwe port ieħor disponibbli magħżul mill-amministratur) | Port tas-smigħ għas-servizz tal-aċċess dirett SSH/SFTP. |
| `3389` | Port tas-smigħ għas-servizz tal-aċċess dirett RDP. |
| `8443` | Port tas-smigħ għas-servizz tar-reġistrazzjoni, li għandu jiġi espost meta jintuża l-aġent tar-reġistrazzjoni għal Windows. |

## Skjerament tal-komponent Edge Gateway Docker

### Skjerament bil-pairing

> **Prerekwiżiti**
>
> Qabel ma tiskjera l-komponent Edge Gateway Docker, trid [tikseb token tal-pairing](https://docs.cyberelements.io/bastion/4.6/mt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

L-iskjerament deskritt hawn taħt se juża l-volumi disponibbli kollha (ħlief `/opt/certificates/`, li mhuwiex utli f’dan il-kuntest) u se jesponi l-portijiet kollha.
Il-volumi se jiġu mmuntati fuq is-sistema tal-fajls tal-kompjuter ospitanti fil-post `EDGE_GATEWAY_REP`. F’dan il-post hemm is-sottofolders li ġejjin:

- config
- graphical_archives
- ssh_archives
- log

Tista’ tippersonalizza l-varjabbli għall-kmandi li ġejjin:

| Valur personalizzat | Varjabbli | Kumment |
|---|---|---|
|  | `DOCKER_NAME` | Isem il-kontenitur Docker. |
|  | `EDGE_GATEWAY_REP` | Il-post fis-sistema tal-fajls fejn jiġu mmuntati l-volumi. |
|  | `ENV_MEDIATION_VALUE` | Il-valur tal-[varjabbli tal-ambjent](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Il-valur tal-[varjabbli tal-ambjent](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Il-valur tal-[varjabbli tal-ambjent](#environment-variables) `ENV_NO_CHECK_CERT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Il-valur tal-[varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Il-valur tal-[varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Il-valur tal-[varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Il-valur tal-[varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Oħloq is-siġra tal-folders meħtieġa għall-immuntar tal-volumi fuq is-sistema tal-fajls:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

U fl-aħħar, ibda kontenitur ġdid:

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

Ir-reġistri tal-kontenitur jistgħu jiġu kkonsultati bil-kmand li ġej:

```
1
```

### Skjerament manwali

> **Prerekwiżiti**
>
> Qabel ma tiskjera l-komponent Edge Gateway Docker, irid ikollok iċ-ċertifikati meħtieġa għall-komponent Edge Gateway u għas-servizz tar-reġistrazzjoni.

> **Passwords viżibbli b’`docker inspect`**
>
> Il-varjabbli tal-ambjent ta’ kontenitur, inklużi l-passwords taċ-ċertifikati, jibqgħu jinqraw minn kull min huwa awtorizzat iħaddem `docker inspect` fuq is-server Docker. Għalhekk għandu jiġi ppreferut [l-iskjerament bil-pairing](#deployment-with-pairing), li ma juża l-ebda password ta’ ċertifikat.

L-iskjerament deskritt hawn taħt se juża l-volumi kollha disponibbli u jesponi l-portijiet kollha.
Il-volumi se jiġu mmuntati fis-sistema tal-fajls tal-kompjuter ospitanti fil-post `MANUAL_REP`. F’dan il-post hemm is-sottodirettorji li ġejjin:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Tista’ tippersonalizza l-varjabbli għall-kmandi li ġejjin:

| Valur personalizzat | Varjabbli | Kumment |
|---|---|---|
|  | `MANUAL_NAME` | Isem il-kontenitur Docker. |
|  | `MANUAL_REP` | Post fis-sistema tal-fajls fejn jiġu mmuntati l-volumi. |
|  | `ENV_GW_CERT_NAME_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_CARE_CERT_NAME_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_CARE_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_SSL_ROUTER_PORT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Valur [tal-varjabbli tal-ambjent](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Oħloq is-siġra tal-folders meħtieġa għall-immuntar tal-volumi fuq is-sistema tal-fajls:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Imbagħad poġġi ċ-ċertifikati tal-komponent Edge Gateway u tas-servizz tar-reġistrazzjoni fil-folder `MANUAL_REP/certificates`.

Biex il-passwords taċ-ċertifikati ma jinżammux fl-istorja tax-shell, daħħalhom f’varjabbli tal-ambjent tas-sessjoni attwali (dak li tikteb ma jintweriex):

**Bash**

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

**PowerShell**

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

Fl-aħħar, ibda kontenitur ġdid:

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

Ladarba l-kontenitur ikun beda, neħħi dawn il-varjabbli mis-sessjoni:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Ir-reġistri tal-kontenitur jistgħu jiġu kkonsultati bil-kmand li ġej:

```
1
```
