ci-scripts/README.md

Continuous Integration Scripts for EPICS Modules

The scripts in this repository are intended to provide a common, easy-to-use and flexible way to add Continuous Integration to EPICS software modules, e.g. Device Support modules.

By including this repository as a Git Submodule, your module will always use an explicit commit, i.e. a fixed version of the scripts. That way, further development of these scripts cannot break your setup.

Travis-CI

Features

• Compile against different version of EPICS Base
• Use different versions of compilers (gcc, clang)
• Cross-compile for Windows 32bit using MinGW and WINE
• Cross-compile for RTEMS 4.9 and 4.10
• Compile on MacOS

How to Use these Scripts

1. Get an account on Travis-CI, connect it to your GitHub account and activate your support module's repository. For more details, please refer to the Travis-CI Tutorial. Make sure to use travis-ci.org and not their .com site.

2. In your Support Module, add this respository as a Git Submodule (name suggestion: .ci).

   $ git submodule add https://github.com/epics-base/ci-scripts .ci
   

3. Create a Travis configuration by copying one of the examples.

   $ cp .ci/.travis.yml.example-full .travis.yml
   

4. Edit the .travis.yml configuration to include the jobs you want Travis to run.

5. Push your changes and check travis-ci.org for your build results.