You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2021/03/28 12:07:43 UTC

[isis] branch master updated: ISIS-2484: removes page relating to interim releases

This is an automated email from the ASF dual-hosted git repository.

danhaywood pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/isis.git


The following commit(s) were added to refs/heads/master by this push:
     new 4007586  ISIS-2484: removes page relating to interim releases
4007586 is described below

commit 400758656513149a7e8f35c5256687a410e0fd13
Author: danhaywood <da...@haywood-associates.co.uk>
AuthorDate: Sun Mar 28 13:07:27 2021 +0100

    ISIS-2484: removes page relating to interim releases
    
    as we now publish nightly builds as a matter of course
---
 antora/components/comguide/modules/ROOT/nav.adoc   |  1 -
 .../comguide/modules/ROOT/pages/about.adoc         |  2 -
 .../release-process-for-interim-releases.adoc      | 74 ----------------------
 interim-release.sh                                 | 56 ----------------
 4 files changed, 133 deletions(-)

diff --git a/antora/components/comguide/modules/ROOT/nav.adoc b/antora/components/comguide/modules/ROOT/nav.adoc
index 44d2387..b6723f8 100644
--- a/antora/components/comguide/modules/ROOT/nav.adoc
+++ b/antora/components/comguide/modules/ROOT/nav.adoc
@@ -7,7 +7,6 @@
 * xref:verifying-releases.adoc[Verifying Releases]
 * xref:post-release-successful.adoc[Post Release (Successful)]
 * xref:post-release-unsuccessful.adoc[Post Release (Unsuccessful)]
-* xref:release-process-for-interim-releases.adoc[Interim Releases]
 * xref:key-generation.adoc[Key Generation]
 * xref:algolia-search.adoc[Appendix: Algolia Search]
 * xref:release-process-prereqs.adoc[Appendix: Release Process Prereqs]
diff --git a/antora/components/comguide/modules/ROOT/pages/about.adoc b/antora/components/comguide/modules/ROOT/pages/about.adoc
index 750f13e..290bed3 100644
--- a/antora/components/comguide/modules/ROOT/pages/about.adoc
+++ b/antora/components/comguide/modules/ROOT/pages/about.adoc
@@ -18,8 +18,6 @@ This committers' guide is for committers of Apache Isis itself who want guidance
 //
 //include::post-release-unsuccessful.adoc[leveloffset=+1]
 //
-//include::release-process-for-interim-releases.adoc[leveloffset=+1]
-//
 //include::antora-publish-procedure.adoc[leveloffset=+1]
 //
 //include::key-generation.adoc[leveloffset=+1]
diff --git a/antora/components/comguide/modules/ROOT/pages/release-process-for-interim-releases.adoc b/antora/components/comguide/modules/ROOT/pages/release-process-for-interim-releases.adoc
deleted file mode 100644
index 08c8cd4..0000000
--- a/antora/components/comguide/modules/ROOT/pages/release-process-for-interim-releases.adoc
+++ /dev/null
@@ -1,74 +0,0 @@
-[[release-process-for-interim-releases]]
-= Interim Releases
-
-:Notice: 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 ag [...]
-:page-partial:
-
-
-
-
-
-
-The intent of an "interim" release is to allow a developer team to release their application based on a `-SNAPSHOT` version of the framework.
-Since `-SNAPSHOT` changes on a day-to-day basis, the idea is to tag a particular revision and to release this, thereby providing stability/traceability for the application being developed.
-
-Whereas xref:comguide:ROOT:cutting-a-release.adoc.adoc[formal release]s are public (released through the Maven repository maintained by Apache Software Foundation), interim releases are non-public and rely on infrastructure provided by a developer team.
-The tagged release resides __not__ in the
-xref:docs:ROOT:downloads/how-to.adoc#source-code[official Apache Isis git repository], but instead in a fork/clone maintained by the developer team.
-
-== Prerequisites
-
-Create a remote fork/clone of the Apache Isis repository (eg using link:http://github.com[github] or link:http://bitbucket.org[bitbucket] or similar), and ensure that your local fork specifies this remote.
-
-Also, set up a CI server against your fork/clone, to build against any branches called `origin/interim/*`.
-To build it should use the command:
-
-[source,bash]
-----
-mvn clean install -Dskip.app
-----
-
-The CI server should then also publish the resultant artifacts to a local Maven repository.
-For example, Jenkins provides post-build plugins to perform such a task.
-
-== Sanity Check
-
-Ensure that the framework builds ok using the same command that your CI server is set up to execute (see section above).
-
-== Release
-
-Deploy the framework using:
-
-[source,bsah]
-----
-sh interim-release.sh xxx yyyyy
-----
-
-where `xxx` is the most recent release of Isis (to act as the base), and `yyyyy` is the name of the remote.
-
-For example,
-
-[source,bash]
-----
-sh interim-release.sh 1.13.0 incodehq
-----
-
-This will result in a new branch and tagged being pushed to the remote, with an appropriate version (details below).
-
-As noted in the prereqs (above), the CI server configured should then detect the new branch (or tag, if you prefer), build the framework (skipping application and architecture, as in the prerequisites) and then publish the resultant artifacts to a private Maven repo.
-
-=== Implementation details
-
-The script itself:
-
-* removes any local branches called `interim/*`
-* creates a new branch called `interim/YYYYmmDD-HHMM`
-** eg `interim/1.13.0.20160909-0758`
-* updates the version of the pom.xml to the baseline plus the date
-** eg `<version>1.13.0.20160909-0758</version>`
-* commits the changes and tags the new commit
-** eg `isis-1.13.0.20160909-0758`
-* removes any remote branches called `interim/*`
-* pushes both the branch and the tag to the remote.
-
-
diff --git a/interim-release.sh b/interim-release.sh
deleted file mode 100644
index 5fc943e..0000000
--- a/interim-release.sh
+++ /dev/null
@@ -1,56 +0,0 @@
-#!/bin/bash
-VERSION_BASE=$1
-REMOTE=$2
-
-if [ -z "$VERSION_BASE" -o -z "$REMOTE" ]; then
-    echo "usage: $(basename $0) [base version] [remote]"
-    echo "   eg: $(basename $0) 1.13.0 incodehq"
-    exit 1
-fi
-
-DATE=`date +'%Y%m%d-%H%M'`
-
-VERSION="$VERSION_BASE.$DATE"
-BRANCH="interim/$VERSION"
-TAG="interim/isis-$VERSION"
-
-CURR_BRANCH=`git rev-parse --abbrev-ref HEAD`
-
-echo "checking out new branch $BRANCH"
-git checkout -b "$BRANCH"
-
-echo "updating version in all pom.xml files..."
-pushd isis-parent >/dev/null
-mvn versions:set -DnewVersion=$VERSION > /dev/null
-popd >/dev/null
-pushd starter >/dev/null
-mvn versions:set -DnewVersion=$VERSION > /dev/null
-popd >/dev/null
-
-echo "Committing changes"
-git commit -am "bumping to $VERSION"
-
-echo "Building"
-mvn clean install -o
-
-echo "tagging"
-git tag $TAG
-
-echo "pushing tag"
-git push $REMOTE $TAG
-
-echo "removing any earlier remote branches"
-for a in `git ls-remote --heads $REMOTE  | sed 's?.*refs/heads/??' | grep interim`
-do
-    git push $REMOTE --delete $a
-done
-
-# need to push branch, so will be picked up for building by CI
-echo "pushing branch"
-git push $REMOTE $BRANCH
-
-echo "switching back to original branch"
-git checkout $CURR_BRANCH
-
-echo "and deleting interim branch"
-git branch -D $BRANCH