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

# Inštalácia komponentu Edge Gateway Docker

## Import obrazu Docker

Pred vytvorením kontajnera Docker Edge Gateway musíte importovať obraz Docker. Na tento účel spustite prostredie shell, v ktorom máte k dispozícii príkazy Docker, ako aj súbor `cleanroom-gateway-4.6.1-33-v4.tgz`. V prostredí shell spustite nasledujúci príkaz a ak sa súbor `TGZ` nenachádza v aktuálnom adresári, upravte cestu k nemu:

```
1
```

Potom pomocou nasledujúceho príkazu overte, či bol import úspešný:

```
1
```

Očakávaný výstup je nasledujúci (ID SHA256 sa môže líšiť v závislosti od operačného systému, v ktorom je Docker nainštalovaný; príklady pochádzajú zo systému Debian 13). Ak to tak nie je, import zlyhal:

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

> **Úplný výstup**
>
> ```
>  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
> ```

## Konfigurácia kontajnera

### Premenné prostredia

#### Premenné pre nasadenie pomocou pairingu

| Názov | Povinné | Predvolená hodnota | Komentár |
|---|---|---|---|
| `ENV_MEDIATION` | ÁNO |  | Používa sa pri pripojení pomocou pairingu. Názov DNS alebo IP adresa na pripojenie k webovému rozhraniu platformy CyberElements Bastion. |
| `ENV_TOKEN` | ÁNO |  | Používa sa na pripojenie pomocou pairingu. Označenie tokenu pairingu, ktorý sa má použiť na pripojenie k službe Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NIE | `false` | Používa sa pri pripojeniach pomocou pairingu. Určuje, či sa má zakázať kontrola webového certifikátu služby Mediation Controller; užitočné pri CyberElements Bastion, keď sa pristupuje cez IP adresu alebo keď webový certifikát nie je certifikátom uznávaným predvolenými verejnými certifikačnými autoritami. Akceptované hodnoty: `true` alebo `false`. |

#### Premenné pre manuálne nasadenie

| Názov | Povinné | Predvolená hodnota | Komentár |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | ÁNO |  | Používa sa na pripojenie s manuálnou konfiguráciou. Názov súboru certifikátu na pripojenie k serveru SSL Router. |
| `ENV_GW_CERT_PASSWORD` | ÁNO |  | Používa sa na pripojenie s manuálnou konfiguráciou. Heslo súboru certifikátu na pripojenie k serveru SSL Router. |
| `ENV_CARE_CERT_NAME` | NIE | Hodnota `ENV_GW_CERT_NAME` | Používa sa na pripojenie s manuálnou konfiguráciou. Názov súboru certifikátu služby nahrávania. |
| `ENV_CARE_CERT_PASSWORD` | NIE | Hodnota `ENV_GW_CERT_PASSWORD` | Používa sa na pripojenie s manuálnou konfiguráciou. Heslo súboru certifikátu služby nahrávania. |
| `ENV_SSL_ROUTER_IP` | ÁNO |  | Používa sa na pripojenie s manuálnou konfiguráciou. IP adresa alebo názov DNS servera SSL Router, ku ktorému sa komponent Edge Gateway pripojí. |
| `ENV_SSL_ROUTER_PORT` | NIE | `443` | Používa sa na pripojenie s manuálnou konfiguráciou. Port servera SSL Router, ku ktorému sa komponent Edge Gateway pripojí. |

#### Rôzne premenné

| Názov | Povinné | Predvolená hodnota | Komentár |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NIE | `false` | Deaktivácia služby `rsyslog`. Akceptované hodnoty: `true` alebo `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NIE | `false` | Povolí nastavenia protokolu Kerberos, aby sa aplikácie RDP mohli overovať v režime bez agenta pomocou protokolu Kerberos. Akceptované hodnoty: `true` alebo `false`. Ak je hodnota `false`, ostatné premenné Kerberos sa ignorujú. |
| `ENV_KERBEROS_DEFAULT_REALM` | ÁNO (ak je konfigurácia Kerberos povolená) |  | Názov sféry Kerberos. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | ÁNO (ak je konfigurácia Kerberos povolená) |  | Názov domény Kerberos. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | ÁNO (ak je konfigurácia Kerberos povolená) |  | Adresa na pripojenie k radiču Kerberos. |

### Zväzky

| Zväzok | Komentár |
|---|---|
| `/etc/ipdiva/` | Konfiguračný zväzok komponentu Edge Gateway. Odporúčame ho pripojiť k pomenovanému zväzku alebo do systému súborov hostiteľského počítača. |
| `/opt/certificates/` | Zväzok obsahujúci certifikát(y) komponentu Edge Gateway v konfigurácii bez pairingu. |
| `/var/lib/ipdiva/carerecord/archives/` | Zväzok obsahujúci grafické archívy. Odporúčame ho pripojiť k pomenovanému zväzku alebo do systému súborov hostiteľského počítača. |
| `/var/ipdiva/care/sshrecord/` | Zväzok obsahujúci archívy SSH. Odporúčame ho pripojiť k pomenovanému zväzku alebo do systému súborov hostiteľského počítača. |
| `/var/log/` | Zväzok obsahujúci logy komponentu Edge Gateway. |

### Porty

| Port | Komentár |
|---|---|
| `2222` (alebo akýkoľvek iný dostupný port zvolený správcom) | Port, na ktorom načúva služba priameho prístupu SSH/SFTP. |
| `3389` | Port, na ktorom načúva služba priameho prístupu RDP. |
| `8443` | Port, na ktorom načúva služba nahrávania; treba ho sprístupniť pri používaní agenta nahrávania pre Windows. |

## Nasadenie komponentu Edge Gateway Docker

### Nasadenie pomocou pairingu

> **Predpoklady**
>
> Pred nasadením komponentu Edge Gateway Docker musíte [získať token pairingu](https://docs.cyberelements.io/bastion/4.6/sk/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Nižšie opísané nasadenie použije všetky dostupné zväzky (okrem `/opt/certificates/`, ktorý v tomto kontexte nie je užitočný) a sprístupní všetky porty.
Zväzky sa pripoja do systému súborov hostiteľského počítača v umiestnení `EDGE_GATEWAY_REP`. V tomto umiestnení sa nachádzajú nasledujúce podadresáre:

- config
- graphical_archives
- ssh_archives
- log

Premenné pre nasledujúce príkazy môžete prispôsobiť:

| Vlastná hodnota | Premenná | Komentár |
|---|---|---|
|  | `DOCKER_NAME` | Názov kontajnera Docker. |
|  | `EDGE_GATEWAY_REP` | Umiestnenie v systéme súborov, kam sa pripoja zväzky. |
|  | `ENV_MEDIATION_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_NO_CHECK_CERT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Vytvorte stromovú štruktúru adresárov potrebnú na pripojenie zväzkov v systéme súborov:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

A nakoniec spustite nový kontajner:

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

Logy kontajnera môžete zobraziť pomocou nasledujúceho príkazu:

```
1
```

### Manuálne nasadenie

> **Predpoklady**
>
> Pred nasadením komponentu Edge Gateway Docker musíte mať k dispozícii požadované certifikáty pre Edge Gateway a pre službu nahrávania.

> **Heslá viditeľné pomocou `docker inspect`**
>
> Premenné prostredia kontajnera vrátane hesiel certifikátov zostávajú čitateľné pre každého, kto smie spúšťať `docker inspect` na serveri Docker. Preto uprednostnite [nasadenie s pairingom](#deployment-with-pairing), ktoré nepoužíva žiadne heslo certifikátu.

Nasadenie opísané nižšie použije všetky dostupné zväzky a sprístupní všetky porty.
Zväzky sa pripoja do systému súborov hostiteľského počítača v umiestnení `MANUAL_REP`. V tomto umiestnení sa nachádzajú tieto podadresáre:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Premenné pre nasledujúce príkazy môžete prispôsobiť:

| Vlastná hodnota | Premenná | Komentár |
|---|---|---|
|  | `MANUAL_NAME` | Názov kontajnera Docker. |
|  | `MANUAL_REP` | Umiestnenie v systéme súborov, kam sa pripoja zväzky. |
|  | `ENV_GW_CERT_NAME_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_CARE_CERT_NAME_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_CARE_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_SSL_ROUTER_PORT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Hodnota [premennej prostredia](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Vytvorte stromovú štruktúru adresárov potrebnú na pripojenie zväzkov v systéme súborov:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Potom umiestnite certifikáty pre Edge Gateway a pre službu nahrávania do `MANUAL_REP/certificates`.

Aby sa heslá certifikátov neuchovávali v histórii shellu, zadajte ich do premenných prostredia aktuálnej relácie (zadávaný text sa nezobrazuje):

**Bash**

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

**PowerShell**

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

Nakoniec spustite nový kontajner:

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

Po spustení kontajnera odoberte tieto premenné z relácie:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Logy kontajnera môžete zobraziť pomocou nasledujúceho príkazu:

```
1
```
