src/main/webapp/contribute/manual-release-guide.html [397:581]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  • Go back to the site project and make sure you update the documentation page to link to the proper versions of the documents.
  • Docker image

    1. Checkout the tagged version:
      git checkout tags/unomi-root-${next.stable.version}
    2. Change to the Docker directory. Make sure you have docker running locally (start Docker Desktop for example):
      cd docker
    3. Launch the docker build and push
      mvn clean install
      mvn docker:push

    Rollback

    1. Delete the tag:
      git push --delete origin unomi-root-${next.stable.version}
      git tag --delete unomi-root-${next.stable.version}
    2. Reset to the previous commit before the release preparation:
      git reset --hard c65f9897ec5f31d9d22ad639738c7db9d109aa77
      git push origin -f

    Announce

    1. Send an announce to the project mailing list and the Apache announce mailing list to announce the new release using mail template [3]
    2. If you were releasing from a branch, make sure you merge all the branch changes for the release back to the master.

    Social media

    Tweet, post on Facebook, LinkedIn, and other platforms. Ask other contributors to do the same.

    Remove old releases

    In order to lighten the load on mirrors, remove old releases from the dist server once the new release has properly been deployed to all the mirrors. Old releases are automatically archived so they are not needed on the mirrors anymore. Just make sure that all the links in the download page do point to the archive server.

    Checklist to declare the process completed

    1. Release announced on the user@ mailing list.
    2. Release recorded in reporter.apache.org.
    3. Release announced on social media.
    4. Completion declared on the dev@ mailing list.
    5. Check that old release where removed from the dist server

    Improve the process

    It is important that we improve the release processes over time. Once you’ve finished the release, please take a step back and look what areas of this process and be improved. Perhaps some part of the process can be simplified. Perhaps parts of this guide can be clarified.

    If we have specific ideas, please start a discussion on the dev@ mailing list and/or propose a pull request to update this guide. Thanks!


    Mail templates

    [1] Mail template for the Unomi PMC vote:
    
    Subject: [VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
    Body:
    Hi all,
    
    I submit Apache Unomi ${next.stable.version} release [TAKE2] to your vote.
    
    The following corrections were done since TAKE 1:
    NOTICE year (2016) has been updated to 2018
    unexpected binaries inside zip file [1] : zip file has been completely removed
    All artefacts are now signed in an apache email address
    
    Staging Repository:
    *https://repository.apache.org/content/repositories/orgapacheunomi-1021/
    <https://repository.apache.org/content/repositories/orgapacheunomi-1021/>*
    
    You can find the sources here :
    
    *https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip
    <https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip>*
    
    Convenience binaries are also available here:
    *https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi/${next.stable.version}/
    <https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi/${next.stable.version}/>*
    
    Git tag:
    unomi-root-${next.stable.version}
    
    Release Notes:
    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
    version=12341610
    
    Please vote to approve this release:
    
    [ ] +1 Approve the release
    [ ] -1 Don't approve the release (please provide specific comments)
    
    This vote will be open for at least 72 hours, or until the necessary number
    of binding votes (3 +1) is reached.
    
    Please let me know if you have any questions.
    
    Thanks,
    Regards
                
    [2] Mail template for the results of the Unomi PMC vote:
    
    Subject: [RESULT][VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
    Body:
    Hi,
    
    Thank you for your votes.
    
    Here's the summary :
    
    3 binding votes +1:
    
    John Doe 1
    John Doe 2
    John Doe 3
    
    2 non-binding vote +1:
    John Doe 4
    John Doe 5
    
    No 0 or -1.
    
    The proposal to release Unomi ${next.stable.version} is approved by the team.
    
    Thanks,
    John Doe 1
                
    [3] Announce mailing list template:
    
    Subject : [ANNOUNCE] Apache Unomi ${next.stable.version} Release
    Body:
    The Apache Unomi team would like to announce the release of Apache
    Unomi ${next.stable.version}.
    
    Release notes are here:
    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
    version=12338361
    
    Apache Unomi is a Java Open Source customer data platform, a Java server
    designed to manage customers, leads and visitors' data and help personalize customers'
    experiences.
    
    More details regarding Apache Unomi can be found here:
    http://unomi.apache.org/
    
    The release artifacts can be downloaded here:
    https://dist.apache.org/repos/dist/release/incubator/unomi/${next.stable.version}/
    
    All JIRAs completed for this release are tagged with 'FixVersion =
    ${next.stable.version}'; the JIRA release notes can be found here:
    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
    version=12338361
    
    Thanks!
    The Apache Unomi Team
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    
    
    
    src/main/webapp/contribute/release-guide.html [290:474]:
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                    
  • Go back to the site project and make sure you update the documentation page to link to the proper versions of the documents.
  • Docker image

    1. Checkout the tagged version:
      git checkout tags/unomi-root-${next.stable.version}
    2. Change to the Docker directory. Make sure you have docker running locally (start Docker Desktop for example):
      cd docker
    3. Launch the docker build and push
      mvn clean install
      mvn docker:push

    Rollback

    1. Delete the tag:
      git push --delete origin unomi-root-${next.stable.version}
      git tag --delete unomi-root-${next.stable.version}
    2. Reset to the previous commit before the release preparation:
      git reset --hard c65f9897ec5f31d9d22ad639738c7db9d109aa77
      git push origin -f

    Announce

    1. Send an announce to the project mailing list and the Apache announce mailing list to announce the new release using mail template [3]
    2. If you were releasing from a branch, make sure you merge all the branch changes for the release back to the master.

    Social media

    Tweet, post on Facebook, LinkedIn, and other platforms. Ask other contributors to do the same.

    Remove old releases

    In order to lighten the load on mirrors, remove old releases from the dist server once the new release has properly been deployed to all the mirrors. Old releases are automatically archived so they are not needed on the mirrors anymore. Just make sure that all the links in the download page do point to the archive server.

    Checklist to declare the process completed

    1. Release announced on the user@ mailing list.
    2. Release recorded in reporter.apache.org.
    3. Release announced on social media.
    4. Completion declared on the dev@ mailing list.
    5. Check that old release where removed from the dist server

    Improve the process

    It is important that we improve the release processes over time. Once you’ve finished the release, please take a step back and look what areas of this process and be improved. Perhaps some part of the process can be simplified. Perhaps parts of this guide can be clarified.

    If we have specific ideas, please start a discussion on the dev@ mailing list and/or propose a pull request to update this guide. Thanks!


    Mail templates

    [1] Mail template for the Unomi PMC vote:
    
    Subject: [VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
    Body:
    Hi all,
    
    I submit Apache Unomi ${next.stable.version} release [TAKE2] to your vote.
    
    The following corrections were done since TAKE 1:
    NOTICE year (2016) has been updated to 2018
    unexpected binaries inside zip file [1] : zip file has been completely removed
    All artefacts are now signed in an apache email address
    
    Staging Repository:
    *https://repository.apache.org/content/repositories/orgapacheunomi-1021/
    <https://repository.apache.org/content/repositories/orgapacheunomi-1021/>*
    
    You can find the sources here :
    
    *https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip
    <https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip>*
    
    Convenience binaries are also available here:
    *https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi/${next.stable.version}/
    <https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
    unomi/unomi/${next.stable.version}/>*
    
    Git tag:
    unomi-root-${next.stable.version}
    
    Release Notes:
    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
    version=12341610
    
    Please vote to approve this release:
    
    [ ] +1 Approve the release
    [ ] -1 Don't approve the release (please provide specific comments)
    
    This vote will be open for at least 72 hours, or until the necessary number
    of binding votes (3 +1) is reached.
    
    Please let me know if you have any questions.
    
    Thanks,
    Regards
                
    [2] Mail template for the results of the Unomi PMC vote:
    
    Subject: [RESULT][VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
    Body:
    Hi,
    
    Thank you for your votes.
    
    Here's the summary :
    
    3 binding votes +1:
    
    John Doe 1
    John Doe 2
    John Doe 3
    
    2 non-binding vote +1:
    John Doe 4
    John Doe 5
    
    No 0 or -1.
    
    The proposal to release Unomi ${next.stable.version} is approved by the team.
    
    Thanks,
    John Doe 1
                
    [3] Announce mailing list template:
    
    Subject : [ANNOUNCE] Apache Unomi ${next.stable.version} Release
    Body:
    The Apache Unomi team would like to announce the release of Apache
    Unomi ${next.stable.version}.
    
    Release notes are here:
    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
    version=12338361
    
    Apache Unomi is a Java Open Source customer data platform, a Java server
    designed to manage customers, leads and visitors' data and help personalize customers'
    experiences.
    
    More details regarding Apache Unomi can be found here:
    http://unomi.apache.org/
    
    The release artifacts can be downloaded here:
    https://dist.apache.org/repos/dist/release/incubator/unomi/${next.stable.version}/
    
    All JIRAs completed for this release are tagged with 'FixVersion =
    ${next.stable.version}'; the JIRA release notes can be found here:
    https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
    version=12338361
    
    Thanks!
    The Apache Unomi Team
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -