jetbrains.buildServer.agent.vcs
Interface UpdateByCheckoutRules2

All Superinterfaces:

AgentExtension, AgentVcsExtension, TeamCityExtension, UpdatePolicy

public interface UpdateByCheckoutRules2
extends UpdatePolicy

Implement this interface to support agent side vcs checkout if you want to process CheckoutRules yourself. Consider implementing UpdateByIncludeRules2 interface if you do not need to handle chekout rules processing explicitly.

Since:

6.0

Method Summary

void	updateSources(VcsRoot root, CheckoutRules rules, java.lang.String toVersion, java.io.File destFolder, AgentRunningBuild build, boolean cleanCheckoutRequested) Called to update sources in the specified working directory.

Method Detail

updateSources

void updateSources(@NotNull
                   VcsRoot root,
                   @NotNull
                   CheckoutRules rules,
                   @NotNull
                   java.lang.String toVersion,
                   @NotNull
                   java.io.File destFolder,
                   @NotNull
                   AgentRunningBuild build,
                   boolean cleanCheckoutRequested)
                   throws VcsException

Called to update sources in the specified working directory. Sources must be updated to the specified version. BuildProgressLogger can be used to add messages in the build log.

Parameters:

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 agent)

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

root - VCS root

toVersion - version to update sources to

rules - checkout rules to consider during sources updating the moment of updateSources call)

Throws:

VcsException - if any error occurs preventing sources update