Page History
Div | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
|
You can create Docker containers from the BRIDGE images using docker-compose. This includes the following steps:
...
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
.Create a file docker-compose.yml to the previously created folder. This file should have the following content:
Code Block linenumbers true version: '2.1' services: bridge: image: 'bridge:<version>${VERSION:-7.7.0}' hostname: '<your hostname>${BRIDGE_SERVER_HOSTNAME:}' restart: always ports: - '<your host port>${HOST_BRIDGE_PORT:-8080}:8080' - '<your host proxy port>:<Docker BRIDGE proxy port>${HOST_PORTS}:${CONTAINER_PORTS}' volumes: - 'bridge_data:/opt/bridge_data/' volumes: bridge_data: driver: local
Change Here, you can change the settings of this file as described below.following settings:
Line Setting Description Allowed Values / Example 4 services/image
Provide the version of the Docker image. 'bridge:7. 5 .1'5 services/bridge/hostname
Provide your BRIDGE hostname (that matches with the BRIDGE license). hostname: 'bridge.e2e.ch'
6 services/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.
always Restart BRIDGE container on host reboot. To define the variables used in the docker-compose.yml, create a .env file in the same folder the docker-compose.yml resides in.
Variable Description Mandatory Allowed Values / Example BRIDGE_SERVER_HOSTNAME
Provide your BRIDGE hostname (that matches with the BRIDGE license). BRIDGE_SERVER_HOSTNAME='bridge.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
VERSION
Provide the version of the Docker image. VERSION=7.8.0
HOST_BRIDGE_PORT
Provide the BRIDGE port on the host. HOST_BRIDGE_PORT=8090
Default 8080
HOST_PORTS
7-9 services/bridge/ports
Map the BRIDGE Docker ports to the ports of the host like
<your host port>:<Docker BRIDGE port>
. Mapping the BRIDGE port is the minimal configuration needed, you can add more port mappings if necessary.Info Map BRIDGE Docker ports to the ports of the host. You can specify a single port or a range
FROM-TO
.
TheHOST_PORTS
andCONTAINER_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
ports:
- '18080:8080'
- '1443:443'
Step 3: Start the Container
...