MapStore Release 2024.02.01

[tdipisa]

Setup and preliminary checks

This steps have to be followed always when preparing a new release.

• [x] Create an issue with this checklist in the release milestone, named "Release YYYY.XX.xx".
• [x] Create the milestone if it doesn't exist. (Name YYYY.XX.xx).
• [x] Verify if it is needed to release a new version of http_proxy, mapfish-print or geostore, and do it if necessary accordingly with release calendar.
  • [x] #10675
  • [x] for http_proxy, check if here is present the version specified. Release procedure is specified in the Readme.md file of the project.
  • [x] for mapfish-print check if here is present the version specified. Release procedure is specified in the Readme.md file of the project.
• [x] Check if dependencies of MapStore libraries and geostore libraries are the same (compare src/pom.xml in geostore e pom.xml in MapStore).

Before the Release

• [x] Check pom.xml dependencies are all in fixed stable versions ( no -SNAPSHOT usage release). If not, You use the action Update dependencies versions to fix them, setting:
  • [x] the branch to YYYY.XX.xx
  • [x] the of geostore, http_proxy and mapfish-print versions accordingly with the MapStore release calendar
• [x] Check that MapStoreExtension repository is aligned and working.
• [x] Run the Submodule Update of MapStoreExtension to generate the SampleExtension.zip to use for testing.
  • [x] Use workflow from YYYY.XX.xx branch
  • [x] Wait for completition
  • [x] Download the Artifacts.zip that contains SampleExtension.zip from the execution of the checks action on the branch YYYY.XX.xx. This can be used for tests.
• [x] Test on QA https://qa-mapstore.geosolutionsgroup.com/mapstore/
  • [x] Test everything, not only the new features
  • [x] Test the creation of a standard project starting in from the stable branch and with the internal backend, so:
    • [x] node ./createProject.js and insert the entries (for the rest simply press enter:
      • project name: release_project_test
      • base branch: insert the release branch (e.g. YYYY.XX.xx)
      • project folder insert ../test_release_<release_number> )
    • [x] cd ../test_release_<release_number>
    • [x] npm install
    • [x] npm run start:app, then check that an empty homepage loads correctly
  • [x] Test Binary (take the mapstore2--qa-bin.zip, from latest build)

Prepare Release

• [x] Run Prepare Release workflow on github actions with the following parameters:
  • Use workflow from branch YYYY.XX.xx (the release branch)
  • Version to release YYYY.XX.mm (the effective number of the release)
  • MapStore version for changelog generation YYYY.XX.mm (the effective number of the previous release)
  • version to fix for the java module, accordingly with release calendar (e.g. 1.7.0)
  • use the default value for the other parameters
• [x] Wait for the process to complete. At the end:
  • a new commit will be added to the release branch tagged as vYYYY.XX.mm. This commit will contain the changelog and the updated version of the java modules.
  • a pull request will be created on master with the changelog updates
• [x] Merge the incoming PR created by the workflow for updating changelog on Master
• [x] Run Submodules Update on MapStoreExtension:
  • Branch YYYY.XX.xx

MapStore Stable deploy

• [x] check if there are changes to be ported to STABLE branch of mapstore-datadir repo
  • [x] if so prepare a PR to be merged
  • [x] merge the PR and move on with the steps otherwise stop here
• [x] Lunch MapStore2-Stable-Build
  • branch: vYYYY.XX.mm (the version tag name, e.g. v2024.01.01)
  • version: ${branch}-stable ( version to pass to the build )
  • TAG_NAME: ${branch}-stable (tag to assign to the docker hub image)
• [x] After "MapStore2-Stable-Build" finished, Launch MapStore2-Stable-Deploy to install the latest stable version on official demo.
  • branch: vYYYY.XX.mm (the version tag name, e.g. v2024.01.01)
  • TAG_NAME: ${branch}-stable (tag of the docker hub image, previously build)
• [x] Test the change has been applied, login on https://mapstore.geosolutionsgroup.com and verify that the layers from gs-stable are visible without errors (typically authentication errors that was caused by the wrong auth-key).

Create and Publish MapStoreExtension release

• [x] Create a draft release for MapstoreExtension with the same name and tag
  • target of the release is stable branch aligned to latest commit in stable branch of main mapstore repo
  • tag is vYYYY.XX.mm
• [x] Upload the SampleExtension.zip to upload on release:
  • Open the page. You will see a process running for the stable branch, triggered by "Update submodules". Wait for the end of this task.
  • When the process is succesfully finished click on the "Update submodules" last successful task. The task page will open.
  • At the bottom of the page click on "Artifacts" to download.
  • Extract from the artifacts.zip the SampleExtension.zip file
  • Upload the SampleExtension.zip to the draft release created.
• [x] Publish the MapStoreExtension release

Create and Publish MapStore release

• [x] Run Create Release workflow on github actions with the following parameters:
  • Use workflow from branch YYYY.XX.xx (the release branch)
  • Version to release YYYY.XX.mm (version without the v prefix)
• [x] Launch MapStore2-Stable-Releaser Jenkins job with
  • branch: vYYYY.XX.mm (the version tag name, e.g. v2024.01.01)
  • ms2Version: YYYY.XX.mm (version without the v prefix)
• [x] Wait the end of the 2 process

When the processes are finished, the release is ready to be published on github in draft mode.

• [x] Open the new release in draft from here
• [x] Update the link to Docker in the release notes with the link to the latest stable release (search the new tag on docker hub )
• [ ] Update the description of the release details
• [x] Publish the release

Update ReadTheDocs

• [x] create on ReadTheDocs project the version build for vYYYY.XX.mm (click on "Versions" and activate the version of the tag, created when release was published)
• [x] Update Default version to point the release version in the Advanced Settings menu of the ReadTheDocs admin panel

Finalize Release

• [x] Run the Post Release workflow on github with the following parameters:
  • Use workflow from branch YYYY.XX.xx (the release branch)
  • Version of Java Packages to restore accordingly with release calendar with -SNAPSHOT E.g. 1.7-SNAPSHOT
• [ ] Write to the mailing list about the current release news and the next release major changes
• [x] Optional - prepare a PR for updating release procedure, if needed
• [x] Close this issue
• [x] Close the related milestone YYYY.XX.mm

Other useful information

[tdipisa]

@ElenaGallo issue is ready. You can take care of your part regarding functional tests and check list above within the schedule we have agreed.

[ElenaGallo]

the test run is ready here

[ElenaGallo]

@tdipisa all tests passed on the test run

[tdipisa]

It seems we are ready to proceed here as scheduled @offtherailz.