diff --git a/tomee/README-short.txt b/tomee/README-short.txt new file mode 100644 index 00000000..f376c897 --- /dev/null +++ b/tomee/README-short.txt @@ -0,0 +1 @@ +Apache TomEE is an all-Apache Java EE certified stack where Apache Tomcat is top dog. diff --git a/tomee/content.md b/tomee/content.md new file mode 100644 index 00000000..aeaa4d15 --- /dev/null +++ b/tomee/content.md @@ -0,0 +1,58 @@ +#What is TomEE? + +Apache TomEE, pronounced "Tommy", is an all-Apache Java EE Web Profile certified stack where Apache Tomcat is top dog. Apache TomEE is assembled from a vanilla Apache Tomcat zip file. We start with Apache Tomcat, add our jars and zip up the rest. The result is Tomcat with added EE features - TomEE. + +%%LOGO%% + +Versions 1.X of Apache TomEE are Java EE 6 Web Profile certified. + +Versions 7.X of Apache TomEE are Java EE 7 Web Profile certified. + +Apache TomEE comes with four different flavors, Web Profile, JAX-RS, Plus and Plume. + +- Apache TomEE Web Profile delivers Servlets, JSP, JSF, JTA, JPA, CDI, Bean Validation and EJB Lite. +- Apache TomEE JAX-RS (RESTfull Services) delivers the Web Profile plus JAX-RS (RESTfull Services). +- Apache TomEE Plus delivers all that is in the Web Profile and JAX-RS (RESTfull Services), plus EJB Full, Java EE Connector Architecture, JMS (Java Message Service) and JAX-WS (Web Services). +- Apache TomEE Plume delivers all that is in the Plus Profile, but includes Mojarra and EclipseLink support. + +All Dockerfile files of supported versions can be found at https://github.com/tomitribe/docker-tomee + +# How to use this image. + +Run the default TomEE server (`CMD ["catalina.sh", "run"]`): + +docker run -it --rm tomee/:\-\- + +For example: + +docker run -it --rm tomee/webprofile:1.7.1-jre7 + +or + +docker run -it --rm tomee/jaxrs:1.7.1-jre7 + +You can test it by visiting `http://container-ip:8080` in a browser or, if you need access outside the host, on port 8888: + +docker run -it --rm -p 8888:8080 tomee/plus:1.7.1-jre7 + +You can then go to `http://localhost:8888` or `http://host-ip:8888` in a browser. + +The configuration files are available in `/usr/local/tomee/conf/`. By default, no user is included in the "manager-gui" role required to operate the "/manager/html" web application. If you wish to use this app, you must define such a user in `tomcat-users.xml`. + +You can also use this image as base image in your Dockerfile file. Then you can add your application by running next Dockerfile operation: + +ADD / /usr/local/tomee/webapps/ + +# Issues & Contributors + +Any issue can be notified to Tomitribe team by using next link https://github.com/tomitribe/docker-tomee/issues + +Contributions are more than welcome and can be done by forking https://github.com/tomitribe/docker-tomee repository and sending a PR. + +Note that project contains three scripts which can be used to generate a *tomee* version. + +The most important file is one called `Dockerfile.template` which is used as a based `Dockerfile`. + +# License + +Apache TomEE comes with an APL v2 version (http://www.apache.org/licenses/LICENSE-2.0) and all files provided to produce the Docker images are APL v2 as well. diff --git a/tomee/license.md b/tomee/license.md new file mode 100644 index 00000000..59e3b0f9 --- /dev/null +++ b/tomee/license.md @@ -0,0 +1 @@ +View [license information](http://www.apache.org/licenses/LICENSE-2.0) for the software contained in this image. diff --git a/tomee/logo.png b/tomee/logo.png new file mode 100644 index 00000000..975688d2 Binary files /dev/null and b/tomee/logo.png differ