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

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