2.6 KiB
Troubleshooting Travis CI builds locally in a Docker image
This document describes how to run a Travis CI build locally using docker.
Most of the information is available in the Getting Started guide under Common Build Problems, but this guide is specifically tailored towards building Cyclone.
Ensure Docker is installed, the daemon is running and you have the required privileges.
See this entry on the Fedora Developer Portal for setting up and using Docker on Fedora.
The instance: line under Worker information in the Job log will show exactly which instance of the ci-garnet image is used, but the latest image will do just fine.
Worker information
...
instance: travis-job-70cf1506-780a-445e-8f0d-da928d16ed65 travis-ci-garnet-trusty-1512502259-986baf0 (via amqp)
...
- Start a Docker container detached with
/sbin/init.
$ docker run --name travis-debug --cap-add=SYS_PTRACE --security-opt seccomp=unconfined -dit travisci/ci-garnet:packer-1515445631-7dfb2e1 /sbin/init
The image is quite large (4 GB) and it will take some time to download.
- Open a login shell in the running container.
$ docker exec -it travis-debug bash -l
- Install all packages required to build Cyclone.
$ add-apt-repository ppa:ubuntu-toolchain-r/test
$ echo "deb http://apt.llvm.org/trusty/ llvm-toolchain-trusty-6.0 main" >> /etc/apt/sources.list.d/llvm-toolchain-6.0.list
$ wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | apt-key add -
$ apt-get update
$ apt-get install gcc-8 g++-8 clang-6.0 oracle-java8-set-default maven
- Switch to the travis user.
su - travis
- Install The Conan C/C++ Package Manager.
$ pip intall conan --upgrade --user
$ conan user
- Add the required repositories.
$ conan remote add atolab https://api.bintray.com/conan/atolab/public-conan
$ conan remote add bincrafters https://api.bintray.com/conan/bincrafters/public-conan
- Clone the git repository.
$ git clone https://github.com/eclipse-cyclonedds/cyclonedds.git
- Build the project and run the tests.
By default CMake and Conan will choose gcc. To switch to clang, set the CC and CXX environment variables to clang and clang++ respectively.
$ export CC=gcc-8
$ export CXX=g++-8
$ cd cyclonedds
$ mkdir build
$ conan install ..
$ cmake -DBUILD_TESTING=on ../src
$ cmake --build .
$ ctest -T test