Interface StashManager.StashAwareArtifactManager
-
- Enclosing class:
- StashManager
public static interface StashManager.StashAwareArtifactManager
Mixin interface for anArtifactManager
which supports specialized stash behavior as well.When implementing off-Jenkins artifact storage, you should NOT extend this directly but instead use the
JCloudsArtifactManager
in the plugin currently namedartifact-manager-s3
. This is dangerous to directly extend if using remote storage unless you write a very robust handling of network failures including at least a base timeout and retries. TheJCloudsArtifactManager
implementation supports extensibility to various cloud providers and custom stores via theBlobStoreProvider
ExtensionPoint. It handles all aspects of making cloud artifact storage work smoothly in Jenkins including theVirtualFile
implementation, robust network error handling, overall configuration UI, and more. Implement this interface directly at your own risk.- See Also:
- JEP-202
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
clearAllStashes(TaskListener listener)
void
copyAllArtifactsAndStashes(Run<?,?> to, TaskListener listener)
Copy all stashes and artifacts from one build to another.void
stash(String name, FilePath workspace, Launcher launcher, EnvVars env, TaskListener listener, String includes, String excludes, boolean useDefaultExcludes, boolean allowEmpty)
void
unstash(String name, FilePath workspace, Launcher launcher, EnvVars env, TaskListener listener)
-
-
-
Method Detail
-
stash
void stash(@NonNull String name, @NonNull FilePath workspace, @NonNull Launcher launcher, @NonNull EnvVars env, @NonNull TaskListener listener, @CheckForNull String includes, @CheckForNull String excludes, boolean useDefaultExcludes, boolean allowEmpty) throws IOException, InterruptedException
-
unstash
void unstash(@NonNull String name, @NonNull FilePath workspace, @NonNull Launcher launcher, @NonNull EnvVars env, @NonNull TaskListener listener) throws IOException, InterruptedException
-
clearAllStashes
void clearAllStashes(@NonNull TaskListener listener) throws IOException, InterruptedException
- Throws:
IOException
InterruptedException
- See Also:
StashManager.clearAll(Run, TaskListener)
-
copyAllArtifactsAndStashes
void copyAllArtifactsAndStashes(@NonNull Run<?,?> to, @NonNull TaskListener listener) throws IOException, InterruptedException
Copy all stashes and artifacts from one build to another. TheArtifactManager
configuration will be as of the origin build. If the implementation cannot handleto
for whatever reason, it may throwAbortException
.- Throws:
IOException
InterruptedException
- See Also:
StashManager.CopyStashesAndArtifacts
-
-