From 502461fc9bdeec3305db3c3ebc29d500d71b49da Mon Sep 17 00:00:00 2001 From: Robbie Gemmell Date: Tue, 26 Apr 2022 16:39:27 +0100 Subject: [PATCH] NO-JIRA: update release instructions to reflect change to CDN, and clarify some bits --- RELEASING.md | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/RELEASING.md b/RELEASING.md index 46f2e2a773..ea332c0715 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -293,18 +293,23 @@ cd activemq-artemis ./promote-release.sh ${CURRENT-RELEASE} ``` -Good mirror coverage can take up to 24 hours. Mirror status can be viewed [here](https://www.apache.org/mirrors/). +It takes a small period to sync with the CDN, say ~15mins. The CDN content can be viewed [here](https://dlcdn.apache.org/activemq/activemq-artemis/). ## Release the staging repo Go to https://repository.apache.org/#stagingRepositories and click the "Release" button. +It takes a small period to sync with Maven Central, say ~30-60mins. The Central content can be viewed [here](https://repo1.maven.org/maven2/org/apache/activemq/). + ## Web site update: -Wait 24 hours after updating SVN to get a good mirror coverage, before proceeding. -Mirror status can be viewed [here](https://www.apache.org/mirrors/). +Wait for the CDN to sync first after updating SVN, and additionally for Maven Central to sync, before proceeding. + +The CDN content can be viewed [here](https://dlcdn.apache.org/activemq/activemq-artemis/). +The Maven Central content can be viewed [here](https://repo1.maven.org/maven2/org/apache/activemq/). + Clone the website repository from: @@ -319,16 +324,17 @@ Once the mirrors are up-to-date then update the following: 2. Copy `src/_artemis_releases/artemis--release.md` to `src/_artemis_releases/artemis--release.md`. Update the versions and dates. 3. Update the _artemis_ list within the `src/_data/current_releases.yml` file if needed. 4. Copy `src/components/artemis/documentation/latest` to `src/components/artemis/documentation/`. -5. Create `src/components/artemis/documentation/latest` and copy these files into it: +5. Build the `artemis-website` module from the new-version release sources with `mvn clean package -Prelease`. +6. Create `src/components/artemis/documentation/latest` and copy these files into it: 1. the contents of user-manual from `apache-artemis-/web/user-manual` 2. book.pdf version of user-manual (generated from the new-version sources at `artemis-website/target/scratch/user-manual/` with the command `gitbook pdf`) 3. book.epub version of user-manual (generated from the new-version sources at `artemis-website/target/scratch/user-manual/` with the command `gitbook epub`) 4. book.mobi version of user-manual (generated from the new-version sources at `artemis-website/target/scratch/user-manual/` with the command `gitbook mobi`) -6. Create `src/components/artemis/documentation/hacking-guide` and copy these files into it: +7. Create `src/components/artemis/documentation/hacking-guide` and copy these files into it: 1. the contents of hacking-guide from `apache-artemis-/web/hacking-guide` 2. book.pdf version of hacking-guide (generated with `gitbook pdf`) -7. Copy `src/components/artemis/documentation/javadocs/javadoc-latest` to `src/components/artemis/documentation/javadocs/javadoc-`. -8. Create `src/components/artemis/documentation/javadocs/javadoc-latest` and copy the contents of `apache-artemis-/web/api` into it. +8. Copy `src/components/artemis/documentation/javadocs/javadoc-latest` to `src/components/artemis/documentation/javadocs/javadoc-`. +9. Create `src/components/artemis/documentation/javadocs/javadoc-latest` and copy the contents of `apache-artemis-/web/api` into it. Run `git add` for all the added directories & files and then `git commit -m "updates for release"`. Once pushed, the changes should be published automatically by the `jekyll_websites` builder of the [apache buildbot](https://ci2.apache.org/#/builders).