FINERACT-1470: Fineract release plugin

2022-05-04 15:11:53 +02:00
parent b185937962
commit 40eb547a5c
160 changed files with 4954 additions and 638 deletions
@@ -0,0 +1,38 @@
+<#--
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements. See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership. The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied. See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+-->
+
+
+[INSTRUCTIONS:START]
+
+As discussed in https://issues.apache.org/jira/browse/FINERACT-1154, now that everything is final, please do the following to remove the release branch (and just keep the tag),
+and make sure that everything on the release tag is merged to develop and that e.g. git describe works:
+
+>> git checkout develop
+>> git branch -D ${project['fineract.release.version']}
+>> git push origin :${project['fineract.release.version']}
+>> git checkout develop
+>> git checkout -b merge-${project['fineract.release.version']}
+>> git merge -s recursive -Xignore-all-space ${project['fineract.release.version']}
+>> git commit
+>> git push <USER>
+>> hub pull-request
+
+[INSTRUCTIONS:END]
@@ -0,0 +1,28 @@
+<#--
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements. See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership. The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied. See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+-->
+
+
+[INSTRUCTIONS:START]
+
+Finally update the https://fineract.apache.org website with the latest release details.
+The website's HTML source code is available at https://github.com/apache/fineract-site.
+
+[INSTRUCTIONS:END]
@@ -0,0 +1,39 @@
+<#--
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements. See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership. The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied. See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+-->
+
+
+[INSTRUCTIONS:START]
+
+Before a release is done, make sure that any issues that are fixed have their fix version setup correctly.
+
+"project = FINERACT and resolution = fixed and fixVersion is empty"
+
+Move all unresolved JIRA issues which have this release as Fix Version to the next release
+
+"project = FINERACT and fixVersion = ${project['fineract.release.version']} and status not in ( Resolved, Done, Accepted, Closed )"
+
+You can also run the following query to make sure that the issues fixed for the to-be-released version look accurate:
+
+"project = FINERACT and fixVersion = ${project['fineract.release.version']}"
+
+Finally, check out the output of the JIRA release note tool to see which tickets are included in the release, in order to do a sanity check.
+
+[INSTRUCTIONS:END]
@@ -0,0 +1,29 @@
+<#--
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements. See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership. The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied. See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+-->
+
+
+[INSTRUCTIONS:START]
+
+You first need to close the release in JIRA so that the about to be released version cannot be used as "fixVersion" for new bugs anymore.
+Go to JIRA "Administer project" page and follow "Versions" in left menu. Table with list of all releases should appear, click on additional menu on the right of your release and choose "Release" option.
+Submit release date and you're done.
+
+[INSTRUCTIONS:END]
@@ -0,0 +1,38 @@
+<#--
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements. See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership. The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License. You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied. See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+-->
+
+
+[INSTRUCTIONS:START]
+
+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.
+
+Make sure release artifacts are hosted at https://dist.apache.org/repos/dist/dev/fineract
+
+* Release candidates should be in format apache-fineract-${project['fineract.release.version']}-binary.tar.gz
+* Verify signatures and hashes. You may have to import the public key of the release manager to verify the signatures. (`gpg --recv-key <key id>`)
+* Git tag matches the released bits (diff -rf)
+* Can compile successfully from source
+* Verify DISCLAIMER, NOTICE and LICENSE (year etc)
+* All files have correct headers (Rat check should be clean - gradlew rat)
+* No jar files in the source artifacts
+* Integration tests should work
+
+[INSTRUCTIONS:END]