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

# Edge Gateway Docker instalēšana

## Docker attēla importēšana

Lai varētu izveidot Docker Edge Gateway konteineru, vispirms ir jāimportē Docker attēls. Lai to izdarītu, palaidiet čaulu, kurā jums ir pieejamas Docker komandas, kā arī fails `cleanroom-gateway-4.6.1-33-v4.tgz`. Čaulā izpildiet šo komandu, pielāgojot ceļu uz failu `TGZ`, ja tas neatrodas pašreizējā direktorijā:

```
1
```

Pēc tam ar šo komandu pārbaudiet, vai importēšana bija sekmīga:

```
1
```

Paredzamā izvade ir šāda (SHA256 ID var atšķirties atkarībā no operētājsistēmas, kurā ir instalēts Docker; piemēri ir no Debian 13). Ja tā nav, importēšana nav izdevusies:

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

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

## Konteinera konfigurācija

### Vides mainīgie

#### Mainīgie izvietošanai, izmantojot pairing

| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
| `ENV_MEDIATION` | JĀ |  | Tiek izmantots pairing savienojumam. DNS nosaukums vai IP adrese savienojumam ar CyberElements Bastion platformas tīmekļa saskarni. |
| `ENV_TOKEN` | JĀ |  | Tiek izmantots pairing savienojumam. Norāda pairing marķieri, kas jāizmanto savienojumam ar Mediation Controller. |
| `ENV_NO_CHECK_CERT` | NĒ | `false` | Tiek izmantots pairing savienojumiem. Norāda, vai atspējot Mediation Controller tīmekļa sertifikāta pārbaudi; noder ar CyberElements Bastion, ja piekļuve notiek, izmantojot IP adresi, vai ja tīmekļa sertifikāts nav sertifikāts, ko atpazīst noklusējuma publiskās sertificēšanas iestādes. Pieņemtās vērtības: `true` vai `false`. |

#### Mainīgie manuālai izvietošanai

| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
| `ENV_GW_CERT_NAME` | JĀ |  | Tiek izmantots savienojumam ar manuālu konfigurāciju. Sertifikāta faila nosaukums savienojumam ar SSL Router. |
| `ENV_GW_CERT_PASSWORD` | JĀ |  | Tiek izmantots savienojumam ar manuālu konfigurāciju. Sertifikāta faila parole savienojumam ar SSL Router. |
| `ENV_CARE_CERT_NAME` | NĒ | `ENV_GW_CERT_NAME` vērtība | Tiek izmantots savienojumam ar manuālu konfigurāciju. Ierakstīšanas pakalpojuma sertifikāta faila nosaukums. |
| `ENV_CARE_CERT_PASSWORD` | NĒ | `ENV_GW_CERT_PASSWORD` vērtība | Tiek izmantots savienojumam ar manuālu konfigurāciju. Ierakstīšanas pakalpojuma sertifikāta faila parole. |
| `ENV_SSL_ROUTER_IP` | JĀ |  | Tiek izmantots savienojumam ar manuālu konfigurāciju. IP adrese vai DNS nosaukums komponentam SSL Router, kuram pievienosies Edge Gateway. |
| `ENV_SSL_ROUTER_PORT` | NĒ | `443` | Tiek izmantots savienojumam ar manuālu konfigurāciju. Komponenta SSL Router ports, kuram pievienosies Edge Gateway. |

#### Dažādi mainīgie

| Nosaukums | Obligāts | Noklusējuma vērtība | Komentārs |
|---|---|---|---|
| `ENV_DISABLE_RSYSLOG` | NĒ | `false` | Pakalpojuma `rsyslog` atspējošana. Pieņemamās vērtības: `true` vai `false`. |
| `ENV_KERBEROS_CONFIG_ENABLE` | NĒ | `false` | Iespējo Kerberos iestatījumus, lai RDP lietojumprogrammas varētu autentificēties režīmā bez aģenta, izmantojot Kerberos. Pieņemamās vērtības: `true` vai `false`. Ja `false`, pārējie Kerberos mainīgie tiek ignorēti. |
| `ENV_KERBEROS_DEFAULT_REALM` | JĀ (ja Kerberos konfigurācija ir iespējota) |  | Kerberos sfēras nosaukums. |
| `ENV_KERBEROS_DEFAULT_DOMAIN` | JĀ (ja Kerberos konfigurācija ir iespējota) |  | Kerberos domēna nosaukums. |
| `ENV_KERBEROS_CONTROLLER_ADDRESS` | JĀ (ja Kerberos konfigurācija ir iespējota) |  | Kerberos kontrollera savienojuma adrese. |

### Sējumi

| Sējums | Komentārs |
|---|---|
| `/etc/ipdiva/` | Edge Gateway konfigurācijas sējums. Ieteicams to piemontēt nosauktā sējumā vai resursdatora failu sistēmā. |
| `/opt/certificates/` | Sējums, kurā ir Edge Gateway sertifikāts(-i) konfigurācijā bez pairing. |
| `/var/lib/ipdiva/carerecord/archives/` | Sējums, kurā ir grafiskie arhīvi. Ieteicams to piemontēt nosauktā sējumā vai resursdatora failu sistēmā. |
| `/var/ipdiva/care/sshrecord/` | Sējums, kurā ir SSH arhīvi. Ieteicams to piemontēt nosauktā sējumā vai resursdatora failu sistēmā. |
| `/var/log/` | Sējums, kurā ir Edge Gateway žurnāli. |

### Porti

| Ports | Komentārs |
|---|---|
| `2222` (vai jebkurš cits pieejams ports, ko izvēlējies administrators) | SSH/SFTP tiešās piekļuves pakalpojuma klausīšanās ports. |
| `3389` | RDP tiešās piekļuves pakalpojuma klausīšanās ports. |
| `8443` | Ierakstīšanas pakalpojuma klausīšanās ports, kas jāpadara pieejams, ja tiek izmantots Windows ierakstīšanas aģents. |

## Edge Gateway Docker izvietošana

### Izvietošana, izmantojot pairing

> **Priekšnosacījumi**
>
> Pirms Edge Gateway Docker izvietošanas jums ir [jāiegūst pairing marķieris](https://docs.cyberelements.io/bastion/4.6/lv/Usage/Configuration/AdminConsole/CreatePairingTokenForEdgeGateway/).

Tālāk aprakstītajā izvietošanā tiks izmantoti visi pieejamie sējumi (izņemot `/opt/certificates/`, kas šajā kontekstā nav noderīgs) un padarīti pieejami visi porti.
Sējumi tiks piemontēti resursdatora failu sistēmā vietā `EDGE_GATEWAY_REP`. Šajā vietā atrodas šādi apakšdirektoriji:

- config
- graphical_archives
- ssh_archives
- log

Tālāk norādīto komandu mainīgos varat pielāgot:

| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
|  | `DOCKER_NAME` | Docker konteinera nosaukums. |
|  | `EDGE_GATEWAY_REP` | Vieta failu sistēmā, kur piemontēt sējumus. |
|  | `ENV_MEDIATION_VALUE` | [Vides mainīgā](#environment-variables) `ENV_MEDIATION` vērtība. |
|  | `ENV_TOKEN_VALUE` | [Vides mainīgā](#environment-variables) `ENV_TOKEN` vērtība. |
|  | `ENV_NO_CHECK_CERT_VALUE` | [Vides mainīgā](#environment-variables) `ENV_NO_CHECK_CERT` vērtība. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE` vērtība. |
|  | `ENV_KERBEROS_DEFAULT_REALM_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM` vērtība. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN` vērtība. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS` vērtība. |

Izveidojiet direktoriju koku, kas nepieciešams sējumu piemontēšanai failu sistēmā:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Un visbeidzot palaidiet jaunu konteineru:

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

Konteinera žurnālus var skatīt, izmantojot šo komandu:

```
1
```

### Manuāla izvietošana

> **Priekšnosacījumi**
>
> Pirms komponenta Edge Gateway Docker izvietošanas jums ir nepieciešami sertifikāti komponentam Edge Gateway un ierakstīšanas pakalpojumam.

> **Paroles, kas redzamas ar `docker inspect`**
>
> Konteinera vides mainīgos, tostarp sertifikātu paroles, var nolasīt ikviens, kam Docker serverī ir atļauts izpildīt `docker inspect`. Tāpēc ieteicams izmantot [izvietošanu ar pairing](#deployment-with-pairing), kurai nav vajadzīga sertifikāta parole.

Tālāk aprakstītā izvietošana izmantos visus pieejamos sējumus un padarīs pieejamus visus portus.
Sējumi tiks pievienoti resursdatora failu sistēmā vietā `MANUAL_REP`. Šajā vietā atrodas šādas apakšmapes:

- config
- graphical_archives
- ssh_archives
- log
- certificates

Tālāk norādīto komandu mainīgos varat pielāgot:

| Pielāgotā vērtība | Mainīgais | Komentārs |
|---|---|---|
|  | `MANUAL_NAME` | Docker konteinera nosaukums. |
|  | `MANUAL_REP` | Vieta failu sistēmā, kur pievienot sējumus. |
|  | `ENV_GW_CERT_NAME_VALUE` | [Vides mainīgā](#environment-variables) `ENV_GW_CERT_NAME` vērtība. |
|  | `ENV_CARE_CERT_NAME_VALUE` | [Vides mainīgā](#environment-variables) `ENV_CARE_CERT_NAME` vērtība. |
|  | `ENV_SSL_ROUTER_IP_VALUE` | [Vides mainīgā](#environment-variables) `ENV_SSL_ROUTER_IP` vērtība. |
|  | `ENV_SSL_ROUTER_PORT_VALUE` | [Vides mainīgā](#environment-variables) `ENV_SSL_ROUTER_PORT` vērtība. |
|  | `ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_CONFIG_ENABLE` vērtība. |
|  | `ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_DEFAULT_REALM` vērtība. |
|  | `ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_DEFAULT_DOMAIN` vērtība. |
|  | `ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE` | [Vides mainīgā](#environment-variables) `ENV_KERBEROS_CONTROLLER_ADDRESS` vērtība. |

Izveidojiet direktoriju koku, kas nepieciešams sējumu piemontēšanai failu sistēmā:

**Bash**

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

**PowerShell**

> ```
> 1
> ```

Pēc tam ievietojiet komponenta Edge Gateway un ierakstīšanas pakalpojuma sertifikātus mapē `MANUAL_REP/certificates`.

Lai sertifikātu paroles netiktu saglabātas čaulas vēsturē, ievadiet tās pašreizējās sesijas vides mainīgajos (ievadītais netiek rādīts):

**Bash**

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

**PowerShell**

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

Visbeidzot palaidiet jaunu konteineru:

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

Kad konteiners ir palaists, noņemiet šos mainīgos no sesijas:

**Bash**

> ```
> 1
> ```

**PowerShell**

> ```
> 1
> ```

Konteinera žurnālus var skatīt, izmantojot šo komandu:

```
1
```
