Merge pull request #454 from Josh-Matsuoka/jlink-stage-1

[OPENJDK-2686] Jlink stage 1 - BuildConfig and Imagestream for creating a builder image with the jmods rpm installed

Author: jmtd

templates/jlink/jlink-builder/README.md

@@ -0,0 +1,58 @@
+# OpenShift-JLink PoC
+
+Try it out:
+
+## Stage 1: create ubi9 jlink imagestream and push a ubi9 image with jmods installed to it.
+
+You need:
+
+1. Access to an OpenShift instance, such as crc
+2. UBI9 OpenJDK ImageStreams. You can load them from this repository with
+
+    oc create -f templates/ubi9-community-image-streams.json
+
+Steps to produce the imagestream and image:
+
+1. install the template
+
+    oc create -f templates/jlink/jlink-builder/jlink-builder-template.yaml
+
+This will create a Template called jlink-builder-template, you should see
+
+    template.template.openshift.io/jlink-builder-template created
+
+and after running oc get template, it should be in the list as
+
+    jlink-builder-template                        Template to produce an imagestream and buildconfig for a Jlink builder image       1 (all set)       2
+
+2. Set the parameters and create the imagestream and buildconfig from the template.
+
+The template for now defines a single parameter, JDK_VERSION. Setting this will set the version of the builder image used in the BuildConfig. Currently suppoted values are 11, 17, and 21. By default this will be 11.
+
+    oc process --parameters jlink-builder-template
+    
+    NAME                DESCRIPTION                                GENERATOR           VALUE
+    JDK_VERSION         JDK version to produce a jmods image for                       11
+
+In order to set the JDK version, you will need to use the -p flag of oc process. To process the template and create the imagestreams, simply run 
+
+    oc process jlink-builder-template -p JDK_VERSION=11 | oc create -f -
+    
+    imagestream.image.openshift.io/ubi9-openjdk-11-jlink created
+    buildconfig.build.openshift.io/jlink-builder-jdk-11 created
+
+3. Start and observe the build
+
+Start the build using
+
+    oc start-build jlink-builder-jdk-11
+    
+    build.build.openshift.io/jlink-builder-jdk-11-1 started
+
+Then observe it by using
+
+    oc logs -f bc/jlink-builder-jdk-11
+
+## Stage 2: build and analyse application with OpenShift source-to-image (S2I)
+
+TODO

templates/jlink/jlink-builder/jlink-builder-template.yaml

@@ -0,0 +1,42 @@
+---
+apiVersion: template.openshift.io/v1
+kind: Template
+metadata:
+  annotations:
+    description: Template to produce an imagestream and buildconfig for a Jlink builder image
+  name: jlink-builder-template
+parameters:
+- description: JDK version to produce a jmods image and imagestream for
+  name: JDK_VERSION
+  value: "11"
+  required: true
+objects:
+- apiVersion: image.openshift.io/v1
+  kind: ImageStream
+  metadata:
+    name: ubi9-openjdk-${JDK_VERSION}-jlink
+  spec:
+    lookupPolicy:
+      local: false
+- apiVersion: build.openshift.io/v1
+  kind: BuildConfig
+  metadata: 
+    name: jlink-builder-jdk-${JDK_VERSION}
+    labels:
+      app: jlink-builder-jdk-${JDK_VERSION}
+  spec:
+    source:
+      dockerfile: |
+        FROM -
+        USER 0
+        RUN microdnf --setopt=install_weak_deps=0 --setopt=tsflags=nodocs install -y java-${JDK_VERSION}-openjdk-jmods
+        USER 185
+    strategy:
+      dockerStrategy:
+        from: 
+          kind: ImageStreamTag
+          name: ubi9-openjdk-${JDK_VERSION}:1.18
+    output:
+      to:
+        kind: ImageStreamTag
+        name: ubi9-openjdk-${JDK_VERSION}-jlink:latest