Dubbo deploy to Docker environment

take Dubbo deploy to Docker environment

Some deployment scenarios need to dynamically specify the address of service registration. For example, docker bridge network mode need to specify a registered host IP for external network communication. Dubbo provides two pairs of system attributes in the startup phase, which are used to set the IP and port addresses of external communication.

  • DUBBO_IP_TO_REGISTRY — Registering to the IP address of the registration center
  • DUBBO_PORT_TO_REGISTRY — Registering to the port of the registration center
  • DUBBO_IP_TO_BIND — Listening IP addresses  
  • DUBBO_PORT_TO_BIND — Listening ports
  1. The above four configurations are optional. Dubbo will automatically get IP and port if there is no configuration. Please choose them flexibly according to deployment scenarios.
  2. Dubbo supports multi-protocol. If an application exposes multiple different protocol services simultaneously and need to specify IP or port separately for each service. Please add the protocol prefix before the above attributes separately. For example:
  • HESSIAN_DUBBO_PORT_TO_BIND hessian protocol bound port
  • DUBBO_DUBBO_PORT_TO_BIND   dubbo protocol bound port
  • HESSIAN_DUBBO_IP_TO_REGISTRY hessian protocol registered IP
  • DUBBO_DUBBO_IP_TO_REGISTRY     dubbo protocol registered IP
  1. PORT_TO_REGISTRY or IP_TO_REGISTRYwon’t be used as default PORT_TO_BIND or IP_TO_BIND,But the reverse is true.
  • If setPORT_TO_REGISTRY=20881 IP_TO_REGISTRY=,then PORT_TO_BIND IP_TO_BINDwon’t be affected.
  • If setPORT_TO_BIND=20881 IP_TO_BIND=,then PORT_TO_REGISTRY=20881 IP_TO_REGISTRY= by default.

dubbo-docker-sample local operation process:

  1. clone project to local
git clone git@github.com:dubbo/dubbo-docker-sample.git
cd dubbo-docker-sample
  1. package local maven
mvn clean install
  1. build a mirror by docker build
docker build --no-cache -t dubbo-docker-sample .


FROM openjdk:8-jdk-alpine
ADD target/dubbo-docker-sample-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT exec java $JAVA_OPTS -jar /app.jar
  1. Create and run containers from mirroring
# Since we use the zk registration center, we start zk container first
docker run --name zkserver --restart always -d zookeeper:3.4.9
docker run -e DUBBO_IP_TO_REGISTRY= -e DUBBO_PORT_TO_REGISTRY=20881 -p --link zkserver:zkserver -it --rm dubbo-docker-sample

Suppose the host IP is set the provider to register the IP address and port of the registration center by environment variables DUBBO_IP_TO_REGISTRY= DUBBO_PORT_TO_REGISTRY=20881   Implement the port mapping by-p, where 20880 is the listening port automatically selected by dubbo. There is no monitoring IP configuration, so it will listen (all IP). After startup, the registered address of provider is, and the listening address of the container is: 

  1. Test Execute from another host or container
telnet 20881
invoke org.apache.dubbo.test.docker.DemoService.hello("world")

Last modified January 28, 2023: Update Docker.md (#1959) (a296a74687)