General Info

Vendor

JetBrains

License

Apache 2.0

Type

free, open source

Description

This plugin allows to limit

the number of
concurrently running builds from different build configurations based on defined "resources" and "locks".
Current version supports multiple read and write locks per build configuration.

Plugin Development Status

In active development. Everybody is encouraged to try the plugin and provide feedback in the forum or post bugs into the issue tracker.

Installation

New installation

Install the plugin as usual under TeamCity 7.1.x. Plugin in bundled since TeamCity version 8.

7.1.x to 8.0 update

If you have used the plugin with TeamCity v 7.1.x, you need to remove installed plugin manually:

  1. Navigate to TeamCityDataDirectory/plugins
  2. Delete file TeamCity.SharedResources.zip
  3. Navigate to TeamCityDataDirectory/.unpacked
  4. Delete folder TeamCity.SharedResources and all of its contents

Usage

Managing resources

Resource is a named entity that is defined per project. Build configurations can lock resources during execution of build steps. To create a resource, head to project configuration page. There choose 'SharedResources' tab. You can create resources of two types: simple named resources with quotas and resources with custom values.

Project groups support. (TC 8.0+)

Resources support project groups and subprojects. If you define a resource in a project that has subprojects, it will be available to all tree of subprojects

Information on resource usage is gathered across all subprojects

Managing locks

Locking resources with quotas

There are two types of locks supported: read locks and write locks. Read locks are shared (multiple builds with read locks are allowed), write locks are exclusive (only a single running build with a write lock is allowed).

Locking resources with custom values

Resources with custom values support three types of locks:

Information in build queue

TODO: add description of build parameters defined

TeamCity Versions Compatibility

TeamCity 7.1+

Download

Stable builds of the plugin are bundled since TeamCity 8.0. Nightly builds and builds for TeamCity 7.1.x can be acquired from our public server

Development Links

Sources on GitHub

Related Materials

Original issue