snowdrop/release-manager

Jira Java Client Tool

Release Manager Tool

Table of Contents

• Release Manager Tool
  • Table of Contents
  • Introduction
  • Release process
    • Instructions
    • Release definition
    • Init release repositories for a new Major.Minor
    • Start a new Snowdrop release
    • Create JIRA stakeholder request issues
    • Link JIRA issues to a parent
    • Clone a JIRA Release issue and their subtasks
    • List CVE
    • Update Config For Release
  • Testing
    • Profiles
  • Tricks
    • Get JIRA issue
    • Post a new JIRA ticket

Introduction

This project has been designed to investigate different technology able to manage the creation, update or deletion of the JIRA tickets as documented under the table of content. It is being also used to automate release process tasks.

Release process

Instructions

• Build the code

./mvnw clean package 

• Build the container image

docker build -f src/main/docker/Dockerfile.jvm -t snowdrop/release-manager:1.0 .
docker tag snowdrop/release-manager:1.0 quay.io/snowdrop/release-manager:1.0
docker push quay.io/snowdrop/release-manager:1.0

Remark: No ENTRYPOINT has been defined within the container in order to be able to execute the script /deployments/run-java.sh manually, using a Jenkins Pipeline Job. The UID of the user is 1000 like also the UID of the Jenkins JNLP Agent !

Release definition

The release.yml release file contains the metadata for each release. This metadata links the release to the components that constitute it. This, in particular, allows for automated creation of stakeholder issue marking the beginning of a new release cycle.

The release.yml file lives in the snowdrop/spring-boot-bom repository right next to the pom.xml file so that they can evolve concurrently as needed and be kept in sync. This file should be updated each time the team starts working on a new release.

An example of such release.yml can be found at: https://github.com/snowdrop/spring-boot-bom/blob/sb-2.3.x/release.yml

Init release repositories for a new Major.Minor

Whenever a new Major.Minor release occurs:

• a new sb-<major>.<minor>.x branch must be created in the snowdrop/spring-boot-bom github repository
• a new folder in the middleware/build-configurations gitlab repository must be created.

This command performs these operations automatically.

NOTE: The previous release is used as a source of information. It is used as the source for the new snowdrop/spring-boot-bom github repository branch and as the source for the new build-configurations configuration.

java -jar target/quarkus-app/quarkus-run.jar \
    -u <jira user> -p <jira password> 
    new-build-config-version 
    -g <github org>/<github repo>/<git reference: branch, tag, hash> \ 
    -o <github token> \
    -glu <gitlab user> \
    -glt <gitlab token> \ 
    -r <new release> \
    -pr <previous release>

e.g.

java -jar target/quarkus-app/quarkus-run.jar \
    -u my_user -p my_secret \
    new-build-config-version
    -g snowdrop/spring-boot-bom/sb-2.4.x \
    -o my_github_token 
    -glu my_gitlab_user -glt my_gitlab_token 
    -r 2.4.3 -pr 2.3.6.RELEASE

NOTE: The release and previous release versions are the versions SpringBoot releases (see https://github.com/spring-projects/spring-boot/releases).

Start a new Snowdrop release

Starting a release means executing the following tasks:

• Create Runtime Release ticket from the template issue (JIRA)
• Create the stakeholder request tickets (JIRA)
• Link the stakeholder request tickets to the related Runtime Release ticket (JIRA)
• Link any CVE associated with the release (JIRA)
• Initialize the CPaaS repository for the version (GitLab):
  • new branch for the release
  • update the configuration files (release.yml, product.yml)
  • remove the advisory file

This process consumes a release.yml file associated with the code base that contains the release information and structure. The information used by this tool and that is provided to other systems, e.g. JIRA, is obtained from the code base that has been previously updated from an upstream released Spring Boot. All these tasks are executed by running the following command:

java -jar target/quarkus-app/quarkus-run.jar \
    -u JBOSS_JIRA_USER \
    -p JBOSS_JIRA_PWD \
    start-release \
    -g <github org>/<github repo>/<git reference: branch, tag, hash> \
    -ghu <Github user name>
    -o <github token> \
    -glu <gitlab user> -glt <gitlab token> \
    -pr <previous release> \
    -r <Release Date(yyyy-mm-dd)>
    -e <End of Life Date(yyyy-mm-dd)>
    -w john,doe,foo  

The -w option allows to optionally add the list of comma-separated JIRA user names to the list of watchers for the issues that have been created.

Create JIRA stakeholder request issues

To create a bulk of issues for a component/starter which are blocking a JIRA Issue release, use the following command:

java -jar target/quarkus-app/quarkus-run.jar \
    -u JBOSS_JIRA_USER \
    -p JBOSS_JIRA_PWD \
    create-component \
    -g <github org>/<github repo>/<git reference: branch, tag, hash> 

This will parse the release.yml file found at the specified git reference, retrieve all the defined components , retrieve their associated version from the Snowdrop pom.xml and create a corresponding JIRA issue in the appropriate JIRA project. If release.yml includes a key field in its main issue field, this key is used to identify the main release issue to which the component requests tickets will be linked.

Each component is identified by its associated JIRA project name (which is used to create the corresponding JIRA request) and a set of properties used to identify which artifacts are linked to this particular component. The name of the component's properties follow the name version properties defined in the POM. For example, for Hibernate, the version property is named hibernate.version and the associated component property is named hibernate (release-manager takes care of matching that property to the one used in the POM). If we also want to associate other properties to the same component, we can add more. For example, the Hibernate component is associated with the hibernate-validator property.

IMPORTANT:

Link JIRA issues to a parent

To Link different issues to a JIRA issue using as relation type Is Blocked By, then execute the following command:

java -jar target/quarkus-app/quarkus-run.jar \
    -u JBOSS_JIRA_USER \
    -p JBOSS_JIRA_PWD \
    link \
    ENTSBT-xxx \
    --to EAP-yyy 

The to option represents the issue which currently blocks the release issue referenced by the issue specified as a parameter.

Clone a JIRA Release issue and their subtasks

To clone a Release issue and their sub-tasks

 java -jar target/quarkus-app/quarkus-run.jar \
    -u JBOSS_JIRA_USER \
    -p JBOSS_JIRA_PWD \
    clone \
    ENTSBT-ddd \    
    --git <github org>/<github repo>/<git reference: branch, tag, hash> 

List CVE

Generate a list of CVE. This process will print the list of CVE in a report. If the -r option is used this list will also be pushed to GitHub, being the -o option required for that.

 java -jar target/quarkus-app/quarkus-run.jar \
    -u JBOSS_JIRA_USER \
    -p JBOSS_JIRA_PWD \
    list-cves \
    -r \
    -o <github token> \ 
    version

Update Config For Release

This task performs the following steps:

• gathers information from the JIRA issues stored in the release file
• updates the build configuration file
  • pushes the changes to the gitlab repository to be merged
• updates the CPaaS configuration script (https://gitlab.cee.redhat.com/cpaas/documentation/-/tree/master)
  • pushes the changes to the gitlab repository to be merged

The required parameters are the following:

Parameter	Required	Description
-g, --git	YES	Git reference in the / format
-o, --token	YES	Github API token
-glu, --gluser	YES	Gitlab user name
-glt, --gltoken	YES	Gitlab API token
-r, --release	YES	Release number (e.g. 2.4.3)
-pr, --previous-release	YES	Previous release number (e.g. 2.3.6)
-q, --qualifier	YES	Qualifier [Alpha, Beta, Final, SP] (e.g. Beta1)
-m, --milestone	YES	Milestone [DR*, ER*, CR*]

Execution example:

$ java -jar target/quarkus-app/quarkus-run.jar \
  -u ${JBOSS_JIRA_USER} -p ${JBOSS_JIRA_PWD} \
  update-build-config \
  -g snowdrop/spring-boot-bom -o ${GITHUB_TOKEN} -glu ${GITLAB_USER} -glt ${GITLAB_TOKEN} -r 2.4.3  -q Alpha1 -m "DR*"

Testing

The unit tests require the providing of 2 parameters to be able to login to the JIRA REST API.

$ ./mvnw test -Dgithub.user=${GITHUB_USER} -Dgithub.token=${GITHUB_TOKEN} -Dgitlab.user=${JBOSS_JIRA_USER} -Dgitlab.token=${GITLAB_TOKEN}

Test profiles have been implemented to differenciate unit tests and integration tests (testing against the actual JIRA API).

Profiles

The following profiles have been created:

• core - core tests
• it - integration tests

Executing a specific profile is as simple as passing the profile tag name in the test maven command line. More information on running specific Quarkus test profiles here.

$ mvn test -Dquarkus.test.profile.tags=<test profile tag [core,it]> -Djboss.jira.user=${JBOSS_JIRA_USER} -Djboss.jira.password=${JBOSS_JIRA_PWD}

The quarkus.test.profile.tags is optional and if no profile tag is included all the tests are executed.

To launch the core tests without executing the integration tests use the following command.

$ ./mvnw test -Dquarkus.test.profile.tags=core -Djboss.jira.user=${JBOSS_JIRA_USER} -Djboss.jira.password=${JBOSS_JIRA_PWD}

Integration tests can also be executed specifically.

$ ./mvnw test -Dquarkus.test.profile.tags=it -Djboss.jira.user=${JBOSS_JIRA_USER} -Djboss.jira.password=${JBOSS_JIRA_PWD}

Tricks

To query the JIRA server using HTTP requests (GET, POST, ...), you can execute the following commands

Reference documentation is available here at Atlassian REST API v2 doc

Get JIRA issue

http --verify=no --follow --auth user:pwd https://issues.redhat.com/rest/api/2/issue/SB-889

Post a new JIRA ticket

http --verify=no --follow  --auth user:pwd POST https://issues.redhat.com/rest/api/2/issue/ < jira.json