Procedure

1. Create the application directory and navigate to it.

   $ mkdir myApp
   $ cd myApp

2. Create a pom.xml file.

   <?xml version="1.0" encoding="UTF-8"?>
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
   
     <groupId>com.example</groupId>
     <artifactId>my-app</artifactId>
     <version>1.0.0-SNAPSHOT</version>
   
     <name>MyApp</name>
     <description>My Application</description>
   
     <properties>
       <fabric8.generator.from>registry.access.redhat.com/redhat-openjdk-18/openjdk18-openshift:1.2</fabric8.generator.from>
     </properties>
   
     <dependencyManagement>
       <dependencies>
         <dependency>
           <groupId>me.snowdrop</groupId>
           <artifactId>spring-boot-bom</artifactId>
           <version>1.5.16.Final-redhat-00001</version>
           <type>pom</type>
           <scope>import</scope>
         </dependency>
       </dependencies>
     </dependencyManagement>
   
     <dependencies>
       <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-tomcat</artifactId>
       </dependency>
       <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-actuator</artifactId>
       </dependency>
       <dependency>
         <groupId>org.apache.cxf</groupId>
         <artifactId>cxf-spring-boot-starter-jaxrs</artifactId>
       </dependency>
       <dependency>
         <groupId>com.fasterxml.jackson.jaxrs</groupId>
         <artifactId>jackson-jaxrs-json-provider</artifactId>
       </dependency>
     </dependencies>
   
     <build>
       <plugins>
         <plugin>
           <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-maven-plugin</artifactId>
           <version>1.5.16.RELEASE</version>
         </plugin>
       </plugins>
     </build>
   
     <!-- Specify the repositories containing RHOAR artifacts -->
     <repositories>
       <repository>
         <id>redhat-ga</id>
         <name>Red Hat GA Repository</name>
         <url>https://maven.repository.redhat.com/ga/</url>
       </repository>
     </repositories>
   
     <pluginRepositories>
       <pluginRepository>
         <id>redhat-ga</id>
         <name>Red Hat GA Repository</name>
         <url>https://maven.repository.redhat.com/ga/</url>
       </pluginRepository>
     </pluginRepositories>
   
     <profiles>
       <profile>
         <id>openshift</id>
         <build>
           <plugins>
             <plugin>
               <groupId>io.fabric8</groupId>
               <artifactId>fabric8-maven-plugin</artifactId>
               <version>3.5.40</version>
               <executions>
                 <execution>
                   <goals>
                     <goal>resource</goal>
                     <goal>build</goal>
                   </goals>
                 </execution>
               </executions>
             </plugin>
           </plugins>
         </build>
       </profile>
     </profiles>
   </project>

3. Create a new class in src/main/java/com/example/.

   As a recommended practice, ensure that the location of your class within the directory structure of your project reflects the value that you set for groupId in your pom.xml file. For example, for <groupId>my.awesome.project</groupId>, the location of the class should be src/main/java/my/awesome/project/.

   package com.example;
   
   import org.springframework.boot.SpringApplication;
   import org.springframework.boot.autoconfigure.SpringBootApplication;
   import org.springframework.web.bind.annotation.RequestMapping;
   import org.springframework.web.bind.annotation.ResponseBody;
   import org.springframework.web.bind.annotation.RestController;
   
   @SpringBootApplication
   @RestController
   public class MyApp {
   
       public static void main(String[] args) {
           SpringApplication.run(MyApp.class, args);
       }
   
       @RequestMapping("/")
       @ResponseBody
       public Message displayMessage() {
           return new Message();
       }
   
       static class Message {
           private String content = "Greetings!";
   
           public String getContent() {
               return content;
           }
   
           public void setContent(String content) {
               this.content = content;
           }
       }
   }

4. Start your application. Execute the following command in the directory containing you application.

   $ mvn spring-boot:run

5. Using curl or your browser, verify your application is running at http://localhost:8080.

   $ curl http://localhost:8080
   {"content":"Greetings!"}

Procedure

1. Log in to your OpenShift instance with the oc client.

   $ oc login ...

2. Create a new project.

   $ oc new-project MY_PROJECT_NAME

3. In a terminal application, navigate to the directory containing your application:

   $ cd myApp

4. Use Maven to start the deployment to OpenShift.

   $ mvn clean fabric8:deploy -Popenshift

   This command uses the Fabric8 Maven Plugin to launch the S2I process on OpenShift and to start the pod.

5. Check the status of your booster and ensure your pod is running.

   $ oc get pods -w
   NAME                             READY     STATUS      RESTARTS   AGE
   MY_APP_NAME-1-aaaaa               1/1       Running     0          58s
   MY_APP_NAME-s2i-1-build           0/1       Completed   0          2m

   The MY_APP_NAME-1-aaaaa pod should have a status of Running once it is fully deployed and started. Your specific pod name will vary. The number in the middle will increase with each new build. The letters at the end are generated when the pod is created.

6. Once your booster is deployed and started, determine its route.

   Example Route Information

   $ oc get routes
   NAME                 HOST/PORT                                                     PATH      SERVICES        PORT      TERMINATION
   MY_APP_NAME         MY_APP_NAME-MY_PROJECT_NAME.OPENSHIFT_HOSTNAME      MY_APP_NAME      8080

   The route information of a pod gives you the base URL which you use to access it. In the example above, you would use http://MY_APP_NAME-MY_PROJECT_NAME.OPENSHIFT_HOSTNAME as the base URL to access the application.

7. Using curl or your browser, verify your application is running in OpenShift.

   $ curl http://MY_APP_NAME-MY_PROJECT_NAME.OPENSHIFT_HOSTNAME
   {"content":"Greetings!"}