[GR-64786] Revisit Oracle Linux support and installation guides to add OL 10.

PullRequest: graal/20738

Author: olyagpl

docs/getting-started/container-images/graalvm-ce-container-images.md

@@ -14,10 +14,10 @@ To support container-based development, GraalVM Community Edition container imag
 
 There are different GraalVM Community Edition container images provided depending on the architecture and the Java version, and have `-community` as part of their names.
 These are: **native-image-community**, **jdk-community**, **truffleruby-community**, **nodejs-community**, and **graalpy-community**.
-The container images are multi-arch, for x64 and AArch64 processor architectures, with a choice of Oracle Linux versions 8 or 9.
+The container images are multi-arch, for x64 and AArch64 processor architectures, with a choice of Oracle Linux versions 8, 9, and 10.
 
 GraalVM is installed in _/usr/lib64/graalvm/graalvm-community-java&lt;$FeatureVersion&gt;/_ where `<$FeatureVersion>` is `17`, `21`, `24`, and so on.
-For instance, GraalVM for JDK 24 is installed in _/usr/lib64/graalvm/graalvm-community-java24/_. 
+For instance, GraalVM for JDK 24 is installed in _/usr/lib64/graalvm/graalvm-community-java24/_.
 All binaries, including `java`, `javac`, `native-image`, and other binaries are available as global commands via the `alternatives` command.
 
 > Note: For GraalVM non-RPM based images (**graalvm-community**, **python-community**, **truffleruby-community**), the installation location is under _/opt/_ (_/opt/graalvm-community-java&lt;$FeatureVersion&gt;/_, _/opt/truffleruby-&lt;$GRAALVM_VERSION&gt;/_, and _/opt/graalpy-&lt;$GRAALVM_VERSION&gt;/_ respectively).
@@ -28,13 +28,13 @@ See a full list of GraalVM Community Edition container images [here](https://git
 
 ## Tags
 
-Each repository provides multiple tags that let you choose the level of stability you need including the Java version, build number, and the Oracle Linux version. 
+Each repository provides multiple tags that let you choose the level of stability you need including the Java version, build number, and the Oracle Linux version.
 Image tags use the following naming convention:
 ```bash
 $version[-muslib(for native image only)][-$platform][-$buildnumber]
 ```
 
-The following tags are listed from the most-specific tag (at the top) to the least-specific tag (at the bottom). 
+The following tags are listed from the most-specific tag (at the top) to the least-specific tag (at the bottom).
 The most-specific tag is unique and always points to the same image, while the less-specific tags point to newer image variants over time.
 For example:
 ```
@@ -51,23 +51,23 @@ For example:
     ```bash
     docker pull ghcr.io/graalvm/jdk-community:24
     ```
-    
+
     Alternatively, to use the container image as the base image in your Dockerfile, use:
     ```bash
     FROM ghcr.io/graalvm/jdk-community:24
     ```
     You have pulled a size compact GraalVM Community Edition container image with the GraalVM JDK and the Graal compiler preinstalled.
 
-2. To pull the container image with the `native-image` utility for a specific JDK feature version, such as _24_, run: 
+2. To pull the container image with the `native-image` utility for a specific JDK feature version, such as _24_, run:
     ```bash
     docker pull ghcr.io/graalvm/native-image-community:24
     ```
-    
+
     Alternatively, to pull the container image with the `native-image` utility with the `musl libc` toolchain to create fully statically linked executables, use:
     ```bash
     docker pull ghcr.io/graalvm/native-image-community:24-muslib
     ```
-    
+
     Alternatively, to use the container image as the base image in your Dockerfile, use:
     ```bash
     FROM ghcr.io/graalvm/native-image-community:24-muslib
@@ -88,7 +88,7 @@ For example:
     ```bash
     java -version
     ```
-    
+
     To check the `native-image` version, run:
     ```bash
     native-image --version
@@ -99,10 +99,10 @@ For example:
     docker pull --platform linux/aarch64 ghcr.io/graalvm/native-image-community:24
     ```
 
-## Oracle GraalVM Container Images 
+## Oracle GraalVM Container Images
 
-Oracle GraalVM container images are published in the [Oracle Container Registry](https://container-registry.oracle.com/ords/ocr/ba/graalvm) under the [GraalVM Free Terms and Conditions (GFTC) license](https://www.oracle.com/downloads/licenses/graal-free-license.html). 
-Learn more at the [Oracle Help Center](https://docs.oracle.com/en/graalvm/jdk/24/docs/getting-started/container-images/).
+Oracle GraalVM container images are published in the [Oracle Container Registry (OCR)](https://container-registry.oracle.com/ords/ocr/ba/graalvm) and include [GFTC-licensed](https://www.oracle.com/downloads/licenses/graal-free-license.html) Oracle GraalVM.
+Learn more in the [Oracle GraalVM Container Images documentation](https://docs.oracle.com/en/graalvm/jdk/24/docs/getting-started/container-images/).
 
 ### Related Documentation
 

docs/getting-started/container-images/oracle-graalvm-container-images.md

@@ -7,18 +7,18 @@ permalink: /getting-started/container-images/
 
 ## Oracle GraalVM Container Images
 
-Oracle GraalVM container images are available in [Oracle Container Registry (OCR)](https://container-registry.oracle.com/ords/ocr/ba/graalvm) under the [GraalVM Free Terms and Conditions (GFTC) license](https://www.oracle.com/downloads/licenses/graal-free-license.html).
+Oracle GraalVM container images are published in the [Oracle Container Registry (OCR)](https://container-registry.oracle.com/ords/ocr/ba/graalvm) and include [GFTC-licensed](https://www.oracle.com/downloads/licenses/graal-free-license.html) Oracle GraalVM.
 
 ## Repositories
 
-Oracle GraalVM container images are published in two OCR repositories: **jdk** and **native-image**. 
+Oracle GraalVM container images are published in two OCR repositories: **jdk** and **native-image**.
 
 | Repository       | Description |
 |------------------|-------------|
 | **jdk**          | Provides container images with Oracle GraalVM JDK (without the `native-image` utility) which can be used to both compile and deploy a Java application. Use the container image tags to select the appropriate Java version and Oracle Linux version. |
 | **native-image** | Provides Oracle GraalVM container images with the `native-image` utility along with all tools required to compile an application into a native Linux executable. These images are commonly used in multistage builds to compile an application into an executable that is then packaged in a lightweight container image. Use the container image tags to select the Java version and Oracle Linux version as well as variants that include the `musl` toolchain for the creation of a fully statically linked executable. |
 
-Both repositories provide container images for x64 and AArch64 processor architectures, with a choice of Oracle Linux versions 8 or 9.
+Both repositories provide container images for x64 and AArch64 processor architectures, with a choice of Oracle Linux versions 8, 9, and 10.
 
 Oracle GraalVM is installed in _/usr/lib64/graalvm/graalvm-java&lt;$FeatureVersion&gt;/_ where `<$FeatureVersion>` is `17`, `21`, `24`, and so on.
 
@@ -27,13 +27,13 @@ All binaries, including `java`, `javac`, `native-image`, and other binaries are
 
 ## Tags
 
-Each repository provides multiple tags that let you choose the level of stability you need including the Java version, build number, and the Oracle Linux version. 
+Each repository provides multiple tags that let you choose the level of stability you need including the Java version, build number, and the Oracle Linux version.
 Oracle GraalVM container image tags use the following naming convention:
 ```bash
 $version[-muslib(for native image only)][-$platform][-$buildnumber]
 ```
 
-The following tags are listed from the most-specific tag (at the top) to the least-specific tag (at the bottom). 
+The following tags are listed from the most-specific tag (at the top) to the least-specific tag (at the bottom).
 The most-specific tag is unique and always points to the same container image, while the less-specific tags point to newer container image variants over time.
 ```
 24.0.1-ol9-20250318
@@ -49,27 +49,27 @@ The most-specific tag is unique and always points to the same container image, w
     ```bash
     docker pull container-registry.oracle.com/graalvm/jdk:24
     ```
-    
+
     Alternatively, to use the container image as the base image in your Dockerfile, use:
     ```bash
     FROM container-registry.oracle.com/graalvm/jdk:24
     ```
 
-2.  To pull the container image for Oracle GraalVM `native-image` utility for a specific JDK feature version, such as _24_, run: 
+2.  To pull the container image for Oracle GraalVM `native-image` utility for a specific JDK feature version, such as _24_, run:
     ```bash
     docker pull container-registry.oracle.com/graalvm/native-image:24
     ```
-    
+
     Alternatively, to pull the container image for Oracle GraalVM `native-image` utility with the `musl libc` toolchain to create fully statically linked executables, run:
     ```bash
     docker pull container-registry.oracle.com/graalvm/native-image:24-muslib
     ```
-    
+
     Alternatively, to use the container image as the base image in your Dockerfile, use:
     ```bash
     FROM container-registry.oracle.com/graalvm/native-image:24-muslib
     ```
-    
+
 3. To verify, start the container and enter a Bash session:
     ```bash
     docker run -it --rm --entrypoint /bin/bash container-registry.oracle.com/graalvm/native-image:24
@@ -86,13 +86,13 @@ The most-specific tag is unique and always points to the same container image, w
     java -version
     ```
     The output shows the installed Oracle GraalVM Java runtime environment and version information.
-    
+
     To check the `native-image` version, run the following command from the Bash prompt:
     ```bash
     native-image --version
     ```
     The output shows the installed Oracle GraalVM `native-image` utility version information.
-    
+
 4. A `docker pull` command that omits a processor architecture pulls a container image for the processor architecture that matches your Docker client. To pull a container image for a different platform architecture, specify the desired platform architecture with the `--platform` option and either `linux/amd64` or `linux/aarch64` as follows:
     ```bash
     docker pull --platform linux/aarch64 container-registry.oracle.com/graalvm/native-image:24

docs/getting-started/oci/installation-compute-instance-with-OL.md

@@ -5,7 +5,7 @@ permalink: /getting-started/oci/compute-instance/
 
 # Oracle GraalVM on an OCI Compute Instance with Oracle Linux
 
-This guide describes how to install Oracle GraalVM on an Oracle Cloud Infrastructure (OCI) Compute instance with Oracle Linux 7, 8, and 9.
+This guide describes how to install Oracle GraalVM on an Oracle Cloud Infrastructure (OCI) Compute instance with Oracle Linux 7, 8, 9, and 10.
 For complete beginners, [start with this tutorial to create and launch your first Linux instance](https://docs.oracle.com/iaas/Content/GSG/Reference/overviewworkflow.htm).
 
 > Note: Oracle GraalVM license and support are included in the Oracle Cloud Infrastructure subscription at no additional cost.
@@ -30,51 +30,28 @@ ssh -i .ssh/id_rsa opc@INSTANCE_PUBLIC_IP
 Where `.ssh/id_rsa` is the full path and name of the file containing your private SSH key; `opc` is the default name for the Oracle Linux image; and `INSTANCE_PUBLIC_IP` is the instance IP address provisioned from the console.
 For more details, refer to the [Connecting to Your Linux Instance Using SSH](https://docs.cloud.oracle.com/iaas/Content/GSG/Tasks/testingconnection.htm) tutorial.
 
-The installation steps may differ per Oracle Linux version or package manager. 
+The installation steps may differ per Oracle Linux version or package manager.
 
-### Oracle Linux 7
-
-1. Install a newer devtoolset with GCC version 10 (required by Oracle GraalVM Native Image):
-   ```bash
-   sudo yum -y install oracle-softwarecollection-release-el7
-   ```
-   ```bash
-   sudo yum install devtoolset-10
-   ```
-2. Enable the newer devtoolset by default:
-   ```bash
-   echo 'source scl_source enable devtoolset-10' >> ~/.bashrc
-   ```
-3. Enter a new bash session with the newer devtoolset enabled:
-   ```
-   bash
-   ```
-4. Install the latest Oracle GraalVM:
-   ```
-   sudo yum install graalvm-24-native-image
-   ```
-   Confirm that the installed package size is correct by entering `yes` at the prompt.
+### Oracle Linux 10
 
-### Oracle Linux 8
-
-On Oracle Linux 8 with the `yum` package manager, run these commands one by one:
+On Oracle Linux 10 with the `yum` package manager, run these commands one by one:
 ```bash
-sudo yum update -y oraclelinux-release-el8
+sudo yum update -y oraclelinux-release-el10
 ```
 ```bash
-sudo yum config-manager --set-enabled ol8_codeready_builder
+sudo yum config-manager --set-enabled el10_codeready_builder
 ```
 ```bash
 sudo yum install graalvm-24-native-image
 ```
 Confirm that the installed package size is correct by entering `yes` at the prompt.
 
-On Oracle Linux 8 with `dnf` or `microdnf` default package managers, run these commands one by one:
+On Oracle Linux 10 with `dnf` or `microdnf` default package managers, run these commands one by one:
 ```bash
-sudo dnf update -y oraclelinux-release-el8
+sudo dnf update -y oraclelinux-release-el10
 ```
 ```bash
-sudo dnf config-manager --set-enabled ol8_codeready_builder
+sudo dnf config-manager --set-enabled el10_codeready_builder
 ```
 ```bash
 sudo dnf install graalvm-24-native-image
@@ -105,9 +82,58 @@ sudo dnf config-manager --set-enabled ol9_codeready_builder
 sudo dnf install graalvm-24-native-image
 ```
 
-### Configure Environment Variables
+### Oracle Linux 8
+
+On Oracle Linux 8 with the `yum` package manager, run these commands one by one:
+```bash
+sudo yum update -y oraclelinux-release-el8
+```
+```bash
+sudo yum config-manager --set-enabled ol8_codeready_builder
+```
+```bash
+sudo yum install graalvm-24-native-image
+```
+Confirm that the installed package size is correct by entering `yes` at the prompt.
+
+On Oracle Linux 8 with `dnf` or `microdnf` default package managers, run these commands one by one:
+```bash
+sudo dnf update -y oraclelinux-release-el8
+```
+```bash
+sudo dnf config-manager --set-enabled ol8_codeready_builder
+```
+```bash
+sudo dnf install graalvm-24-native-image
+```
+
+### Oracle Linux 7
+
+1. Install a newer devtoolset with GCC version 10 (required by Oracle GraalVM Native Image):
+   ```bash
+   sudo yum -y install oracle-softwarecollection-release-el7
+   ```
+   ```bash
+   sudo yum install devtoolset-10
+   ```
+2. Enable the newer devtoolset by default:
+   ```bash
+   echo 'source scl_source enable devtoolset-10' >> ~/.bashrc
+   ```
+3. Enter a new bash session with the newer devtoolset enabled:
+   ```
+   bash
+   ```
+4. Install the latest Oracle GraalVM:
+   ```
+   sudo yum install graalvm-24-native-image
+   ```
+   Confirm that the installed package size is correct by entering `yes` at the prompt.
+
+
+## Configure Environment Variables
 
-Configure environment variables to point to the Oracle GraalVM installation for this SSH session. 
+Configure environment variables to point to the Oracle GraalVM installation for this SSH session.
 After installation, the package files are placed in the _/usr/lib64/graalvm_ directory, and binaries in _bin_ accordingly.
 
 1. Set the values of the `PATH` and `JAVA_HOME` environment variables in the bash configuration to point to the location of the Oracle GraalVM installation with the following commands:

docs/getting-started/oci/installation-devops-build-pipeline.md

@@ -10,7 +10,7 @@ This guide describes how to use Oracle GraalVM in the Oracle Cloud Infrastructur
 
 > Note: Oracle GraalVM license and support are included in the Oracle Cloud Infrastructure subscription at no additional cost.
 
-OCI DevOps service provides build runners with Oracle Linux 7 as the base container image along with a number of [runtimes and tools](https://docs.oracle.com/en-us/iaas/Content/devops/using/runtime_details.htm).
+OCI DevOps service provides build runners with Oracle Linux 8 as the base container image along with a number of [runtimes and tools](https://docs.oracle.com/en-us/iaas/Content/devops/using/runtime_details.htm).
 
 Oracle GraalVM RPMs are available in the Oracle YUM repository.
 Each RPM is self-contained and will automatically pull in all its required dependencies.
@@ -26,12 +26,13 @@ To work with a Build Pipeline, add statements to a [build specification file](ht
 The DevOps CI/CD platform reads the file and runs the commands one by one.
 You do not need to run a YUM package manager command manually.
 
-The RPM package for Oracle GraalVM for JDK 24 is available with the package name `graalvm-24-native-image`.
+RPMs for Oracle GraalVM are available with the package names `graalvm-17-native-image`, `graalvm-21-native-image`, and `graalvm-24-native-image`.
 Each package includes the JDK and the Native Image tool.
 
 To install and use Oracle GraalVM in your DevOps Build Pipeline, update your build specification file as shown in the following example.
 
 1. Add a command to install Oracle GraalVM for JDK 24 with Native Image and Java Development Kit (JDK):
+
     ```yml
     steps:
     - type: Command
@@ -41,13 +42,15 @@ To install and use Oracle GraalVM in your DevOps Build Pipeline, update your bui
     ```
 
 2. Add a command to set the value of the `JAVA_HOME` environment variable for Oracle GraalVM for JDK 24:
+
     ```yml
     env:
     variables:
         "JAVA_HOME" : "/usr/lib64/graalvm/graalvm-java24"
     ```
 
 3. Add the command to set the value of the `PATH` environment variable:
+
     ```yml
     env:
     variables:
@@ -71,7 +74,7 @@ yum list graalvm-24*
 ...
 ```
 
-To try this feature out, use the sample project: [Using Oracle GraalVM in OCI DevOps Build Pipelines](https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_devops_build_with_graalenterprise). 
+To try this feature out, use the sample project: [Using Oracle GraalVM in OCI DevOps Build Pipelines](https://github.com/oracle-devrel/oci-devops-examples/tree/main/oci-build-examples/oci_devops_build_with_graalenterprise).
 It describes how to set up Oracle GraalVM in OCI DevOps service, create a Build Pipeline, add build stages, and so on.
 
 ### Related Documentation