geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rmannibu...@apache.org
Subject svn commit: r1052175 - in /websites/production/geronimo/content/arthur: implementation.html index.html maven.html
Date Wed, 30 Oct 2019 17:08:16 GMT
Author: rmannibucau
Date: Wed Oct 30 17:08:16 2019
New Revision: 1052175

Log:
Site checkin for project Arthur :: Documentation

Modified:
    websites/production/geronimo/content/arthur/implementation.html
    websites/production/geronimo/content/arthur/index.html
    websites/production/geronimo/content/arthur/maven.html

Modified: websites/production/geronimo/content/arthur/implementation.html
==============================================================================
--- websites/production/geronimo/content/arthur/implementation.html (original)
+++ websites/production/geronimo/content/arthur/implementation.html Wed Oct 30 17:08:16 2019
@@ -136,6 +136,53 @@ You will likely want to add these depend
 }</code></pre>
 </div>
 </div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_graalvm_installer">GraalVM Installer</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>The implementation module also contains the building block to install GraalVM locally.
+It is based on <code>org.apache.geronimo.arthur.impl.nativeimage.installer.SdkmanGraalVMInstaller</code>.
+The high level mecanism is to download it from an URL and cache it locally (archive + exploded
folder).
+For that it needs an "extractor" implementation which supports <code>tar.gz</code>
on linux and <code>zip</code> on windows/cygwin.
+You can use the provided <code>Extractor</code> class but then you need to add
<code>commons-compress</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-xml" data-lang="xml">&lt;dependency&gt;
+  &lt;groupId&gt;org.apache.commons&lt;/groupId&gt;
+  &lt;artifactId&gt;commons-compress&lt;/artifactId&gt;
+  &lt;version&gt;1.19&lt;/version&gt;
+&lt;/dependency&gt;</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Once done the usage is pretty straigh forward:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-java" data-lang="java">final Path
cache = Paths.get("cached-graal.tar.gz");
+final Path workdir = Paths.get(System.getProperty("java.io.tmpdir")).resolve("graal_work_dir");
+final SdkmanGraalVMInstallerConfiguration config = SdkmanGraalVMInstallerConfiguration.builder()
+    .offline(offline)
+    .inheritIO(inheritIO)
+    .url("https://api.sdkman.io/2/broker/download/java/19.2.1-grl/linux64")
+    .version("19.2.1")
+    .platform("linux64")
+    .gav("com.oracle.graal:graalvm:tar.gz:19.2.1")
+    .workdir(workdir)
+    // use built-in commons-compress based extractor, alternative you can do an exec of tar
command if preferred
+    .extractor(new Extractor()::unpack)
+    // hardcoded cache
+    .resolver(gav -&gt; cache)
+    .installer((gav, file) -&gt; Files.copy(file, cache))
+    .build();
+final SdkmanGraalVMInstaller graalInstaller = new SdkmanGraalVMInstaller(config);
+final Path graalHome = graalInstaller.install();
+configuration.setNativeImage(graalInstaller.installNativeImage().toAbsolutePath().toString());</code></pre>
+</div>
+</div>
 <hr>
 <div class="paragraph">
 <p>Previous: <a href="spi.html">Arthur SPI</a> Next: <a href="maven.html">Arthur
Maven Plugin</a></p>

Modified: websites/production/geronimo/content/arthur/index.html
==============================================================================
--- websites/production/geronimo/content/arthur/index.html (original)
+++ websites/production/geronimo/content/arthur/index.html Wed Oct 30 17:08:16 2019
@@ -68,7 +68,7 @@
 <h2 id="_graalvm_for_everyone">GraalVM for everyone</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>Apache Geronimo Arthur is an effort to buil a thin layer on top of Oracle GraalVM
to build native binaries from your Java programs.</p>
+<p>Apache Geronimo Arthur is an effort to build a thin layer on top of Oracle GraalVM
to build native binaries from your Java programs.</p>
 </div>
 <div class="paragraph">
 <p>Learn more on our <a href="documentation.html">documentation</a>.</p>

Modified: websites/production/geronimo/content/arthur/maven.html
==============================================================================
--- websites/production/geronimo/content/arthur/maven.html (original)
+++ websites/production/geronimo/content/arthur/maven.html Wed Oct 30 17:08:16 2019
@@ -388,7 +388,7 @@ Here is the full list of available confi
 <td class="tableblock halign-left valign-top"><p class="tableblock">graalExtensions</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">List</p></td>
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
-<p>{@code &lt;groupId&gt;:&lt;artifactId&gt;[:&lt;extension&gt;[:&lt;classifier&gt;]]:&lt;version&gt;}
list of artifacts appended to graal build.</p>
+<p><code>&lt;groupId&gt;:&lt;artifactId&gt;[:&lt;extension&gt;[:&lt;classifier&gt;]]:&lt;version&gt;</code>
list of artifacts appended to graal build.</p>
 </div>
 <div class="paragraph">
 <p><strong>Default value</strong>: -</p>
@@ -658,6 +658,19 @@ Here is the full list of available confi
 </div></div></td>
 </tr>
 <tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">scanningExcludedArtifacts</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">List</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
+<p>groupId:artifactId list of ignored artifact during the scanning phase.Compared to
<code>excludedArtifacts</code>, it keeps the jar in the scanning/extension classloaderbut
it does not enable to find any annotation in it.Note that putting <code>*</code>
will disable the scanning completely.</p>
+</div>
+<div class="paragraph">
+<p><strong>Default value</strong>: -</p>
+</div>
+<div class="paragraph">
+<p><strong>User property</strong>: arthur.scanningExcludedArtifacts</p>
+</div></div></td>
+</tr>
+<tr>
 <td class="tableblock halign-left valign-top"><p class="tableblock">skip</p></td>
 <td class="tableblock halign-left valign-top"><p class="tableblock">boolean</p></td>
 <td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">



Mime
View raw message