AppVeyor - Continuous Integration service for Windows

AppVeyor is a continuous integration service for Windows. From their website:

​AppVeyor aims to give powerful Continuous Integration and Deployment tools to every .NET developer without the hassle of setting up and maintaining their own build server.

They offer their service free of charge for Open Source projects, like Trac.

We use it for automating our builds on Windows. See TracDev/AutomaticBuilds for the other automated build services we use.

It works together with the git repositories hosted on GitHub, like our mirror and their forks:

• Builds for the ​Trac mirror (not yet active).
• Builds for developer branches: ​cboos, … .

Settings

Common settings

The configuration and the build steps are taken directly from the repository:

• a configuration file .appveyor.yml,
• its companion PowerShell script contrib/appveyor.ps1, which contains some common utilities and settings, and one function for each build step

Per-project settings

A project can be configured to build all new branches, ​or just some. Also, in the settings, don't forget to specify that the appveyor.yml file is named .appveyor.yml.

Another useful tip is that a build ​can be skipped if the last changeset pushed contains [skip ci] in its commit log message.

Known issues

Test failures

There are still a number of test issues only seen on AppVeyor that need to be resolved before getting a "green" build, mostly SQLite related.

See all ​related tickets.

If you are on Windows, you can reproduce the build locally the same way AppVeyor would do it, from a PowerShell console.

Note that you may need to perform a few preparation steps first in that shell:

• enable sourcing local scripts by setting the execution policy to "unrestricted",
• make a backup of your Makefile.cfg if you have it customized (as it will be created by the scripts)
• make sure you have GNU make.exe in the Path (grab ​ezmake for example)
• set the environment variables that are normally set up by the "build matrix" in the configuration file, i.e.
  • PYTHONHOME, to point to the Python version you want to use
  • TEST_TRAC_DB_URI, as usual (see TracDev/UnitTests)
  • SVN_BRANCH, to indicate the "base" branch (e.g. if you forked a topic branch from 1.0-stable, set it to 1.0-stable)

For example:

> cd 1.0-stable
> cp Makefile.cfg Makefile.cfg.custom # if needed...
> Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope Process
> . .\contrib\appveyor.ps1
> $env:PATH = "$($env:PATH);C:/Dev/ez-make-4.1/bin" # example
> $env:PYTHONHOME = 'C:\Python27'          # example
> $env:TEST_TRAC_DB_URI = 'sqlite:test.py' # example
> $env:SVN_BRANCH = '1.0-stable' 
> $DebugPreference = "Continue"            # to see the Appveyor API calls
> Trac-Install
> Trac-Build
> Trac-Tests

Project not building

It can happen that the build won't trigger, and no matter what you do about it, the jobs stay in the "queued" state forever instead of just a few minutes.

If this happens, ask the support to do a global reset on the project. They're very friendly and responsive.