Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Gemini/Blueprint/Releasing"
Olaf.x100.de (Talk | contribs) m (→Step 4 - publish the release (or drop it)) |
Olaf.x100.de (Talk | contribs) m |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
== Releasing Gemini Blueprint 2.x == | == Releasing Gemini Blueprint 2.x == | ||
| − | Pre- | + | Pre-requisites: JDK 1.8. Maven 3.3.x. |
| − | === Step 1 - | + | === Step 1 - make sure artifacts are prepared === |
| + | The docs/ module is independent of the maven module structure any may have to be set to the release target version manually in the pom.xml. The docs module | ||
| + | must then be build manually. The resulting generated documentation in target/site/reference must be copied to the gemini website. | ||
| − | + | mvn docbkx:generate-html@single-page && | |
| − | + | mvn docbkx:generate-html@multi-page | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | Make sure the changelog.txt is up to date regarding the included changes of the release. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | === Step | + | === Step 2 - execute staging release === |
| + | Execute the Hudson release staging build (https://hudson.eclipse.org/gemini/view/blueprint/job/gemini-blueprint-stage-release/). After execution, test the staged artifacts. | ||
| + | Go to https://oss.sonatype.org/ and switch to the nexus managed repositories: | ||
| − | + | [[File:gemini-blueprint-releasing-nexus-managed-repos.png]] | |
| − | + | ||
| − | + | There, select the orgeclipsegemini-[NNN] repository created by the build. Download and test the artifacts contained therein: | |
| + | - Are all expected release artifacts contained? | ||
| + | - Are the artifacts versioned as expected? | ||
| − | If you are satisfied with the staged artifacts, copy the staging repo id (e.g., "orgeclipsegemini-1001" in /service/local/repositories/orgeclipsegemini-1001/content/). Provide this as a parameter to the Gemini Blueprint Release | + | === Step 3 - publish the release (or drop it) === |
| + | |||
| + | If you are satisfied with the staged artifacts, copy the staging repo id (e.g., "orgeclipsegemini-1001" in /service/local/repositories/orgeclipsegemini-1001/content/). Provide this as a parameter to the Gemini Blueprint Publish Release Job (https://hudson.eclipse.org/gemini/job/gemini-blueprint-publish-release/). This will irrevocably release the artifacts to maven central. In case you want to discard the staged artifacts execute the Gemini Blueprint Discard Release Job (https://hudson.eclipse.org/gemini/job/gemini-blueprint-discard-release/) with the same repository ID and the staged release version. | ||
[[Category:Gemini Blueprint|Blueprint]] | [[Category:Gemini Blueprint|Blueprint]] | ||
Latest revision as of 18:38, 2 April 2018
Contents
Releasing Gemini Blueprint 2.x
Pre-requisites: JDK 1.8. Maven 3.3.x.
Step 1 - make sure artifacts are prepared
The docs/ module is independent of the maven module structure any may have to be set to the release target version manually in the pom.xml. The docs module must then be build manually. The resulting generated documentation in target/site/reference must be copied to the gemini website.
mvn docbkx:generate-html@single-page && mvn docbkx:generate-html@multi-page
Make sure the changelog.txt is up to date regarding the included changes of the release.
Step 2 - execute staging release
Execute the Hudson release staging build (https://hudson.eclipse.org/gemini/view/blueprint/job/gemini-blueprint-stage-release/). After execution, test the staged artifacts. Go to https://oss.sonatype.org/ and switch to the nexus managed repositories:
There, select the orgeclipsegemini-[NNN] repository created by the build. Download and test the artifacts contained therein: - Are all expected release artifacts contained? - Are the artifacts versioned as expected?
Step 3 - publish the release (or drop it)
If you are satisfied with the staged artifacts, copy the staging repo id (e.g., "orgeclipsegemini-1001" in /service/local/repositories/orgeclipsegemini-1001/content/). Provide this as a parameter to the Gemini Blueprint Publish Release Job (https://hudson.eclipse.org/gemini/job/gemini-blueprint-publish-release/). This will irrevocably release the artifacts to maven central. In case you want to discard the staged artifacts execute the Gemini Blueprint Discard Release Job (https://hudson.eclipse.org/gemini/job/gemini-blueprint-discard-release/) with the same repository ID and the staged release version.