Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

classic Classic list List threaded Threaded
8 messages Options
Reply | Threaded
Open this post in threaded view
|

Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

cschneider
Recently I had quite a few issues with the availability of my homepage http://liquid-reality.de .
So I am in the process of moving my whole site to github io pages. The first and most important part is done now.

The Tutorials for Apache Karaf now live at:
https://cschneider.github.io/Karaf-Tutorial/

This has some advantages:
- The tutorials now live closer to the code (same repo)
- You can provide PRs for the tutorials
- The hosting by github should be a lot more stable

Christian

--
--
Christian Schneider

http://www.liquid-reality.de

Computer Scientist

Reply | Threaded
Open this post in threaded view
|

Re: Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

jbonofre
Hi Christian

Thanks for the update.

Did you see the effort we are doing right now on examples that will be part of the distribution? Maybe it would make sense to have tutorials as part of the exemples ?

Regards
JB
Le 4 juil. 2018, à 11:50, Christian Schneider <[hidden email]> a écrit:
Recently I had quite a few issues with the availability of my homepage http://liquid-reality.de .
So I am in the process of moving my whole site to github io pages. The first and most important part is done now.

The Tutorials for Apache Karaf now live at:
https://cschneider.github.io/Karaf-Tutorial/

This has some advantages:
- The tutorials now live closer to the code (same repo)
- You can provide PRs for the tutorials
- The hosting by github should be a lot more stable

Christian

--
--
Christian Schneider

http://www.liquid-reality.de

Computer Scientist

Reply | Threaded
Open this post in threaded view
|

Re: Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

cschneider
Hi JB,

yes having some tutorials in the karaf docs makes sense. 
I am not yet sure how to best structure these. The current examples are often too simple to explain a certain technology. On the other hand I also do not yet have a really good concept.

I would also like to focus on just declarative services. I do not see a big future for blueprint. 

Another thing is the way we build bundles in the examples. In my newer tutorials I only use the bnd-maven-plugin. 
I also define the exported packages simply by a package info file with a version annotation. I think this makes the OSGi configs a lot simpler and avoids errors.
This config can be put in a parent pom for all modules of an example. So indiviual modules do not need any OSGi config.
I think we really need to bring the examples and tutorials to the next level of best practices. As OSGi R7 support will arrive soon I plan to aim at 
R7 as target platform for upcoming tutorials (Similar to the new enroute).

Christian

Am Mi., 4. Juli 2018 um 11:54 Uhr schrieb Jean-Baptiste Onofré <[hidden email]>:
Hi Christian

Thanks for the update.

Did you see the effort we are doing right now on examples that will be part of the distribution? Maybe it would make sense to have tutorials as part of the exemples ?

Regards
JB
Le 4 juil. 2018, à 11:50, Christian Schneider <[hidden email]> a écrit:
Recently I had quite a few issues with the availability of my homepage http://liquid-reality.de .
So I am in the process of moving my whole site to github io pages. The first and most important part is done now.

The Tutorials for Apache Karaf now live at:
https://cschneider.github.io/Karaf-Tutorial/

This has some advantages:
- The tutorials now live closer to the code (same repo)
- You can provide PRs for the tutorials
- The hosting by github should be a lot more stable

Christian

--
--
Christian Schneider

http://www.liquid-reality.de

Computer Scientist



--
--
Christian Schneider

http://www.liquid-reality.de

Computer Scientist

Reply | Threaded
Open this post in threaded view
|

Re: Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

jbonofre
We have different perspective there. My standpoint is simpler: we need
to help our users to start easily with Karaf.

Users don't care about some technologies, bnd or maven-bundle-plugin, or
whatever: they just need turnkey examples.

Anyway, Karaf 4.2.1 will include the current examples and we will
improve and add new ones for next releases.

Regards
JB

On 04/07/2018 23:31, Christian Schneider wrote:

> Hi JB,
>
> yes having some tutorials in the karaf docs makes sense. 
> I am not yet sure how to best structure these. The current examples are
> often too simple to explain a certain technology. On the other hand I
> also do not yet have a really good concept.
>
> I would also like to focus on just declarative services. I do not see a
> big future for blueprint. 
>
> Another thing is the way we build bundles in the examples. In my newer
> tutorials I only use the bnd-maven-plugin. 
> I also define the exported packages simply by a package info file with a
> version annotation. I think this makes the OSGi configs a lot simpler
> and avoids errors.
> See here for an example:
> https://github.com/apache/felix/blob/trunk/systemready/src/main/java/org/apache/felix/systemready/package-info.java
>
> This config can be put in a parent pom for all modules of an example. So
> indiviual modules do not need any OSGi config.
> https://github.com/apache/felix/blob/trunk/systemready/pom.xml#L38-L58
>
> I think we really need to bring the examples and tutorials to the next
> level of best practices. As OSGi R7 support will arrive soon I plan to
> aim at 
> R7 as target platform for upcoming tutorials (Similar to the new enroute).
>
> Christian
>
> Am Mi., 4. Juli 2018 um 11:54 Uhr schrieb Jean-Baptiste Onofré
> <[hidden email] <mailto:[hidden email]>>:
>
>     Hi Christian
>
>     Thanks for the update.
>
>     Did you see the effort we are doing right now on examples that will
>     be part of the distribution? Maybe it would make sense to have
>     tutorials as part of the exemples ?
>
>     Regards
>     JB
>     Le 4 juil. 2018, à 11:50, Christian Schneider
>     <[hidden email] <mailto:[hidden email]>> a écrit:
>
>         Recently I had quite a few issues with the availability of my
>         homepage http://liquid-reality.de .
>         So I am in the process of moving my whole site to github io
>         pages. The first and most important part is done now.
>
>         The Tutorials for Apache Karaf now live at:
>         https://cschneider.github.io/Karaf-Tutorial/
>
>         This has some advantages:
>         - The tutorials now live closer to the code (same repo)
>         - You can provide PRs for the tutorials
>         - The hosting by github should be a lot more stable
>
>         Christian
>
>         --
>         --
>         Christian Schneider
>         http://www.liquid-reality.de
>
>         Computer Scientist
>         http://www.adobe.com
>
>
>
> --
> --
> Christian Schneider
> http://www.liquid-reality.de
>
> Computer Scientist
> http://www.adobe.com
>

--
Jean-Baptiste Onofré
[hidden email]
http://blog.nanthrax.net
Talend - http://www.talend.com
Reply | Threaded
Open this post in threaded view
|

Re: Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

cschneider


Am Do., 5. Juli 2018 um 00:02 Uhr schrieb Jean-Baptiste Onofré <[hidden email]>:
We have different perspective there. My standpoint is simpler: we need
to help our users to start easily with Karaf.
 
 Not sure if this is different from my view. I also want to help people to start easily.  

Users don't care about some technologies, bnd or maven-bundle-plugin, or
whatever: they just need turnkey examples.

This is exactly the point. New users take the examples as starting point for their software. So whatever we put in there will be what users keep using for a long time.
That is why I think we need to have consistent and opinionated examples to provide real best practices to avoid leading users on a way that turns out to be a dead end.

Typically users will either choose blueprint or DS and will not want to mix both. My opionion is to simply not have blueprint examples but I am totally fine if we have them.. but they should be 
separate from the DS ones. So I propose the directories below examples are ds and blueprint. That should prevent quite a bit of confusion.

I see one other problem with the parent. The examples use the karaf parent. I think this is not good as users will want to copy the examples but they will not want to keep the karaf parent.
Actually I am not sure if the examples must live in the karaf repo at all. They are not strictly tied to the karaf release and often have a different lifecycle. Maybe there could be a repo karaf-examples or karaf-tutorials.

Christian

Reply | Threaded
Open this post in threaded view
|

Re: Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

jbonofre
Hi Christian,

I agree about focusing on DS.

About the parent, it's a willing to have example as part of the karaf
repo and distribution because the examples will be used in itests and
updating to match what Karaf upstream is providing. However, I agree
about the parent, I will clean it up to allow people to start without
the Karaf parent dependency.

Regards
JB

On 05/07/2018 08:14, Christian Schneider wrote:

>
>
> Am Do., 5. Juli 2018 um 00:02 Uhr schrieb Jean-Baptiste Onofré
> <[hidden email] <mailto:[hidden email]>>:
>
>     We have different perspective there. My standpoint is simpler: we need
>     to help our users to start easily with Karaf.
>
>  
>  Not sure if this is different from my view. I also want to help people
> to start easily.  
>
>
>     Users don't care about some technologies, bnd or maven-bundle-plugin, or
>     whatever: they just need turnkey examples.
>
>
> This is exactly the point. New users take the examples as starting point
> for their software. So whatever we put in there will be what users keep
> using for a long time.
> That is why I think we need to have consistent and opinionated examples
> to provide real best practices to avoid leading users on a way that
> turns out to be a dead end.
>
> Typically users will either choose blueprint or DS and will not want to
> mix both. My opionion is to simply not have blueprint examples but I am
> totally fine if we have them.. but they should be 
> separate from the DS ones. So I propose the directories below examples
> are ds and blueprint. That should prevent quite a bit of confusion.
>
> I see one other problem with the parent. The examples use the karaf
> parent. I think this is not good as users will want to copy the examples
> but they will not want to keep the karaf parent.
> Actually I am not sure if the examples must live in the karaf repo at
> all. They are not strictly tied to the karaf release and often have a
> different lifecycle. Maybe there could be a repo karaf-examples or
> karaf-tutorials.
>
> Christian
>

--
Jean-Baptiste Onofré
[hidden email]
http://blog.nanthrax.net
Talend - http://www.talend.com
Reply | Threaded
Open this post in threaded view
|

Re: Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

imranrazakhan
This post was updated on .
In reply to this post by cschneider
it would be nice to have tutorial about deployment of karaf with cellar on
kubernetes.

Infact we have documentations for all projects like Karaf Cellar, Karaf Cave and Karaf Decanter, but tutorial are always nice for new starter. Currently these projects might be adopted by existing users.

To extend community around karaf showcasing these projects with some use case and tutorial would really help.



--
Sent from: http://karaf.922171.n3.nabble.com/Karaf-User-f930749.html
Reply | Threaded
Open this post in threaded view
|

Re: Karaf Tutorials moved to new site https://cschneider.github.io/Karaf-Tutorial/

jbonofre
Hi,

+1, however it will be in Cellar examples, not directly Karaf.

Regards
JB

On 10/07/2018 09:42, imranrazakhan wrote:
> it would be nice to have tutorial about deployment of karaf with cellar on
> kubernetes
>
>
>
> --
> Sent from: http://karaf.922171.n3.nabble.com/Karaf-User-f930749.html
>

--
Jean-Baptiste Onofré
[hidden email]
http://blog.nanthrax.net
Talend - http://www.talend.com