Package jetbrains.buildServer.agent.impl.upgrade

Interface AgentVersionController

All Known Implementing Classes:

AgentVersionControllerImpl

public interface AgentVersionController

Created by Eugene Petrenko (eugene.petrenko@gmail.com) Date: 31.08.11 17:47

Method Summary

Modifier and Type	Method	Description
void	dropAgentVersion()	Totally removes agent upgrade info to make agent be upgraded in the next start
AgentUpdateInfo	loadAgentUpdateInfo()	Tries to load current agent version info.
void	updateAgentCoreForLauncherUpdate(AgentUpdateInfoDifference diff)	Updates agent core part version
void	updateAgentPluginVersion(AgentUpdateInfoDifference diff, AgentUpdateInfo newInfo)	Updates agent version info replacing plugins information
void	updateAgentVersion(AgentUpdateInfo newInfo)	Updates agent version file by replacing all data in the original file with a given data
void	writeVersoinForLauncerUpdate(AgentUpdateInfo newInfo)	Prepares version info for agent update with launcher update procedure.

Method Detail

updateAgentVersion

void updateAgentVersion(@NotNull
                        AgentUpdateInfo newInfo)
                 throws UpgradeFailedException

Updates agent version file by replacing all data in the original file with a given data

Parameters:

newInfo - new information to replace

Throws:

UpgradeFailedException - on error

Since:

7.0

dropAgentVersion

void dropAgentVersion()

Totally removes agent upgrade info to make agent be upgraded in the next start

Since:

7.0

updateAgentPluginVersion

void updateAgentPluginVersion(@NotNull
                              AgentUpdateInfoDifference diff,
                              AgentUpdateInfo newInfo)
                       throws UpgradeFailedException

Updates agent version info replacing plugins information

Parameters:

removed - plugins that were removed

changed - plugins that were changed

added - plugins that are new

newInfo -

Throws:

UpgradeFailedException - in error

Since:

7.0

updateAgentCoreForLauncherUpdate

void updateAgentCoreForLauncherUpdate(@NotNull
                                      AgentUpdateInfoDifference diff)
                               throws UpgradeFailedException

Updates agent core part version

Parameters:

agentVersion - agent version string

newParts - updated agent contenst, mainly buildAgent.zip

Throws:

UpgradeFailedException - on error

Since:

7.0

writeVersoinForLauncerUpdate

void writeVersoinForLauncerUpdate(@NotNull
                                  AgentUpdateInfo newInfo)
                           throws UpgradeFailedException

Prepares version info for agent update with launcher update procedure.

Parameters:

newInfo - new version for upgrade

Throws:

UpgradeFailedException - on error

Since:

7.0

loadAgentUpdateInfo

@Nullable
AgentUpdateInfo loadAgentUpdateInfo()

Tries to load current agent version info.

Returns:

version information or null

Since:

7.0