The Jenkins continuous integration environment at http://djangoci.com is setup to build pull requests [https://wiki.jenkins-ci.org/display/JENKINS/GitHub+pull+request+builder+plugin using this plugin]. == Commands == Admins can comment "buildbot, test this please." on a a pull request to trigger a build (and whitelisted users can do so on their own PRs). Jenkins polls GitHub every 5 minutes to pickup new changes so there may be a short delay after a comment before the build is triggered. For trusted users, builds are automatically triggered for new pull requests and when a pull request is updated. The [http://djangoci.com/job/pull-requests-trusty/ main pull request builder] runs on Ubuntu 14.04 with PostgreSQL 9.5.3 and MySQL 5.6. GIS: spatialite 4.1.1, GDAL 1.10.1, GEOS 3.4.2, PostGIS 2.1 Other pull request builders which can be triggered manually with the corresponding comment phrases: * [http://djangoci.com/job/pull-requests-precise/ Ubuntu 12.04 builder] runs on PostgreSQL 9.1 and MySQL 5.5. GIS: spatialite 3.0.0~beta, GDAL 1.7.3, GEOS 3.2.2, PostGIS 1.5.3 * buildbot, test on precise. * [http://djangoci.com/job/pull-requests-precise/ Ubuntu 16.04 builder] runs on PostgreSQL 9.5 and MySQL 5.7. GIS: spatialite 4.3.0a-5, GDAL 1.11.3, GEOS 3.5.0, PostGIS 2.2 * buildbot, test on xenial. * [http://djangoci.com/job/pull-requests-oracle/ Oracle builder] runs on Oracle 12.1.0.2.0. The Oracle tests take about 40 minutes, so we avoid them unless we suspect a change may have broken something on Oracle. * buildbot, test on oracle. * [http://djangoci.com/job/pull-requests-selenium/ Selenium builder] also runs the selenium tests. * buildbot, test on selenium. Admins can comment, "buildbot, add to whitelist." to add a user to the trusted list. Whitelisted users will have their pull requests built automatically. In general if you submit a couple of solid PRs, we'll be happy to add you to this list. The admins list is primarily core developers and is accessible at http://djangoci.com/job/django-pull-requests/configure for those with a Jenkins account. The White list is available on the same page after clicking "Advanced". If you are doing a lot of triage work and think it'd be helpful to trigger builds, ask the [https://docs.djangoproject.com/en/dev/internals/roles/#ops-team ops team] for access. == Other checks == Three builders run on all pull requests: * [http://djangoci.com/job/flake8/ flake8] - runs the equivalent of `flake8` from the root checkout directory and fails if there are any warnings * [http://djangoci.com/job/docs/ docs] - runs the equivalent of `make spelling` from the docs directory and fails if there are any spelling or sphinx errors. * [http://djangoci.com/job/isort/ isort] - runs `isort --recursive --check-only .` from the root checkout directory and fails if any imports aren't [https://docs.djangoproject.com/en/dev/internals/contributing/writing-code/coding-style/#imports sorted properly]. == Troubleshooting == If: 1. you force push to a branch after the initial build starts or 2. a commit is pushed to master after the initial build starts You will see an error like `git checkout where hash was not the commit`. Currently the only solution is to retrigger the build. There is a [https://github.com/janinko/ghprb/issues/116 ticket] for the issue in GitHub Pull Request Builder.