jetbrains.buildServer.agent.vcs
Interface AgentVcsSupportCore

All Superinterfaces:

AgentExtension, AgentVcsExtension, TeamCityExtension

All Known Implementing Classes:

AgentVcsSupport

public interface AgentVcsSupportCore
extends AgentVcsExtension

Implement this interface for your version control name to provide agent environment check for your vcs plugin.

Since:

4.5

Method Summary

boolean	canRun(BuildAgentConfiguration agentConfiguration, TextLogger messageLog) This method may be called at any time.
java.lang.String	getName() Name of the VCS plugin.

Method Detail

getName

@NotNull
java.lang.String getName()

Name of the VCS plugin. Should be the same as VcsSupportConfig.getName()

Returns:

see above

canRun

boolean canRun(@NotNull
               BuildAgentConfiguration agentConfiguration,
               @NotNull
               TextLogger messageLog)

This method may be called at any time. It's garanteed vcs plugin will be disabled if it has returned false from this method. But subsequent calls to canRun are still possible.

Parameters:

agentConfiguration - - current agent configuration

messageLog - - logger to log user-related information on plugin availability

Returns:

true if the vcs support can run in this particular environment or not. For example, returning 'false' is a way for a runner to refuse to run on a system that is not supported by the runner If 'false' is returned, the Agent won't register the vcs support and it won't be advertised to the build server server during agent's registration