Development work is done directly against the master branch, and should always happen with a "-SNAPSHOT" version for all components/config files. Gitlab pipelines will automatically build and test the JavaTemplates projects on push/merge. These automatically triggered pipelines will not deploy to artifactory.
Note this section is intended for developers working on the JavaTemplates who have permission to deploy a release.
- Make sure all changes that are intended to be released have been merged into the master branch.
- Make sure Constants.java is updated with proper version(s).
- If the release includes a CDTS version change, make sure all
cdn.properties
files have been updated accordingly. - Update the CHANGELOG identifying all Breaking changes, New features and improvements, and Fixes / Patches form the last release; identify the version number appropriately for Semantic Versioning.
- Navigate to CI / CD -> Pipelines for the project.
- Click Run Pipeline
- Under Run for ensure the
master
branch (or other deployable protected branch) is selected (master should be default) - Add a Variable with:
- The Key being
DEPLOY_VERSION
(Will match the key in the .gitlab-ci.yml - The Value being the version you are deploying. This version value will
override the version of all pom files for the deployment build. Format must be:
- For a SNAPSHOT version:
x.y.z-SNAPSHOT
- For a RELEASE version:
x.y.z
- For a SNAPSHOT version:
- The Key being
- Click Run Pipeline
The pipeline will run and deploy the JavaTemplates artifact to ESDC Artifactory:
In addition, the release deployment will generate ZIP files for external departments.
These ZIP files will be available in the pipeline deploy_release
job's page and should be used to update the
Installation page.
After a release deployment, the Wiki Installation Page should be updated with the appropriate information (including the new set of ZIP files for external departments).
This script is used to update the version number in all pom.xml and configuration files so they all match.
This script is meant to be launched by the release pipeline scripts, but can be used manually whenever there is a need to change the version.
This Ant script will put together the needed files to create a Maven archetype from the sample projecs and launch a "mvn deloy" on the generated projects.
Because Maven deployment targets SADE's Artifactory, this script is mainly launched from the pipeline.
This Ant script will create a ZIP archive from the sample projects meant to be downloaded by users outside the ESDC network. Prior to packaging, the sample projects are modified slightly to include the internal dependencies in a Maven repository local to the project (because external users don't have access to SADE's Artifactory installation).
This script can be launched locally (typically from 'master' branch after finalizing the release by calling prepare-release.sh, see above), but is mainly used by the build pipeline.