We can choose any services for CI, but now we decided to use Jenkins, Travis CI and AppVeyor.
| CI | Target OS | Target Language | Description |
|---|---|---|---|
| Jenkins CI | Windows | Java 8 | Deprecated |
| Travis CI | Ubuntu | Oracle Java 8 | Test all new pull requests |
| AppVeyor CI | Windows | .NET VS 2013, 2015, 2017 | Test all pull requests |
1. Build services provided by ASF
This page (http://ci.apache.org) contains information on the various build services that are provided to all ASF projects for continuous integration, builds, testing, snapshots and deployment. Please read this page first.
Jenkins setup
- First, you have to get an access to Jenkins (http://builds.apache.org). To get an access to Jenkins, Ask your PMC chair
- If you get an access, open builds.apache.org and login with your account
- Jenkins > New Item : Enter item name and check Maven project.
- To trigger Github pull request builds, Follow the steps in this link: https://blogs.apache.org/infra/entry/github_pull_request_builds_now
- Set JDK version to 1.7
- Check "Restrict where this project can be run" and add "ubuntu" into the "Label Expression" filed. The builder will be executed on ubuntu machines. Therefore, to build in windows machine, we have to create another new item and add "windows1||windows2" into the "Label Expression".
- In Build, write "clean install" into "Goals and options"
- In Post Steps, check "Run regardless of build result"
- If you want to update relevant JIRA issues whenever Jenkins builds the related patch, then add "Update JIRA relevant issues" in Post-build Action. To trigger this post build action, we have to insert JIRA issue number into our commit message. Here is an example commit message: "[REEF-11] Jenkins integration test".
- If you have any problem using Jenkins, please file a ticket to INFRA (https://issues.apache.org/jira/browse/INFRA ) or send an email to builds@apache.org
- Here is an example setting:
Rebuild
- Open http://builds.apache.org and login with your account
- Access a build link what you want to rebuild. (ex. https://builds.apache.org/job/Reef-pull-request-ubuntu/187/ )
- Click rebuild button
Reconfiguration
- Open http://builds.apache.org and login with your account
- Click "Configuration" in https://builds.apache.org/job/Reef-pull-request-ubuntu/ or https://builds.apache.org/job/Reef-pull-request-windows
- Change setting and click the save button
2. Travis CI
Travis-CI.org provides free service for Open Source projects.
Travis CI was enabled for apache/reef GitHub repository by Apache INFRA team : https://issues.apache.org/jira/browse/INFRA-10567
For instructions on setting up your own instance of Travis CI see Java build instructions.
3. AppVeyor
AppVeyor provides free service for Open Source projects.
For instructions on setting up your own instance of AppVeyor see C# build instructions.