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

# Edge Gateway Docker įdiegimas

## Docker atvaizdo importavimas

Kad galėtumėte sukurti Docker Edge Gateway konteinerį, turite importuoti Docker atvaizdą. Tam paleiskite apvalkalą, kuriame jums pasiekiamos Docker komandos ir failas `cleanroom-gateway-4.6.1-33-v4.tgz`. Apvalkale vykdykite šią komandą, pakoreguodami failo `TGZ` kelią, jei jis nėra dabartiniame kataloge:

```
1
```

Tada šia komanda patikrinkite, ar importavimas pavyko:

```
1
```

Tikėtina išvestis yra tokia (SHA256 identifikatorius gali skirtis priklausomai nuo operacinės sistemos, kurioje įdiegtas Docker; pavyzdžiai paimti iš Debian 13). Jei taip nėra, importuoti nepavyko:

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

> **Visa išvestis**
>
> ```
>  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
> ```

## Konteinerio konfigūracija

### Aplinkos kintamieji

#### Kintamieji diegimui naudojant pairing

| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
| `ENV_MEDIATION` | TAIP |  | Naudojamas jungiantis per pairing. DNS vardas arba IP adresas, skirtas prisijungti prie CyberElements Bastion platformos žiniatinklio sąsajos. |
| `ENV_TOKEN` | TAIP |  | Naudojama pairing ryšiui. Nurodo pairing tokeną, naudotiną jungiantis prie Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NE | `false` | Naudojamas jungiantis per pairing. Ar išjungti Mediation Controller žiniatinklio sertifikato tikrinimą; naudinga su CyberElements Bastion, kai jungiamasi per IP adresą arba kai žiniatinklio sertifikato nepripažįsta numatytosios viešosios sertifikavimo institucijos. Priimamos reikšmės: `true` arba `false`. |

#### Kintamieji rankiniam diegimui

| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | TAIP |  | Naudojama ryšiui su rankine konfigūracija. Sertifikato failo, skirto jungtis prie SSL Router, pavadinimas. |
| `ENV_GW_CERT_PASSWORD` | TAIP |  | Naudojama ryšiui su rankine konfigūracija. Sertifikato failo, skirto jungtis prie SSL Router, slaptažodis. |
| `ENV_CARE_CERT_NAME` | NE | `ENV_GW_CERT_NAME` reikšmė | Naudojama ryšiui su rankine konfigūracija. Įrašymo paslaugos sertifikato failo pavadinimas. |
| `ENV_CARE_CERT_PASSWORD` | NE | `ENV_GW_CERT_PASSWORD` reikšmė | Naudojama ryšiui su rankine konfigūracija. Įrašymo paslaugos sertifikato failo slaptažodis. |
| `ENV_SSL_ROUTER_IP` | TAIP |  | Naudojama ryšiui su rankine konfigūracija. SSL Router, prie kurio jungsis Edge Gateway, IP adresas arba DNS vardas. |
| `ENV_SSL_ROUTER_PORT` | NE | `443` | Naudojama ryšiui su rankine konfigūracija. SSL Router prievadas, prie kurio jungsis Edge Gateway. |

#### Įvairūs kintamieji

| Pavadinimas | Privaloma | Numatytoji reikšmė | Komentaras |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NE | `false` | Paslaugos `rsyslog` išjungimas. Leistinos reikšmės: `true` arba `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NE | `false` | Įjungia Kerberos parametrus, kad RDP taikomosios programos galėtų autentifikuotis režimu be agento naudodamos Kerberos. Leistinos reikšmės: `true` arba `false`. Jei `false`, kiti Kerberos kintamieji bus ignoruojami. |
| `ENV_KERBEROS_DEFAULT_REALM` | TAIP (jei įjungta Kerberos konfigūracija) |  | Kerberos srities pavadinimas. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | TAIP (jei įjungta Kerberos konfigūracija) |  | Kerberos domeno pavadinimas. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | TAIP (jei įjungta Kerberos konfigūracija) |  | Prisijungimo prie Kerberos valdiklio adresas. |

### Tomai

| Tomas | Komentaras |
|---|---|
| `/etc/ipdiva/` | Edge Gateway konfigūracijos tomas. Rekomenduojame jį prijungti prie pavadintojo tomo arba pagrindinio kompiuterio failų sistemoje. |
| `/opt/certificates/` | Tomas, kuriame yra Edge Gateway sertifikatas (-ai), kai naudojama konfigūracija be pairing. |
| `/var/lib/ipdiva/carerecord/archives/` | Tomas, kuriame saugomi grafiniai archyvai. Rekomenduojame jį prijungti prie pavadintojo tomo arba pagrindinio kompiuterio failų sistemoje. |
| `/var/ipdiva/care/sshrecord/` | Tomas, kuriame saugomi SSH archyvai. Rekomenduojame jį prijungti prie pavadintojo tomo arba pagrindinio kompiuterio failų sistemoje. |
| `/var/log/` | Tomas, kuriame saugomi Edge Gateway žurnalai. |

### Prievadai

| Prievadas | Komentaras |
|---|---|
| `2222` (arba bet kuris kitas administratoriaus pasirinktas laisvas prievadas) | SSH/SFTP tiesioginės prieigos paslaugos klausymosi prievadas. |
| `3389` | RDP tiesioginės prieigos paslaugos klausymosi prievadas. |
| `8443` | Įrašymo paslaugos klausymosi prievadas, kurį reikia atverti naudojant Windows įrašymo agentą. |

## Edge Gateway Docker diegimas

### Diegimas naudojant pairing

> **Būtinosios sąlygos**
>
> Prieš diegdami Edge Gateway Docker, turite [gauti pairing tokeną](https://docs.cyberelements.io/bastion/4.6/lt/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Toliau aprašytam diegimui bus naudojami visi galimi tomai (išskyrus `/opt/certificates/`, kuris šiame kontekste nenaudingas) ir bus atverti visi prievadai.
Tomai bus prijungti pagrindinio kompiuterio failų sistemoje vietoje `EDGE_GATEWAY_REP`. Šioje vietoje yra šie pakatalogiai:

- config
- graphical_archives
- ssh_archives
- log

Galite pritaikyti toliau pateiktų komandų kintamuosius:

| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
|  | `DOCKER_NAME` | Docker konteinerio pavadinimas. |
|  | `EDGE_GATEWAY_REP` | Failų sistemos vieta, kurioje prijungiami tomai. |
|  | `ENV_MEDIATION_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_MEDIATION` reikšmė. |
|  | `ENV_TOKEN_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_TOKEN` reikšmė. |
|  | `ENV_NO_CHECK_CERT_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_NO_CHECK_CERT` reikšmė. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE` reikšmė. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM` reikšmė. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN` reikšmė. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS` reikšmė. |

Sukurkite katalogų medį, reikalingą tomams prijungti failų sistemoje:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Ir galiausiai paleiskite naują konteinerį:

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

Konteinerio žurnalus galima peržiūrėti naudojant šią komandą:

```
1
```

### Rankinis diegimas

> **Būtinosios sąlygos**
>
> Prieš diegdami Edge Gateway Docker konteinerį, turite turėti reikiamus komponento Edge Gateway ir įrašymo paslaugos sertifikatus.

> **Slaptažodžiai, matomi naudojant `docker inspect`**
>
> Konteinerio aplinkos kintamieji, įskaitant sertifikatų slaptažodžius, lieka perskaitomi kiekvienam, kam leidžiama vykdyti `docker inspect` Docker serveryje. Todėl pirmenybę reikėtų teikti [diegimui su pairing](#deployment-with-pairing), kuriam nereikia jokio sertifikato slaptažodžio.

Toliau aprašytas diegimas naudos visus galimus tomus ir atvers visus prievadus.
Tomai bus prijungti prie pagrindinio kompiuterio failų sistemos vietoje `MANUAL_REP`. Šioje vietoje yra šie pakatalogiai:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Galite pritaikyti toliau pateiktų komandų kintamuosius:

| Pasirinktinė reikšmė | Kintamasis | Komentaras |
|---|---|---|
|  | `MANUAL_NAME` | Docker konteinerio pavadinimas. |
|  | `MANUAL_REP` | Failų sistemos vieta, kurioje prijungiami tomai. |
|  | `ENV_GW_CERT_NAME_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_GW_CERT_NAME` reikšmė. |
|  | `ENV_CARE_CERT_NAME_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_CARE_CERT_NAME` reikšmė. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_SSL_ROUTER_IP` reikšmė. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_SSL_ROUTER_PORT` reikšmė. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE` reikšmė. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM` reikšmė. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN` reikšmė. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | [Aplinkos kintamojo](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS` reikšmė. |

Sukurkite katalogų medį, reikalingą tomams prijungti failų sistemoje:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Tada įdėkite komponento Edge Gateway ir įrašymo paslaugos sertifikatus į `MANUAL_REP/certificates`.

Kad sertifikatų slaptažodžiai nebūtų išsaugoti apvalkalo istorijoje, įveskite juos į dabartinio seanso aplinkos kintamuosius (įvestis nerodoma):

**Bash**

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

**PowerShell**

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

Galiausiai paleiskite naują konteinerį:

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

Kai konteineris bus paleistas, pašalinkite šiuos kintamuosius iš seanso:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Konteinerio žurnalus galima peržiūrėti naudojant šią komandą:

```
1
```
