You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/getting-started/graalvm-community/container-images/graalvm-ce-container-images.md
+28-20Lines changed: 28 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,30 +24,34 @@ There are different images provided depending on the platforms, the architectur
24
24
GraalVM binaries are built for Linux, macOS, and Windows platforms on x86 64-bit systems, and for Linux on AArch64 architecture.
25
25
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]`.
26
26
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.
28
28
See what types of container images are available [here](https://github.com/graalvm/container).
29
29
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
32
31
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
+
```
37
41
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
42
49
```
43
50
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):
47
52
48
-
To add the Ruby support, run the following command (the output below is truncated for brevity):
49
53
```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
51
55
bash-4.4# gu install ruby
52
56
Downloading: Component catalog
53
57
Processing component archive: Component ruby
@@ -58,13 +62,13 @@ Downloading: Component ruby
58
62
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.
59
63
60
64
```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
62
66
```
63
67
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.
65
69
66
70
```shell
67
-
FROM ghcr.io/graalvm/jdk:ol8-java17-22.3.0
71
+
FROM ghcr.io/graalvm/graalvm-ce:22.3.1
68
72
RUN gu install ruby
69
73
WORKDIR /workdir
70
74
RUN echo'puts "Hello from Ruby!\nVersion: #{RUBY_DESCRIPTION}"'> app.rb
@@ -78,5 +82,9 @@ docker build -t ruby-demo .
78
82
...
79
83
docker run -it --rm ruby-demo
80
84
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]
82
86
```
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