Official Get Started of MicroProfile

88 views
Skip to first unread message

Bruno Borges

unread,
Aug 18, 2018, 12:50:25 AM8/18/18
to Eclipse MicroProfile
Hi all,

Is there an official Get Started Guide for MicroProfile somewhere, maintained by the project committee and interested parties? 

Thanks

Arjan Tijms

unread,
Aug 18, 2018, 7:20:47 AM8/18/18
to Eclipse MicroProfile
Hi Bruno,

Not so much a guide, but perhaps the samples repo can help you started. 


Each sample is a small application that you can run individually. There are tests included that show how to run them, and actually test them via profiles against the various implementations of MicroProfile such as Payara.

Kind regards,
Arjan

Ken Finnigan

unread,
Aug 20, 2018, 9:59:03 AM8/20/18
to Eclipse MicroProfile
Arjan,

Is that an official MP samples repo? I wasn't aware of this repository until this thread.

It seems tied to MP 1.2 and hasn't been updated in a while. Also it doesn't contain all MP implementations as profiles.

There is also https://github.com/eclipse/microprofile-samples and https://github.com/eclipse/microprofile-conference that are officially part of the MP community.

Ken

Arjan Tijms

unread,
Aug 20, 2018, 6:44:11 PM8/20/18
to Eclipse MicroProfile
Hi,


On Monday, August 20, 2018 at 3:59:03 PM UTC+2, Ken Finnigan wrote:
Arjan,

Is that an official MP samples repo? I wasn't aware of this repository until this thread.

I  mentioned the repo a couple of times in this group, and tweeted about it as well. It's not an official MP samples repo, but if people want to make it official then that would be fine by me. Many people from different companies and organisations already have access to that org, a couple as admin even. It just seems that many people except for the WildFly Swarm/Thorntail team has forgotten about it.

 
It seems tied to MP 1.2 and hasn't been updated in a while. Also it doesn't contain all MP implementations as profiles.

Well, 4 months since the last update. Repos are organised per MP version, and the changes for 1.3 and 1.4 were relatively small hence why it's still at 1.2. By coincidence I was just planning to add new samples this or next week.

As for the profiles, I suggested John to do a PR, but he hasn't done so yet. See https://github.com/javaee-samples/microprofile1.2-samples/issues/1
 
There is also https://github.com/eclipse/microprofile-samples and https://github.com/eclipse/microprofile-conference that are officially part of the MP community.

I know, but these were not moving forward at all, plus if I'm not mistaken that repo was about a single show case application, and not about individual micro samples each demo'ing a single microprofile feature.

Kind regards,
Arjan

Ken Finnigan

unread,
Aug 21, 2018, 9:42:34 AM8/21/18
to Eclipse MicroProfile


On Monday, August 20, 2018 at 6:44:11 PM UTC-4, Arjan Tijms wrote:
Hi,

On Monday, August 20, 2018 at 3:59:03 PM UTC+2, Ken Finnigan wrote:
Arjan,

Is that an official MP samples repo? I wasn't aware of this repository until this thread.

I  mentioned the repo a couple of times in this group, and tweeted about it as well. It's not an official MP samples repo, but if people want to make it official then that would be fine by me. Many people from different companies and organisations already have access to that org, a couple as admin even. It just seems that many people except for the WildFly Swarm/Thorntail team has forgotten about it.

 
It seems tied to MP 1.2 and hasn't been updated in a while. Also it doesn't contain all MP implementations as profiles.

Well, 4 months since the last update. Repos are organised per MP version, and the changes for 1.3 and 1.4 were relatively small hence why it's still at 1.2. By coincidence I was just planning to add new samples this or next week.

There were 3 new specs in MP 1.3 which I consider quite important in terms of cloud deployments, such as Open API and Open Tracing.
 

As for the profiles, I suggested John to do a PR, but he hasn't done so yet. See https://github.com/javaee-samples/microprofile1.2-samples/issues/1
 
There is also https://github.com/eclipse/microprofile-samples and https://github.com/eclipse/microprofile-conference that are officially part of the MP community.

I know, but these were not moving forward at all, plus if I'm not mistaken that repo was about a single show case application, and not about individual micro samples each demo'ing a single microprofile feature.

My only concern is spreading the community too thin in terms of what to maintain, and ensuring we're promoting what we want promoted.

I know both samples and conference have fallen behind, so maybe it's time to decide whether we want to continue working with them or archive them.

Ken

Arjan Tijms

unread,
Aug 21, 2018, 11:42:55 AM8/21/18
to Eclipse MicroProfile
Hi,


On Tuesday, August 21, 2018 at 3:42:34 PM UTC+2, Ken Finnigan wrote:
I know, but these were not moving forward at all, plus if I'm not mistaken that repo was about a single show case application, and not about individual micro samples each demo'ing a single microprofile feature.

My only concern is spreading the community too thin in terms of what to maintain, and ensuring we're promoting what we want promoted.

I understand, though it may work both ways, or even multiple ways. For all its faults, https://github.com/javaee-samples is a pretty well known and established org. Spreading different samples for strongly related technologies all over the place isn't fully ideal either, hence why I created the repo there.

Note that it's not *my* org, but it's a multi vendor org where many different people are in. Roberto Cortez from Apache, Antoine from Red Hat, John Ament from Hammock and Eclipse, Markus Eisele from Lightbend, Reza Rahman as individual, and many more.

Of course https://github.com/eclipse/microprofile-samples would indeed be a logical place too, but last I remember was that a very enthusiastic person was going to give it a major impulse and everyone in this group was massively giving that +1's. So since I didn't want to interfere with that, but still liked the idea of having the samples at a central place, I started that MP repo there.

Only then nothing ever happened at https://github.com/eclipse/microprofile-samples, which is why currently https://github.com/javaee-samples just happened to be the only place with a collection of samples for MicroProfile that target multiple implementations, and that's why I referred Bruno to it. No ill intentions ;)

Kind regards,
Arjan


 

Arjan Tijms

unread,
Aug 22, 2018, 6:58:02 PM8/22/18
to Eclipse MicroProfile
Hi,


On Tuesday, August 21, 2018 at 3:42:34 PM UTC+2, Ken Finnigan wrote:
I know both samples and conference have fallen behind, so maybe it's time to decide whether we want to continue working with them or archive them.

The biggest problem is that deciding is one thing, but actually doing it is in practice quite another. Intends can be good, but there's always the one customer issue, that one other deadline, the shed at home that needs to be fixed etc.

Anyway, so not to get too much offtopic, the MP samples in the java ee samples org are steadily increasing. I just committed 5 new samples for Open API and Rest Client. See here: https://github.com/javaee-samples/microprofile1.4-samples

So I hope that takes away one concern of you that they hadn't been updated for 4 months ;)

These samples could be moved to https://github.com/eclipse/microprofile-samples although I'm not sure who has access to that repo now.

Kind regards,
Arjan
 

John Clingan

unread,
Aug 23, 2018, 5:24:30 AM8/23/18
to Eclipse MicroProfile
IMHO, this is a gap we need to fill. We need a "get started" page. IMHO, a link to a tutorial that utilizes Rudy's MicroProfile Starter would be good. Actually, I may write up that tutorial since I've done it in other contexts.


On Saturday, August 18, 2018 at 6:50:25 AM UTC+2, Bruno Borges wrote:

Arjan Tijms

unread,
Aug 23, 2018, 4:09:40 PM8/23/18
to Eclipse MicroProfile
Fyi, I just added 2 more samples for MP 1.4: https://github.com/javaee-samples/microprofile1.4-samples/tree/master/jwt-auth

It brings the total to 7 now. Contributions are welcome.

Cesar Saavedra

unread,
Sep 18, 2018, 1:31:27 PM9/18/18
to Eclipse MicroProfile
-1 on MicroProfile samples living in a GitHub repo for Java EE.  We are already working with Rudy on bringing start.microprofile.io online.

The more samples, the better though. Arjan, would you consider moving your samples to another repo?

Thanks,
Cesar

Arjan Tijms

unread,
Sep 18, 2018, 1:56:00 PM9/18/18
to Eclipse MicroProfile


On Tuesday, September 18, 2018 at 7:31:27 PM UTC+2, Cesar Saavedra wrote:
-1 on MicroProfile samples living in a GitHub repo for Java EE.  We are already working with Rudy on bringing start.microprofile.io online.

The more samples, the better though. Arjan, would you consider moving your samples to another repo?

Yeah, sure, no problem. Just need to organise a PR then as in EE samples they are in different repos.

Cesar Saavedra

unread,
Sep 28, 2018, 4:39:02 AM9/28/18
to microp...@googlegroups.com
Thank you Arjan.

@Emily: could you please create a repo under EF, just like you did for starter, for the MicroProfile samples transfer?

Thanks,
Cesar

--
You received this message because you are subscribed to a topic in the Google Groups "Eclipse MicroProfile" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/microprofile/adTEtF2zMDw/unsubscribe.
To unsubscribe from this group and all its topics, send an email to microprofile...@googlegroups.com.
To post to this group, send email to microp...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/microprofile/32e22c93-1359-41c6-81a1-10c48f8f3a6f%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
--
Cesar Saavedra
Senior Principal Technical Product Marketing Manager

Emily Jiang

unread,
Sep 28, 2018, 6:43:19 AM9/28/18
to Eclipse MicroProfile
Sure. Can we agree on the repo name?

microprofile-demo?

Thanks
Emily

Ken Finnigan

unread,
Sep 28, 2018, 7:10:30 AM9/28/18
to microp...@googlegroups.com
Could we not just reuse https://github.com/eclipse/microprofile-samples as opposed to adding another repo?

Ken

Sent from my iPhone
You received this message because you are subscribed to the Google Groups "Eclipse MicroProfile" group.
To unsubscribe from this group and stop receiving emails from it, send an email to microprofile...@googlegroups.com.

To post to this group, send email to microp...@googlegroups.com.

Cesar Saavedra

unread,
Sep 28, 2018, 7:32:59 AM9/28/18
to MicroProfile

Gaurav Gupta

unread,
Sep 28, 2018, 7:58:48 AM9/28/18
to microp...@googlegroups.com

Arjan Tijms

unread,
Sep 28, 2018, 9:27:10 AM9/28/18
to Eclipse MicroProfile
Hi,

Okay, seems the majority vote is for re-using the existing samples one then ;)

Kind regards,
Arjan
Reply all
Reply to author
Forward
0 new messages