Chapter 4. Using S2I to deploy Quarkus applications on OpenShift

Procedure

1. Change to the directory that contains your Quarkus Maven project.
2. Create a hidden directory called .s2i at the same level as the pom.xml file.

3. Create a file called environment in the .s2i directory and add the following content:

   ARTIFACT_COPY_ARGS=-p -r lib/ *-runner.jar

4. Commit and push your changes to the remote Git repository.

5. Log in to the OpenShift CLI (oc):

   oc login

6. To create a new OpenShift project, enter the following command where <project_name> is the name of your new project:

   oc new-project <project_name>

7. To import the supported OpenShift image, enter the following command:

   oc import-image --confirm ubi8/openjdk-11 --from=registry.access.redhat.com/ubi8/openjdk-11

   Note

   If you are deploying on IBM Z infrastructure, enter oc import-image --confirm openj9/openj9-11-rhel8 --from=registry.redhat.io/openj9/openj9-11-rhel8.

   For information about this image, see the Red Hat OpenJ9 11 Java Applications on RHEL8 page.

8. To build the project in OpenShift, enter the following command where <git_path> is the path to the Git repository that hosts your Quarkus project and <project_name> is the OpenShift project that you created.

   oc new-app ubi8/openjdk-11 <git_path> --name=<project_name>

   Note

   If you are deploying on IBM Z infrastructure, enter oc new-app openj9/openj9-11-rhel8 <git_path> --name=<project_name>.

   This command builds the project, creates the application, and deploys the OpenShift service.

9. To create an OpenShift route, enter the following command:

   oc expose service/<project_name>

10. To view the new route, enter the following command where <application_name> is the name of an application deployed in your OpenShift project:

    export URL="http://$(oc get route <application_name> -o jsonpath='{.spec.host}}')"
    echo "Application URL: $URL"

11. To create an HTTP request on the route’s hello endpoint, enter the following command:

    curl $URL/hello

12. To use your application, enter the URL returned in the preceding command in a web browser.

13. To deploy an updated version of the project, push any updates to the Git repository then enter the following command:

    oc start-build <project_name>

14. Refresh your browser page after the build completes to see the changes.