Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Slightly change the releasing process
[simgrid.git] / doc / doxygen / inside_release.doc
index 409a58f..700dd67 100644 (file)
@@ -22,12 +22,12 @@ Please apply the following checklist before releasing.
   - The release dub name matches the one given in ChangeLog file
 - Tests
   - The "make distcheck" target works (tested by jenkins)
-  - All tests pass oneverything on ci + travis/macOS + AppVeyor
+  - All tests pass on everything on ci + AppVeyor
   - Tutorials and derivative projects build correctly
     https://framagit.org/simgrid/simgrid-template-s4u/pipelines
     https://framagit.org/simgrid/external-projects-ci/pipelines
   - The python module builds (see below).
-  - You can have a simgrid.jar from jenkins/macosx + AppVeyor
+  - The java jarfile builds from the github action
 
 @subsection inside_release_c_releasing Actually releasing SimGrid
 
@@ -41,22 +41,21 @@ Please apply the following checklist before releasing.
 - If it's not successful, fix it and push again
 - Once it's successful everywhere: merge 'master' into 'stable' and push it to framagit
   - You can interrupt the build on jenkins, as it was tested just before
-  - This builds the tar.gz and jar artefacts. The old doc says how to do manually if something goes wrong.
-  - Do not merge into 'stable' before appveyor and jenkins are done,
-    or your jarfile will not contain the code you expect for win and mac.
+  - This builds the tar.gz artefact.
 
-- Download the SimGrid-doc-3.X.Y (artefact of pipeline 'pages' on framagit)
-  Download the tgz and jar files (artefacts of the pipeline 'stable' on framagit)
-- Push the archive files (tar.gz and jar) on gforge
+- Download the simgrid-doc-3.X.Y (artefact of pipeline 'pages' on framagit)
+  Download the tgz file (artefact of the pipeline 'stable' on framagit)
+  Build the jar file using the github action
 - Tag the git repository v3.XX.X and push it to framagit and ghub
 - Document the tag on framagit and ghub
-  - Upload the files SimGrid-3.XX.tar.gz, simgrid-3_XX.jar and SimGrid-doc-3_XX.zip
+  - Upload the files simgrid-3.XX.tar.gz, simgrid-3_XX.jar and simgrid-doc-3_XX.zip
   - Add a link to the version of the ChangeLog that comes with this tag.
+    https://framagit.org/simgrid/simgrid/-/blob/v3.29/ChangeLog
 - Update the website
   - emacs org/org-templates/level-0.org to change the release version, the tgz link and the jar link.
   - jed .gitlab-ci.yml
-    - Change the link to the SimGrid-doc-3_XX.zip file 
-    - Only keep 2 versions so that people don't find older ones in google
+    - Change the link to the simgrid-doc-3_XX.zip file
+    - Only keep 2 old versions so that people don't find older ones in google
     - Change the link to latest
   - git commit -a && git push # Check that the pipeline goes well on framagit
 
@@ -86,9 +85,10 @@ Please apply the following checklist before releasing.
   - edit debian/control: s/simgrid3.XX/simgrid3.XY/ 
 - Update the simgrid/package.py for spack: https://gitlab.inria.fr/solverstack/spack-repo
 - Update the Docker images (after pushing to the git)
-  - cd tools/docker && make stable tuto-s4u tuto-smpi push
-  - Update the simgrid-template-s4u repository to test against this new release once the docker is uploaded
-    jed ~/Code/simgrid-template-s4u/.gitlab-ci.yml
+  - cd tools/docker && make stable && make tuto-s4u tuto-smpi tuto-mc
+    The tuto images are built upon the simgrid/stable image
+  - Upload these docker images once built
+  - Once the new images are built, trigger a rebuild of the simgrid-template-{s4u,smpi} repositories on framagit
 
 @subsection inside_release_c_postrelease Post-release cleanups
 
@@ -118,7 +118,7 @@ Release numbering semantic:
   - 3.X.Y where Y is odd: git current status between two releases
     - No expectations on such versions
   - Example
-    - 3.22.4: unannounced/losely documented stable release
+    - 3.22.4: unannounced/loosely documented stable release
     - 3.22.5: git status somewhere between the release of 3.22.4 and the next one
     - 3.23: Documented and announced stable release