|
1 | 1 | # GitHub Action for GraalVM [](https://github.com/graalvm/setup-graalvm/actions/workflows/ci.yml)
|
2 |
| -This GitHub action sets up [Oracle GraalVM][graalvm-medium], GraalVM [Community Edition (CE)][repo], [Enterprise Edition (EE)][graalvm-ee], [Mandrel][mandrel], or [Liberica Native Image Kit][liberica] as well as [Native Image][native-image] and GraalVM components such as [Truffle languages][truffle-languages]. |
| 2 | + |
| 3 | +Set up your GitHub Actions workflow with a specific [GraalVM][graalvm] distribution, and use it both as your JDK and for [ahead-of-time Native Image compilation][graalvm]. |
| 4 | + |
3 | 5 |
|
4 | 6 | ## Key Features
|
5 | 7 |
|
6 | 8 | This action:
|
7 | 9 |
|
8 | 10 | - supports Oracle GraalVM [releases][graalvm-dl], [EA builds][ea-builds], GraalVM Community Edition (CE) [releases], [dev builds][dev-builds], GraalVM Enterprise Edition (EE) [releases][graalvm-ee] (set [`gds-token`](#options)) 22.1.0 and later, [Mandrel][mandrel], and [Liberica Native Image Kit][liberica] (see [Options](#options))
|
9 | 11 | - exports a `$GRAALVM_HOME` environment variable
|
10 |
| -- adds `$GRAALVM_HOME/bin` to the `$PATH` environment variable<br>(Native Image, Truffle languages, and tools can be invoked directly) |
| 12 | +- adds `$GRAALVM_HOME/bin` to the `$PATH` environment variable<br>(`native-image`, `javac`, and other JDK tools can be invoked directly) |
11 | 13 | - sets `$JAVA_HOME` to `$GRAALVM_HOME` by default<br>(can be disabled via `set-java-home: 'false'`, see [Options](#options))
|
12 | 14 | - supports `x64` and `aarch64/arm64` (see how to use [Linux arm64 runners](https://github.blog/changelog/2025-01-16-linux-arm64-hosted-runners-now-available-for-free-in-public-repositories-public-preview/))
|
13 | 15 | - supports dependency caching for Apache Maven, Gradle, and sbt (see [`cache` option](#options))
|
14 |
| -- sets up Windows environments with build tools using [vcvarsall.bat][vcvarsall] |
15 |
| -- has built-in support for GraalVM components and the [GraalVM Updater][gu] |
16 | 16 |
|
17 | 17 |
|
18 | 18 | ## Templates
|
@@ -270,21 +270,16 @@ Only pull requests from committers that can be verified as having signed the OCA
|
270 | 270 | [gha-self-hosted-runners]: https://docs.github.com/en/actions/hosting-your-own-runners/about-self-hosted-runners
|
271 | 271 | [gu]: https://www.graalvm.org/reference-manual/graalvm-updater/
|
272 | 272 | [graalvm]: https://www.graalvm.org/
|
273 |
| -[graalvm-dl]: https://www.oracle.com/java/technologies/downloads/ |
274 |
| -[graalvm-medium]: https://medium.com/graalvm/a-new-graalvm-release-and-new-free-license-4aab483692f5 |
| 273 | +[graalvm-dl]: https://www.graalvm.org/downloads/ |
275 | 274 | [graalvm-ee]: https://www.oracle.com/downloads/graalvm-downloads.html
|
276 | 275 | [liberica]: https://bell-sw.com/liberica-native-image-kit/
|
277 | 276 | [mandrel]: https://github.com/graalvm/mandrel
|
278 | 277 | [mandrel-releases]: https://github.com/graalvm/mandrel/releases
|
279 | 278 | [mandrel-stable]: https://github.com/graalvm/mandrel/releases/latest
|
280 | 279 | [musl]: https://musl.libc.org/
|
281 |
| -[native-image]: https://www.graalvm.org/native-image/ |
282 | 280 | [native-image-musl-build]: https://github.com/graalvm/setup-graalvm/blob/778131f1d6837ccd4b2e91382c31830896a2d56e/.github/workflows/test.yml#L74-L92
|
283 | 281 | [native-image-static]: https://github.com/oracle/graal/blob/fa6f4a974dedacf4688dcc430dd100849d9882f2/docs/reference-manual/native-image/StaticImages.md
|
284 | 282 | [oca]: https://oca.opensource.oracle.com
|
285 | 283 | [releases]: https://github.com/graalvm/graalvm-ce-builds/releases
|
286 |
| -[repo]: https://github.com/oracle/graal |
287 | 284 | [setup-java-caching]: https://github.com/actions/setup-java/tree/5b36705a13905facb447b6812d613a06a07e371d#caching-packages-dependencies
|
288 | 285 | [stable]: https://github.com/graalvm/graalvm-ce-builds/releases/latest
|
289 |
| -[truffle-languages]: https://www.graalvm.org/reference-manual/languages/ |
290 |
| -[vcvarsall]: https://docs.microsoft.com/en-us/cpp/build/building-on-the-command-line |
0 commit comments