exoer on the grill: exo add-ons factory using docker and codenvy

Presentation of the

Codenvy/Dockerto create eXo Add-on factories

Copyright 2015 eXo Platform

A presentation

by CWI/PRD Team

● Environment setup to develop eXo extensions is time consuming and resource intensive.

● Setup third party Maven repository

● Setup a complete eXo Platform Runtime to Deploy & Test the extension

● Powerful computer to run eXo Platform

Building eXo Add-on with Current Process


Manual Steps

Agenda


Enjoy...

1. eXo’s Goal - Encourage eXo Addon development2. Docker Introduction3. Codenvy/Factory Introduction4. Building eXo Add-on Factory thanks to Codenvy/Docker5. Live Demo

A developer can view the code and then modify it, build it, test it, debug it and run it without installing anything

eXo’s Goal - Encourage eXo Add-on Development


● Deliver a ready-to-use IDE for fast on boarding.

● Available through a simple URL

● On eXo Add-ons Catalog: “Code & Run” button to launches factory

eXo’s Goal - Encourage eXo Add-on development


Use of Codenvy Factories allows a “One Click Code & Run”

The introduction of

in brief



“An open source project to pack, ship and run any application as a lightweight container.”

● For years, setup/installation/configuration packages/software have been complex activities:○ dependencies: Tomcat needs JVM○ versions management: Tomcat 7 needs JVM 7,

host server can have v6, v7, v8, how assure ?○ configuration: Tomcat ports, security○ update services, startup Become more important in dev/pre-prod/prod

Reasons to use Docker ?




Hope I don’t forget any child, I haz 7 ducks

-- Tomcat Mother Duck --

In prod, I haz 3 ducks more, which one is first ?


DEVELOPMENT

PRODUCTION



With

I embark them all, no need to remember :)


● Docker is a new way of virtualizing, aiming to “build, ship, and run any app, anywhere”

Main Benefits: COST EFFECTIVE

VMs:- Each VM is 10Gb size 10 VMs =10x10= 100Gb resources.Docker (Linux Containers):<< 100Gb resources.

Docker in few words


http://www.zdnet.com/article/what-is-docker-and-why-is-it-so-darn-popular/

● Java is the code, docker is the config (Dockerfile)

sample:


Like Java

● Git semantics: commit, push, pull

● docker pull exoplatform/exo-maven

● docker commit

● docker push


Like Git

● Control versioning like Git (pull, commit, push, diff ...)

● Write once, run everywhere like Java (build, start, run, save ...)○ Run configs on your local as real as on server

● Can be integrated easily into various infrastructures: cloud, CI server (Codenvy, jenkins…)


Working with Docker

eXo has a list of pre-built images

● docker pull exoplatform/ubuntu-jdk7-exo

● docker run -p 8080:8080 exoplatform/ubuntu-jdk7-exo

eXo Docker Images


https://registry.hub.docker.com/repos/exoplatform/

Some cases to use Docker in real world


ADMIN

PLF imagepre-configured

Cloud Dev

Acceptance

Local dev

Support

QA campaigns

Quick fixes

consistency on 1 package

The introduction of


● It started out as an additional feature to the eXo Platform in early 2009.

● Codenvy is a cloud environment for coding, building, debugging and running apps (IDE in the cloud)

● Codenvy allows any developer to run application in Docker, all from the browser without downloading anything on the desktop.

What is Codenvy?


What is Codenvy?


Impact in the software industry and the way we work● The way software vendors promote APIs and

SDKs.● Developers collaborate while building apps.

● Developers exchange with QA teams.

● Cloud development environments are managed by DevOps....

Codenvy


● Creating a pre-configured environment for speeding development of new applications, add-ons, APIs or any other software

● Providing a development environment for modifying existing software and testing it out of the box

● Simplifying project collaboration for Development teams...

Codenvy Factory


● There are three types of Codenvy Factories:

● Hack Factories● Tracked Factories (require a special account)● Branded Factories (require a special account)

Tracked and Branded Factories allow advanced customisations (ex: Welcome screens, branding, etc…) and provide powerful analytics features.

Tutorial: Building a Contribution Factory From Scratch

Codenvy Factory (cont.)


http://docs.codenvy.com/user/tutorials/factories/#contribution-factory

● In Codenvy a “runner” is the term to describe an execution runtime

● In order to deploy custom runners, Codenvy uses Docker recipes



Codenvy custom Runner Docker File

exoplatform/ubuntu-jdk-exo

exoplatform/exo-presetup-account

exoplatform/exo-maven

Inhe

ritan

ce im

age

● Check out source code from the official eXo Github

● Customize Maven config for Codenvy

● Provide a Docker based runtime to Build, Deploy and Test the code Complete Maven based eXo build environmenteXo Platform 4.1 runtime completely setup and ready to try Add-on (with 4GB RAM)

Codenvy Factory



Codenvy Factory

LIVE DEMO CREATE YOUR FIRST FACTORY IN SOME STEPS

Requirements:

● A Codenvy account

● Codenvy CLI installed on your local machine

● Github account and DockerHub account linked to your Github account.

● Host the static resources (html...)

Getting started to build new factory


Create new Codenvy Factory for eXo Marketplace Addon

● Codenvy Factory.json source

● Dockerfile

● Welcome HTML file

● Docker files repo & eXo Dockerhub

DEMO


https://github.com/exo-docker/exo-addons/blob/master/marketplace-extension/factory-markterplace.json

https://github.com/exo-docker/exo-addons/blob/master/marketplace-extension/factory-markterplace.json

https://raw.githubusercontent.com/exo-docker/exo-addons/master/marketplace-extension/exo-marketplace-extension-docker-runner

https://raw.githubusercontent.com/exo-docker/exo-addons/master/marketplace-extension/exo-marketplace-extension-docker-runner

http://cdn.rawgit.com/exo-docker/exo-addons/master/marketplace-extension/eXo-Marketplace-Addon.html

http://cdn.rawgit.com/exo-docker/exo-addons/master/marketplace-extension/eXo-Marketplace-Addon.html

https://github.com/exo-docker/exo-maven

https://registry.hub.docker.com/repos/exoplatform/

https://github.com/exo-docker/exo-maven

DEMO


● Create factory➔ codenvy> create-factory /Users/namph/java/eXoProjects/exo-

docker/exo-addons/marketplace-extension/factory-markterplace.json➔ Factory URL: https://codenvy.com/f?id=3q8lxmzs4clmcdg8

● Visit eXo Add-ons Catalog

● Click on “Code new Add-on” ( ) button

● Implement your Add-on with template

● Click on “Run” ( ) button to build, deploy and start Web Server

Code new eXo Add-on thanks to Docker/Codenvy


http://community.exoplatform.com/portal/intranet/add-ons

● Codenvy’s blog post: Create an new eXo Factory Using Codenvy and Docker

● Webinar: Codenvy Contribution Factory with eXo Chat

● eXo’s blog post: The new codenvy is a game changer and everybody benefits

● Tutorial: Codenvy Contribution Factory with eXo Chat

Find more resources


http://blog.codenvy.com/creating-codenvy-factory-exo-extensions-development/



https://www.youtube.com/watch?v=QCjuoBQvPnk

http://blog.exoplatform.com/en/2014/12/03/the-new-codenvy-is-a-game-changer-and-everybody-benefits



https://www.youtube.com/watch?v=QCjuoBQvPnk

● We can do even better with the new version Codenvy 2.1to make the factory cleaner, easier to maintain and maybe faster

● Improvement for eXo Factories by using “Try Now" and "Code Now" buttons instead of the current "Code & Run"

Go further


Thank you !

exoer on the grill: exo add-ons factory using docker and codenvy

Software

exo extensions

exo platformcopyright

exo platformworking

exo platformhope

exo platformreasons

exo platformenjoy

exo platformwith

exo addon factoriescopyright