Holds all versioned WildFly quickstarts
Clone or download
emmartins Merge pull request #319 from sgilda/JBEAP-15768
JBEAP-15768: Update the root README file to support CD, Product, and Project releases
Latest commit 6021b85 Nov 8, 2018
Permalink
Failed to load latest commit information.
.mvn fix release procedure Feb 21, 2018
app-client WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
batch-processing WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
bean-validation-custom-constraint WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
bean-validation WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
bmt WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
cmt WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
contacts-jquerymobile WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
deltaspike-authorization WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
deltaspike-beanbuilder WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
deltaspike-projectstage WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
dist Next is 15 Alpha Aug 31, 2018
ejb-asynchronous WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-in-ear WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-in-war WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-multi-server adds missing provided scope to war api dependencies Oct 25, 2018
ejb-remote WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-security-context-propagation WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-security-jaas WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-security-programmatic-auth WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-security WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-throws-exception WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ejb-timer WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
greeter WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
guide Rename profiles arq-wildfly-remote / arq-wildfly-managed --> arq-remo… Feb 27, 2017
ha-singleton-deployment WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
ha-singleton-service WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
helloworld-classfiletransformer WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
helloworld-html5 WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld-jms WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld-mbean WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld-mdb-propertysubstitution WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld-mdb WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld-mutual-ssl-secured WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
helloworld-mutual-ssl WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
helloworld-rf WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
helloworld-rs WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld-singleton WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld-ssl WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
helloworld-ws WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
helloworld WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
hibernate WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
hibernate4 WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
http-custom-mechanism WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
inter-app Merge pull request #310 from sgilda/WFLY-11228 Oct 23, 2018
jaxrs-client WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
jaxrs-jwt Merge pull request #293 from msfm/jaxrs-jwt-keystore-path Oct 14, 2018
jaxws-addressing WFLY-11266: introducing jaxws client bom Nov 8, 2018
jaxws-ejb WFLY-11266: introducing jaxws client bom Nov 8, 2018
jaxws-pojo WFLY-11266: introducing jaxws client bom Nov 8, 2018
jaxws-retail WFLY-11266: introducing jaxws client bom Nov 8, 2018
jsonp WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
jta-crash-rec WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
jts-distributed-crash-rec WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
jts WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
kitchensink-angularjs WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
kitchensink-ear WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
kitchensink-jsp WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
kitchensink-ml WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
kitchensink-utjs-angularjs WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
kitchensink-utjs-mustache WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
kitchensink WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
logging-tools WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
logging WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
mail WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
managed-executor-service WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
messaging-clustering-singleton WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
messaging-clustering WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
numberguess WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
payment-cdi-event WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
resteasy-jaxrs-client WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
security-domain-to-domain Upgrade wildfly-maven-plugin from 1.2.1.Final to 2.0.0.Final. Nov 2, 2018
servlet-async WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
servlet-filterlistener WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
servlet-security Upgrade wildfly-maven-plugin from 1.2.1.Final to 2.0.0.Final. Nov 2, 2018
shared-doc JBEAP-15768: Update the root README file to support CD, Product, and … Nov 6, 2018
shopping-cart WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
spring-greeter WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
spring-kitchensink-basic WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
spring-kitchensink-springmvctest WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
spring-resteasy WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
tasks-jsf WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
tasks-rs WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
temperature-converter WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
template WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
thread-racing WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
websocket-client WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
websocket-endpoint WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
websocket-hello WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
wicket-ear WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
wicket-war WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
wsat-simple WFLY-11229, JBEAP-15192: Add JBDS import WSDL WSDLAnalyzer warning to… Oct 23, 2018
wsba-coordinator-completion-simple WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
wsba-participant-completion-simple WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
xml-jaxp WFLY-11228, JBEAP-15704: Update references to Developer Studio to use… Oct 23, 2018
.gitattributes add .gitattributes Mar 16, 2017
.gitignore JBEAP-9156: Use githubRepoUrl and githubRepoBranch variables in OpenS… Mar 27, 2018
CONTRIBUTING.adoc JBEAP-15768: Update the root README file to support CD, Product, and … Nov 6, 2018
CONTRIBUTING.md WFLY-10741: relicense Quickstarts as Apache 2.0 Nov 1, 2018
LICENSE.txt JDF-841 - Synchronize Wildfly and EAP Quickstarts Sep 9, 2015
README.adoc JBEAP-15768: Update the root README file to support CD, Product, and … Nov 6, 2018
RELEASE_PROCEDURE.adoc Move documentation to asciidoc Dec 11, 2017
buildReadmes.sh JBEAP-14084: Create shared content - Pulled out more common content i… Jan 29, 2018
configure-postgresql.cli Initial sync of EAP and WildFly quickstarts Feb 21, 2017
contributor-settings.xml JDF-841 - Synchronize Wildfly and EAP Quickstarts Sep 9, 2015
pom.xml WFLY-11266: introducing jaxws client bom Nov 8, 2018
remove-postgresql.cli Initial sync of EAP and WildFly quickstarts Feb 21, 2017
settings.xml JDF-841 - Synchronize Wildfly and EAP Quickstarts Sep 9, 2015

README.adoc

{productNameFull} ({productName}) Quickstarts

These quickstarts demonstrate {javaVersion} and a few additional technologies from the {productNameFull} stack. They provide small, specific, working examples that can be used as a reference for your own project.

Introduction

These quickstarts run on {productNameFull}. Each quickstart folder contains a README.adoc file that describes the quickstart features and provides instructions about how to build and run it.

The quickstarts are configured to use the correct Maven dependencies and ensure that you test and compile the quickstarts against the correct runtime environment.

Make sure you read this entire document before you attempt to work with the quickstarts. It contains the following information:

Use of {jbossHomeName} and JBOSS_HOME Variables

The quickstart README files use the replaceable value {jbossHomeName} to denote the path to the {productName} installation. When you encounter this value in a README file, make sure you replace it with the actual path to your {productName} installation. The installation path is described in detail here: Use of {jbossHomeName} and JBOSS_HOME Variables.

System Requirements

The applications these projects produce are designed to be run on {productNameFull} {productVersion} or later.

All you need to build these projects is {buildRequirements}. See Configure Maven to Build and Deploy the Quickstarts to make sure you are configured correctly for testing the quickstarts.

To run these quickstarts with the provided build scripts, you need the {productName} distribution ZIP. For information on how to install and run JBoss, see the {LinkGettingStartedGuide}[{GettingStartedBookName}] located on the Red Hat Customer Portal.

You can also run the quickstarts in {JBDSProductName} or Eclipse.

Run the Quickstarts

Build and Deploy a Quickstart

The root folder of each individual quickstart contains a README.adoc file with detailed instructions on how to build and run the example. In most cases you do the following:

  • Start the {productName} server.

  • Build the archive.

  • Deploy the quickstart.

  • Undeploy the quickstart when you are finished testing.

Verify All Quickstarts Build with One Command

You can also verify that all of the quickstarts build using one command. However, quickstarts that have complex dependencies must be skipped. For example, the resteasy-jaxrs-client quickstart is a RESTEasy client that depends on the deployment of the helloworld-rs quickstart. The root pom.xml file defines a complex-dependencies profile to exclude these quickstarts from the root build process.

To build all of the quickstarts:

  1. Open a terminal and navigate to the root directory of the quickstarts.

  2. Use the following command to build the quickstarts that do not have complex dependencies:

    $ mvn clean install '-Pdefault,!complex-dependencies'

Undeploy All Deployed Quickstarts with One Command

To undeploy all of the the quickstarts from the root of the quickstart folder, you must pass the argument -fae (fail at end) on the command line. This allows the command to continue past quickstarts that fail due to complex dependencies or only have Arquillian tests and do not deploy archives to the server.

You can undeploy quickstarts using the following procedure:

  1. Start the {productName} server.

  2. Open a terminal and navigate to the root directory of the quickstarts.

  3. Use the following command to undeploy any deployed quickstarts.

    $ mvn wildfly:undeploy -fae

To undeploy any quickstarts that fail due to complex dependencies, follow the undeploy procedure described in the quickstart’s README.adoc file.

Run the Quickstarts in {JBDSProductName} or Eclipse

You can also start the server and deploy the quickstarts or run the Arquillian tests from Eclipse using JBoss tools. For general information about how to import a quickstart, add a {productName} server, and build and deploy a quickstart, see Use {JBDSProductName} or Eclipse to Run the Quickstarts.

Optional Components

The following components are needed for only a small subset of the quickstarts. Do not install or configure them unless the quickstart requires it.