{"type":"doc","content":[{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"7a68994a-1a7e-4084-9c07-bdf063a2ec36"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"6e4ed9ae-2ff2-47aa-b9a1-d9e24f9afb0b"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick summary major/feature release","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2aa3401e-250b-4f4f-b459-9871720339b9"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":" git checkout -b tmp-release-X.Y.0\n vi NEWS.md\n git commit -m \"Update NEWS\" NEWS.md\n mvn -DautoVersionSubmodules=true release:clean release:prepare # Supply next feature (X.Y+1.0-SNAPSHOT)\n git push --set-upstream origin tmp-release-X.Y.0\n git push --tags\n mvn release:clean","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Log in to ","type":"text"},{"text":"Jenkins","type":"text","marks":[{"type":"link","attrs":{"href":"https://jenkins-aws.indexdata.com/job/folio-org/"}}]},{"text":". Build a module from the created tag.","type":"text"}]},{"type":"paragraph","content":[{"text":"GitHub","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/EBSCOIS"}}]},{"text":": Merge temporary release branch ","type":"text"},{"text":"tmp-release-X.Y.0","type":"text","marks":[{"type":"code"}]},{"text":" to master.","type":"text"}]},{"type":"paragraph","content":[{"text":"GitHub","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/EBSCOIS"}}]},{"text":": Update release notes.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"wrap-left","width":262,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":217,"id":"dc714a7b-030a-4c78-8fce-3666ea1fddf9","collection":"contentId-522780695","type":"file","height":123}}]},{"type":"paragraph","content":[{"text":" Populate the \"FixVersion\" field for all Jira stories included in the release.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Create a long-live branch followed by the major and minor versions, for example, ","type":"text"},{"text":"b2.17","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"git checkout -b bX.Y vX.Y.0\nmvn versions:set -DnewVersion=X.Y.1-SNAPSHOT\nmvn versions:commit\ngit commit -a -m \"release branch\"\ngit push --set-upstream origin bX.Y","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick summary bug fix release","type":"text"}]},{"type":"paragraph","content":[{"text":"Make a bug fix on the release for the ","type":"text"},{"text":"X.Y","type":"text","marks":[{"type":"code"}]},{"text":"-series:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"dcca3180-c6aa-4564-b48e-5629718a68c3"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":" git checkout bX.Y\n git cherry-pick \n vi NEWS.md\n git commit -m \"Update NEWS\" NEWS.md\n mvn --batch-mode -DautoVersionSubmodules=true release:clean release:prepare\n git push && git push --tags","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Log in to ","type":"text"},{"text":"Jenkins","type":"text","marks":[{"type":"link","attrs":{"href":"https://jenkins-aws.indexdata.com/job/folio-org/"}}]},{"text":". Build a module from the created tag.","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"GitHub","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/EBSCOIS"}}]},{"text":", Update release notes (see ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://folio-org.atlassian.net/wiki/spaces/FOLIJET/pages/522780695/Eureka+module+s+release+procedure#Add-release-notes-to-GitHub"}},{"text":" )","type":"text"}]},{"type":"paragraph","content":[{"text":"Populate the \"FixVersion\" field for all Jira stories included in the release.","type":"text"}]},{"type":"rule"},{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-flag_on","text":":flag_on:","shortName":":flag_on:"}},{"text":" ","type":"text"},{"text":"IMPORTANT","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"It is important to keep the SNAPSHOT version for our libraries(app-poc-tools) in the master branch with a SNAPSHOT version in pom.xml. After each release, be sure that the pom.xml contains a snapshot version and depends on the SNAPSHOT version of our libraries.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":317,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":193,"alt":"image-20241011-085832.png","id":"100b2002-4a1f-40af-a3aa-705ce1a3a2ff","collection":"contentId-522780695","type":"file","height":42}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":626,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":304,"alt":"image-20241011-085903.png","id":"cdc6bf2b-973f-4bfb-8d13-5b716283dee1","collection":"contentId-522780695","type":"file","height":13}}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Bug fix releases","type":"text"}]},{"type":"paragraph","content":[{"text":"Generally, we want bug fix releases to occur in separate branches with ","type":"text"},{"text":"only","type":"text","marks":[{"type":"em"}]},{"text":" bug fixes (not to be confused with temporary release branches). For this purpose, we must create a long-lived release branch. We use the naming scheme ","type":"text"},{"text":"b","type":"text","marks":[{"type":"code"}]},{"text":" followed by the major and minor versions, for example, ","type":"text"},{"text":"b2.17","type":"text","marks":[{"type":"code"}]},{"text":" which will include all bug fixes for version 2.17 (so for v2.17.1 and v2.17.2).","type":"text"}]},{"type":"paragraph","content":[{"text":"The bug fix release can be created as follows. Thus, it happens ONCE after a feature/major release has been performed.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Major/minor releases","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that ","type":"text"},{"text":"master","type":"text","marks":[{"type":"code"}]},{"text":" represents ","type":"text"},{"text":"both","type":"text","marks":[{"type":"em"}]},{"text":" new features and bug fixes. If there are important new features to be added while holding back incompatible releases, then a feature branch ","type":"text"},{"text":"b2","type":"text","marks":[{"type":"code"}]},{"text":" could be created. Still, it is probably not worth the effort except in exceptional cases.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Once: Ensure POM declarations","type":"text"}]},{"type":"paragraph","content":[{"text":"(You only need to do this once for a project. On subsequent releases you can skip this point.)","type":"text"}]},{"type":"paragraph","content":[{"text":"For Maven-based projects, the ","type":"text"},{"text":"Maven Release Plugin","type":"text","marks":[{"type":"link","attrs":{"href":"https://maven.apache.org/maven-release/maven-release-plugin"}}]},{"text":" is required. To enable the release plugin, add the following to the parent POM of the project:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6a9ec21b-f4ba-4797-8574-4fb7efcfcbd8"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"\n org.apache.maven.plugins\n maven-release-plugin\n 2.5.3\n \n clean verify\n v@{project.version}\n false\n true\n \n","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Also, you need to add scm block with project artifactId","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"59aff9a6-0064-4d54-b6e4-d6c1dc394fd5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":" \n https://github.com/folio-org/mod-roles-keycloak\n scm:git:git://github.com:folio-org/mod-roles-keycloak.git\n scm:git:git@github.com:folio-org/mod-roles-keycloak.git\n HEAD\n ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Commit all changes to the POM file.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Make a temporary release branch","type":"text"}]},{"type":"paragraph","content":[{"text":"If you do not have commit access to the master branch (and even if you do), you can make the release on a branch.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2c586cea-97a7-4ca9-a448-162c62fc9683"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"git checkout -b \"tmp-release-X.Y.Z\"","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Optional: Update any scripts and descriptors for the release version","type":"text"}]},{"type":"paragraph","content":[{"text":"Update version numbers in places that Maven will not do automatically, to be the version you are about to release. That could be ModuleDescriptors, LaunchDescriptors, or scripts you use for testing and development.","type":"text"}]},{"type":"paragraph","content":[{"text":"Often it is not necessary to have any such. You should be using the autogenerated descriptors from templates. Note that scripts can enable the module without mentioning any version numbers.","type":"text"}]},{"type":"paragraph","content":[{"text":"Commit any such changes:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"c3efa07c-1085-49ba-8900-1a1fad62d160"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"git commit -a -m \"Towards version X.Y.Z\"","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Update information in the NEWS.md","type":"text"}]},{"type":"paragraph","content":[{"text":"Add details about all user stories included in the release to the \"NEWS.md\" file. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow the next format for the news file:","type":"text"}]},{"type":"codeBlock","content":[{"text":"## Version `v1.4.6` (24.09.2024)\n* Added dynamic permission mapping (MODROLESKC-210)\n* Extend Okapi mapping overrides (MODOKAPFAC-4)\n\n---\n## Version `v1.4.5` (30.08.2024)\n* Implement async migration (MODROLESKC-207)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prepare and perform the source release","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"136e9157-a213-4730-8f52-142416a52139"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"mvn -DautoVersionSubmodules=true release:clean release:prepare","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"This command will prompt you for input including the release tag/version, the next post-release SNAPSHOT version, as well as ask you to resolve any SNAPSHOT dependencies if you have any. Do NOT create releases with SNAPSHOT dependencies. Selecting the defaults is mostly fine. Your release tag must be prefixed with ‘v’ (the default) and you can always change the next SNAPSHOT version later if necessary.","type":"text"}]},{"type":"paragraph","content":[{"text":"For the question about the next post-release “new development version”, rather than accepting the default which suggests an increment of the “patch” version, instead, specify the next “minor” version. For example ","type":"text"},{"text":"2.18.0-SNAPSHOT","type":"text","marks":[{"type":"code"}]},{"text":" rather than ","type":"text"},{"text":"2.17.1-SNAPSHOT","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Assuming there are no build errors, you are ready to push your changes to GitHub and delete the release.properties and pom.xml.releaseBackup files.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"b2e2936b-6f2c-4fad-83a6-b5f3b2615e16"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"codeBlock","content":[{"text":"git push && git push --tags\nmvn release:clean","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Build and release artifacts","type":"text"}]},{"type":"paragraph","content":[{"text":"After preparing the release as explained above, the next step is done via ","type":"text"},{"text":"Jenkins","type":"text","marks":[{"type":"link","attrs":{"href":"https://jenkins-aws.indexdata.com/job/folio-org/"}}]},{"text":". Jenkins credentials utilize the GitHub authentication for developers, so ensure that you are logged in to GitHub to then enable login to Jenkins.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"wrap-left","width":273,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":273,"alt":"image-20241011-084015.png","id":"02f66f21-4787-4b18-81f1-33e61398dcc0","collection":"contentId-522780695","type":"file","height":117}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Choose the module and go to the tags tab. Trigger a build for the version that should be released.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"As a result, you should see that your build name will only contain the version of the module (e.g. 1.0.0 or 1.1.0).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Merge the temporary release branch into the master","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to GitHub and make a pull request for the release branch you just pushed. Wait for all the tests to pass and merge the pull request.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Add release notes to GitHub","type":"text"}]},{"type":"paragraph","content":[{"text":"Go to the “Releases” area. Select ","type":"text"},{"text":"Draft a new release","type":"text","marks":[{"type":"code"}]},{"text":". Choose the tag of the new release and the previous tag. Click on the “generate release notes” button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":337,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":337,"alt":"image-20241011-085033.png","id":"8003fbb0-45c3-4335-b256-9d071e0beaef","collection":"contentId-522780695","type":"file","height":72}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Post-release actions","type":"text"}]},{"type":"paragraph","content":[{"text":"Notify on Slack ","type":"text"},{"text":"releases","type":"text","marks":[{"type":"code"}]},{"text":" channel once release is done","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"}],"version":1}

Browser not supported