build-and-run-the-quickstart-with-provisioned-server.adoc

Building and running the quickstart application with provisioned {productName} server

Instead of using a standard {productName} server distribution, you can alternatively provision a {productName} server to deploy and run the quickstart. The functionality is provided by the WildFly Maven Plugin, and you may find its configuration in the quickstart pom.xml:

<profile>
    <id>provisioned-server</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
    <build>
        <plugins>
            <plugin>
                <groupId>org.wildfly.plugins</groupId>
                <artifactId>wildfly-maven-plugin</artifactId>
                <configuration>
                    <discover-provisioning-info>
                        <version>${version.server}</version>
                    </discover-provisioning-info>
                    <add-ons>...</add-ons>
                </configuration>
                <executions>
                    <execution>
                        <goals>
                            <goal>package</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            ...
        </plugins>
    </build>
</profile>

Note	When built, the provisioned {productName} server can be found in the target/server directory, and its usage is similar to a standard server distribution, with the simplification that there is never the need to specify the server configuration to be started.

Follow these steps to run the quickstart using the provisioned server.

Procedure

1. Make sure the server is provisioned.

   $ mvn {mavenServerProvisioningCommand}

2. Start the {productName} provisioned server, using the WildFly Maven Plugin start goal.

   $ mvn wildfly:start 

3. Type the following command to run the integration tests.

   $ mvn verify -Pintegration-testing 

4. Shut down the {productName} provisioned server.

   $ mvn wildfly:shutdown