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

# Instalace komponenty Edge Gateway Docker

## Import obrazu Docker

Než budete moci vytvořit kontejner Docker Edge Gateway, musíte importovat obraz Docker. Za tímto účelem spusťte shell, ve kterém máte k dispozici příkazy Docker i soubor `cleanroom-gateway-4.6.1-33-v4.tgz`. V shellu spusťte následující příkaz a upravte cestu k souboru `TGZ`, pokud se nenachází v aktuálním adresáři:

```
1
```

Poté následujícím příkazem ověřte, že import proběhl úspěšně:

```
1
```

Očekávaný výstup je následující (ID SHA256 se může lišit v závislosti na operačním systému, ve kterém je Docker nainstalován; příklady pocházejí z distribuce Debian 13). Pokud tomu tak není, import selhal:

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

## Konfigurace kontejneru

### Proměnné prostředí

#### Proměnné pro nasazení pomocí pairingu

| Název | Povinná | Výchozí hodnota | Komentář |
|---|---|---|---|
| `ENV_MEDIATION` | ANO |  | Používá se pro připojení pomocí pairingu. Název DNS nebo IP adresa pro připojení k webovému rozhraní platformy CyberElements Bastion. |
| `ENV_TOKEN` | ANO |  | Používá se pro připojení pomocí pairingu. Určuje token pro pairing, který se má použít pro připojení ke službě Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NE | `false` | Používá se pro připojení pomocí pairingu. Určuje, zda se má zakázat kontrola webového certifikátu služby Mediation Controller; užitečné u CyberElements Bastion při přístupu přes IP adresu nebo v případě, že webový certifikát není certifikát uznávaný výchozími veřejnými certifikačními autoritami. Přijímané hodnoty: `true` nebo `false`. |

#### Proměnné pro ruční nasazení

| Název | Povinná | Výchozí hodnota | Komentář |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | ANO |  | Používá se pro připojení s ruční konfigurací. Název souboru certifikátu pro připojení ke komponentě SSL Router. |
| `ENV_GW_CERT_PASSWORD` | ANO |  | Používá se pro připojení s ruční konfigurací. Heslo souboru certifikátu pro připojení ke komponentě SSL Router. |
| `ENV_CARE_CERT_NAME` | NE | Hodnota `ENV_GW_CERT_NAME` | Používá se pro připojení s ruční konfigurací. Název souboru certifikátu služby nahrávání. |
| `ENV_CARE_CERT_PASSWORD` | NE | Hodnota `ENV_GW_CERT_PASSWORD` | Používá se pro připojení s ruční konfigurací. Heslo souboru certifikátu služby nahrávání. |
| `ENV_SSL_ROUTER_IP` | ANO |  | Používá se pro připojení s ruční konfigurací. IP adresa nebo název DNS komponenty SSL Router, ke které se komponenta Edge Gateway připojí. |
| `ENV_SSL_ROUTER_PORT` | NE | `443` | Používá se pro připojení s ruční konfigurací. Port komponenty SSL Router, ke kterému se komponenta Edge Gateway připojí. |

#### Různé proměnné

| Název | Povinná | Výchozí hodnota | Komentář |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NE | `false` | Deaktivace služby `rsyslog`. Přijímané hodnoty: `true` nebo `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NE | `false` | Povoluje nastavení protokolu Kerberos, aby se aplikace RDP mohly v režimu bez agenta ověřovat pomocí protokolu Kerberos. Přijímané hodnoty: `true` nebo `false`. Při hodnotě `false` budou ostatní proměnné Kerberos ignorovány. |
| `ENV_KERBEROS_DEFAULT_REALM` | ANO (pokud je povolena konfigurace protokolu Kerberos) |  | Název sféry Kerberos. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | ANO (pokud je povolena konfigurace protokolu Kerberos) |  | Název domény Kerberos. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | ANO (pokud je povolena konfigurace protokolu Kerberos) |  | Adresa pro připojení k řadiči Kerberos. |

### Svazky

| Svazek | Komentář |
|---|---|
| `/etc/ipdiva/` | Konfigurační svazek komponenty Edge Gateway. Doporučujeme jej připojit k pojmenovanému svazku nebo do systému souborů hostitelského počítače. |
| `/opt/certificates/` | Svazek obsahující certifikát nebo certifikáty komponenty Edge Gateway v konfiguraci bez pairingu. |
| `/var/lib/ipdiva/carerecord/archives/` | Svazek obsahující grafické archivy. Doporučujeme jej připojit k pojmenovanému svazku nebo do systému souborů hostitelského počítače. |
| `/var/ipdiva/care/sshrecord/` | Svazek obsahující archivy SSH. Doporučujeme jej připojit k pojmenovanému svazku nebo do systému souborů hostitelského počítače. |
| `/var/log/` | Svazek obsahující logy komponenty Edge Gateway. |

### Porty

| Port | Komentář |
|---|---|
| `2222` (nebo jakýkoli jiný dostupný port zvolený správcem) | Port, na kterém naslouchá služba přímého přístupu SSH/SFTP. |
| `3389` | Port, na kterém naslouchá služba přímého přístupu RDP. |
| `8443` | Port, na kterém naslouchá služba nahrávání; je nutné jej zpřístupnit při použití agenta nahrávání pro Windows. |

## Nasazení komponenty Edge Gateway Docker

### Nasazení pomocí pairingu

> **Předpoklady**
>
> Před nasazením komponenty Edge Gateway Docker musíte [získat token pro pairing](https://docs.cyberelements.io/bastion/4.6/cs/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Níže popsané nasazení použije všechny dostupné svazky (kromě `/opt/certificates/`, který v tomto kontextu není užitečný) a zpřístupní všechny porty.
Svazky budou připojeny do systému souborů hostitelského počítače v umístění `EDGE_GATEWAY_REP`. V tomto umístění se nacházejí následující podadresáře:

- config
- graphical_archives
- ssh_archives
- log

Proměnné pro následující příkazy si můžete přizpůsobit:

| Vlastní hodnota | Proměnná | Komentář |
|---|---|---|
|  | `DOCKER_NAME` | Název kontejneru Docker. |
|  | `EDGE_GATEWAY_REP` | Umístění v systému souborů, do kterého se připojí svazky. |
|  | `ENV_MEDIATION_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_MEDIATION`. |
|  | `ENV_TOKEN_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_TOKEN`. |
|  | `ENV_NO_CHECK_CERT_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_NO_CHECK_CERT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Vytvořte strom adresářů potřebný pro připojení svazků do systému souborů:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

A nakonec spusťte nový kontejner:

**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 kontejneru lze zobrazit pomocí následujícího příkazu:

```
1
```

### Ruční nasazení

> **Předpoklady**
>
> Před nasazením Edge Gateway pro Docker musíte mít k dispozici požadované certifikáty pro Edge Gateway a pro službu nahrávání.

> **Hesla viditelná pomocí `docker inspect`**
>
> Proměnné prostředí kontejneru, včetně hesel certifikátů, zůstávají čitelné pro každého, kdo smí na serveru Docker spustit `docker inspect`. Proto je vhodnější [nasazení s pairingem](#deployment-with-pairing), které nepoužívá žádné heslo certifikátu.

Níže popsané nasazení použije všechny dostupné svazky a zpřístupní všechny porty.
Svazky budou připojeny do systému souborů hostitelského počítače v umístění `MANUAL_REP`. V tomto umístění se nacházejí následující podadresáře:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Proměnné pro následující příkazy si můžete přizpůsobit:

| Vlastní hodnota | Proměnná | Komentář |
|---|---|---|
|  | `MANUAL_NAME` | Název kontejneru Docker. |
|  | `MANUAL_REP` | Umístění v systému souborů, kam se připojí svazky. |
|  | `ENV_GW_CERT_NAME_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_GW_CERT_NAME`. |
|  | `ENV_CARE_CERT_NAME_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_CARE_CERT_NAME`. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_SSL_ROUTER_IP`. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_SSL_ROUTER_PORT`. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE`. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM`. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN`. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | Hodnota [proměnné prostředí](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS`. |

Vytvořte strom adresářů potřebný pro připojení svazků do systému souborů:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Poté umístěte certifikáty pro Edge Gateway a pro službu nahrávání do `MANUAL_REP/certificates`.

Aby hesla certifikátů nezůstala uložena v historii příkazů shellu, zadejte je do proměnných prostředí aktuální relace (zadávaný text se nezobrazuje):

**Bash**

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

**PowerShell**

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

Nakonec spusťte nový kontejner:

**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 spuštění kontejneru odeberte tyto proměnné z relace:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Logy kontejneru lze zobrazit pomocí následujícího příkazu:

```
1
```
