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

# Edge Gateway Docker versiooni installimine

## Dockeri kujutise importimine

Enne kui saate luua Edge Gateway Docker konteineri, peate importima Dockeri kujutise. Selleks käivitage kest, kust teil on juurdepääs Dockeri käskudele ja failile `cleanroom-gateway-4.6.1-33-v4.tgz`. Käivitage kestast järgmine käsk, kohandades `TGZ`-faili teed, kui see pole praeguses kataloogis:

```
1
```

Seejärel kontrollige järgmise käsuga, kas importimine õnnestus:

```
1
```

Eeldatav väljund on järgmine (SHA256-ID võib erineda olenevalt operatsioonisüsteemist, kuhu Docker on installitud; näited on Debian 13-st). Kui see nii pole, on importimine nurjunud:

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

> **Täielik väljund**
>
> ```
>  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
> ```

## Konteineri konfiguratsioon

### Keskkonnamuutujad

#### Muutujad pairingu abil juurutamiseks

| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
| `ENV_MEDIATION` | JAH |  | Kasutatakse pairingu ühenduse jaoks. DNS-nimi või IP-aadress CyberElements Bastion platvormi veebiliidesega ühenduse loomiseks. |
| `ENV_TOKEN` | JAH |  | Kasutatakse pairingu ühenduse puhul. Näitab pairingu tokenit, mida kasutatakse Mediation Controller teenusega ühenduse loomiseks. |
| `ENV_NO_CHECK_CERT` | EI | `false` | Kasutatakse pairingu ühenduste jaoks. Kas Mediation Controller serveri veebisertifikaadi kontroll välja lülitada või mitte; kasulik CyberElements Bastion lahenduse puhul, kui juurdepääs toimub IP-aadressi kaudu või kui veebisertifikaat pole vaikimisi avalike sertifitseerimisasutuste tunnustatud sertifikaat. Aktsepteeritud väärtused: `true` või `false`. |

#### Muutujad käsitsi juurutamiseks

| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | JAH |  | Kasutatakse käsitsi konfigureeritud ühenduse puhul. SSL Router teenusega ühenduse loomiseks kasutatava sertifikaadifaili nimi. |
| `ENV_GW_CERT_PASSWORD` | JAH |  | Kasutatakse käsitsi konfigureeritud ühenduse puhul. SSL Router teenusega ühenduse loomiseks kasutatava sertifikaadifaili parool. |
| `ENV_CARE_CERT_NAME` | EI | Muutuja `ENV_GW_CERT_NAME` väärtus | Kasutatakse käsitsi konfigureeritud ühenduse puhul. Salvestusteenuse sertifikaadifaili nimi. |
| `ENV_CARE_CERT_PASSWORD` | EI | Muutuja `ENV_GW_CERT_PASSWORD` väärtus | Kasutatakse käsitsi konfigureeritud ühenduse puhul. Salvestusteenuse sertifikaadifaili parool. |
| `ENV_SSL_ROUTER_IP` | JAH |  | Kasutatakse käsitsi konfigureeritud ühenduse puhul. Selle SSL Router teenuse IP-aadress või DNS-nimi, millega Edge Gateway ühenduse loob. |
| `ENV_SSL_ROUTER_PORT` | EI | `443` | Kasutatakse käsitsi konfigureeritud ühenduse puhul. SSL Router teenuse port, millega Edge Gateway ühenduse loob. |

#### Muud muutujad

| Nimi | Kohustuslik | Vaikeväärtus | Kommentaar |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | EI | `false` | Teenuse `rsyslog` väljalülitamine. Aktsepteeritud väärtused: `true` või `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | EI | `false` | Lülitab sisse Kerberose sätted, et RDP-rakendused saaksid agendita režiimis Kerberose abil autentida. Aktsepteeritud väärtused: `true` või `false`. Kui väärtus on `false`, eiratakse teisi Kerberose muutujaid. |
| `ENV_KERBEROS_DEFAULT_REALM` | JAH (kui Kerberose konfiguratsioon on sisse lülitatud) |  | Kerberose valdkonna nimi. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | JAH (kui Kerberose konfiguratsioon on sisse lülitatud) |  | Kerberose domeeni nimi. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | JAH (kui Kerberose konfiguratsioon on sisse lülitatud) |  | Kerberose kontrolleri ühendusaadress. |

### Köited

| Köide | Kommentaar |
|---|---|
| `/etc/ipdiva/` | Edge Gateway komponendi konfiguratsiooniköide. Soovitame selle ühendada nimega köitele või hostarvuti failisüsteemi. |
| `/opt/certificates/` | Köide, mis sisaldab Edge Gateway komponendi sertifikaati või sertifikaate pairinguta konfiguratsioonis. |
| `/var/lib/ipdiva/carerecord/archives/` | Köide, mis sisaldab graafilisi arhiive. Soovitame selle ühendada nimega köitele või hostarvuti failisüsteemi. |
| `/var/ipdiva/care/sshrecord/` | Köide, mis sisaldab SSH-arhiive. Soovitame selle ühendada nimega köitele või hostarvuti failisüsteemi. |
| `/var/log/` | Köide, mis sisaldab Edge Gateway komponendi logisid. |

### Pordid

| Port | Kommentaar |
|---|---|
| `2222` (või mis tahes muu administraatori valitud vaba port) | SSH/SFTP-otsejuurdepääsuteenuse kuulamisport. |
| `3389` | RDP-otsejuurdepääsuteenuse kuulamisport. |
| `8443` | Salvestusteenuse kuulamisport, mis tuleb avaldada Windowsi salvestusagendi kasutamisel. |

## Edge Gateway Docker versiooni juurutamine

### Juurutamine pairingu abil

> **Eeltingimused**
>
> Enne Edge Gateway Docker versiooni juurutamist peate [hankima pairingu tokeni](https://docs.cyberelements.io/bastion/4.6/et/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Allpool kirjeldatud juurutamine kasutab kõiki saadaolevaid köiteid (välja arvatud `/opt/certificates/`, millest selles kontekstis kasu pole) ja avaldab kõik pordid.
Köited ühendatakse hostarvuti failisüsteemi asukohta `EDGE_GATEWAY_REP`. Selles asukohas on järgmised alamkataloogid:

- config
- graphical_archives
- ssh_archives
- log

Järgmiste käskude muutujaid saate kohandada:

| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
|  | `DOCKER_NAME` | Dockeri konteineri nimi. |
|  | `EDGE_GATEWAY_REP` | Failisüsteemi asukoht, kuhu köited ühendatakse. |
|  | `ENV_MEDIATION_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_MEDIATION` väärtus. |
|  | `ENV_TOKEN_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_TOKEN` väärtus. |
|  | `ENV_NO_CHECK_CERT_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_NO_CHECK_CERT` väärtus. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE` väärtus. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM` väärtus. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN` väärtus. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS` väärtus. |

Looge kataloogipuu, mis on vajalik köidete ühendamiseks failisüsteemi:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Lõpuks käivitage uus 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
> ```

Konteineri logisid saab vaadata järgmise käsuga:

```
1
```

### Käsitsi juurutamine

> **Eeltingimused**
>
> Enne Dockeri Edge Gateway komponendi juurutamist peavad teil olemas olema Edge Gateway komponendi ja salvestusteenuse jaoks vajalikud sertifikaadid.

> **Paroolid on nähtavad käsuga `docker inspect`**
>
> Konteineri keskkonnamuutujad, sh sertifikaatide paroolid, jäävad loetavaks kõigile, kellel on lubatud Dockeri serveris käivitada käsku `docker inspect`. Seetõttu tuleks eelistada [pairingu abil juurutamist](#deployment-with-pairing), mis ei kasuta sertifikaadi parooli.

Allpool kirjeldatud juurutamine kasutab kõiki saadaolevaid köiteid ja avab kõik pordid.
Köited ühendatakse hostarvuti failisüsteemi asukohta `MANUAL_REP`. Selles asukohas on järgmised alamkaustad:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Järgmiste käskude muutujaid saate kohandada:

| Kohandatud väärtus | Muutuja | Kommentaar |
|---|---|---|
|  | `MANUAL_NAME` | Dockeri konteineri nimi. |
|  | `MANUAL_REP` | Failisüsteemi asukoht, kuhu köited ühendatakse. |
|  | `ENV_GW_CERT_NAME_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_GW_CERT_NAME` väärtus. |
|  | `ENV_CARE_CERT_NAME_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_CARE_CERT_NAME` väärtus. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_SSL_ROUTER_IP` väärtus. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_SSL_ROUTER_PORT` väärtus. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE` väärtus. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM` väärtus. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN` väärtus. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | [Keskkonnamuutuja](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS` väärtus. |

Looge kataloogipuu, mis on vajalik köidete ühendamiseks failisüsteemi:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Seejärel paigutage Edge Gateway komponendi ja salvestusteenuse sertifikaadid kausta `MANUAL_REP/certificates`.

Et sertifikaatide paroolid kesta ajalukku ei jääks, sisestage need praeguse seansi keskkonnamuutujatesse (sisestust ei kuvata):

**Bash**

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

**PowerShell**

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

Lõpuks käivitage uus 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
> ```

Kui konteiner on käivitunud, eemaldage need muutujad seansist:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Konteineri logisid saab vaadata järgmise käsuga:

```
1
```
