gCubeActionExecutor

Starting from a list of git projects and a Bash fragment, for each project, this Jenkins pipeline:

• clone the git repository
• execs the Bash fragment in the root folder of the repository
• pushes back the repository using git.gcube as author.

Requirements

• Jenkins ver. 2.164.2 or newer
• Pipeline plugin ver. 2.5 or newer
• Pipeline: SCM Step plugin ver. 2.7 or newer
• Pipeline: Shared Groovy Libraries ver. 2.15 or newer
• User credentials configured on Jenkins. These are needed to set the author of the tag.

Parameters

• Git Root: The URL of the parent organization that includes all the listed repositories.
• List of Repositories: A plain text file, one line for each Git repository name to update.
• Action Root: The root URL of the Bash fragment to execute.
• Action File: The relative path under the Action Root of a Bash script

How Does It Work

The pipeline:

1. clones one repository at the time
2. downloads the file Action Root/Action File in the root folder of the repository
3. runs the action file using the root folder of the repository as working dir
4. pushes the repository back to Gitea

Every change to the Git repository MUST be done by the action file. The pipeline is in charge only to push the repository to the remote origin.

Sample Usage

List of Repositories

52n-wps-algorithm-gcube
52n-wps-server-gcube 
about-vre 
accept-invite-portlet 
accounting-aggregator-se-plugin 
accounting-analytics 
...

Action File

The following fragment downloads a file named LICENSE.md and adds it to the repository (if it does not exists):

#!/usr/bin/env bash
if [[ ! -f LICENSE.md ]]; then
    curl <my URL>/LICENSE.md -o LICENSE.md
    git add LICENSE.md
    git commit -m "LICENSE.md"
fi

References

• Pipeline as code
• Pipeline Syntax
• Shared Libraries
• SCM Step

Wiki doc

• CI: gCube Actions Pipeline

License

This project is licensed under the EUPL V.1.1 License.