uPortal-start: releases? Or articulate why no releases?

31 views
Skip to first unread message

Andrew Petro

unread,
May 3, 2018, 4:49:23 PM5/3/18
to uPortal Developers
So, uPortal-start. I think it should either cut releases, or it should articulate clearly why it's not cutting releases.

Otherwise it fails a smell test: one of the first things I look at to see if something seems like it might be any good on GitHub is whether it has releases. No releases? It's probably not being maintained.

This relates to but is not quite the same as our recent discussion of what branches uPortal-start should have and what releases of uPortal it ought to rely upon.

(Context: following up on an action item I took in the most recent uPortal-steering meeting , I think part of a more general theme of tightening up loose ends going into Open Apereo.)

I'd like to give this a chance for discussion and perspectives. Nonetheless where I think this is going is uPortal-start is intentionally not going to be cutting releases and we just need to update the README to be clearer that and why this is the case. I'm willing to take a stab at a Pull Request adding that articulation, once it becomes clear here on uportal-dev@ that that's where this is going.

As ever,

Andrew

Julien Gribonvald

unread,
May 4, 2018, 9:35:29 AM5/4/18
to uport...@apereo.org

Thanks Andrew,

In my point of view uPortal-start is only a CLI to deploy uPortal eco-system apps, so cutting a release per new uPortal release don't make sense for me. Also when I watch on a github project I'm not watching only on release but on the last update of sources (to see if there is a good activity) + commit frequency and if there are several contributors. Also I go more easily on master branch when developping than on release, expect for some case (big projects where a stability is needed when I won't be able or have time to look for patching/ purpose bug fix).

After, to explain my process of my work on uPortal deployment:

Until I stay in development process I won't take care of a release on uPortal-Start as I will try always to be on the last version on master, so in this case the important thing for me is to keep updated dependencies version when a new release is created on theses importants dependencies (of uPortal and portlets).

For the case when I'm in production with a version I will need only to keep updated for security path but I won't go on new uPortal version without a qualification phase that will take some times (so no more than one time per year). So in this case I will watch on github which last commit of the uPortal-start I will use, and if there is a compatibility problem from different uPortal version I will be happy to see a specific branch for my uPortal major version (it's if it makes 2 years that I didn't updated anything).


So for me the important thing to say is : "uPortal-start is only a CLI to deploy an uPortal version with uPortal eco-system apps, so it don't need a release on each new release of all these apps, so just find the commit that will suit your needs !", but the important thing is to be efficient on version change of dependencies and we should be sure that an update of a version won't break any compatibility with all other apps.


Hoping that was understandable for the discussion !

Regards,
 
Julien
--
You received this message because you are subscribed to the Google Groups "uPortal Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email to uportal-dev...@apereo.org.
Visit this group at https://groups.google.com/a/apereo.org/group/uportal-dev/.

Julien Gribonvald

unread,
May 4, 2018, 10:37:41 AM5/4/18
to uport...@apereo.org
Le 04/05/2018 à 15:19, Andrew W Petro a écrit :

wrt "just find the commit that will suit your needs"


If there's a commit that will suit multiple adopters' needs, well, that starts to sound like a release, doesn't it?


It's hard to find the limit of releasing in this case, as if you publish a new release of a portlet you will also need to cut a new release of uPortal-start ?

In my point of view having only a branch per major release would be suffisant and maybe it's too much for some cases. Having a release process on uPortal-start take a sence only if a new feature appear on the uPortal-start and that need to cut the current branch update. In my mind when updating only the uPortal version, even on a major version, which doesn't need a "featured update" / "breaking change" on uPortal-start it won't need a uPortal-start release.

Julien

--
Julien Gribonvald

Benito J. Gonzalez

unread,
May 5, 2018, 4:59:27 PM5/5/18
to uport...@apereo.org
Hi folks,

Three ideas strike me on this topic.

No releases.
An implementor starts at some point and starts tweaking for their
environment. They run some upstream merges to get updates. What did they
pick up? Could be anything. Why should the upgrade? Maybe their heard of
something added recently from this mailing list. Did they spend some
time figuring out their last pull and how upstream master deviated?

Sync'ed releases with uPortal
An implementors wants the latest version of uPortal. They upgrade
uPortal-start to pick it up. Are there releases notes to share what new
CLI features have been added since the previous uPortal version?

Separate releases for uPortal-start
An implementor is tooling along with uPortal and portlet upgrades. They
have a need for a new CLI tool or heard of a new one from the community.
They look at the release notes and find it's been included in a newer
release?

I lean toward separate releases where they follow SemVer (Semantic
Versioning) for the features in that project. Chores of keeping the
latest version of projects would not even rise to "bug fix" releases. I
suggest we note in the readme that the project follows SemVer for the
tooling, but does not cut releases for version upgrades on the projects.

Just thinking out loud,
-bjagg

--
Benito J. Gonzalez
Senior Software Developer
Unicon, Inc.
Voice: 480.558.2360
Text: 209.777.2754
Email: bgon...@unicon.net
GitHub: bjagg
GitLab: bjagg
BitBucket: bjagg

Christian Murphy

unread,
May 14, 2018, 1:51:16 PM5/14/18
to uport...@apereo.org
To me, uPortal start is a collection of per adopter customization. We provide meaningful versions out of uPortal, uPortal-start consumes them and customizes them. uPortal-start releases make sense at the adopter level. The code gets pushed to an environment, that is a release.

I'm not sure they make sense at the open source uPortal-start level. AFAIK, there currently are no cross-adopter shared artifacts from uPortal-start to version, and if there are some share artifacts. It would be arguably better to move those into uPortal core so they get versioned alongside the rest of the project. Keeping uPortal-start focused on customizations.

Best Regards,

Christian Murphy

jmt

unread,
May 15, 2018, 2:31:32 PM5/15/18
to uPortal Developers
I don't think that there should be releases of uPortal-start.
Announcements of updated uPortal and portlets have been helpful with regards to staying on top of the latest and greatest. Maintaining an instance of uPortal using uPortal-start has been a lot easier as opposed to before where we would have to carefully merge the rel-x-y-patches branch and hope nothing gets clobbered in the process.

Therefore README.md should be updated to state that

My .01

- Jonathan

Christian Murphy

unread,
May 15, 2018, 2:39:18 PM5/15/18
to uPortal Developers
I'd second Jonathan's thought on announcing changes.
I also think having a changleog.md or history.md file tracking when uPortal ecosystem updates are applied to uPortal-start could help.

Best Regards,

Christian Murphy

--

Benito J. Gonzalez

unread,
May 16, 2018, 1:48:06 PM5/16/18
to uport...@apereo.org
I would just like to emphasize that there is tooling in uPortal-start;
it is more that just captured versions of other modules. Versioning will
be helpful in determining that a deployer is missing some cool Gradle task.

Hope this helps,
-bjagg
> Voice:  480.558.2360 <tel:(480)%20558-2360>
>  Text:  209.777.2754 <tel:(209)%20777-2754>
> Email:  bgon...@unicon.net <mailto:bgon...@unicon.net>
> GitHub:  bjagg
> GitLab:  bjagg
> BitBucket:  bjagg
>
> --
> You received this message because you are subscribed to the Google
> Groups "uPortal Developers" group.
> To unsubscribe from this group and stop receiving emails from it,
> send an email to uportal-dev...@apereo.org
> <mailto:uportal-dev%2Bunsu...@apereo.org>.
> --
> You received this message because you are subscribed to the Google
> Groups "uPortal Developers" group.
> To unsubscribe from this group and stop receiving emails from it, send
> an email to uportal-dev...@apereo.org
> <mailto:uportal-dev...@apereo.org>.
Reply all
Reply to author
Forward
0 new messages