Versions Compared

Old Version 16

changes.mady.by.user Pavlo Smahin

Saved on

compared with

New Version Current

changes.mady.by.user Pavlo Smahin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Main release

  1. Make sure that all pull requests required for the release are merged.
  2. Pull all changes and create a new branch from the master with the name `tmp-release-vX.Y.Z`, where X.Y.Z - a new version of the module
  3. Use versions-maven-plugin to update module dependencies in pom.xml (only stable versions, without snapshot, betta, alfa, etc.).

  4. Run mvn clean verify to check that new dependencies versions do not affect functionality.

  5. Commit changes with the commit message 'Update dependencies'.

  6. Update NEWS with changes that are included in the release (use the template below).

    Code Block
    collapsetrue
    ## vX.Y.Z YYYY-mm-DD
### Breaking changes
* Description ([ISSUE](https://folio-org.atlassian.net/browse/ISSUE))

### New APIs versions
* Provides `API_NAME vX.Y`
* Requires `API_NAME vX.Y`

### Features
* Description ([ISSUE](https://folio-org.atlassian.net/browse/ISSUE))

### Bug fixes
* Description ([ISSUE](https://folio-org.atlassian.net/browse/ISSUE))

### Tech Dept
* Description ([ISSUE](https://folio-org.atlassian.net/browse/ISSUE))

### Dependencies
* Bump `LIB_NAME` from `OLD_VERSION` to `NEW_VERSION`
* Add `LIB_NAME`NAME `VERSION`VERSION`
* Remove `LIB_NAME`
  7. Add information about the release in RELEASE.md file.


  9. Commit changes with the commit message 'Update NEWS'.
  10. Run mvn release:branch or use the built-in IDE Maven plugin to create a release branch.
    • The branch name should be in the format release/vX.Y
    • The new development version should be X.Y+1.0-SNAPSHOT.
  11. Update folio dependencies to snapshot versions and update NEWS with template for upcoming version. Commit changes.
  12. Push created commits to the repository and create a pull request. Wait for the review of your PR and merge it.
  13. Checkout the release/vX.Y release branch. Then run mvn clean release:prepare or use the built-in Maven plugin to prepare the release.
    1. Release version - X.Y.0
    2. Release tag - vX.Y.0
    3. New version - vX.Y.1-SNAPSHOT
  14. Push the release branch and the tag to the repository.
  15. Go to Jenkins https://jenkins-aws.indexdata.com/job/folio-org/job/<module-name>/view/tags/ and run the pipeline for the new tag.
  16. After the pipeline job is successfully finished you can create a release on GitHub.
  17. Notify the community in the release channel about the release.
  18. Close the release ticket:
    1. Set Fix Version = X.Y.0 (if it does not exist ask SM or TL to create it)
    2. Set Release 
    3. Set Fix Version to all tickets that were included in the release.
    4. Release version in Jira and preapre new versions


Bugfix/Hotfix Release

  1. Make sure that all pull requests required for the release are merged.
  2. Checkout to release/vX.Y branch.
  3. Cherry-Pick required commits from master branch.
  4. Create a new branch with the name `tmp-release-vX.Y.Z`, where X.Y.Z - a new version of the moduleCherry-Pick required commits.

  5. Run mvn clean verify to check that all tests are passed.

  6. Update NEWS with changes that are included in the release (use the template below).

    Code Block
    collapsetrue
    ## vX.Y.Z YYYY-mm-DD
### Bug fixes
* Description ([ISSUE](https://folio-org.atlassian.net/browse/ISSUE))

### Tech Dept
* Description ([ISSUE](https://folio-org.atlassian.net/browse/ISSUE))

### Dependencies
* Bump `LIB_NAME` from `OLD_VERSION` to `NEW_VERSION`
* Add `LIB_NAME` `VERSION`
* Remove `LIB_NAME`


  7. Commit changes with the commit message 'Update NEWS'.
  8. Run mvn release:clean release:prepare or use the built-in Maven plugin to prepare the release. (Use mvn release:clean -DskipTests -Darguments=-DskipTests release:prepare in case of some problems with local maven tests run)
    1. Release version - X.Y.Z
    2. Release tag - vX.Y.Z
    3. New version - vX.Y.Z+1-SNAPSHOT
  9. Push the branch and the tag to the repository and create a pull request. Wait for the review of your PR and merge it.
  10. Go to Jenkins https://jenkins-aws.indexdata.com/job/folio-org/job/<module-name>/view/tags/ and run the pipeline for the new tag.
  11. After the pipeline job is successfully finished you can create a release on GitHub.
  12. Notify the community in the release channel about the release.
  13. Close the release ticket:
    1. Set Fix Version = X.Y.Z (if it does not exist ask SM or TL to create it)
    2. Set Release 
    3. Set Fix Version to all tickets that were included in the release.
    4. Release version in Jira and preapre new versions