Appendix C. Deploying a Spring Boot application using WAR files

Procedure

1. Add war packaging to the pom.xml file of your project:

   Example pom.xml

   <project ...>
     ...
     <packaging>war</packaging>
     ...
   </project>

   Copy to Clipboard Toggle word wrap

2. Specify spring-boot-starter-tomcat as a dependency of your application:

   Example pom.xml

   <project ...>
     ...
     <dependencies>
       ...
       <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-tomcat</artifactId>
       </dependency>
       ...
     </dependencies>
     ...
   </project>

   Copy to Clipboard Toggle word wrap

3. Ensure the repackage Maven goal for the Spring Boot Maven plugin is defined in the pom.xml file:

   Example pom.xml

   <project ...>
   ...
     <build>
       ...
       <plugins>
         ...
         <plugin>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-maven-plugin</artifactId>
           <executions>
             <execution>
               <goals>
                 <goal>repackage</goal>
               </goals>
             </execution>
           </executions>
         </plugin>
       </plugins>
     </build>
   ...
   </project>

   Copy to Clipboard Toggle word wrap

   This ensures that the Spring Boot classes used to launch the application are included in the WAR file, and that the corresponding properties for these classes are defined in the MANIFEST.mf file of the WAR file:

   • Main-Class: org.springframework.boot.loader.WarLauncher
   • Spring-Boot-Classes: WEB-INF/classes/
   • Spring-Boot-Lib: WEB-INF/lib/
   • Spring-Boot-Version: 2.4.9

4. Add the ARTIFACT_COPY_ARGS environment variable to the pom.xml file.

   The Fabric8 Maven Plugin consumes this variable during the build process and ensures that the Build and Deploy tool uses the WAR file (rather than the default fat JAR file) to create the application container image:

   Example pom.xml

       ...
       <profile>
         <id>openshift</id>
         <build>
           <plugins>
             <plugin>
               <groupId>io.fabric8</groupId>
               <artifactId>fabric8-maven-plugin</artifactId>
               <executions>
                 ...
               </executions>
               <configuration>
                   <images>
                       <image>
                           <name>${project.artifactId}:%t</name>
                           <alias>${project.artifactId}</alias>
                           <build>
                               <from>registry.access.redhat.com/redhat-openjdk-18/openjdk18-openshift:${openjdk18-openshift.version}</from>
                               <assembly>
                                   <basedir>/deployments</basedir>
                                   <descriptorRef>artifact</descriptorRef>
                               </assembly>
                               <env>
                                   <ARTIFACT_COPY_ARGS>*.war</ARTIFACT_COPY_ARGS>
                                   <JAVA_APP_DIR>/deployments</JAVA_APP_DIR>
                               </env>
                               <ports>
                                   <port>8080</port>
                               </ports>
                           </build>
                       </image>
                   </images>
               </configuration>
             </plugin>
           </plugins>
         </build>
       </profile>
       ...

   Copy to Clipboard Toggle word wrap

5. Add the JAVA_APP_JAR environment variable to the src/main/fabric8/deployment.yml file.

   This variable instructs the Fabric8 Maven Plugin to launch your application using the WAR file included with the container. If src/main/fabric8/deployment.yml does not exist, you can create it.

   Example deployment.yml

   spec:
     template:
       spec:
         containers:
           ...
             env:
             - name: JAVA_APP_JAR
               value: ${project.artifactId}-${project.version}.war

   Copy to Clipboard Toggle word wrap

6. Build and deploy your application:

   mvn clean fabric8:deploy -Popenshift

   Copy to Clipboard Toggle word wrap