Aliyun OSS Uploader

English | 简体中文

Requirements

Starting with 2.1.0, the plugin requires Jenkins 2.479.3 or newer and Java 17 or 21. Newer Jenkins releases may require a newer Java runtime. Upgrade Jenkins and the Java runtimes on the controller and all agents as needed before upgrading from an older plugin version.

The published 2.0.0 release still requires Jenkins 2.555.3 or newer and Java 21 or 25.

Existing job configuration, aliyunOSSUpload Pipeline parameters, the missing-file option, and object ACL settings remain compatible.

Building from source requires Maven 3.9.6 or newer and JDK 17/21. The Maven Wrapper uses Maven 3.9.9. Pipeline dependencies are managed by a BOM matching the Jenkins baseline.

Usage

  1. Clone the repository and build the plugin:
git clone https://github.com/jenkinsci/aliyun-oss-uploader-plugin.git
cd aliyun-oss-uploader-plugin
./mvnw verify
  1. Upload the HPI file from target through the Jenkins plugin manager, install its dependencies, and restart Jenkins.
  2. Add the Aliyun OSS Upload post-build action to a job.

Adding the post-build action

  1. Enter the OSS endpoint, credentials, bucket, and upload paths.

Configuring OSS uploads

Local paths are relative to the workspace despite the leading /: /abc refers to ${WORKSPACE}/abc. A file path uploads one file; a directory path uploads the directory recursively.

Building

Normally, ./mvnw verify runs the tests and builds the plugin. On Windows, use mvnw.cmd verify. The POM already declares the Jenkins public repository. Only adjust Maven settings when your network requires a custom repository configuration.

For such a configuration, add the following fragments to ~/.m2/settings.xml as needed.

In mirrors:

<mirror>
  <id>repo.jenkins-ci.org</id>
  <url>https://repo.jenkins-ci.org/public/</url>
  <mirrorOf>m.g.o-public</mirrorOf>
</mirror>

In pluginGroups:

<pluginGroup>org.jenkins-ci.tools</pluginGroup>

In profiles:

<profile>
  <id>jenkins</id>
  <activation>
    <activeByDefault>true</activeByDefault>
  </activation>
  <repositories>
    <repository>
      <id>repo.jenkins-ci.org</id>
      <url>https://repo.jenkins-ci.org/public/</url>
    </repository>
  </repositories>
  <pluginRepositories>
    <pluginRepository>
      <id>repo.jenkins-ci.org</id>
      <url>https://repo.jenkins-ci.org/public/</url>
    </pluginRepository>
  </pluginRepositories>
</profile>

To package without running tests:

mvn clean package -DskipTests

To run Jenkins locally for development:

mvn clean hpi:run

Release documentation