Fork of Jobcacher S3 Extension plugin

Background

Original plugin doesn't have ap-southeast-7 support because the upstream library have hardcoded region, and this plugin iterate through that library to populate region selection.

Fix

This fork just add ap-southeast-7 to the Region list of S3ItemStorage.java

Prerequisites

• JDK 17
• Maven

Package

To package this plugin use the following command:

mvn clean package -DskipTests

This will output s3-jobcacher-storage.hpi in the folder target

Install in Jenkins

To install in Jenkins go to Manage Jenkins -> Plugins -> Advanced Settings-> Select s3-jobcacher-storage.hpi file and click deploy

---

ORIGINAL README

Jobcacher S3 Extension plugin

This plugin is an extension of the jobcacher-plugin that allows you to store the caches in S3 compliant storage

This was extracted from jobcacher since this PR

Warning

Users upgrading from version 640.v424a_7cc1087a_ of jobcacher and above AND using S3 storage MUST install this plugin.

Configuration is kept in the same place, but the plugin will not work with S3 storage without this extension.

Introduction

Getting started

You only need to configure the extension to use S3 under System Configuration.

Configuration as Code

S3

unclassified:
  globalItemStorage:
    storage:
      s3:
        bucketName: "caches"
        prefix: "the-prefix/"
        credentialsId: "s3"
        region: "eu-central-2"

S3 with endpoint

unclassified:
  globalItemStorage:
    storage:
      nonAWSS3:
        bucketName: "caches"
        prefix: "the-prefix/"
        credentialsId: "s3"
        endpoint: "http://localhost:9000"
        parallelDownloads: false
        pathStyleAccess: true
        region: "eu-central-2"

CONTRIBUTING

See CONTRIBUTING

LICENSE

Licensed under MIT, see LICENSE