Installing the Bridge Image to a Docker Container

You can create Docker containers from the Bridge images using docker-compose. This includes the following steps:

Step 1: Extract the Software

Load the Bridge Docker image with

CODE

docker image load -i bridge-<version>.tar

Step 2: Configure the Installation Settings

To configure the settings of the Docker image, you need to put your configuration in a docker-compose.yml file.

Create a folder to contain the Bridge Docker configuration.

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

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:

Line	Setting	Description	Allowed Values / Example
6	`services/bridge/environment`	Specify 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}`
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 Bridgecontainer on host reboot.
13/14	`services/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.

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	Allowed Values / Example
`BRIDGE_SERVER_HOSTNAME`	Provide your Bridge hostname (that matches with the Bridge license).	`BRIDGE_SERVER_HOSTNAME='bridge.scheer-acme.com'`
`BRIDGE_PROXY_HOSTNAME`	Provide 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. 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`
`HOST_BRIDGE_PORT`	Provide the Bridge port on the host.	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.	`HOST_PORTS=1443` `HOST_PORTS=1443-1444`
`CONTAINER_PORTS`	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).	`CONTAINER_PORTS=443` `CONTAINER_PORTS=443-444`

Step 3: Start the Container

Start the container by running the following command:

Docker-compose up

To run the container in the background, use:

Docker-compose up -d

You can stop the container using

CODE

docker-compose stop

If you change the Docker configuration in docker-compose.yml, you need to restart the Docker container (stop/up) to apply the changes.

Step 4: Checking the Installation

If you want to check the installation, continue with Checking the Installation.

Related Pages: