On-Premise-Container einrichten

Zweck

Diese Seite beschreibt die empfohlene Vorgehensweise, um BE-Code als lokale On-Premise-Installation auf einem Windows-Server per Docker Compose zu betreiben.

Voraussetzungen

• Windows-Server ab Build 22H2, mindestens 1 CPU-Kern, 1 GB RAM und 10 GB freier Festplattenspeicher.
• Installierte und konfigurierte Docker Engine und Docker Compose.
• Zugriff auf die BE-terna Azure Container Registry becode.azurecr.io; die Authentifizierung erfolgt über ACR-Tokens, ein Token je Kunde.
• Gültiges SSL-Zertifikat als cert.pfx in einem Hostverzeichnis (z. B. C:\certs).

Empfohlene Reihenfolge

1. Anwendungsordner anlegen, z. B. C:\be.code.
2. Dateien docker-compose.yml und .env in diesem Ordner anlegen.
3. docker-compose.yml befüllen.
4. .env befüllen und Kennwörter setzen.
5. Container starten und Erreichbarkeit prüfen.

Einrichtungsbausteine

Docker-Compose-Datei pflegen

Legen Sie im Anwendungsordner die Datei docker-compose.yml mit folgendem Inhalt an:

services:
    becode:
        image: becode.azurecr.io/becode:latest
        container_name: becode
        restart: always
        expose:
            - "1880"
        ports:
            - "1880:1880"
        volumes:
            - C:\certs:C:\certs
        env_file:
            - .env

Der Pfad vor dem Doppelpunkt im volumes-Eintrag verweist auf das Hostverzeichnis, in dem die cert.pfx-Datei liegt.

Umgebungsvariablen in der .env-Datei setzen

Legen Sie im gleichen Ordner die Datei .env an. Die Zertifikatsdatei muss exakt cert.pfx heißen. Ersetzen Sie userPw durch ein starkes Kennwort:

title="BE-terna"
port="1880"
flowfile="C:\\data\\flow.json"
settingsfile="C:\\data\\settings.js"
userPw=""
certificateName="C:\certs\cert.pfx"
certificatePw=""

Container starten

Öffnen Sie ein Terminal im Anwendungsordner und starten Sie den Container:

docker compose up -d

Nach dem Start steht BE-Code unter https://<hostname>:1880/becode bereit. Verwenden Sie dieselbe Adresse im BE-Code-Setup in Business Central.