Skip to content

Commit 8956e3d

Browse files
committed
[GR-44072] Review and correct inconsistencies in GraalVM Community Images guide.
PullRequest: graal/13731
2 parents 524d519 + 69841a9 commit 8956e3d

File tree

1 file changed

+28
-20
lines changed

1 file changed

+28
-20
lines changed

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

Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -24,30 +24,34 @@ There are different images provided depending on the platforms, the architectur
2424
GraalVM binaries are built for Linux, macOS, and Windows platforms on x86 64-bit systems, and for Linux on AArch64 architecture.
2525
The images are multi-arch (`aarch64` or `amd64` will be pulled depending on Docker host architecture), and tagged with the format `ghcr.io/graalvm/$IMAGE_NAME[:][$os_version][-$java_version][-$version][-$build_number]`.
2626
The version tag defines the level of specificity.
27-
It is recommended that the most specific tag be used, e.g., `java17-22.3.0` or `java17-22.3.0-b1`, where the `-b1` means the image required a patch and this specific build will never change.
27+
It is recommended that the most specific tag be used, e.g., `java17-22.3.1` or `java17-22.3.1-b1`, where the `-b1` means the image required a patch and this specific build will never change.
2828
See what types of container images are available [here](https://github.com/graalvm/container).
2929

30-
The images are based on Oracle Linux and has GraalVM Community downloaded, unzipped and made available.
31-
It means that Java and the LLVM runtime are available out of the box.
30+
## Get Started
3231

33-
You can start a container and enter the `bash` session with the following run command:
34-
```shell
35-
docker run -it --rm ghcr.io/graalvm/jdk:ol8-java17-22.3.0 bash
36-
```
32+
1. Start a container and enter the `bash` session with the following run command:
33+
```shell
34+
docker run -it --rm ghcr.io/graalvm/jdk:ol8-java17-22.3.1 bash
35+
```
36+
2. Check the `java` version:
37+
```shell
38+
→docker run -it --rm ghcr.io/graalvm/jdk:ol8-java17-22.3.1 bash
39+
bash-4.4# java -version
40+
```
3741

38-
Check the `java` version:
39-
```shell
40-
→docker run -it --rm ghcr.io/graalvm/jdk:ol8-java17-22.3.0 bash
41-
bash-4.4# java -version
42+
You have pulled a size compact GraalVM Community container image with the GraalVM JDK pre-installed and the Graal compiler.
43+
44+
Size compact images are based on GraalVM components RPMs that are available for Oracle Linux 7, Oracle Linux 8, and Oracle Linux 9. Similar to any other available packages, you can install these components using `yum` on Oracle Linux 7 or `microdnf` on the Oracle Linux 8 and Oracle Linux 9 based images.
45+
46+
To pull a GraalVM Community Edition container image containing the [`gu` utility](../../../reference-manual/graalvm-updater.md) for installing additional components, run this command:
47+
```
48+
docker pull ghcr.io/graalvm/graalvm-ce:22.3.1
4249
```
4350
44-
You have pulled a size compact GraalVM Community container image with the GraalVM JDK pre-installed and the Graal compiler.
45-
You will also find the [`gu` utility](../../../reference-manual/graalvm-updater.md) in the image that can be used to install additional languages and runtimes like JavaScript, Node.js, LLVM, Ruby, R, Python or WebAssembly.
46-
Check what other configuration types of container images are available [here](https://github.com/graalvm/container).
51+
GraalVM Updater, `gu`, can be used to install additional GraalVM language runtimes like JavaScript, Node.js, LLVM, Ruby, R, Python, and WebAssembly. For example, tp add the Ruby support, run the following command (the output below is truncated for brevity):
4752
48-
To add the Ruby support, run the following command (the output below is truncated for brevity):
4953
```shell
50-
docker run -it --rm ghcr.io/graalvm/jdk:ol8-java17-22.3.0 bash
54+
docker run -it --rm ghcr.io/graalvm/graalvm-ce:22.3.1 bash
5155
bash-4.4# gu install ruby
5256
Downloading: Component catalog
5357
Processing component archive: Component ruby
@@ -58,13 +62,13 @@ Downloading: Component ruby
5862
Here is a sample command that maps the `/absolute/path/to/directory/no/trailing/slash` directory from the host system to the `/path/inside/container` inside the container.
5963

6064
```shell
61-
docker run -it --rm -v /absolute/path/to/directory/no/trailing/slash:/path/inside/container ghcr.io/graalvm/jdk:ol8-java17-22.3.0 bash
65+
docker run -it --rm -v /absolute/path/to/directory/no/trailing/slash:/path/inside/container ghcr.io/graalvm/graalvm-ce:22.3.1 bash
6266
```
6367

64-
If you want to create Docker images that contain GraalVM with Ruby, R, or Python, you can use a Dockerfile like the example below, which uses `ghcr.io/graalvm/jdk:ol8-java17-22.3.0` as the base image, installs the Ruby support using the `gu` utility, then creates and runs a sample Ruby program.
68+
If you want to create Docker images that contain GraalVM with Ruby, R, or Python, you can use a Dockerfile like the example below, which uses `ghcr.io/graalvm/graalvm-ce:22.3.1` as the base image, installs the Ruby support using the `gu` utility, then creates and runs a sample Ruby program.
6569

6670
```shell
67-
FROM ghcr.io/graalvm/jdk:ol8-java17-22.3.0
71+
FROM ghcr.io/graalvm/graalvm-ce:22.3.1
6872
RUN gu install ruby
6973
WORKDIR /workdir
7074
RUN echo 'puts "Hello from Ruby!\nVersion: #{RUBY_DESCRIPTION}"' > app.rb
@@ -78,5 +82,9 @@ docker build -t ruby-demo .
7882
...
7983
docker run -it --rm ruby-demo
8084
Hello from Ruby!
81-
Version: truffleruby 22.3.0, like ruby 3.0.3, GraalVM CE Native [x86_64-darwin]
85+
Version: truffleruby 22.3.1, like ruby 3.0.3, GraalVM CE Native [x86_64-darwin]
8286
```
87+
88+
Check what other configuration types of container images are available [here](https://github.com/graalvm/container).
89+
90+
If you look for Oracle GraalVM Enterprise container images, they are published in the [Oracle Container Registry](https://container-registry.oracle.com/ords/f?p=113:10::::::). See [here](https://docs.oracle.com/en/graalvm/enterprise/22/docs/getting-started/container-images/) to learn more.

0 commit comments

Comments
 (0)