Versions Compared

Old Version 4

changes.mady.by.user Kirstin Seidel-Gebert

Saved on

compared with

New Version 5

changes.mady.by.user Kirstin Seidel-Gebert

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space WINSTALLATION and version 9

...

  1. Create a folder to contain the BRIDGE Docker configuration.

    Info

    Please note that the docker-compose project is named after this folder, and also the created Docker containers. Naming convention for the Docker containers is: <docker-compose project name>_bridge_1.

  2. Create a file docker-compose.yml to the previously created folder. This file should have the following content:

    Code Block
    linenumberstrue
    services:
  bridge:
    image: 'bridge:${VERSION:-7.7.0}'
    hostname: '${BRIDGE_SERVER_HOSTNAME:}'
	environment:
      - 'BRIDGE_SERVER_HOSTNAME=${BRIDGE_SERVER_HOSTNAME}'
    restart: always
    ports:
      - '${HOST_BRIDGE_PORT:-8080}:8080'
      - '${HOST_PORTS}:${CONTAINER_PORTS}'
    volumes:
      - 'bridge_data:/opt/bridge_data/'
      - './${BRIDGE_SERVER_HOSTNAME}_key.pem:/opt/bridge_data/proxies/conf/${BRIDGE_SERVER_HOSTNAME}_key.pem'
      - './${BRIDGE_SERVER_HOSTNAME}_cert.pem:/opt/bridge_data/proxies/conf/${BRIDGE_SERVER_HOSTNAME}_cert.pem'
volumes:
  bridge_data:
    driver: local

    Here, you can change the following settings:

    LineSettingDescriptionAllowed Values / Example
    6services/bridge/environmentSpecify a proxy node name for your BRIDGE installation. You can use the environment variables ${BRIDGE_PROXY_HOSTNAME} and ${BRIDGE_SERVER_HOSTNAME}, or specify a fix filename.a string
    ${BRIDGE_PROXY_HOSTNAME}
    ${BRIDGE_SERVER_HOSTNAME}
    75services/bridge/restart 

    Define if the BRIDGE Docker container should be started automatically, e.g. on host reboot. Delete this line, if you do not want to start the container automatically.

    For more information on Docker restart refer to the Docker documentation pages.

    		alwaysRestart BRIDGE container on host reboot.
    13/14services/bridge/volumes/*.pem

    Mount the proxy certificate files into the container. This works with intermediate certificates as well.

    • Copy the certificate files to the folder the docker-compose.yml resides in, or specify a valid path instead of ./.
    • You can use the environment variables ${BRIDGE_PROXY_HOSTNAME} and ${BRIDGE_SERVER_HOSTNAME}, or specify a fix filename.

  3. To define the variables used in the docker-compose.yml, create a .env file in the same folder the docker-compose.yml resides in.

    VariableDescriptionMandatoryAllowed Values / Example
    BRIDGE_SERVER_HOSTNAME Provide your BRIDGE hostname (that matches with the BRIDGE license).(tick)
    BRIDGE_SERVER_HOSTNAME='bridge.scheer-acme.com'
    BRIDGE_PROXY_HOSTNAMEProvide your BRIDGE proxy hostname (that matches with the proxy license).
    BRIDGE_PROXY_HOSTNAME='proxy.scheer-acme.com'

    COMPOSE_PROJECT_NAME

    Define the Docker compose project name. This name is used as a prefix for all BRIDGE volumes and containers.

    Note

    Once you have defined a project name and installed the BRIDGE, do not change the project name anymore.


    COMPOSE_PROJECT_NAME=bridge_prod
    VERSIONProvide the version of the Docker image.
    VERSION=7.8.0
    HOST_BRIDGE_PORTProvide the BRIDGE port on the host.
    HOST_BRIDGE_PORT=8090
    Default
    8080
    HOST_PORTS

    Map BRIDGE Docker ports to the ports of the host. You can specify a single port or a range FROM-TO.
    The HOST_PORTS and CONTAINER_PORTS must have a matching count of port numbers.

    Info

    We recommend to route all service calls via the same proxy, so at least one more proxy mapping will be needed (as shown in the example).


    HOST_PORTS=1443
    HOST_PORTS=1443-1444
    CONTAINER_PORTS
    CONTAINER_PORTS=443
    CONTAINER_PORTS=443-444

Step 3: Start the Container

...