Merge pull request #64 from sachin-pikle/main

Using Oracle GraalVM for JDK 17 and 20

Author: RahulMR42

AIO.md

@@ -4,13 +4,13 @@
 - A way (workaround) to execute commands on to a Windows machine using OCI Run command agent from OCI Build pipeline. - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-devops-connect-to-windows-from-buildmachines
 - Access resource with Private IP from OCI Build runner - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-devops-pa-with-private-oke
 - Build Caching - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci-build-caching
-- Build Native image with Graal VM Enterprise edition - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_devops_build_with_graalenterprise
-- Build a micronaut restapi application with Graal VM Enterprise - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_devops_graalee_micronaut
+- Build Native image with Oracle GraalVM - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_devops_build_with_graalenterprise
+- Build a micronaut restapi application with Oracle GraalVM - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_devops_graalee_micronaut
 - Build and Deploy a Golang application using OCI Devops - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-devops-golan-sample
 - Build and Deploy a RUST application using OCI Devops - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-devops-cicd-rust-sample
 - Build and deploy a JAVA - Graal EE - Micronaut application on to Instances - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-devops-graal-micronaut-deploy-to-instances
-- Build and run a OCI devops pipeline with JAVA and Graal VM framework. - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-java-graalvm-devops-example
-- Build and run a OCI devops pipeline with Java-Micronaut framework. - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-java-micronaut-devops-example
+- Build and run a OCI devops pipeline with JAVA and GraalVM - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-java-graalvm-devops-example
+- Build and run a OCI devops pipeline with Java-Micronaut framework - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-java-micronaut-devops-example
 - Cascade delete of OCI Project  - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-config-examples/oci-project-cascadedelete
 - Cascaded Pipelines - With in the Region - https://github.com/oracle-devrel/oci-devops-examples/blob/main/oci-pipeline-examples/oci-cascaded-pipelines/same-region
 - Container image scan before deploy - https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_imagescan_before_deploy

oci-build-examples/README.md

@@ -36,10 +36,10 @@ All about OCI devops build samples ..
 </details>
 
 <details>
-  <summary>Graal VM Enterprise - click to expand</summary>
+  <summary>Oracle GraalVM - click to expand</summary>
 
-* [Build a native executable application with Graal VM Enterprise](./oci_devops_build_with_graalenterprise/)
-* [Build a micronaut restapi application with Graal VM Enterprise](./oci_devops_graalee_micronaut/)
+* [Build a native executable application with Oracle GraalVM](./oci_devops_build_with_graalenterprise/)
+* [Build a micronaut restapi application with Oracle GraalVM](./oci_devops_graalee_micronaut/)
 
 </details>
 

oci-build-examples/oci_devops_build_with_graalenterprise/README.md

@@ -1,14 +1,14 @@
-# Using GraalVM Enterprise in OCI DevOps Build Pipelines to build a Java App
+# Using Oracle GraalVM in OCI DevOps Build Pipelines to build a Java App
 
-This sample shows how to use `Oracle GraalVM Enterprise Edition` in `OCI DevOps build pipelines` to build a Java hello world application. You can use this approach to build any high-performance Java application with GraalVM Enterprise and OCI DevOps.
+This sample shows how to use `Oracle GraalVM` in `OCI DevOps build pipelines` to build a Java hello world application. You can use this approach to build any high performance Java application with Oracle GraalVM and OCI DevOps.
 
 ## What is GraalVM?
 
-- Oracle GraalVM Enterprise is a high-performance JDK distribution that can accelerate any Java workload running on the HotSpot JVM.
+- GraalVM is a high performance JDK distribution that can accelerate any Java workload running on the HotSpot JVM.
 
-- Oracle GraalVM Enterprise Native Image ahead-of-time compilation enables you to build lightweight Java applications that are smaller, faster, and use less memory and CPU. At build time, GraalVM Native Image analyzes a Java application and its dependencies to identify just what classes, methods, and fields are necessary and generates optimized machine code for just those elements.
+- GraalVM Native Image ahead-of-time compilation enables you to build lightweight Java applications that are smaller, faster, and use less memory and CPU. At build time, GraalVM Native Image analyzes a Java application and its dependencies to identify just what classes, methods, and fields are necessary and generates optimized machine code for just those elements.
 
-- Oracle GraalVM Enterprise Edition is available for use on Oracle Cloud Infrastructure (OCI) at no additional cost.
+- Oracle GraalVM is available for use on Oracle Cloud Infrastructure (OCI) at no additional cost.
 
 
 
@@ -27,7 +27,7 @@ This sample shows how to use `Oracle GraalVM Enterprise Edition` in `OCI DevOps
 ## Objectives
 
 - Create an OCI build pipeline.
-- Make a build using Oracle GraalVM Enterprise edition.
+- Make a build using Oracle GraalVM.
 - Here the focus will be on the build specification and DevOps build pipeline
 
 
@@ -77,6 +77,7 @@ Allow dynamic-group  <YOUR_DynamicGroup_NAME> to use ons-topics in compartment <
 ![](images/oci_buildpipeline_managedbuild.png)
 
 - Click `Next` and provide the details.
+- In the `Build spec file path`, enter `build_spec.yaml` to use the [GraalVM Enterprise 22.x Java 17 build spec](build_spec.yaml). Alternatively, you can enter `build_spec_oracle_graalvm_jdk17.yaml` to use the [Oracle GraalVM for JDK 17 build spec](./build_spec_oracle_graalvm_jdk17.yaml) or `build_spec_oracle_graalvm_jdk20.yaml` to use the [Oracle GraalVM for JDK 20 build spec](./build_spec_oracle_graalvm_jdk20.yaml).
 
 ![](images/oci_buildstage_1.png)
 
@@ -91,14 +92,14 @@ Allow dynamic-group  <YOUR_DynamicGroup_NAME> to use ons-topics in compartment <
 
 ## Take a closer look at the build instructions below
 
-To install and use GraalVM Enterprise in the DevOps build pipeline, the build specification file is as follows:
+To install and use Oracle GraalVM in the DevOps build pipeline, the build specification file is as follows:
 
-1. Add the following command to install one or more required GraalVM Enterprise components. For example, this command installs Native Image along with the Java Development Kit (JDK) and other necessary dependencies.
+1. Add the following command to install the required Oracle GraalVM components. For example, this command installs Native Image along with the Java Development Kit (JDK) and other necessary dependencies.
 
     ```shell
     steps:
       - type: Command
-        name: "Install GraalVM Enterprise 22.x Native Image for Java17"
+        name: "Install Oracle GraalVM Enterprise 22.x Native Image for Java17"
         command: |
           yum -y install graalvm22-ee-17-native-image
     ```
@@ -144,7 +145,9 @@ To install and use GraalVM Enterprise in the DevOps build pipeline, the build sp
     location: target/my-app
 ```
 
-Here's the complete [build specification](build_spec.yaml) file.
+Here's the complete [build specification for GraalVM Enterprise 22.x Java 17](build_spec.yaml) file. Alternatively, you can use the 
+[build specification for Oracle GraalVM for JDK 17](./build_spec_oracle_graalvm_jdk17.yaml) or
+[build specification for Oracle GraalVM for JDK 20](./build_spec_oracle_graalvm_jdk20.yaml).
 
 
 ## How to export the executable file outside of the build pipeline stage.
@@ -286,9 +289,9 @@ The following instructions will help you to export the `executable app file` to
 References
 ==========
 
-- Using GraalVM Enterprise in DevOps Build Pipelines - https://docs.oracle.com/en-us/iaas/Content/devops/using/graalvm.htm
+- Using Oracle GraalVM in DevOps Build Pipelines - https://docs.oracle.com/en-us/iaas/Content/devops/using/graalvm.htm
 - Oracle Cloud Infrastructure DevOps - https://docs.oracle.com/en-us/iaas/Content/devops/using/home.htm
-- Oracle Graal VM Enterprise - https://www.oracle.com/java/graalvm/
+- Oracle GraalVM - https://www.oracle.com/java/graalvm/
 
 Contributors
 ===========

oci-build-examples/oci_devops_build_with_graalenterprise/build_spec_oracle_graalvm_jdk17.yaml

@@ -0,0 +1,44 @@
+version: 0.1
+component: build
+timeoutInSeconds: 600
+runAs: root
+shell: bash
+env:
+  exportedVariables:
+    - BUILDRUN_HASH
+  variables:
+    "JAVA_HOME" : "/usr/lib64/graalvm/graalvm-java17"
+    # PATH is a reserved variable and cannot be defined as a variable.
+    # However, PATH can be changed in a build step and the change is visible in subsequent steps.
+steps:
+  - type: Command
+    name: "Define unique  tag"
+    timeoutInSeconds: 40
+    command: |
+      export BUILDRUN_HASH=`echo ${OCI_BUILD_RUN_ID} | rev | cut -c 1-7`
+      echo "BUILDRUN_HASH: " $BUILDRUN_HASH
+
+  - type: Command
+    name: "Install Oracle GraalVM for JDK 17 (Native Image and JDK)"
+    command: |
+      yum -y install graalvm-17-native-image
+  - type: Command
+    name: "Set PATH Variable"
+    command: |
+      export PATH=$JAVA_HOME/bin:$PATH
+  # - type: Command
+  #   name: "Build a Jar"
+  #   command: |
+  #     mvn --no-transfer-progress clean package
+  - type: Command
+    name: "Build a native executable "
+    command: |
+      mvn --no-transfer-progress -Pnative -DskipTests package
+
+outputArtifacts:
+  # - name: app_jar
+  #   type: BINARY
+  #   location: target/my-app-1.0-SNAPSHOT.jar
+  - name: app_native_executable
+    type: BINARY
+    location: target/my-app

oci-build-examples/oci_devops_build_with_graalenterprise/build_spec_oracle_graalvm_jdk20.yaml

@@ -0,0 +1,44 @@
+version: 0.1
+component: build
+timeoutInSeconds: 600
+runAs: root
+shell: bash
+env:
+  exportedVariables:
+    - BUILDRUN_HASH
+  variables:
+    "JAVA_HOME" : "/usr/lib64/graalvm/graalvm-java20"
+    # PATH is a reserved variable and cannot be defined as a variable.
+    # However, PATH can be changed in a build step and the change is visible in subsequent steps.
+steps:
+  - type: Command
+    name: "Define unique  tag"
+    timeoutInSeconds: 40
+    command: |
+      export BUILDRUN_HASH=`echo ${OCI_BUILD_RUN_ID} | rev | cut -c 1-7`
+      echo "BUILDRUN_HASH: " $BUILDRUN_HASH
+
+  - type: Command
+    name: "Install Oracle GraalVM for JDK 20 (Native Image and JDK)"
+    command: |
+      yum -y install graalvm-20-native-image
+  - type: Command
+    name: "Set PATH Variable"
+    command: |
+      export PATH=$JAVA_HOME/bin:$PATH
+  # - type: Command
+  #   name: "Build a Jar"
+  #   command: |
+  #     mvn --no-transfer-progress clean package
+  - type: Command
+    name: "Build a native executable "
+    command: |
+      mvn --no-transfer-progress -Pnative -DskipTests package
+
+outputArtifacts:
+  # - name: app_jar
+  #   type: BINARY
+  #   location: target/my-app-1.0-SNAPSHOT.jar
+  - name: app_native_executable
+    type: BINARY
+    location: target/my-app

oci-build-examples/oci_devops_graalee_micronaut/README.md

@@ -1,14 +1,14 @@
-# Using GraalVM Enterprise in OCI DevOps to build a Micronaut REST App
+# Using Oracle GraalVM in OCI DevOps to build a Micronaut REST App
 
-This sample shows how to use `Oracle GraalVM Enterprise Edition` in `OCI DevOps build pipelines` to build a simple Micronaut hello world REST application. You can use this approach to build any high-performance Java application with Micronaut, GraalVM Enterprise and OCI DevOps.
+This sample shows how to use `Oracle GraalVM` in `OCI DevOps build pipelines` to build a simple Micronaut hello world REST application. You can use this approach to build any high performance Java application with Micronaut, Oracle GraalVM and OCI DevOps.
 
 ## What is GraalVM?
 
-- Oracle GraalVM Enterprise is a high-performance JDK distribution that can accelerate any Java workload running on the HotSpot JVM.
+- GraalVM is a high performance JDK distribution that can accelerate any Java workload running on the HotSpot JVM.
 
-- Oracle GraalVM Enterprise Native Image ahead-of-time compilation enables you to build lightweight Java applications that are smaller, faster, and use less memory and CPU. At build time, GraalVM Native Image analyzes a Java application and its dependencies to identify just what classes, methods, and fields are necessary and generates optimized machine code for just those elements.
+- GraalVM Native Image ahead-of-time compilation enables you to build lightweight Java applications that are smaller, faster, and use less memory and CPU. At build time, GraalVM Native Image analyzes a Java application and its dependencies to identify just what classes, methods, and fields are necessary and generates optimized machine code for just those elements.
 
-- Oracle GraalVM Enterprise Edition is available for use on Oracle Cloud Infrastructure (OCI) at no additional cost.
+- Oracle GraalVM is available for use on Oracle Cloud Infrastructure (OCI) at no additional cost.
 
 ## What is Micronaut
 
@@ -32,7 +32,7 @@ This sample shows how to use `Oracle GraalVM Enterprise Edition` in `OCI DevOps
 ## Objectives
 
 - Create an OCI build pipeline.
-- Make a build using Oracle GraalVM Enterprise Edition.
+- Make a build using Oracle GraalVM.
 - Here the focus will be on the build specification and DevOps build pipeline
 
 
@@ -82,6 +82,7 @@ Allow dynamic-group  <YOUR_DynamicGroup_NAME> to use ons-topics in compartment <
 ![](images/oci_buildpipeline_managedbuild.png)
 
 - Click `Next` and provide the details.
+- In the `Build spec file path`, enter `build_spec.yaml` to use the [GraalVM Enterprise 22.x Java 17 build spec](build_spec.yaml). Alternatively, you can enter `build_spec_oracle_graalvm_jdk17.yaml` to use the [Oracle GraalVM for JDK 17 build spec](./build_spec_oracle_graalvm_jdk17.yaml) or `build_spec_oracle_graalvm_jdk20.yaml` to use the [Oracle GraalVM for JDK 20 build spec](./build_spec_oracle_graalvm_jdk20.yaml).
 
 ![](images/oci_buildstage_1.png)
 
@@ -96,14 +97,14 @@ Allow dynamic-group  <YOUR_DynamicGroup_NAME> to use ons-topics in compartment <
 
 ## Take a closer look at the build instructions below
 
-To install and use GraalVM Enterprise with Micronaut REST in the DevOps build pipeline, the build specification file is as follows:
+To install and use Oracle GraalVM with Micronaut REST in the DevOps build pipeline, the build specification file is as follows:
 
-1. Add the following command to install one or more required GraalVM Enterprise components. For example, this command installs Native Image along with the Java Development Kit (JDK) and other necessary dependencies.
+1. Add the following command to install the required Oracle GraalVM components. For example, this command installs Native Image along with the Java Development Kit (JDK) and other necessary dependencies.
 
     ```shell
     steps:
       - type: Command
-        name: "Install GraalVM Enterprise 22.x Native Image for Java17"
+        name: "Install Oracle GraalVM Enterprise 22.x Native Image for Java17"
         command: |
           yum -y install graalvm22-ee-17-native-image
     ```
@@ -170,7 +171,9 @@ To install and use GraalVM Enterprise with Micronaut REST in the DevOps build pi
         type: DOCKER_IMAGE
         location: ${TAG}
     ```
-Here's the complete [build specification](build_spec.yaml) file.
+Here's the complete [build specification for GraalVM Enterprise 22.x Java 17](build_spec.yaml) file. Alternatively, you can use the 
+[build specification for Oracle GraalVM for JDK 17](./build_spec_oracle_graalvm_jdk17.yaml) or
+[build specification for Oracle GraalVM for JDK 20](./build_spec_oracle_graalvm_jdk20.yaml).
 
 
 ## How to export the executable file outside of the build pipeline stage.
@@ -338,9 +341,9 @@ You can create an OCI Container registry and push the build container image whic
 References
 ==========
 
-- Using GraalVM Enterprise in DevOps Build Pipelines - https://docs.oracle.com/en-us/iaas/Content/devops/using/graalvm.htm
+- Using Oracle GraalVM in DevOps Build Pipelines - https://docs.oracle.com/en-us/iaas/Content/devops/using/graalvm.htm
 - Oracle Cloud Infrastructure DevOps - https://docs.oracle.com/en-us/iaas/Content/devops/using/home.htm
-- Oracle Graal VM Enterprise - https://www.oracle.com/java/graalvm/
+- Oracle GraalVM - https://www.oracle.com/java/graalvm/
 
 Contributors
 ===========

oci-build-examples/oci_devops_graalee_micronaut/build_spec_oracle_graalvm_jdk17.yaml

@@ -0,0 +1,54 @@
+version: 0.1
+component: build
+timeoutInSeconds: 900
+runAs: root
+shell: bash
+env:
+  variables:
+    "JAVA_HOME" : "/usr/lib64/graalvm/graalvm-java17"
+    # PATH is a reserved variable and cannot be defined as a variable.
+    # However, PATH can be changed in a build step and the change is visible in subsequent steps.
+    TAG: "mn-hello-ni:0.0.1"
+    APP_FILE: "MnHelloRest"
+
+  # exportedVariables are made available to use as parameters in sucessor Build Pipeline stages
+  # For this Build to run, the Build Pipeline needs to have a BUILDRUN_HASH parameter set
+  exportedVariables:
+    - BUILDRUN_HASH
+
+steps:
+  - type: Command
+    name: "Define unique image tag"
+    timeoutInSeconds: 140
+    command: |
+      echo "OCI_BUILD_RUN_ID: ${OCI_BUILD_RUN_ID}"
+      export BUILDRUN_HASH=`echo ${OCI_BUILD_RUN_ID} | rev | cut -c 1-7`
+      echo "BUILDRUN_HASH: " $BUILDRUN_HASH
+  - type: Command
+    name: "Install Oracle GraalVM for JDK 17 (Native Image and JDK)"
+    command: |
+      yum -y install graalvm-17-native-image
+  - type: Command
+    name: "Set PATH Variable."
+    command: |
+      export PATH=$JAVA_HOME/bin:$PATH
+  - type: Command
+    name: "Build a native executable"
+    command: |
+      ./mvnw --no-transfer-progress package -Dpackaging=native-image
+  - type: Command
+    name: "Build a container image with Native executable"
+    command: |
+      docker build -f ./Dockerfile \
+                  --build-arg APP_FILE=${APP_FILE} \
+                  -t ${TAG} .
+outputArtifacts:
+  - name: app_native_executable
+    type: BINARY
+    location: target/MnHelloRest
+  - name: runtime_image
+    type: DOCKER_IMAGE
+    # this is only the locally exported container image name
+    # this location tag doesn't affect the tag used to deliver the container image
+    # to the Container Registry.
+    location: ${TAG}