diff --git a/release.md b/release.md index ab1574b2e..f9e52f214 100644 --- a/release.md +++ b/release.md @@ -172,30 +172,32 @@ tool [`release.py`](https://github.com/gazebo-tooling/release-tools/blob/master/ ![release.py interactions](releasing/images/releasepy_execution.png) -Actions for releasing a new version of library (note that it can starts with -ign or gz, ign/gz is used for this propose) `foo` with major version `X`: +Actions for releasing a new version of library `gz-foo` with major version `X`: 1. [`release.py`](https://github.com/gazebo-tooling/release-tools/blob/master/release.py) - will generate a local tarball with the source code of the new version and - upload it to `osrf-distributions S3`. - 1. `release.py` will start the following jobs in the build server + will tag the local repository and call `gz-fooX-source` to generate the sources + corresponding to that tag. + 1. `gz-fooX-source` will generate a tarball with the source code of the new version and + call `repository_uploader_packages` to upload the tarball to `osrf-distributions S3`. + 1. `gz-fooX-source` will call `_releasepy` with the tarball URI information. + 1. `_releasepy` will start the following jobs in the build server `build.osrfoundation.org`: - 1. `ign/gz-fooX-debbuilder`: multiple calls for different Debian/Ubuntu releases + 1. `gz-fooX-debbuilder`: multiple calls for different Debian/Ubuntu releases 1. [`generic-release-homebrew_pull_request_updater`](https://build.osrfoundation.org/job/generic-release-homebrew_pull_request_updater/): one call for Homebrew macOS release 1. `build.osrfoundation.org` jobs start the work of creating releases: - 1. `ign/gz-fooX-debbuilder`: use tarball with release sources and metadata from `ign/gz-fooX-release` + 1. `gz-fooX-debbuilder`: use tarball with release sources and metadata from `gz-fooX-release` 1. `generic-release-homebrew_pull_request_updater`: use [`homebrew-simulation`](https://github.com/osrf/homebrew-simulation/) repository metadata together with the release sources 1. The output of the first round of initial jobs triggered by `release.py` is different: - 1. `ign/gz-fooX-debbuilder`: builds the Debian/Ubuntu .deb packages and + 1. `gz-fooX-debbuilder`: builds the Debian/Ubuntu .deb packages and passes them to the `repository_uploader_packages` job 1. `generic-release-homebrew_pull_request_updater`: opens a new PR to coordinate the release process in `homebrew-simulation` 1. [`repository_uploader_packages`](https://build.osrfoundation.org/job/repository_uploader_packages/) - imports the packages created by the `ign/gz-fooX-debbuilder` job (there will be + imports the packages created by the `gz-fooX-debbuilder` job (there will be one build for each platform combination of Ubuntu/Debian release and architecture) and uploads the .deb packages to `packages.osrfoundation.org` and [`osrf-distributions S3`](http://gazebosim.org/distributions). diff --git a/releasing/images/releasepy_execution.png b/releasing/images/releasepy_execution.png index b182e2394..933f6cb37 100644 Binary files a/releasing/images/releasepy_execution.png and b/releasing/images/releasepy_execution.png differ diff --git a/releasing/images/releasepy_execution.svg b/releasing/images/releasepy_execution.svg index 3b685b5b4..5a0bbc546 100644 --- a/releasing/images/releasepy_execution.svg +++ b/releasing/images/releasepy_execution.svg @@ -10,19 +10,22 @@ xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" - width="434.68741" - height="336.08563" - viewBox="0 0 115.01104 88.922659" + width="540.68744" + height="400.08563" + viewBox="0 0 143.05688 105.85599" version="1.1" id="svg8" sodipodi:docname="releasepy_execution.svg" - inkscape:version="0.92.3 (2405546, 2018-03-11)"> + inkscape:version="0.92.5 (2060ec1f9f, 2020-04-08)" + inkscape:export-filename="/home/jrivero/code/gz/docs/releasing/images/releasepy_execution.png" + inkscape:export-xdpi="95.879997" + inkscape:export-ydpi="95.879997"> + inkscape:isstock="true"> @@ -55,61 +57,77 @@ orient="auto" refY="0" refX="0" - id="marker20258" + id="marker2471" style="overflow:visible" inkscape:isstock="true" inkscape:collect="always"> + + + + d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z" + transform="scale(-0.6)" /> @@ -117,7 +135,7 @@ - - - - - - - - - - - - image/svg+xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + id="g1480" + transform="translate(-5.3755174,-11.463414)"> + id="layer1-3-5-2-3" + inkscape:label="Capa 1" + transform="matrix(0.06064796,0,0,0.06064796,108.11739,43.519828)"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + id="g10-5-2-6" + transform="matrix(0.0423,0,0,0.0423,834.55666,-82.774194)" + class="Graphic"> - - - - + id="g12-4-2-0"> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + build + osrfoundation.org + - build - osrfoundation.org release.py + transform="matrix(0.75957065,0,0,0.75957065,14.011985,-8.3172854)"> ignition-fooXgz-fooX + transform="matrix(0.65272719,0,0,0.65272719,19.390582,-43.334749)"> @@ -5087,7 +6144,7 @@ y="38.865078" x="84.242783" id="tspan5655-4-7-8-7" - sodipodi:role="line">ign-fooX-releasegz-fooX-release - + transform="matrix(0.855986,0,0,0.855986,11.302251,-9.835142)"> @@ -5248,2437 +6300,3386 @@ style="fill:url(#linearGradient2722-2)" inkscape:connector-curvature="0" /> + + + + osrf-distributions + + s3.amazonaws.com + + + + + + + + repository + uploader_packages + + + + + + + github.com + + homebrew-simulation + + + + + + + + + + + d="m 119.5587,47.857506 c 0.0325,0.738619 1.96812,1.333145 4.345,1.333145 2.37011,0 4.29499,-0.590993 4.33807,-1.326716 -0.011,0.0087 -0.0232,0.01727 -0.0344,0.02576 -0.2737,0.665002 -2.09562,1.17855 -4.30364,1.17855 -2.22833,0 -4.06931,-0.517524 -4.31745,-1.191458 -0.009,-0.0065 -0.019,-0.01251 -0.0276,-0.01931 z" /> + + 1 + 2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - osrf-distributions + transform="matrix(0.0891219,0,0,0.0891219,116.32651,51.117049)" + id="g3062-6-2"> - s3.amazonaws.com + id="g2471-9-2" + transform="matrix(0.29301243,0,0,0.29301243,196.31367,96.751863)"> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - repository - uploader_packages - - - - - + id="g17788-2" + transform="translate(-23.359612,-27.460868)"> - github + transform="matrix(0.0891219,0,0,0.0891219,117.62419,52.428608)" + id="g3062-6-21"> - homebrew-simulation + id="g2471-9-7" + transform="matrix(0.29301243,0,0,0.29301243,196.31367,96.751863)"> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - 1 - 2 - - - + transform="matrix(0.0891219,0,0,0.0891219,114.56087,53.50538)" + id="g3062-6-2-7-0"> + transform="matrix(0.0891219,0,0,0.0891219,116.32651,51.117049)" + id="g3062-6-2-6"> + + + + + + + + + + + + + + + + 3 + + + + generic-release + homebrew_triggered_bottle_builder + + 4 + + + + + + + + 5 + + + + + + + build + + bottle + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + id="g16724-3-5-9-7" + transform="matrix(0.05247328,0,0,0.04907765,7.3025064,78.160676)"> + + + + + + + + + + + osrf-distributions + + s3.amazonaws.com + 6 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + id="g2471-9-8-0-6-4-0-6" + transform="matrix(0.02922805,0,0,0.02922805,124.14077,94.387323)"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + id="path3355-12-7-3-7-2-8-3" + inkscape:connector-curvature="0" /> + + + + + + + gz-fooX + source + + + + transform="matrix(0.75957065,0,0,0.75957065,104.48708,63.330318)" + id="g1395-6-7"> + _releasepy + + + + + + + + + + + + + + + + + + + + + transform="matrix(0.0891219,0,0,0.0891219,114.56087,53.50538)" + id="g3062-6-2-7-0-8"> - - - - - - - - - - - - - - - - 3 - - 3 - - - generic-release - homebrew_triggered_bottle_builder - - 4 - - - - - - - - 4 - 5 - - - - - - build + transform="matrix(0.0891219,0,0,0.0891219,116.32651,51.117049)" + id="g3062-6-2-6-9"> - bottle + id="g2471-9-2-5-8" + transform="matrix(0.29301243,0,0,0.29301243,196.31367,96.751863)"> + + + + + + + + + + - - - - - - - - - - - - - - - osrf-distributions - s3.amazonaws.com + id="layer1-1-3-8-0-6" + transform="matrix(0.02467827,0,0,0.02685823,218.9088,116.75322)"> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - 6 - - 7 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + id="g2471-9-8-0-6-4-2-0" + transform="matrix(0.02922805,0,0,0.02922805,103.26384,38.913443)"> + 7 + + + + + 8 + 2 + 5 + 6 + 9