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:

docker load --input cleanroom-gateway-4.6.1-33-v4.tgz

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

docker inspect --type=image cleanroom-gateway:4.6.1-33-v4

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:

[
    {
        "Id": "sha256:c63645a09181bc3b83958bedf2eb3d7ea5fbbc2526126edb660a519b93338974",
        "RepoTags": [
            "cleanroom-gateway:4.6.1-33-v4"
        ],

Úplný výstup

[
    {
        "Id": "sha256:c63645a09181bc3b83958bedf2eb3d7ea5fbbc2526126edb660a519b93338974",
        "RepoTags": [
            "cleanroom-gateway:4.6.1-33-v4"
        ],
        "RepoDigests": [
            "cleanroom-gateway@sha256:fd96104ea219a05216c90c71c39b761083c989cbab8ef1f388cac09015bd54a3"
        ],
        "Comment": "buildkit.dockerfile.v0",
        "Created": "2026-02-17T16:21:12.399890264+01:00",
        "Config": {
            "User": "root",
            "ExposedPorts": {
                "9080/tcp": {}
            },
            "Env": [
                "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin",
                "DEBIAN_FRONTEND=noninteractive",
                "IMAGE_BUILD_DATE=20260217T161839",
                "IMAGE_BUILD_VERSION=4.6.1-33-v4",
                "IMAGE_IPDIPC=IPC-54826,IPC-53702,IPC-55425"
            ],
            "Entrypoint": [
                "/entrypoint.sh"
            ],
            "Volumes": {
                "/etc/ipdiva/": {},
                "/var/log/": {}
            },
            "Labels": {
                "maintainer": "contact@systancia.com",
                "org.label-schema.build-date": "20260217T161839",
                "org.label-schema.description": "Systancia Cleanroom Gateway",
                "org.label-schema.name": "Systancia Cleanroom 4.6.1-33-v4 Gateway",
                "org.label-schema.url": "http://systancia.com/",
                "org.label-schema.vendor": "Systancia",
                "version": "4.6.1-33-v4"
            },
            "Healthcheck": {
                "Test": [
                    "CMD-SHELL",
                    "/usr/lib/nagios/plugins/IPdivaSensorGateway -a isConnected -g 127.0.0.1:9080"
                ],
                "Interval": 300000000000,
                "Timeout": 10000000000,
                "Retries": 3
            }
        },
        "Architecture": "amd64",
        "Os": "linux",
        "Size": 1248982227,
        "GraphDriver": {
            "Data": {
                "LowerDir": "/var/lib/docker/overlay2/5a32af4bf30239320f2d4f04e9dde6e448d138d0e00dbcd0aa07ff859518bfd5/diff:/var/lib/docker/overlay2/da3ceed2e06933403d5e2b503f654efe58afd3067562d4991615cc79109f5000/diff:/var/lib/docker/overlay2/022f1b9fc82a6210ac50a7bf20705651a5a6bd2bfcdd8ca4993778870c4f04ce/diff:/var/lib/docker/overlay2/7675c3cb606871d89d593c5b40746256a109640e03d4846ee49392792f94c29b/diff:/var/lib/docker/overlay2/a0bc243e1069486711b74a39142def4596f99b21d00d286a2bd6212cf8902401/diff:/var/lib/docker/overlay2/fe91732a9355873a0d60ec041ea365567f0fbc963173c9428ab896b591fcb460/diff:/var/lib/docker/overlay2/d4af0110a3ab43120dea8c19e35b7552ad8f8d993d556c34143ecb3c4bd7e670/diff:/var/lib/docker/overlay2/399d72a9751679283e1435dffa5ea7b5abc07f264987815be3846e8e617cf031/diff:/var/lib/docker/overlay2/5c1723a91777858469dc540b3a91738f4b6fc6c0a3cc6686d48b4cb85a9c0400/diff:/var/lib/docker/overlay2/60b4e962507a658aa32be63de9cea55df0a45459b2f3549b3eef3443b35519b9/diff:/var/lib/docker/overlay2/9ff870b850857af52af3de1939f1abd129e96a91d608f3b8f68e0cbcd09eb181/diff",
                "MergedDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/merged",
                "UpperDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/diff",
                "WorkDir": "/var/lib/docker/overlay2/48efe7a9b5e8c4e24a395024dd0876c942b03a52ea161df553d5ee566505c4a8/work"
            },
            "Name": "overlay2"
        },
        "RootFS": {
            "Type": "layers",
            "Layers": [
                "sha256:51e78f04fd47b324ef2558bbed0cb5bc0d6d8e5ca3c56d5b98b91866a88f37bb",
                "sha256:3bb2b94a7a30506f2a91d55a04aa0e90a487b3a321d2e1df4f97dfbcfe32cfc0",
                "sha256:deb44bbc3e3d6990e142dc66532aeace714d6c191f1ede7a0f6fd8dcd7e751d3",
                "sha256:e61e4e2f89a04cb7bed974b2c8f510dd72d76e4bf998a000d082fc33bf29947e",
                "sha256:96b1236ab0e31d36a0d0fd17878770d969a11c8d4d33f8cacac568d0b0d76324",
                "sha256:989a4d7dbba1836ad30f58ca73f3101b21b80929f732d5ebdc87a69939b8cf6d",
                "sha256:1f2b05f37aceed6edd80cbe798657a7eb8fce3c7383df8d40d9fdeb273867a9d",
                "sha256:63aa193be3dc44af0057719f79991745e40d8b522a2aa49743dd04fe81b6a637",
                "sha256:02dcea7c2ed886996c81bd6980516420b90e2cdd930dc805388bcd5c7e14b5b3",
                "sha256:1f8c0ab2de5021d138baa67506b22d4d21750a23d0e9278a152daa2e7e953bff",
                "sha256:3601c2e047e3c5019a5e45fb23b478154beb6188761e31aeddb4326bfe16f81c",
                "sha256:20963ed8264d1ceaeb3680375c9c3df4045aa17af258957f3fa83f6224e62138"
            ]
        },
        "Metadata": {
            "LastTagTime": "0001-01-01T00:00:00Z"
        }
    }
]

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. Určuje tenant CyberElements.
`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é 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.

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í `ENV_MEDIATION`.
	`ENV_TOKEN_VALUE`	Hodnota proměnné prostředí `ENV_TOKEN`.
	`ENV_NO_CHECK_CERT_VALUE`	Hodnota proměnné prostředí `ENV_NO_CHECK_CERT`.
	`ENV_KERBEROS_CONFIG_ENABLE_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_CONFIG_ENABLE`.
	`ENV_KERBEROS_DEFAULT_REALM_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_DEFAULT_REALM`.
	`ENV_KERBEROS_DEFAULT_DOMAIN_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_DEFAULT_DOMAIN`.
	`ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_CONTROLLER_ADDRESS`.

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

BashPowerShell

mkdir -p EDGE_GATEWAY_REP/config
mkdir EDGE_GATEWAY_REP/graphical_archives
mkdir EDGE_GATEWAY_REP/ssh_archives
mkdir EDGE_GATEWAY_REP/log

New-Item -ItemType Directory -Force -Path "EDGE_GATEWAY_REP\config", "EDGE_GATEWAY_REP\graphical_archives", "EDGE_GATEWAY_REP\ssh_archives", "EDGE_GATEWAY_REP\log"

A nakonec spusťte nový kontejner:

BashPowerShell

docker run -d --restart unless-stopped --name "DOCKER_NAME" \
-e ENV_MEDIATION="ENV_MEDIATION_VALUE" \
-e ENV_TOKEN="ENV_TOKEN_VALUE" \
-e ENV_NO_CHECK_CERT="ENV_NO_CHECK_CERT_VALUE" \
-e ENV_KERBEROS_CONFIG_ENABLE="ENV_KERBEROS_CONFIG_ENABLE_VALUE" \
-e ENV_KERBEROS_DEFAULT_REALM="ENV_KERBEROS_DEFAULT_REALM_VALUE" \
-e ENV_KERBEROS_DEFAULT_DOMAIN="ENV_KERBEROS_DEFAULT_DOMAIN_VALUE" \
-e ENV_KERBEROS_CONTROLLER_ADDRESS="ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE" \
-v "EDGE_GATEWAY_REP/config/:/etc/ipdiva/:rw" \
-v "EDGE_GATEWAY_REP/graphical_archives/:/var/lib/ipdiva/carerecord/archives/:rw" \
-v "EDGE_GATEWAY_REP/ssh_archives/:/var/ipdiva/care/sshrecord/:rw" \
-v "EDGE_GATEWAY_REP/log/:/var/log/:rw" \
-p 2222:2222 \
-p 3389:3389 \
-p 8443:8443 \
cleanroom-gateway:4.6.1-33-v4

docker run -d --restart unless-stopped --name "DOCKER_NAME" `
-e "ENV_MEDIATION=ENV_MEDIATION_VALUE" `
-e "ENV_TOKEN=ENV_TOKEN_VALUE" `
-e "ENV_NO_CHECK_CERT=ENV_NO_CHECK_CERT_VALUE" `
-e "ENV_KERBEROS_CONFIG_ENABLE=ENV_KERBEROS_CONFIG_ENABLE_VALUE" `
-e "ENV_KERBEROS_DEFAULT_REALM=ENV_KERBEROS_DEFAULT_REALM_VALUE" `
-e "ENV_KERBEROS_DEFAULT_DOMAIN=ENV_KERBEROS_DEFAULT_DOMAIN_VALUE" `
-e "ENV_KERBEROS_CONTROLLER_ADDRESS=ENV_KERBEROS_CONTROLLER_ADDRESS_VALUE" `
-v "EDGE_GATEWAY_REP\config:/etc/ipdiva/:rw" `
-v "EDGE_GATEWAY_REP\graphical_archives:/var/lib/ipdiva/carerecord/archives/:rw" `
-v "EDGE_GATEWAY_REP\ssh_archives:/var/ipdiva/care/sshrecord/:rw" `
-v "EDGE_GATEWAY_REP\log:/var/log/:rw" `
-p 2222:2222 `
-p 3389:3389 `
-p 8443:8443 `
cleanroom-gateway:4.6.1-33-v4

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

docker logs -f DOCKER_NAME

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, 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í `ENV_GW_CERT_NAME`.
	`ENV_CARE_CERT_NAME_VALUE`	Hodnota proměnné prostředí `ENV_CARE_CERT_NAME`.
	`ENV_SSL_ROUTER_IP_VALUE`	Hodnota proměnné prostředí `ENV_SSL_ROUTER_IP`.
	`ENV_SSL_ROUTER_PORT_VALUE`	Hodnota proměnné prostředí `ENV_SSL_ROUTER_PORT`.
	`ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_CONFIG_ENABLE`.
	`ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_DEFAULT_REALM`.
	`ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_DEFAULT_DOMAIN`.
	`ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE`	Hodnota proměnné prostředí `ENV_KERBEROS_CONTROLLER_ADDRESS`.

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

BashPowerShell

mkdir -p MANUAL_REP/config
mkdir MANUAL_REP/graphical_archives
mkdir MANUAL_REP/ssh_archives
mkdir MANUAL_REP/log
mkdir MANUAL_REP/certificates

New-Item -ItemType Directory -Force -Path "MANUAL_REP\config", "MANUAL_REP\graphical_archives", "MANUAL_REP\ssh_archives", "MANUAL_REP\log", "MANUAL_REP\certificates"

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):

BashPowerShell

read -rsp "Edge Gateway certificate password: " ENV_GW_CERT_PASSWORD; echo
read -rsp "Recording service certificate password: " ENV_CARE_CERT_PASSWORD; echo
export ENV_GW_CERT_PASSWORD ENV_CARE_CERT_PASSWORD

$env:ENV_GW_CERT_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host -AsSecureString "Edge Gateway certificate password")).Password
$env:ENV_CARE_CERT_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host -AsSecureString "Recording service certificate password")).Password

Nakonec spusťte nový kontejner:

BashPowerShell

docker run -d --restart unless-stopped --name "MANUAL_NAME" \
-e ENV_GW_CERT_NAME="ENV_GW_CERT_NAME_VALUE" \
-e ENV_GW_CERT_PASSWORD \
-e ENV_CARE_CERT_NAME="ENV_CARE_CERT_NAME_VALUE" \
-e ENV_CARE_CERT_PASSWORD \
-e ENV_SSL_ROUTER_IP="ENV_SSL_ROUTER_IP_VALUE" \
-e ENV_SSL_ROUTER_PORT="ENV_SSL_ROUTER_PORT_VALUE" \
-e ENV_KERBEROS_CONFIG_ENABLE="ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE" \
-e ENV_KERBEROS_DEFAULT_REALM="ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE" \
-e ENV_KERBEROS_DEFAULT_DOMAIN="ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE" \
-e ENV_KERBEROS_CONTROLLER_ADDRESS="ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE" \
-v "MANUAL_REP/config/:/etc/ipdiva/:rw" \
-v "MANUAL_REP/graphical_archives/:/var/lib/ipdiva/carerecord/archives/:rw" \
-v "MANUAL_REP/ssh_archives/:/var/ipdiva/care/sshrecord/:rw" \
-v "MANUAL_REP/log/:/var/log/:rw" \
-v "MANUAL_REP/certificates/:/opt/certificates/:ro" \
-p 2222:2222 \
-p 3389:3389 \
-p 8443:8443 \
cleanroom-gateway:4.6.1-33-v4

docker run -d --restart unless-stopped --name "MANUAL_NAME" `
-e "ENV_GW_CERT_NAME=ENV_GW_CERT_NAME_VALUE" `
-e ENV_GW_CERT_PASSWORD `
-e "ENV_CARE_CERT_NAME=ENV_CARE_CERT_NAME_VALUE" `
-e ENV_CARE_CERT_PASSWORD `
-e "ENV_SSL_ROUTER_IP=ENV_SSL_ROUTER_IP_VALUE" `
-e "ENV_SSL_ROUTER_PORT=ENV_SSL_ROUTER_PORT_VALUE" `
-e "ENV_KERBEROS_CONFIG_ENABLE=ENV_KERBEROS_CONFIG_ENABLE_MANUAL_VALUE" `
-e "ENV_KERBEROS_DEFAULT_REALM=ENV_KERBEROS_DEFAULT_REALM_MANUAL_VALUE" `
-e "ENV_KERBEROS_DEFAULT_DOMAIN=ENV_KERBEROS_DEFAULT_DOMAIN_MANUAL_VALUE" `
-e "ENV_KERBEROS_CONTROLLER_ADDRESS=ENV_KERBEROS_CONTROLLER_ADDRESS_MANUAL_VALUE" `
-v "MANUAL_REP\config:/etc/ipdiva/:rw" `
-v "MANUAL_REP\graphical_archives:/var/lib/ipdiva/carerecord/archives/:rw" `
-v "MANUAL_REP\ssh_archives:/var/ipdiva/care/sshrecord/:rw" `
-v "MANUAL_REP\log:/var/log/:rw" `
-v "MANUAL_REP\certificates:/opt/certificates/:ro" `
-p 2222:2222 `
-p 3389:3389 `
-p 8443:8443 `
cleanroom-gateway:4.6.1-33-v4

Po spuštění kontejneru odeberte tyto proměnné z relace:

BashPowerShell

unset ENV_GW_CERT_PASSWORD ENV_CARE_CERT_PASSWORD

Remove-Item Env:ENV_GW_CERT_PASSWORD, Env:ENV_CARE_CERT_PASSWORD

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

docker logs -f MANUAL_NAME