org.springframework.cloud.skipper.server.repository.jpa

Interface ReleaseRepositoryCustom

All Known Subinterfaces:

ReleaseRepository

All Known Implementing Classes:

ReleaseRepositoryImpl

public interface ReleaseRepositoryCustom

Author:

Mark Pollack, Ilayaperumal Gopinathan

Method Summary

Modifier and Type	Method and Description
org.springframework.cloud.skipper.domain.Release	findByNameAndVersion(String releaseName, int version) Find the release for the given release name and version
List<org.springframework.cloud.skipper.domain.Release>	findLatestDeployedOrFailed() Find the latest status (deployed or failed) of all the releases.
List<org.springframework.cloud.skipper.domain.Release>	findLatestDeployedOrFailed(String releaseName) Find the latest status (deployed or failed) of the release, by the name.
org.springframework.cloud.skipper.domain.Release	findLatestDeployedRelease(String releaseName) Find the latest in time, release object, by name and with the deployed status.
org.springframework.cloud.skipper.domain.Release	findLatestRelease(String releaseName) Find the latest in time, release object, by name.
org.springframework.cloud.skipper.domain.Release	findLatestReleaseForUpdate(String releaseName) Find the latest in time, release object, by name whose status is neither unknown nor failed.
org.springframework.cloud.skipper.domain.Release	findLatestReleaseIfDeleted(String releaseName) Return the release by the given name if the most recent status of the release is StatusCode.DELETED.
List<org.springframework.cloud.skipper.domain.Release>	findReleaseRevisions(String releaseName, Integer revisions) Find the revisions of the release, by name.
org.springframework.cloud.skipper.domain.Release	findReleaseToRollback(String releaseName) Find the release to rollback from the existing version.

Method Detail

findLatestRelease

org.springframework.cloud.skipper.domain.Release findLatestRelease(String releaseName)

Find the latest in time, release object, by name.

Parameters:

releaseName - the name of the release

Returns:

the Release object

Throws:

{@link - ReleaseNotFoundException} if no Release for the given name can be found.

findLatestDeployedRelease

org.springframework.cloud.skipper.domain.Release findLatestDeployedRelease(String releaseName)

Find the latest in time, release object, by name and with the deployed status.

Parameters:

releaseName - the name of the release

Returns:

the Release object

Throws:

{@link - ReleaseNotFoundException} if no deployed Release for the given name can be found.

findLatestReleaseForUpdate

org.springframework.cloud.skipper.domain.Release findLatestReleaseForUpdate(String releaseName)

Find the latest in time, release object, by name whose status is neither unknown nor failed. This release can be used for upgrade/rollback operations.

Parameters:

releaseName - the name of the release

Returns:

the Release object

Throws:

{@link - ReleaseNotFoundException} if no latest Release (with the deployed/deleted status) for the given name can be found.

findReleaseToRollback

org.springframework.cloud.skipper.domain.Release findReleaseToRollback(String releaseName)

Find the release to rollback from the existing version.

Parameters:

releaseName - the name of the release to rollback

Returns:

the Release object to rollback to

Throws:

{@link - ReleaseNotFoundException} if no latest Release found to rollback to.

findByNameAndVersion

org.springframework.cloud.skipper.domain.Release findByNameAndVersion(String releaseName,
                                                                      int version)

Find the release for the given release name and version

Parameters:

releaseName - the name of the release

version - the version of the release

Returns:

ReleaseNotFoundException if no Release for the given name and version can be found.

findReleaseRevisions

List<org.springframework.cloud.skipper.domain.Release> findReleaseRevisions(String releaseName,
                                                                            Integer revisions)

Find the revisions of the release, by name.

Parameters:

releaseName - the name of the release

revisions - the maximum number of revisions of the release to look for

Returns:

the list of Releases with their revisions as history

Throws:

org.springframework.cloud.skipper.SkipperException - if no Release for the given name can be found.

findLatestDeployedOrFailed

List<org.springframework.cloud.skipper.domain.Release> findLatestDeployedOrFailed(String releaseName)

Find the latest status (deployed or failed) of the release, by the name.

Parameters:

releaseName - the name is the wildcard expression

Returns:

list of releases (by the given name) that has the latest revision with the state either deployed or failed.

findLatestDeployedOrFailed

List<org.springframework.cloud.skipper.domain.Release> findLatestDeployedOrFailed()

Find the latest status (deployed or failed) of all the releases.

Returns:

list of releases that has the latest revision with the state either deployed or failed.

findLatestReleaseIfDeleted

org.springframework.cloud.skipper.domain.Release findLatestReleaseIfDeleted(String releaseName)

Return the release by the given name if the most recent status of the release is StatusCode.DELETED.

Parameters:

releaseName - the name of the release

Returns:

if the latest status of the release is deleted then the release is returned, otherwise null.