Skip to content

Latest commit

 

History

History
57 lines (46 loc) · 2.99 KB

spring-boot-support.md

File metadata and controls

57 lines (46 loc) · 2.99 KB
Raw

Spring Boot Support

The liberty-maven-plugin provides support for Spring Boot applications, allowing you to install the Spring Boot executable JAR to Open Liberty and WebSphere Liberty runtime versions 18.0.0.2 and above. The spring-boot-maven-plugin should be configured before liberty-maven-plugin to create an executable jar.

Additional Parameters

When installing a Spring Boot application via the Spring Boot executable JAR, the following are the parameters supported by the install-apps goal in addition to the common server parameters and the common parameters.

Parameter Description Required
appsDirectory The server's apps or dropins directory where the application files should be copied. The default value is set to apps if the application is defined in the server configuration, otherwise it is set to dropins. No
deployPackages The Maven packages to copy to Liberty runtime's application directory. spring-boot-project should be configured to this parameter. Yes

The server.xml provided by the serverXml parameter should enable the one of the following Spring Boot features.

Feature Description
springBoot-1.5 Required to support applications with Spring Boot version 1.5.x.
springBoot-2.0 Required to support applications with Spring Boot version 2.0.x and above.

The Liberty features that support the Spring Boot starters can be found here. They should be enabled in the server.xml along with the appropriate Spring Boot feature.

Example

To use the liberty-maven-plugin to install a Spring Boot application packaged as a Spring Boot Uber JAR, include the appropriate XML in the plugins section of your pom.xml.

<build>
    <plugins> 
        ...   	  
        <plugin>
            <groupId>io.openliberty.tools</groupId>
            <artifactId>liberty-maven-plugin</artifactId>
            <executions>
               ...
                <execution>
                    <id>install-apps</id>
                    <phase>pre-integration-test</phase>
                    <goals>
                        <goal>install-apps</goal>
                    </goals>
                    <configuration>
                        <appsDirectory>apps</appsDirectory>
                        <deployPackages>spring-boot-project</deployPackages>
                    </configuration>
                </execution>
                ...
            </executions>
            <configuration>
               <installDirectory>/opt/ibm/wlp</installDirectory>
               <serverName>test</serverName>
           </configuration>
        </plugin>
    </plugins>
</build>