Skip to content

Latest commit

 

History

History
118 lines (92 loc) · 3.55 KB

15-Adding-Custom-S2I-Image-to-the-Project-Catalog.adoc

File metadata and controls

118 lines (92 loc) · 3.55 KB
Raw

Adding Custom S2I Image to the Project Catalog

In the last lab to Using Custom S2I Image, we used the S2I image directly from a docker registry that is outside OpenShift environment. This custom S2I image was not in openshift catalog. In this lab, we will learn how to add the Spring Boot image to the project catalog so that you can deploy the application directly from your screen.

Step 1: Clean up the project that you created in the last lab.

Ensure you are in the right project by running oc project command. If not, change your project by running oc project spring-UserName, replacing the UserName with your own userid.

Clean up the contents of this project:

oc delete all --all

Verify that all the contents are gone by running oc get all

Step 2: Add the Spring Boot image stream.

We will use the image stream from the file https://github.com/VeerMuchandi/openshift-springboot/blob/master/springboot-imagestream.json. Please go through the contents of this file.

{
    "kind": "ImageStream",
    "apiVersion": "v1",
    "metadata": {
        "name": "springboot"
    },
    "spec": {
        "tags": [
            {
                "name": "latest",
                "annotations": {
                    "description": "Spring Boot S2I Image CentOS based",
                    "iconClass": "icon-jboss",
                    "tags": "builder,springboot,java,maven",
                    "supports": "springboot,java:8,maven",
                    "version": "1.0"
                },
            "from": {
              "kind": "DockerImage",
              "name": "docker.io/veermuchandi/spring-mvn-base:latest"
            }
            }
        ]
    }
}

Notice, that this json points to the Spring Boot S2I builder Image on docker hub. Also note the tags used in this imagestream. The tag builder will display this in the catalog.

You have two ways to add this to the catalog. 1. Add from command line 2. Add using the web console

To add using CLI run the oc create command as under -

$ oc create -f https://raw.githubusercontent.com/VeerMuchandi/openshift-springboot/master/springboot-imagestream.json
imagestream "springboot" created

Check by running oc get is

You can also search your spring boot image by running the following command

$ oc new-app --search springboot
Image streams (oc new-app --image-stream=<image-stream> [--code=<source>])
-----
springboot
  Project: springtest2
  Tags:    latest

To add using the web console, select Add to Project, and then Import YAML/JSON tab on the top. Then you can copy paste the above imagestream contents into the text box and press Create button.

Step 3

Now use that S2I image to deploy your sample spring boot application https://github.com/RedHatWorkshops/spring-sample-app on OpenShift using your experience from the previous labs.

oc new-app springboot~https://github.com/RedHatWorkshops/spring-sample-app.git --name bootapp

Congratulations!! you have learnt to make an image stream available in your project.

If you got a question in mind - Well how can I make this image available for everyone? Pat yourself on your back.. or ask your colleague to do it ;). You are thinking right. All you need to do is tell your openshift cluster administrator.
Answer The cluster administrator will add the image to the openshift project and everyone will start seeing it.