add Dockerfile for building opensim-gui on Ubuntu Bionic

[mikekaram]

Fixes issue #1255

Brief summary of changes

Add Dockerfile for building opensim-gui in a clean environment.

Testing I've completed

Tested it under the following Docker version:

Client: Docker Engine - Community
 Version:           19.03.5
 API version:       1.40
 Go version:        go1.12.12
 Git commit:        633a0ea838
 Built:             Wed Nov 13 07:50:12 2019
 OS/Arch:           linux/amd64
 Experimental:      false

Server: Docker Engine - Community
 Engine:
  Version:          19.03.5
  API version:      1.40 (minimum version 1.12)
  Go version:       go1.12.12
  Git commit:       633a0ea838
  Built:            Wed Nov 13 07:48:43 2019
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.2.10
  GitCommit:        b34a5c8af56e510852c35414db4c1f4fa6172339
 runc:
  Version:          1.0.0-rc8+dev
  GitCommit:        3e425f80a8c931f88e6d94a8c831b9d5aa481657
 docker-init:
  Version:          0.18.0
  GitCommit:        fec3683

CHANGELOG.md

• no need to update because I added a new file

This PR aims to solve the difficulty I encountered when building the opensim-gui from source. I found the relevant issue but the discussion there wasn't enough for me to overcome the issues I faced. After building successfully (so so many tries), I wrote this Dockerfile to aid the next Ubuntu Bionic users in their installation process (and debugging).

Note 1: One of the main issues encountered, is the usage of openjdk-8. In my machine, I had installed the openjdk-11 and had to remove it. I’m not sure if update alternatives --config java could be sufficient. I removed the other version, just to be on the safe side.

Note 2: For some reason, the proposed installation of opensim-gui from the CI configuration file didn’t work. Especially the command cmake --build . --config Release for opensim-core didn’t work correctly, since there was no ~/opensim-core-install directory created. This resulted in some commands in the build.xml of opensim-gui to not find some paths, which should have been created from the installation of opensim-core. I changed the previous command to make -j4 && make install and worked like a charm.

[aymanhab]

Thanks for the PR, much appreciated 👍 . How do we test this so that we verify there's nothing special to your environment? Also what is the use case that you needed to build the gui in a docker container so we can document/publicize?

[mikekaram]

Hi @aymanhab, thanks for the prompt response.

I test it locally using this command: docker build --rm -t opensim-gui:bionic -f opensim-gui.dockerfile .. (Notice the dot at the end). Of course, you need to have the above Dockerfile in a file called opensim-gui.dockerfile, in the directory you are running the command from. I think you can run the Dockerfile in any Linux machine with Docker. For me, the acceptance criterion was for it to build without errors. I followed the steps in my machine and it worked, meaning that I could run opensim with the GUI without any error or warning.

That's the nice part with the above Dockerfile, you are sure that there aren't any extra dependencies installed. It's a clean process with concise installation steps. My need was to explore the installation process of Opensim in Linux, so that I can share the steps with my colleagues at work. I found this to be the easiest and more comprehensive way, rather than giving them scripts that may or not work in their setting.

Cheers,