com.google.jenkins.plugins.storage

Class AbstractBucketLifecycleManager

java.lang.Object

com.google.jenkins.plugins.storage.AbstractUpload

com.google.jenkins.plugins.storage.AbstractBucketLifecycleManager

All Implemented Interfaces:

hudson.ExtensionPoint, hudson.model.Describable<AbstractUpload>, Serializable

Direct Known Subclasses:

ExpiringBucketLifecycleManager

public abstract class AbstractBucketLifecycleManager
extends AbstractUpload

This extension point may be implemented to surface the object lifecycle options available on cloud storage buckets. Generally the expectation is that the UI will ask for the bucket, and surface some additional UI for capturing the lifecycle features of the plugin. This is done by implementing these two overrides:

• checkBucket: Validated the annotations on a pre-existing bucket, returning it if they are satisfactory, and throwing a InvalidAnnotationException if we must update it.
• decorateBucket: Annotates either a new or existing bucket with the lifecycle features of the plugin.

NOTE: This extends AbstractUpload, but isn't really an upload. You could reason about it as an empty upload to a bucket with special bucket annotation properties. TODO(mattmoor): We should factor out a common AbstractStorageOperation base class that this and AbstractUpload can share. The current entrypoint is benign enough (see "perform").

See Also:

ExpiringBucketLifecycleManager, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.google.jenkins.plugins.storage.AbstractUpload

AbstractUpload.UploadSpec

Nested classes/interfaces inherited from interface hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

Field Summary

Fields inherited from class com.google.jenkins.plugins.storage.AbstractUpload

module

Constructor Summary

Constructors

Constructor and Description
AbstractBucketLifecycleManager(String bucketNameWithVars, UploadModule module) Constructs the base bucket OLM plugin from the bucket name and module.

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract com.google.api.services.storage.model.Bucket	checkBucket(com.google.api.services.storage.model.Bucket bucket) This is intended to be an identity function that throws when the input is not adequately annotated.
protected abstract com.google.api.services.storage.model.Bucket	decorateBucket(com.google.api.services.storage.model.Bucket bucket) A hook by which extensions may annotate a new or existing bucket.
AbstractBucketLifecycleManagerDescriptor	getDescriptor() Boilerplate, see: https://wiki.jenkins-ci.org/display/JENKINS/Defining+a+new+extension+point
protected AbstractUpload.UploadSpec	getInclusions(hudson.model.AbstractBuild<?,?> build, hudson.FilePath workspace, hudson.model.TaskListener listener) Implementations override this interface in order to surface the set of FilePaths the core logic should upload.
protected com.google.api.services.storage.model.Bucket	getOrCreateBucket(com.google.api.services.storage.Storage service, com.google.jenkins.plugins.credentials.oauth.GoogleRobotCredentials credentials, com.google.jenkins.plugins.util.Executor executor, String bucketName) This overrides the core implementation to provide additional hooks for decorating storage objects with lifecycle annotations.

Methods inherited from class com.google.jenkins.plugins.storage.AbstractUpload

all, annotateObject, forResult, getBucketNameWithVars, getDetails, getMetadata, getRelative, isForFailedJobs, isSharedPublicly, perform

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AbstractBucketLifecycleManager

public AbstractBucketLifecycleManager(String bucketNameWithVars,
                              @Nullable
                              UploadModule module)

Constructs the base bucket OLM plugin from the bucket name and module. NOTE: this hides the "make public" and "for failed" options of the base, which are mainly relevant for true uploads.

Method Detail

getInclusions

@Nullable
protected final AbstractUpload.UploadSpec getInclusions(hudson.model.AbstractBuild<?,?> build,
                                               hudson.FilePath workspace,
                                               hudson.model.TaskListener listener)
                                                 throws UploadException

Implementations override this interface in order to surface the set of FilePaths the core logic should upload.

Specified by:

getInclusions in class AbstractUpload

Throws:

UploadException

See Also:

for further details.

getOrCreateBucket

protected com.google.api.services.storage.model.Bucket getOrCreateBucket(com.google.api.services.storage.Storage service,
                                                             com.google.jenkins.plugins.credentials.oauth.GoogleRobotCredentials credentials,
                                                             com.google.jenkins.plugins.util.Executor executor,
                                                             String bucketName)
                                                                  throws UploadException

This overrides the core implementation to provide additional hooks for decorating storage objects with lifecycle annotations.

Overrides:

getOrCreateBucket in class AbstractUpload

Parameters:

credentials - The credentials with which to fetch/create the bucket

bucketName - The top-level bucket name to ensure exists

Returns:

an instance of the named bucket, created or retrieved.

Throws:

UploadException - if any issues are encountered

checkBucket

protected abstract com.google.api.services.storage.model.Bucket checkBucket(com.google.api.services.storage.model.Bucket bucket)
                                                                     throws InvalidAnnotationException

This is intended to be an identity function that throws when the input is not adequately annotated.

Parameters:

bucket - the pre-existing bucket whose annotations to validate

Throws:

InvalidAnnotationException - if not annotated properly

decorateBucket

protected abstract com.google.api.services.storage.model.Bucket decorateBucket(com.google.api.services.storage.model.Bucket bucket)

A hook by which extensions may annotate a new or existing bucket.

Parameters:

bucket - the bucket to annotate and return

getDescriptor

public AbstractBucketLifecycleManagerDescriptor getDescriptor()

Boilerplate, see: https://wiki.jenkins-ci.org/display/JENKINS/Defining+a+new+extension+point

Specified by:

getDescriptor in interface hudson.model.Describable<AbstractUpload>

Overrides:

getDescriptor in class AbstractUpload