Chapter 3. Using source-to-image for OpenShift

Procedure

1. Log in to the OpenShift instance by running the following command and by providing your credentials:

   Copy to Clipboard Toggle word wrap

   $ oc login

2. Create a new project:

   Copy to Clipboard Toggle word wrap

   $ oc new-project <project-name>

3. Create a new application using the S2I for OpenShift image:

   The <source-location> is the URL of GitHub repository or path to a local folder.

   Copy to Clipboard Toggle word wrap

   $ oc new-app <source-location>

   For example:

   Copy to Clipboard Toggle word wrap

   $ oc new-app --context-dir=getting-started --name=quarkus-quickstart \
    'registry.access.redhat.com/ubi8/openjdk-11~https://github.com/quarkusio/quarkus-quickstarts.git#2.12.1.Final'

4. Get the service name:

   Copy to Clipboard Toggle word wrap

   $ oc get svc

5. Expose the service as a route, so that you can use the server from your browser:

   Copy to Clipboard Toggle word wrap

   $ oc expose svc/ --port=8080

6. Get the route:

   Copy to Clipboard Toggle word wrap

   $ oc get route

7. Access the application in your browser by using the URL. Use the value of HOST/PORT field from the previous command’s output.

Procedure

1. Log in to the OpenShift instance by running the following command and by providing your credentials:

   Copy to Clipboard Toggle word wrap

   $ oc login

2. Create a new project:

   Copy to Clipboard Toggle word wrap

   $ oc new-project jdk-bin-demo

3. Create a new binary build, and specify the image stream and the application’s name:

   Copy to Clipboard Toggle word wrap

   $ oc new-build --binary=true \
   --name=jdk-us-app \
   --image-stream=java:11
   --> Found image c1f5b31 (2 months old) in image stream "openshift/java:11" under tag "latest" for "java:11"
   
       Java Applications
       -----------------
       Platform for building and running plain Java applications (fat-jar and flat classpath)
   
   --> Creating resources with label build=jdk-us-app ...
       imagestream "jdk-us-app" created
       buildconfig "jdk-us-app" created
   --> Success
   Application is not exposed. You can expose services to the outside world by executing one or more of the commands below:
    'oc expose svc/jdk-us-app'

4. Start the binary build.

   Instruct the oc executable to use main directory of the binary build you have created in previous step as the directory containing binary input for the OpenShift build:

   Copy to Clipboard Toggle word wrap

   $ oc start-build jdk-us-app --from-dir=./ocp --follow
   Uploading directory "ocp" as binary input for the build ...
   build "jdk-us-app-1" started
   Receiving source from STDIN as archive ...
   ==================================================================
   Starting S2I Java Build .....
   S2I source build with plain binaries detected
   Copying binaries from /tmp/src/deployments to /deployments ...
   ... done
   Pushing image 172.30.197.203:5000/jdk-bin-demo/jdk-us-app:latest ...
   Pushed 0/6 layers, 2% complete
   Pushed 1/6 layers, 24% complete
   Pushed 2/6 layers, 36% complete
   Pushed 3/6 layers, 54% complete
   Pushed 4/6 layers, 71% complete
   Pushed 5/6 layers, 95% complete
   Pushed 6/6 layers, 100% complete
   Push successful

5. Create a new OpenShift application based on the build:

   Copy to Clipboard Toggle word wrap

   $ oc new-app jdk-us-app
   --> Found image 66f4e0b (About a minute old) in image stream "jdk-bin-demo/jdk-us-app" under tag "latest" for "jdk-us-app"
   
       jdk-bin-demo/jdk-us-app-1:c1dbfb7a
       ----------------------------------
       Platform for building and running plain Java applications (fat-jar and flat classpath)
   
       Tags: builder, java
   
       * This image will be deployed in deployment config "jdk-us-app"
       * Ports 8080/tcp, 8443/tcp, 8778/tcp will be load balanced by service "jdk-us-app"
         * Other containers can access this service through the hostname "jdk-us-app"
   
   --> Creating resources ...
       deploymentconfig "jdk-us-app" created
       service "jdk-us-app" created
   --> Success
       Run 'oc status' to view your app.

6. Expose the service as route.

   Copy to Clipboard Toggle word wrap

   $ oc expose svc/jdk-us-app
   route "jdk-us-app" exposed

7. Get the route:

   Copy to Clipboard Toggle word wrap

   $ oc get route

8. Access the application in your browser by using the URL (value of HOST/PORT field from the previous command output).