src/main/webapp/contribute/manual-release-guide.html [289:361]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  • Send out to the Unomi mailing list a mail to start the voting process, see [1]
  • If the vote is refused or cancelled, peform the following steps to restart the release process:
    1. Drop the release in Nexus
    2. Remove the tag in Git:
      git push --delete origin unomi-root-${next.stable.version}
      git tag -d unomi-root-${next.stable.version}
    3. Correct any problems in the source, make sure to do them in master and cherry-pick them to the relevant branches
    4. Reset all versions with the following command:
      mvn versions:set -DskipITs=true -DskipTests=true -P integration-tests,rat,apache-release,docker,\!run-tests
    5. Restart at the release:prepare step
  • If the vote is refused, you will need to restart the release process. Make sure you remove the staging repositories as well as the release tag. You will also need to reset the version in the project using:
    mvn versions:set
  • Send out a vote summary in the same thread to the Unomi mailing list once the voting period has expired, see [2]
  • Finalize the release

    1. Move the files uploaded to the unomi-dev repository to the unomi-release repository by doing the following:
      svn mv https://dist.apache.org/repos/dist/dev/unomi/${next.stable.version} https://dist.apache.org/repos/dist/release/unomi/${next.stable.version} -m "Apache Unomi ${next.stable.version} Release"
    2. In JIRA mark the version as released and add a release date
    3. Connect to https://repository.apache.org/#stagingRepositories and look for the open staging repositories, you should have one. Select the staging repositoriy and click on release.
    4. Update the website (in project `unomi-site`) to point to the new release on the download page by first copying the previous archive release and replacing all the version numbers with the current release version. Also don't forget to copy the release notes. Then you can update the download page with the proper links to the new release (no direct links to www.apache.org/dist, make sure you use the closer.lua script). Be careful with links that contain & (ampersand) characters, they must be replaced with &. Normally all this should be easy to do by simply search & replacing the version number. Finally on the home page update the news section to add the release.
      git clone https://gitbox.apache.org/repos/asf/unomi-site.git
      Perform any modifications, notably change the versions in the pom.xml file:
          <properties>
              <latest.stable.version>1.5.4</latest.stable.version>
              <next.development.version>1.5.5-SNAPSHOT</next.development.version>
              <next.stable.version>1.5.5</next.stable.version>
              <latest.development.version>2.0.0-SNAPSHOT</latest.development.version>
          </properties>
      
      Then modify the index.html, download.html to add the new files. For the documentation see the next step.
    5. Test the site modifications using the generated site HTML using Jekyll serve
      ./mvnw clean install gem:exec@jekyll-serve-filtered
      Connect to http://127.0.0.1:4000 to check the modifications. If you need to make more modifications, simply relaunch the above line after modifying the HTML files.
    6. Deploy the web site changes using:
      ./mvnw clean install
      ./mvnw install scm-publish:publish-scm -Dusername=YOUR_APACHE_USERNAME -Dpassword=YOUR_APACHE_PASSWORD
    7. Then make sure to commit all the changes to the web site's git project:
      git commit -m "Apache Unomi ${next.stable.version} Release website update"
      git push

    Documentation

    1. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - src/main/webapp/contribute/release-guide.html [207:279]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    2. Send out to the Unomi mailing list a mail to start the voting process, see [1]
    3. If the vote is refused or cancelled, peform the following steps to restart the release process:
      1. Drop the release in Nexus
      2. Remove the tag in Git:
        git push --delete origin unomi-root-${next.stable.version}
        git tag -d unomi-root-${next.stable.version}
      3. Correct any problems in the source, make sure to do them in master and cherry-pick them to the relevant branches
      4. Reset all versions with the following command:
        mvn versions:set -DskipITs=true -DskipTests=true -P integration-tests,rat,apache-release,docker,\!run-tests
      5. Restart at the release:prepare step
    4. If the vote is refused, you will need to restart the release process. Make sure you remove the staging repositories as well as the release tag. You will also need to reset the version in the project using:
      mvn versions:set
    5. Send out a vote summary in the same thread to the Unomi mailing list once the voting period has expired, see [2]

    Finalize the release

    1. Move the files uploaded to the unomi-dev repository to the unomi-release repository by doing the following:
      svn mv https://dist.apache.org/repos/dist/dev/unomi/${next.stable.version} https://dist.apache.org/repos/dist/release/unomi/${next.stable.version} -m "Apache Unomi ${next.stable.version} Release"
    2. In JIRA mark the version as released and add a release date
    3. Connect to https://repository.apache.org/#stagingRepositories and look for the open staging repositories, you should have one. Select the staging repositoriy and click on release.
    4. Update the website (in project `unomi-site`) to point to the new release on the download page by first copying the previous archive release and replacing all the version numbers with the current release version. Also don't forget to copy the release notes. Then you can update the download page with the proper links to the new release (no direct links to www.apache.org/dist, make sure you use the closer.lua script). Be careful with links that contain & (ampersand) characters, they must be replaced with &. Normally all this should be easy to do by simply search & replacing the version number. Finally on the home page update the news section to add the release.
      git clone https://gitbox.apache.org/repos/asf/unomi-site.git
      Perform any modifications, notably change the versions in the pom.xml file:
          <properties>
              <latest.stable.version>1.5.4</latest.stable.version>
              <next.development.version>1.5.5-SNAPSHOT</next.development.version>
              <next.stable.version>1.5.5</next.stable.version>
              <latest.development.version>2.0.0-SNAPSHOT</latest.development.version>
          </properties>
      
      Then modify the index.html, download.html to add the new files. For the documentation see the next step.
    5. Test the site modifications using the generated site HTML using Jekyll serve
      ./mvnw clean install gem:exec@jekyll-serve-filtered
      Connect to http://127.0.0.1:4000 to check the modifications. If you need to make more modifications, simply relaunch the above line after modifying the HTML files.
    6. Deploy the web site changes using:
      ./mvnw clean install
      ./mvnw install scm-publish:publish-scm -Dusername=YOUR_APACHE_USERNAME -Dpassword=YOUR_APACHE_PASSWORD
    7. Then make sure to commit all the changes to the web site's git project:
      git commit -m "Apache Unomi ${next.stable.version} Release website update"
      git push

    Documentation

    1. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -