](https://hub.docker.com/r/marksailes/al2-graalvm) [marksailes/al2-graalvm](https://hub.docker.com/r/marksailes/al2-graalvm)
16 |
17 | If you would like to contribute to this effort / make improvements, please open an issue or pull request.
18 |
19 | [
](https://github.com/marksailes/al2-graalvm) [marksailes/al2-graalvm](https://github.com/marksailes/al2-graalvm)
20 |
21 |
--------------------------------------------------------------------------------
/quickstart/content/summary/how-it-works.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "How GraalVM works on AWS Lambda"
3 | description: "The steps and details involved for running GraalVM native image on AWS Lambda"
4 | date: 2021-05-08T12:30:39+01:00
5 | draft: false
6 | weight: 30
7 | ---
8 |
9 | # Lambda with a Managed Java Runtime
10 |
11 | For example the managed Java runtimes (Java 8, Java 8 Corretto and Java 11) you supply your code as a .zip or a .jar.
12 | AWS provisions a FireCracker MicroVM, downloads your code to it, starts the JVM and loads your code. On your
13 | behalf an AWS managed implementation of the [Runtime API](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-api.html)
14 | is asking Lambda for the next event to process.
15 |
16 | 
17 |
18 | # Using GraalVM with a Provided Runtime
19 |
20 | When using a GraalVM native image you no longer want or need the managed Java runtimes. Instead you want the ability to
21 | directly decision what is executed. This functionality is enabled by the `provided`
22 |
23 | 
24 |
--------------------------------------------------------------------------------
/quickstart/content/summary/why-graalvm.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Why should you use GraalVM"
3 | description: "Java is an enormously popular programming language for business applications."
4 | date: 2021-05-08T12:19:54+01:00
5 | draft: false
6 | weight: 20
7 | ---
8 |
9 | Java is an enormously popular programming language for business applications. These applications have typically run on
10 | large application servers of fixed capacity. They are booted up, left on and scaled for expected peak capacity. The only
11 | time they are restarted is when a new release is released. If scaling of capacity is done, then it is done in large
12 | steps well a head of time to cater for the time required to provision a new server.
13 |
14 | Moving this style of application to AWS Lambda is difficult as start up time has never been an issue before and suddenly
15 | it's very important. These applications typically make use of runtime dependency injection which slows down time to first
16 | request.
17 |
18 | GraalVM and specifically GraalVM Native Image is a project which aims to match the performance of native languages and
19 | reduce the start up time for JVM-based languages by compiling them ahead-of-time.
20 |
21 | These goals align perfectly with Lambda which benefits greatly from fast start up times.
--------------------------------------------------------------------------------
/quickstart/content/summary/why-lambda.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Why should you use AWS Lambda"
3 | description: "AWS Lambda is a fully managed compute service which allows you to focus on delivering value, and leaves all the
4 | maintenance overhead to AWS."
5 | date: 2021-05-08T12:19:49+01:00
6 | draft: false
7 | weight: 10
8 | ---
9 |
10 | AWS Lambda is a fully managed compute service which allows you to focus on delivering value, and leaves all the
11 | maintenance overhead to AWS.
12 |
13 | What does fully managed mean in this case; A huge amount. Firstly the provisioning of servers, operating systems and
14 | runtimes. The scaling of capacity across multiple AWS availability zones. Load balancing of requests and automatic failover
15 | in case of failure. If you work in a regulated industry, AWS Lambda is [SOC](https://aws.amazon.com/compliance/soc-faqs/),
16 | [HIPAA](https://aws.amazon.com/compliance/hipaa-compliance/), [PCI](https://aws.amazon.com/compliance/pci-dss-level-1-faqs/),
17 | [ISO](https://aws.amazon.com/compliance/iso-27001-faqs/) compliant.
--------------------------------------------------------------------------------
/quickstart/content/usage/frameworks.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Frameworks for developing GraalVM on AWS Lambda"
3 | description: "Descriptions of the three main frameworks used in the development of GraalVM on AWS Lambda"
4 | date: 2021-04-29T21:21:46+01:00
5 | draft: false
6 | weight: 40
7 | ---
8 |
9 | Reducing the friction of developing with GraalVM are a number of frameworks.
10 |
11 | {{< columns >}}
12 | [
](https://micronaut.io/)
13 |
14 | Designed with start up times in mind at each stage, resulting in great performance and a minimal memory footprint.
15 |
16 | [](https://github.com/micronaut-projects/micronaut-aws)
17 |
18 | <--->
19 |
20 | [
](https://quarkus.io/)
21 |
22 | Probably the most established of the modern frameworks.
23 |
24 | [](https://github.com/quarkusio/quarkus)
25 |
26 | <--->
27 |
28 | [
](https://github.com/spring-projects-experimental/spring-native)
29 |
30 | Spring Native is still in beta, but one to keep an eye on for the future.
31 |
32 | [](https://github.com/spring-projects-experimental/spring-native)
33 |
34 | {{< /columns >}}
35 |
36 | {{< columns >}}
37 |
38 | [
](https://cljdoc.org/d/fierycod/holy-lambda/CURRENT/doc/tutorial)
39 |
40 | A micro framework that integrates Clojure with AWS Lambda on either Java, Clojure Native, or Babashka runtime.
41 |
42 | [](https://github.com/FieryCod/holy-lambda)
43 |
44 | <--->
45 |
46 |
47 |
48 | <--->
49 |
50 |
51 | {{< /columns >}}
--------------------------------------------------------------------------------
/quickstart/content/usage/libraries.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Libraries ready for GraalVM"
3 | description: "A List of known libraries which are ready for GraalVM on AWS Lambda"
4 | date: 2021-04-29T22:18:57+01:00
5 | draft: false
6 | weight: 50
7 | ---
8 |
9 | ## GitHub Shields.io Badge
10 |
11 | Please add the follow badge to help developers know your library is GraalVM ready.
12 |
13 | 
14 |
15 | GitHub Markdown
16 | {{< highlight md "linenos=table" >}}
17 | 
18 | {{< /highlight >}}
19 |
20 | {{< columns >}}
21 | [
](https://aws.amazon.com/blogs/developer/graalvm-native-image-support-in-the-aws-sdk-for-java-2-x/)
22 |
23 | The AWS SDK for Java v2 supports GraalVM out of the box from version 2.16.1 or later.
24 |
25 | <--->
26 |
27 |
28 | <--->
29 |
30 |
31 | {{< / columns >}}
32 |
--------------------------------------------------------------------------------
/quickstart/content/walkthrough/_index.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Walk Through Guide"
3 | date: 2021-05-24T22:21:27+01:00
4 | draft: false
5 | ---
6 |
7 | This will be a complete walk through guide step-by-step including how to validate each stage and the complete source code.
8 |
9 | Check the [GitHub project](https://github.com/marksailes/graalvm-on-lambda/tree/main/walkthrough/serverless-graalvm) for the complete source code.
--------------------------------------------------------------------------------
/quickstart/content/walkthrough/generating-graalvm-config.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Generating Graalvm Config"
3 | description: "How to automatically generating the GraalVM config required by your application"
4 | date: 2021-06-07T21:32:29+01:00
5 | draft: false
6 | weight: 70
7 | ---
8 |
9 | Next page to do.
--------------------------------------------------------------------------------
/quickstart/content/walkthrough/graalvm-performance.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Native Image Performance"
3 | description: "Comparing GraalVM native-image performance against Java 11 on AWS Lambda"
4 | date: 2021-06-10T20:58:10+01:00
5 | draft: false
6 | weight: 80
7 | ---
8 |
9 | Lets compare the performance of GraalVM native-image and Java11 on AWS Lambda.
10 |
11 | Quick reminder, the handler isn't doing much at all. This project has minimal functionality
12 | and few dependencies.
13 |
14 | ```java
15 | @Override
16 | public APIGatewayV2HTTPResponse handleRequest(APIGatewayV2HTTPEvent event, Context context) {
17 | context.getLogger().log(event.getRequestContext().getRequestId());
18 |
19 | return APIGatewayV2HTTPResponse.builder()
20 | .withStatusCode(200)
21 | .build();
22 | }
23 | ```
24 |
25 | | Test | Memory | Init | Duration |
26 | |:----------------|:------:|:------:|:-------:|
27 | | Java 11 (Cold) | 2048 MB | 418.41 ms | 14.71 ms |
28 | | Java 11 (Warm) | 2048 MB | - | 1.71 ms |
29 | | Native Image (Cold) | 256 MB | 256.62 ms | 12.70 ms |
30 | | Native Image (Warm) | 256 MB | - | 1.01 ms |
31 |
32 | Not only is GraalVM `native-image` faster, it's faster with a vastly less resources. CPU is allocated
33 | proportionally to memory when you use AWS Lambda.
--------------------------------------------------------------------------------
/quickstart/content/walkthrough/project-structure.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: "Project Structure"
3 | description: "Initial project structure for Java Lambda functions and CDK IaC"
4 | date: 2021-05-24T22:21:27+01:00
5 | draft: false
6 | weight: 10
7 | ---
8 |
9 |
10 | We'll be using my favoured project layout which is to create one folder for our function source code, and a separate
11 | folder for our infrastructure source code.
12 |
13 | ```bash
14 | mkdir serverless-graalvm
15 | mkdir serverless-graalvm/software
16 | mkdir serverless-graalvm/infrastructure
17 | ```
18 |
19 | ```
20 | serverless-graalvm/
21 | ├── infrastructure # This will contain our CDK Stacks
22 | └── software # This will contain all our Lambda functions
23 | ```
--------------------------------------------------------------------------------
/quickstart/data/menu/main.yml:
--------------------------------------------------------------------------------
1 | ---
2 | main:
3 | - name: Summary
4 | icon: "notification"
5 | sub:
6 | - name: Why GraalVM
7 | ref: "/summary/why-graalvm"
8 | - name: Why Lambda
9 | ref: "/summary/why-lambda"
10 | - name: How it works
11 | ref: "/summary/how-it-works"
12 | - name: Walk Through - Public API
13 | ref: "/walkthrough/"
14 | sub:
15 | - name: Project Structure
16 | ref: "/walkthrough/project-structure"
17 | - name: Function Creation
18 | ref: "/walkthrough/function"
19 | - name: Infrastructure as Code (CDK)
20 | ref: "/walkthrough/initial-infra"
21 | - name: Convert function to GraalVM
22 | ref: "/walkthrough/convert-to-graalvm"
23 | - name: CDK & Docker for native-image
24 | ref: "/walkthrough/cdk-docker-build"
25 | - name: GraalVM Configuration
26 | ref: "/walkthrough/graalvm-config"
27 | - name: Generating GraalVM Configuration
28 | ref: "/walkthrough/generating-graalvm-config"
29 | - name: Native Image Performance
30 | ref: "/walkthrough/graalvm-performance"
31 | - name: Native Image on ARM
32 | ref: "/walkthrough/arm-architecture"
33 |
34 | - name: Building
35 | sub:
36 | - name: with Docker
37 | ref: "/building/docker"
38 | - name: which Runtime API
39 | ref: "/building/runtime-interface-client"
40 | - name: Usage
41 | sub:
42 | - name: Examples
43 | ref: "/usage/examples"
44 | - name: Frameworks
45 | ref: "/usage/frameworks"
46 | - name: Libraries
47 | ref: "/usage/libraries"
--------------------------------------------------------------------------------
/quickstart/layouts/partials/head/meta.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 | {{ $description := default (default .Site.Title .Site.Params.description) (default .Summary .Description) }}
6 | {{ $keywords := default .Site.Params.Keywords .Keywords }}
7 |
8 | {{ with $description }}
9 |
10 | {{ end }}
11 | {{ with $keywords }}
12 |
13 | {{ end }}
14 |
15 |
16 |
17 |
18 |
19 | {{ template "_internal/twitter_cards.html" . }}
20 |
21 |
22 | {{ template "_internal/opengraph.html" . }}
23 |
24 |
25 |
26 |
27 |
32 |
--------------------------------------------------------------------------------
/quickstart/layouts/partials/site-footer.html:
--------------------------------------------------------------------------------
1 |
28 |
--------------------------------------------------------------------------------
/quickstart/layouts/partials/site-header.html:
--------------------------------------------------------------------------------
1 | 
3 | 
4 | 2 | {{ .Inner | $.Page.RenderString }} 3 |4 | -------------------------------------------------------------------------------- /quickstart/themes/hugo-geekdoc/layouts/shortcodes/icon.html: -------------------------------------------------------------------------------- 1 | {{ $id := .Get 0 }} 2 | 3 | {{- with $id -}} 4 | 5 | {{- end -}} 6 | -------------------------------------------------------------------------------- /quickstart/themes/hugo-geekdoc/layouts/shortcodes/img.html: -------------------------------------------------------------------------------- 1 | {{ $source := ($.Page.Resources.ByType "image").GetMatch (printf "%s" (.Get "name")) }} 2 | {{ $customAlt := .Get "alt" }} 3 | {{ $customSize := .Get "size" }} 4 | {{ $lazyLoad := default (default true $.Site.Params.GeekdocImageLazyLoading) (.Get "lazy") }} 5 | 6 | {{ with $source }} 7 | {{ $caption := default .Title $customAlt }} 8 | 9 | {{ $tiny := (.Resize "320x").RelPermalink }} 10 | {{ $small := (.Resize "600x").RelPermalink }} 11 | {{ $medium := (.Resize "1200x").RelPermalink }} 12 | {{ $large := (.Resize "1800x").RelPermalink }} 13 | 14 | {{ $size := dict "tiny" $tiny "small" $small "medium" $medium "large" $large }} 15 | 16 |
32 | {{- .Inner -}}
33 |
34 |
--------------------------------------------------------------------------------
/quickstart/themes/hugo-geekdoc/layouts/shortcodes/tab.html:
--------------------------------------------------------------------------------
1 | {{ if .Parent }}
2 | {{ $name := .Get 0 }}
3 | {{ $group := printf "tabs-%s" (.Parent.Get 0) }}
4 |
5 | {{ if not (.Parent.Scratch.Get $group) }}
6 | {{ .Parent.Scratch.Set $group slice }}
7 | {{ end }}
8 |
9 | {{ .Parent.Scratch.Add $group (dict "Name" $name "Content" .Inner) }}
10 | {{ else }}
11 | {{ errorf "%q: 'tab' shortcode must be inside 'tabs' shortcode" .Page.Path }}
12 | {{ end}}
13 |
--------------------------------------------------------------------------------
/quickstart/themes/hugo-geekdoc/layouts/shortcodes/tabs.html:
--------------------------------------------------------------------------------
1 | {{ if .Inner }}{{ end }}
2 | {{ $id := .Get 0 }}
3 | {{ $group := printf "tabs-%s" $id }}
4 |
5 |