org.springframework.cloud.deployer.spi.app

Interface AppDeployer

public interface AppDeployer

SPI defining a runtime environment capable of deploying and managing the lifecycle of apps that are intended to run indefinitely (until undeployed), as opposed to tasks.

Author:

Mark Fisher, Patrick Peralta, Marius Bogoevici, Janne Valkealahti

Field Summary

Fields

Modifier and Type	Field and Description
static String	COUNT_PROPERTY_KEY The deployment property for the count (number of app instances).
static String	GROUP_PROPERTY_KEY The deployment property for the group to which an app belongs.

Method Summary

Methods

Modifier and Type	Method and Description
String	deploy(AppDeploymentRequest request) Deploy an app using an AppDeploymentRequest.
AppStatus	status(String id) Return the AppStatus for an app represented by a deployment id.
void	undeploy(String id) Un-deploy an app using its deployment id.

Field Detail

COUNT_PROPERTY_KEY

static final String COUNT_PROPERTY_KEY

The deployment property for the count (number of app instances).

See Also:

Constant Field Values

GROUP_PROPERTY_KEY

static final String GROUP_PROPERTY_KEY

The deployment property for the group to which an app belongs.

See Also:

Constant Field Values

Method Detail

deploy

String deploy(AppDeploymentRequest request)

Deploy an app using an AppDeploymentRequest. The returned id is later used with undeploy(String) or status(String) to undeploy an app or check its status, respectively. Implementations may perform this operation asynchronously; therefore a successful deployment may not be assumed upon return. To determine the status of a deployment, invoke status(String).

Parameters:

request - the app deployment request

Returns:

the deployment id for the app

Throws:

IllegalStateException - if the app has already been deployed

undeploy

void undeploy(String id)

Un-deploy an app using its deployment id. Implementations may perform this operation asynchronously; therefore a successful un-deployment may not be assumed upon return. To determine the status of a deployment, invoke status(String).

Parameters:

id - the app deployment id, as returned by deploy(org.springframework.cloud.deployer.spi.core.AppDeploymentRequest)

Throws:

IllegalStateException - if the app has not been deployed

status

AppStatus status(String id)

Return the AppStatus for an app represented by a deployment id.

Parameters:

id - the app deployment id, as returned by deploy(org.springframework.cloud.deployer.spi.core.AppDeploymentRequest)

Returns:

the app deployment status