DockerMv is an extended version of Docker which supports software multi-versioning in services. By using DockerMV, we can create Docker services with more than one image.
In order to run this program, follow these steps:
-
Install the go programming language as following:
1.1) Run the following commands:
wget https://dl.google.com/go/go1.13.6.linux-amd64.tar.gz tar -xvf go1.13.6.linux-amd64.tar.gz sudo mv go /usr/local1.2) Now set the GOPATH variable, which tells GO where to look for its files:
sudo nano ~/.profileAt the end of the file add this line:
export GOPATH=$HOME/DockerMV/go export PATH=$PATH:/usr/local/go/bin:$GOPATH/binNow save and close the file, and refresh your profile.
source ~/.profile -
Install docker as follows:
2.1) Run the following commands:
sudo apt install apt-transport-https ca-certificates curl software-properties-common curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add - sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable" apt-cache policy docker-ceAt the end you should see output similar to this:
Installed: (none) Candidate: 5:19.03.5~3-0~ubuntu-bionic Version table: 5:19.03.5~3-0~ubuntu-bionic 500 500 https://download.docker.com/linux/ubuntu bionic/stable amd64 Packages2.2) Finally install docker
sudo apt install docker-ce -
Clone this project and put in you $HOME directory.
-
Run the following command from your $HOME directory.
chmod -R 777 DockerMV
- Move to $HOME/DockerMV/go/src/github.com/docker/cli directory and run the following command to build the project.
make binary
You will see a similar message when the program is successfuly compiled:
WARNING: you are not in a container.
Use "make -f docker.Makefile binary" or set
DISABLE_WARN_OUTSIDE_CONTAINER=1 to disable this warning.
Press Ctrl+C now to abort.
WARNING: binary creates a Linux executable. Use cross for macOS or Windows.
./scripts/build/binary
Building statically linked build/docker-linux-amd64
- To run services with DockerMV, you need to create a Docker Swarm. Check the public IP address of your machine on your network. Notice that the IP address must be accessible from outside.
hostname -I | awk '{print $1}'
Then, you need to create an overlay network by running the following command:
sudo docker swarm init --advertise-addr HOST_IP
sudo docker network create -d overlay --attachable my-net
- To run a command using DockerMV, first move to $HOME/DockerMV/go/src/github.com/docker/cli directory, and your command needs to start with ./build/docker
The TeaStore application is a reference application for testing and benchmarking. You can find two version of its Recommender service on our Docker Hub page. Also, we used the teastore.jmx to create a load on the system for our testing purposes.
The Znn application is used for testing and benchmarking of self-adaptive applications. We created two version of its content-providing component which are available on our Docker Hub page. Also, we used the znn.jmx to create a load on the system for our testing purposes.
You can setup the Znn application with the following commands. Notice to replace the HOST_IP with your host IP address.
sudo docker run --network="my-net" -d -p 3306:3306 alirezagoli/znn-mysql:v1
./build/docker service create HOST_IP my-net my_znn 1081 $HOME/DockerMV/znn_sample_rule.txt alirezagoli/znn-text:v1 1 1g 1g 0.2 alirezagoli/znn-multimedia:v1 1 1g 1g 0.2
By running th following command you can see four containers are running.
sudo docker ps -a
Now, you can see the service working by running the following command. Notice that the NGINX port is randomly assigned and you can find it by the above command.
curl http://HOST_IP:NGINX_PORT/news.php
In order to remove the containers you need to first stop them.
sudo docker stop CONTAINER_ID
Afterward, you can remove the containers
sudo docker rm CONTAINER_ID
The DockerMV was first published in Proceedings of the 2020 ACM/SPEC International Conference on Performance Engineering (ICPE '20). You can find the paper on the ASGAARD lab website.