Add Example Dockerfile

[Kalatyr]

What language and solver does this apply to?
All

Describe the problem you are trying to solve.
I have a macbook M1Pro and I have been trying to just install the or-tools c++ library for 4 days without any success. There is always something. There is always a mismatch of library or missing definition or missing flag not remotely mentioned in the guide.
I also tried to create it in docker with DebianBullseye to no avail.

Describe the solution you'd like
I was thinking maybe someone can add dockerfile(s), where the library gets installed and any example program is run. This way we can guarantee atleast an environment has no problems and the margin of chaos (that is hardware, OS, external dependencies) are limited or at least highlighted

Additional context
I was thinking just one file per language would help alot

• from X (e.g. Bullseye )
• apt install all needed libraries
• wget google/or-tools
• build
• install
• test library
• run example project and test

[lperron]

we have plenty of dockerfiles that build the libraries.

[lperron]

you can also check the github runner. They correctly build the libraries.

[lperron]

Finally, OR-Tools is also delivered by homebrew.

[Kalatyr]

First of all thank you for the work and the answers.

I either didn't explain myself correctly or you are pointing me towards something but i am just too overwhelmed to find it.

The idea is: a dockerfile not just with the installed or-tools but with a functioning external project based on one of the examples provided. (in case this exists already, can you please comment with a link to the file as i definitely missed it)

Background/Rant:
While building or-tools correctly was a challenge, it is a minor one compared to trying to use the solvers in my project (a new c++ project to be exact). In my case, I implemented some of the "solvers" in rust and I want to test if it would be better for a productive env (maintenability / soundness / speed ...) to use a "wrapper" for or-tools. But i can't do that without first testing how it works (real quick) in its own language.

[lperron]

In java, dotnet, and python, we already support the standard package manager (maven, nuget, pypi).

So this only applies in C++.

Furthermore, unless you are using windows, the easiest way to try the library in C++ is to use bazel.

And we do have examples on how to use them:

• https://github.com/or-tools/bazel_or-tools
• https://github.com/or-tools/cmake_or-tools

[Kalatyr]

Alright, fair enough. I guess i will switch languages and make another try. Thanks for the quick answers.

[Mizux]

Otherwise like laurent said you have:

• tons of docker to build release artifacts -> https://github.com/google/or-tools/tree/main/tools/docker/images
  note: you have a makefile in tools/docker to orchestrate the build
• For cmake you also have lots of Dockerfile there: https://github.com/google/or-tools/tree/main/cmake
  • First a Makefile to orchestrate e.g. cd cmake && make amd64_ubuntu_cpp_install_test
  • Take a look at the Dockerfile: https://github.com/google/or-tools/blob/main/cmake/docker/ubuntu/cpp.Dockerfile
  • you can spawn a temporary container to play with the C++ sample (using an cmake installed or-tools) (https://github.com/google/or-tools/tree/main/cmake/samples/cpp) using the cmd
    make sh_amd64_ubuntu_cpp_install_test

[Mizux]

$ docker image ls
REPOSITORY                          TAG                             IMAGE ID       CREATED              SIZE
ortools/cmake                       amd64_ubuntu_cpp_install_test   c1996c95b872   About a minute ago   774MB

%docker run --rm --init -it ortools/cmake:amd64_ubuntu_cpp_install_test
root@fac10d2b6dd8:/home/sample# ls
CMakeLists.txt  build  main.cpp
root@fac10d2b6dd8:/home/sample# ./build/sample
Number of variables = 2
Number of constraints = 3
Solution:
x = 6
y = 4
Optimal objective value = 34

[Mizux]

There is always a mismatch of library or missing definition or missing flag not remotely mentioned in the guide.

Most/all flags are automatically carried by the CMake ortools target, how did you try to build and use ortools if it wasn't using the CMake ecosystem and usual workflow (using cmake install then consume it, using ExternalProject (old) or FetchContent (recommended and use by or-tools/cmake_ortools template project)) ?

[Kalatyr]

C++ macOS Binaries -> https://developers.google.com/optimization/install/cpp/binary_mac
I tried to go through it like here but failed. with error use of undeclared identifier 'FLAGS_stderrthreshold'

did you have the cmd to reproduce it ? 50% chance it may be a missing header (bug on our side)

C++ macOS Source -> https://developers.google.com/optimization/install/cpp/source_mac
I tried so many different times here
cmake --build build --config Release --target ALL_BUILD -j -v resulted in make: *** No rule to make target ALL_BUILD'. Stop.`
Took me some time to understand the error (didn't work with C/C++ since Uni)

Can you run cmake -G and see where is the default (*) generator, on macOS you must use/setup XCode as a prerequisite so the target is name ALL_BUILD, on linux the default is often * Unix Makefiles = Generates standard UNIX makefiles. so the target is call all.
If your macos don't have XCode then it fallback to Unix Makefile as a regular Linux machine...

cmake --build build --config Release --target all -j -v made my M1 crash so i removed the -j and -v
Still took ages but i managed to make it ... in retrospect I should've removed the target section completely

-j will spawn a nearly infinite number of parallel build, you should try a -j4 or -j8 instead to have 4 or 8 compile threads respectively...

[Kalatyr]

I will give c++ another try with Bazel then with docker and let you know.