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

# Namestitev komponente Edge Gateway Docker

## Uvoz slike Docker

Preden lahko ustvarite vsebnik Docker Edge Gateway, morate uvoziti sliko Docker. V ta namen zaženite lupino, v kateri so vam na voljo ukazi Docker in datoteka `cleanroom-gateway-4.6.1-33-v4.tgz`. V lupini zaženite naslednji ukaz in prilagodite pot do datoteke `TGZ`, če ta ni v trenutnem imeniku:

```
1
```

Nato z naslednjim ukazom preverite, ali je bil uvoz uspešen:

```
1
```

Pričakovani izhod je naslednji (ID SHA256 se lahko razlikuje glede na operacijski sistem, v katerem je nameščen Docker; primeri so iz sistema Debian 13). Če ni tako, uvoz ni uspel:

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

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

## Konfiguracija vsebnika

### Okoljske spremenljivke

#### Spremenljivke za uvedbo s pairingom

| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
| `ENV_MEDIATION` | DA |  | Uporablja se za povezavo prek pairinga. Ime DNS ali naslov IP za povezavo s spletnim vmesnikom platforme CyberElements Bastion. |
| `ENV_TOKEN` | DA |  | Uporablja se za povezavo s pairingom. Navedba tokena pairinga, ki se uporabi za povezavo s storitvijo Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NE | `false` | Uporablja se za povezave prek pairinga. Določa, ali se onemogoči preverjanje spletnega potrdila storitve Mediation Controller; uporabno s platformo CyberElements Bastion pri dostopu prek naslova IP ali kadar spletnega potrdila ne priznavajo privzeti javni overitelji potrdil. Sprejete vrednosti: `true` ali `false`. |

#### Spremenljivke za ročno uvedbo

| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | DA |  | Uporablja se za povezavo z ročno konfiguracijo. Ime datoteke potrdila za povezavo s komponento SSL Router. |
| `ENV_GW_CERT_PASSWORD` | DA |  | Uporablja se za povezavo z ročno konfiguracijo. Geslo datoteke potrdila za povezavo s komponento SSL Router. |
| `ENV_CARE_CERT_NAME` | NE | Vrednost `ENV_GW_CERT_NAME` | Uporablja se za povezavo z ročno konfiguracijo. Ime datoteke potrdila storitve za snemanje. |
| `ENV_CARE_CERT_PASSWORD` | NE | Vrednost `ENV_GW_CERT_PASSWORD` | Uporablja se za povezavo z ročno konfiguracijo. Geslo datoteke potrdila storitve za snemanje. |
| `ENV_SSL_ROUTER_IP` | DA |  | Uporablja se za povezavo z ročno konfiguracijo. Naslov IP ali ime DNS komponente SSL Router, s katero se bo povezala komponenta Edge Gateway. |
| `ENV_SSL_ROUTER_PORT` | NE | `443` | Uporablja se za povezavo z ročno konfiguracijo. Vrata komponente SSL Router, s katero se bo povezala komponenta Edge Gateway. |

#### Razne spremenljivke

| Ime | Obvezno | Privzeta vrednost | Opomba |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NE | `false` | Onemogočanje storitve `rsyslog`. Sprejete vrednosti: `true` ali `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NE | `false` | Omogoči nastavitve Kerberos, da lahko aplikacije RDP v načinu brez agenta preverijo pristnost prek protokola Kerberos. Sprejete vrednosti: `true` ali `false`. Pri `false` se druge spremenljivke Kerberos prezrejo. |
| `ENV_KERBEROS_DEFAULT_REALM` | DA (če je konfiguracija Kerberos omogočena) |  | Ime področja Kerberos. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | DA (če je konfiguracija Kerberos omogočena) |  | Ime domene Kerberos. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | DA (če je konfiguracija Kerberos omogočena) |  | Naslov za povezavo s krmilnikom Kerberos. |

### Nosilci

| Nosilec | Opomba |
|---|---|
| `/etc/ipdiva/` | Konfiguracijski nosilec komponente Edge Gateway. Priporočamo, da ga vpnete v imenovani nosilec ali v datotečni sistem gostiteljskega računalnika. |
| `/opt/certificates/` | Nosilec, ki vsebuje potrdilo ali potrdila komponente Edge Gateway v konfiguraciji brez pairinga. |
| `/var/lib/ipdiva/carerecord/archives/` | Nosilec, ki vsebuje grafične arhive. Priporočamo, da ga vpnete v imenovani nosilec ali v datotečni sistem gostiteljskega računalnika. |
| `/var/ipdiva/care/sshrecord/` | Nosilec, ki vsebuje arhive SSH. Priporočamo, da ga vpnete v imenovani nosilec ali v datotečni sistem gostiteljskega računalnika. |
| `/var/log/` | Nosilec, ki vsebuje dnevnike komponente Edge Gateway. |

### Vrata

| Vrata | Opomba |
|---|---|
| `2222` (ali katera koli druga razpoložljiva vrata, ki jih izbere skrbnik) | Vrata za poslušanje storitve neposrednega dostopa SSH/SFTP. |
| `3389` | Vrata za poslušanje storitve neposrednega dostopa RDP. |
| `8443` | Vrata za poslušanje storitve za snemanje, ki jih je treba izpostaviti pri uporabi agenta za snemanje za Windows. |

## Uvedba komponente Edge Gateway Docker

### Uvedba s pairingom

> **Predpogoji**
>
> Pred uvedbo komponente Edge Gateway Docker morate [pridobiti token pairinga](https://docs.cyberelements.io/bastion/4.6/sl/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Spodaj opisana uvedba bo uporabila vse razpoložljive nosilce (razen `/opt/certificates/`, ki v tem kontekstu ni uporaben) in izpostavila vsa vrata.
Nosilci bodo vpeti v datotečni sistem gostiteljskega računalnika na lokaciji `EDGE_GATEWAY_REP`. Na tej lokaciji so naslednji podimeniki:

- config
- graphical_archives
- ssh_archives
- log

Spremenljivke za naslednje ukaze lahko prilagodite:

| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
|  | `DOCKER_NAME` | Ime vsebnika Docker. |
|  | `EDGE_GATEWAY_REP` | Lokacija v datotečnem sistemu, v katero se vpnejo nosilci. |
|  | `ENV_MEDIATION_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_NO_CHECK_CERT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Ustvarite drevo imenikov, potrebno za vpenjanje nosilcev v datotečni sistem:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

In na koncu zaženite nov vsebnik:

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

Dnevnike vsebnika si lahko ogledate z naslednjim ukazom:

```
1
```

### Ročna uvedba

> **Predpogoji**
>
> Pred uvedbo strežnika Edge Gateway za Docker morate imeti zahtevana potrdila za strežnik Edge Gateway in za storitev za snemanje.

> **Gesla, vidna z ukazom `docker inspect`**
>
> Okoljske spremenljivke vsebnika, vključno z gesli potrdil, lahko prebere vsak, ki sme na strežniku Docker zagnati `docker inspect`. Zato je priporočljivo uporabiti [uvedbo s pairingom](#deployment-with-pairing), ki ne uporablja nobenega gesla potrdila.

Spodaj opisana uvedba bo uporabila vse razpoložljive nosilce in izpostavila vsa vrata.
Nosilci bodo vpeti v datotečni sistem gostiteljskega računalnika na mestu `MANUAL_REP`. Na tem mestu so naslednji podimeniki:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Spremenljivke za naslednje ukaze lahko prilagodite:

| Vrednost po meri | Spremenljivka | Komentar |
|---|---|---|
|  | `MANUAL_NAME` | Ime vsebnika Docker. |
|  | `MANUAL_REP` | Mesto v datotečnem sistemu, kamor se vpnejo nosilci. |
|  | `ENV_GW_CERT_NAME_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_CARE_CERT_NAME_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_CARE_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_SSL_ROUTER_PORT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Vrednost [okoljske spremenljivke](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Ustvarite drevo imenikov, potrebno za vpenjanje nosilcev v datotečni sistem:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Nato potrdila za strežnik Edge Gateway in za storitev za snemanje postavite v `MANUAL_REP/certificates`.

Da se gesla potrdil ne shranijo v zgodovino lupine, jih vnesite v okoljske spremenljivke trenutne seje (vnos ni prikazan):

**Bash**

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

**PowerShell**

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

Na koncu zaženite nov vsebnik:

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

Ko se vsebnik zažene, odstranite te spremenljivke iz seje:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Dnevnike vsebnika si lahko ogledate z naslednjim ukazom:

```
1
```
