90 lines
2.6 KiB
Markdown
90 lines
2.6 KiB
Markdown
# 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](https://docs.travis-ci.com/user/common-build-problems/#running-a-container-based-docker-image-locally),
|
|
but this guide is specifically tailored towards building Cyclone.
|
|
|
|
> Ensure [Docker](https://www.docker.com/) is installed, the daemon is running
|
|
> and you have the required privileges.
|
|
|
|
> See this [entry](https://developer.fedoraproject.org/tools/docker/about.html)
|
|
> 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)
|
|
...
|
|
```
|
|
|
|
1. 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.
|
|
|
|
2. Open a login shell in the running container.
|
|
|
|
```
|
|
$ docker exec -it travis-debug bash -l
|
|
```
|
|
|
|
3. 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
|
|
```
|
|
|
|
4. Switch to the *travis* user.
|
|
|
|
```
|
|
su - travis
|
|
```
|
|
|
|
5. Install The [Conan C/C++ Package Manager](https://conan.io).
|
|
|
|
```
|
|
$ pip intall conan --upgrade --user
|
|
$ conan user
|
|
```
|
|
|
|
6. 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
|
|
```
|
|
|
|
7. Clone the git repository.
|
|
|
|
```
|
|
$ git clone https://github.com/eclipse-cyclonedds/cyclonedds.git
|
|
```
|
|
|
|
8. 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
|
|
```
|