Skip to content

Commit 30b25cd

Browse files
committed
docs: adapt artifact checks to new ATR tool
We're already reaping rewards for using ATR (checks+voting+email support), and I want us to do both the old way AND the new way for now. I'll consider the old release process in "soft deprecation" as the ATR matures.
1 parent f4aa114 commit 30b25cd

File tree

3 files changed

+10
-3
lines changed

3 files changed

+10
-3
lines changed

fineract-doc/src/docs/en/chapters/release/process-step01.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@
44

55
The RM should, if one doesn't already exist, first create a new release umbrella issue in JIRA. This issue is dedicated to tracking (a summary of) any discussion related to the planned new release. An example of such an issue is https://issues.apache.org/jira/browse/FINERACT-873[FINERACT-873].
66

7+
Next, the RM logs in to https://release-test.apache.org[the ATR (ASF Trusted Releases)] tool and clicks "+ Start a new release", naming the release `{revnumber}`.
8+
79
The RM then creates a list of resolved issues & features through an initial check in JIRA for already resolved issues for the release, and then setup a timeline for release branch point. The time for the day the issue list is created to the release branch point must be at least two weeks in order to give the community a chance to prioritize and commit any last minute features and issues they would like to see in the upcoming release.
810

911
The RM must then send the pointer to the umbrella issue along with the tentative timeline for branch point to the developer lists. Any work identified as release related that needs to be completed should be added as a sub tasks of the umbrella issue to allow all developers and users to see the overall release progress in one place. The umbrella issue shall also link to any issues still requiring clarification whether or not they will make it into the release.

fineract-doc/src/docs/en/chapters/release/process-step08.adoc

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,11 @@ Next we'll stage the release candidate. Create a new folder and add these files:
1111
* apache-fineract-src-{revnumber}.tar.gz.sha512
1212
* apache-fineract-src-{revnumber}.tar.gz.asc
1313

14-
These files (or "artifacts") comprise the release candidate. Upload these files to https://www.apache.org/legal/release-policy.html#stage[ASF's distribution dev/staging area] like so:
14+
These files (or "artifacts") comprise the release candidate.
15+
16+
First, upload these files to https://release-test.apache.org/compose/fineract/{revnumber}. This tool will initiate automated checks on the files. We'll come back to those in next step and ensure they pass.
17+
18+
Next, upload these files to https://www.apache.org/legal/release-policy.html#stage[ASF's distribution dev/staging area] like so:
1519

1620
[source,bash,subs="attributes+"]
1721
----

fineract-doc/src/docs/en/chapters/release/process-step09.adoc

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22

33
== Description
44

5-
Following are the typical things we need to verify before voting on a release candidate. And the release manager should verify them too before calling out a vote.
5+
Following are the typical things we need to verify before voting on a release candidate. And the release manager should verify them too before calling out a vote. Some of these checks are duplicated by https://release-test.apache.org[the ATR (ASF Trusted Releases) tool], and will need to continue to be duplicated until we get more comfortable with that tool.
66

7-
Make sure release artifacts are hosted at https://dist.apache.org/repos/dist/dev/fineract
7+
Make sure release artifacts are hosted at both https://release-test.apache.org/compose/fineract/{revnumber} AND https://dist.apache.org/repos/dist/dev/fineract
88

99
* Release candidate files should match filenames mentioned earlier, and will be moved without renaming if/when the release vote passes.
1010
* Verify signatures and hashes. You may have to import the public key of the release manager to verify the signatures. (`gpg --import KEYS` or `gpg --recv-key <key id>`)
@@ -14,6 +14,7 @@ Make sure release artifacts are hosted at https://dist.apache.org/repos/dist/dev
1414
* All files have correct headers (Rat check should be clean - `./gradlew rat`)
1515
* No jar files in the source artifacts
1616
* All tests pass both in CI and locally
17+
* All ATR checks pass
1718

1819
=== Artifact verification
1920

0 commit comments

Comments
 (0)