Skip to content
Distributed continuous integration testing for JavaScript.
PHP JavaScript CSS
Branch: master
Clone or download

Latest commit

Latest commit d2dc36a Jan 22, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cache Check filemtime only if the file is readable, prevent errors on first… Apr 9, 2012
config Don't index /client/ pages Jul 16, 2015
css BrowserInfo: Add the new Edge logo, keep the old one for legacy Edge Dec 20, 2019
external build: Update jQuery to 1.12 Jul 10, 2017
img BrowserInfo: Update the Opera icon Jan 22, 2020
inc BrowserInfo: Fix typos in a comment Jan 22, 2020
js build: Update development dependencies; add test for PHP 7.1 Dec 29, 2018
scripts build: Update development dependencies; add test for PHP 7.1 Dec 29, 2018
test build: Update development dependencies; add test for PHP 7.1 Dec 29, 2018
vendor build: Update ua-parser to recognize Chromium-based Edge & Android 9 Dec 19, 2019
.gitignore build: Commit the subset of production dependencies Dec 18, 2019
.jshintignore build: Update Travis CI configuration Jun 24, 2015
.jshintrc build: Update development dependencies; add test for PHP 7.1 Dec 29, 2018
.mailmap build: Add a .mailmap file Dec 19, 2019
.travis.yml build: Commit the subset of production dependencies Dec 18, 2019
AUTHORS.txt Add "Reset failed jobs" button. Fixes #222. Closes #235. Nov 2, 2012
CONTRIBUTING.md build: Update development dependencies; add test for PHP 7.1 Dec 29, 2018
History.md Tag v1.1.0 Jun 4, 2018
LICENSE.txt Build: Remove dates from copyright notice Dec 30, 2014
README.md build: Commit the subset of production dependencies Dec 18, 2019
api.php api: Ensure api-error page can render Jun 23, 2017
composer.json build: Update ua-parser to recognize Chromium-based Edge & Android 9 Dec 19, 2019
composer.lock build: Update ua-parser to recognize Chromium-based Edge & Android 9 Dec 19, 2019
index.php Page: Implement partial response support for JobPage Jul 10, 2017
package.json build: Update development dependencies; add test for PHP 7.1 Dec 29, 2018

README.md

Build Status

TestSwarm - Distributed Continuous Integration for JavaScript

TestSwarm provides distributed continuous integration testing for JavaScript.

The main instance monitoring jQuery core and related projects runs at swarm.jquery.org.

Project Status

TestSwarm is still in use in projects of the jQuery Foundation, but it isn't under active development anymore. Although critical issues may be patched in the future, most open issues will remain unaddressed.

Within the jQuery Foundation, we're experimenting with alternative projects, to eventually shut down our own instance of TestSwarm:

We recommend reviewing those and other alternatives.

Quick start

Clone the repo, git clone --recursive git://github.com/jquery/testswarm.git.

Versioning

TestSwarm uses the Semantic Versioning guidelines as much as possible.

Releases will be numbered in the following format:

<major>.<minor>.<patch>

The -alpha suffix is used to indicate unreleased versions in development.

For more information on SemVer, please visit https://semver.org/.

Bug tracker

Found a bug? Please report it using our issue tracker!

Installation

Environmental compatibility

To run TestSwarm you will need a web server, a database server and PHP. At the moment TestSwarm supports the following, but other configurations may work as well.

  • Apache 2.0+, NGINX 1.2+
  • PHP 5.4+ (or PHP-FPM for NGINX)
  • MySQL 4.0+
  • cURL (for the cleanup action; see step 8)

Steps

  1. Create an empty MySQL database and create a user with read and write access to it.

  2. Copy config/sample-localSettings.php to config/localSettings.php
    Copy config/sample-localSettings.json to config/localSettings.json.
    Edit localSettings.json and replace the sample settings with your own.
    Refer to the Settings page for more information.

  3. For Apache:
    Copy config/sample-.htaccess to .htaccess.
    To run TestSwarm from a non-root directory, set web.contextpath in localSettings.json to the correct path from the web root and update RewriteBase in .htaccess. Verify that .htaccess is working properly by opening a page other than the HomePage (e.g. /testswarm/projects) in your browser.
    Required Apache configuration:

    • AllowOverride is set to All (or ensure FileInfo is included).
    • mod_rewrite installed and loaded.

    For NGINX:
    Copy config/sample-nginx.conf to /etc/nginx/sites-available.
    The file name should match your domain e.g. for swarm.example.org:
    cp config/sample-nginx.conf /etc/nginx/sites-available/swarm.example.org.conf
    Open this conf file in your editor and replace the "example" values with the correct values.
    Make sure your install is located at /var/www/testswarm (otherwise update the file to match the correct location).
    Now you need to link the sites-available config to the sites-enabled config:
    (replace the "swarm.example.org" with your own file name):
    ln -s /etc/nginx/sites-available/swarm.example.org.conf /etc/nginx/sites-enabled/swarm.example.org.conf
    Now make sure that php-fpm is running: /etc/init.d/php-fpm status
    if is not running start it: /etc/init.d/php-fpm start

  4. Copy config/sample-robots.txt to robots.txt
    Or, if TestSwarm is not in the root directory, add similar rules to your root robots.txt.

  5. Set storage.cacheDir to a writable directory that is not readable from the web. Either set it to a custom path outside the document root, or use the default cache directory (protected with .htaccess).
    Chmod it: chmod 777 cache.

  6. Install dependencies composer install --no-dev

  7. Install the TestSwarm database by running: php scripts/install.php

  8. Create an entry in your crontab for action=cleanup. This performs various cleaning duties such as making timed-out runs available again.
    * * * * * curl -s http://swarm.example.org/api.php?action=cleanup > /dev/null

  9. Create a project and submit jobs.

Get involved

You're welcome to use the GitHub issue tracker to start discussions.

Some of us are also on Gitter at jquery/dev.

Documentation

Copyright and license

See LICENSE.txt.

History

TestSwarm was originally created by John Resig as a basic tool to support unit testing of the jQuery JavaScript library. It later become a Mozilla Labs project, and has since moved again to become a jQuery Foundation project.

You can’t perform that action at this time.