Skip to content

Latest commit

 

History

History
158 lines (105 loc) · 5.61 KB

README-Cloud-Shell.md

File metadata and controls

158 lines (105 loc) · 5.61 KB
Raw

Spring Boot Microservice with Oracle GraalVM in OCI Cloud Shell

This part shows how you can get started quickly with Oracle GraalVM in Oracle Cloud Infrastructure (OCI) Cloud Shell using the Spring Boot 3 microservice example.

Oracle GraalVM is available for use on Oracle Cloud Infrastructure (OCI) at no additional cost.

What is Cloud Shell?

Cloud Shell is a free-to-use browser-based terminal accessible from the Oracle Cloud Console. It provides access to a Linux shell with preinstalled developer tools and a pre-authenticated OCI CLI. You can use the shell to interact with OCI resources, follow labs and tutorials, and quickly run utility commands.

Oracle GraalVM for JDK 17 (with Native Image) is preinstalled in Cloud Shell, so you don’t have to install and configure a development machine to get started.

Step 1: Launch Cloud Shell

Login to OCI Console and launch Cloud Shell.

Step 2: Select GraalVM as the Current JDK

  1. List the installed JDKs:

    csruntimectl java list

    The output should be similar to (versions may vary):

      graalvmjdk-17                                                      /usr/lib64/graalvm/graalvm-java17
* oraclejdk-11                                                                   /usr/java/jdk-11.0.17
  oraclejdk-1.8                                                        /usr/lib/jvm/jdk-1.8-oracle-x64

  2. Select GraalVM as the current JDK:

    csruntimectl java set graalvmjdk-17

    The output should be similar to:

    The current managed java version is set to graalvmjdk-17.

Step 3: (Optional) Confirm Software Version and Environment Variables

This step is optional - Check software version and environment variables

Step 4: Set up Your Project, Build and Run a JAR

  1. Git clone this example.

    git init graalvmee-spring-native-image

cd graalvmee-spring-native-image

git remote add origin https://github.com/graalvm/graalvm-demos.git

git config core.sparsecheckout true

echo "spring-native-image/*">>.git/info/sparse-checkout

git pull --depth=1 origin master

cd spring-native-image

  2. Build a JAR file for the example app.

    mvn clean package

  3. Run the app JAR in the background.

    java -jar ./target/benchmark-jibber-0.0.1-SNAPSHOT.jar &

  4. Test the app JAR.

    curl http://localhost:8080/jibber

    It should generate a random nonsense verse in the style of the poem Jabberwocky by Lewis Carrol. The output should be similar to:

    ...
And, as in uffish thought he stood, The Jabberwock, my beamish boy!<br/>
’Twas brillig, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And burbled as it came!<br/>
He left it dead, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And the mome raths outgrabe.<br/>
Beware the Jubjub bird, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And burbled as it came!<br/>
Beware the Jabberwock, my beamish boy!<br/>
Beware the Jubjub bird, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And the mome raths outgrabe.<br/>
’Twas brillig, and with its head He went galumphing back.<br/>
And, as in uffish thought he stood, The Jabberwock, my son!<br/>
Come to my arms, my son!<br/>
’Twas brillig, and shun The frumious Bandersnatch!<br/>

  5. Bring the running app JAR in the foreground

    fg

  6. Once the app is running in the foreground, press CTRL+C to stop it.

Step 5: Build and Run a Native Executable

Now build a native executable for your Spring Boot microservice using Oracle GraalVM Native Image.

  1. Build the app native executable

    mvn -Pnative native:compile

    This will create a binary executable target/benchmark-jibber.

  2. Run the app native executable in the background

    ./target/benchmark-jibber &

  3. Test the app native executable

    curl http://localhost:8080/jibber

    It should generate a random nonsense verse in the style of the poem Jabberwocky by Lewis Carrol. The output should be similar to:

    ...
The Jabberwock, my beamish boy!<br/>
Beware the Jubjub bird, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And the mome raths outgrabe.<br/>
Beware the Jubjub bird, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And burbled as it came!<br/>
Beware the Jabberwock, with eyes of flame, Came whiffling through the tulgey wood, And the mome raths outgrabe.<br/>
He left it dead, and shun The frumious Bandersnatch!<br/>
He left it dead, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And the mome raths outgrabe.<br/>
’Twas brillig, and the slithy toves Did gyre and gimble in the wabe: All mimsy were the borogoves, And burbled as it came!<br/>
’Twas brillig, and with its head He went galumphing back.<br/>
Come to my arms, my son!<br/>
Beware the Jabberwock, with eyes of flame, Came whiffling through the tulgey wood, And burbled as it came!<br/>

  4. Bring the running app native executable in the foreground

    fg

  5. Once the app is running in the foreground, press CTRL+C to stop it.