You can use Gitlab CI cloud or local service to automatically build and test your project in Linux/OSX/Windows environments.
It is free for OSS projects, and offers an easy integration with Gitlab, so builds can be automatically
fired in Gitlab CI after a
git push to Gitlab.
You can use Gitlab CI both for:
- Building and testing your project, which manages dependencies with Conan, and probably a conanfile.txt file
- Building and testing conan binary packages for a given conan package recipe (with a conanfile.py)
Building and testing your project¶
We are going to use the Google Test example now, with Gitlab CI support to run the tests.
Clone the project from github:
$ git clone https://github.com/lasote/conan-gtest-example
.gitlab-ci.yml file and paste this code in it:
image: lasote/conangcc63 build: before_script: # Upgrade Conan version - sudo pip install --upgrade conan # Automatic detection of your arch, compiler, etc. - conan user script: # Download dependencies, build, test and create package - conan test_package
Gitlab CI will install the conan tool and will execute the conan install command. Then, the script section creates the build folder, compiles the project with cmake and runs the tests.
Creating, testing and uploading conan package binaries¶
You can use Gitlab CI to automate the building of binary packages, which will be created in the cloud after pushing to Gitlab. You can probably setup your own way, but conan has some utilities to help in the process.
conan new has arguments to create a default working
Other setups might be possible, but for this example we are assuming that you are using github and also uploading your final packages to Bintray.
You could follow these steps:
- First, create an empty gitlab repository, lets call it “hello”, for creating a “hello world” package. Gitlab allows to create it with a Readme, license and .gitignore.
- Get the credentials User and API Key (remember, Bintray uses the API key as “password”, not your main Bintray account password)
- Create a conan repository in Bintray under your user or organization, and get its URL (“Set me up”). We will call it
- Under your project page, Settings -> Pipelines -> Add a variable, add the
CONAN_PASSWORDenvironment variable with the Bintray API Key. If your Bintray user is different from the package user, you can define your Bintray username too, defining the environment variable
- Clone the repo:
$ git clone <your_repo/hello> && cd hello
- Create the package:
$ conan new Hello/0.1@<user>/testing -t -s -ciglg -ciglc -cis -ciu=UPLOAD_URLwhere
useris your Bintray username
- You can inspect the created files: both
build.pyscript, that is used by
conan-package-toolsutility to split different builds with different configurations in different GitLab CI jobs.
- You can test locally, before pushing, with
$ conan test_packageor by GitLab Runner
- Add the changes, commit and push:
$ git add . && git commit -m "first commit" && git push
- Go to Pipelines page and see the pipeline, with the different jobs.
- When it finish, go to your Bintray repository, you should see there the uploaded packages for different configurations
- Check locally, searching in Bintray:
$ conan search Hello/0.1@<user>/testing -r=mybintray
If something fails, please report an issue in the
conan-package-tools github repository: https://github.com/conan-io/conan-package-tools