jetbrains.buildServer.agent.vcs
Interface UpdateByIncludeRules2

All Superinterfaces:

AgentExtension, AgentVcsExtension, TeamCityExtension, UpdatePolicy

public interface UpdateByIncludeRules2
extends UpdatePolicy

This is a simpliest way to implement agent side checkout. Consider implementing UpdateByCheckoutRules2 instead, if you need to explicitly handle checkout rules.

Since:

6.0

Method Summary

IncludeRuleUpdater

getUpdater(VcsRoot root, CheckoutRules checkoutRules, java.lang.String toVersion, java.io.File checkoutDirectory, AgentRunningBuild build, boolean cleanCheckoutRequested) Factory method that is used to create checkout-by-include rule implementation that will be called for each include rule from CheckoutRules.

Method Detail

getUpdater

IncludeRuleUpdater getUpdater(@NotNull
                              VcsRoot root,
                              @NotNull
                              CheckoutRules checkoutRules,
                              @NotNull
                              java.lang.String toVersion,
                              @NotNull
                              java.io.File checkoutDirectory,
                              @NotNull
                              AgentRunningBuild build,
                              boolean cleanCheckoutRequested)
                              throws VcsException

Factory method that is used to create checkout-by-include rule implementation that will be called for each include rule from CheckoutRules. IncludeRuleUpdater.dispose() is called at the end of include rules processing. BuildProgressLogger can be used to add messages in the build log.

Parameters:

root - VCS root

checkoutRules - checkout rules of entyre checkout operation

toVersion - version to update sources to

checkoutDirectory - working directory where sources will be updated (root directory for the sources)

build - agent running build. You can get logger by requesting build.getBuildLogger()

cleanCheckoutRequested - true if clean checkout should be performed (note - checkout directories are already re-created by

Returns:

an instance of IncludeRuleUpdater that will be called for each include rule to perform checkout operation. if any error occurs preventing sources update

Throws:

VcsException - on VCS error