Merge pull request #1297 from ArmDeveloperEcosystem/main

Merge to production

Author: pareenaverma

contributors.csv renamed to assets/contributors.csv

@@ -0,0 +1,177 @@
+---
+title: AWS SAM CLI
+
+author_primary: Jason Andrews
+minutes_to_complete: 15
+
+official_docs: https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html
+
+additional_search_terms:
+- AWS
+- Lambda
+
+layout: installtoolsall
+multi_install: false
+multitool_install_part: false
+test_maintenance: false
+tool_install: true
+weight: 1
+---
+
+The Amazon Web Services (AWS) Serverless Application Model (SAM) CLI is an open-source command-line tool that you can use to build, test, and deploy serverless applications. The SAM CLI provides a Lambda-like execution environment that lets you locally build, test and debug applications defined by AWS SAM templates. It is available for a variety of operating systems and Linux distributions, and supports the Arm architecture. 
+
+## Before you begin
+
+Follow the instructions below to install and try the latest version of the AWS SAM CLI for Ubuntu on Arm.
+
+Confirm you are using an Arm machine by running:
+
+```bash { target="ubuntu:latest" }
+uname -m
+```
+
+The output should be:
+
+```output
+aarch64
+```
+
+If you see a different result, you are not using an Arm-based computer running 64-bit Linux.
+
+Running the AWS SAM CLI requires Docker. Refer to the [Docker](/install-guides/docker/) Install Guide for installation instructions. Confirm Docker is running before installing the SAM CLI.
+
+Python and Python pip are also required to run the SAM CLI example.
+
+To install, run the following command:
+
+```console
+sudo apt install python-is-python3 python3-pip -y
+```
+
+## Download and install the AWS SAM CLI
+
+There are two options to install the SAM CLI, you can select your preferred method:
+
+* From a zip file.
+* Using the Python `pip` command.
+
+### Download and install from zip file
+
+Use `wget`:
+
+```bash
+wget https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip
+unzip aws-sam-cli-linux-arm64.zip -d sam-install
+sudo ./sam-install/install
+```
+
+### Install the SAM CLI using Python pip
+
+```
+sudo apt install python3-venv -y
+python -m venv .venv
+source .venv/bin/activate
+pip install aws-sam-cli
+```
+
+### Confirm that the SAM CLI has been installed
+
+```bash
+sam --version
+```
+
+The version should be printed on screen:
+
+```output
+SAM CLI, version 1.125.0
+```
+
+## Example application
+
+You can use the AWS SAM CLI to build and deploy a simple "Hello World" serverless application that includes the line `uname -m` to check the platform it is running on, by following these steps.
+
+1. Create the project 
+
+Use the code below, adjusting the runtime argument if you have a different version of Python:
+
+```console
+sam init --runtime python3.12 --architecture arm64 --dependency-manager pip --app-template hello-world --name uname-app --no-interactive
+```
+
+2. Change to the new directory:
+
+```console
+cd uname-app
+```
+
+3. Modify the `hello_world/app.py` file to include the command `uname -m`
+
+Use a text editor to replace the contents of the `hello_world/app.py` file with the code below:
+
+```python
+import json
+import os
+
+def lambda_handler(event, context):
+    """Sample pure Lambda function
+
+    Parameters
+    ----------
+    event: dict, required
+        API Gateway Lambda Proxy Input Format
+
+        Event doc: https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html#api-gateway-simple-proxy-for-lambda-input-format
+
+    context: object, required
+        Lambda Context runtime methods and attributes
+
+        Context doc: https://docs.aws.amazon.com/lambda/latest/dg/python-context-object.html
+
+    Returns
+    ------
+    API Gateway Lambda Proxy Output Format: dict
+
+        Return doc: https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html
+    """
+
+    ret = os.popen('uname -m').read()
+
+    return {
+        "statusCode": 200,
+        "body": json.dumps({
+            "message": ret,
+            # "location": ip.text.replace("\n", "")
+        }),
+    }
+```
+
+4. Build the application:
+
+```console
+sam build
+```
+
+5. Test the deployed application:
+
+```console
+sam local invoke "HelloWorldFunction" -e events/event.json
+```
+
+The output below shows the results from the command `uname -m` and the value of `aarch64` confirms an Arm Linux computer: 
+
+```output
+Invoking app.lambda_handler (python3.12)                                                                                                                             
+Local image was not found.                                                                                                                                           
+Removing rapid images for repo public.ecr.aws/sam/emulation-python3.12                                                                                               
+Building image........................................................................................................................
+Using local image: public.ecr.aws/lambda/python:3.12-rapid-arm64.                                                                                                    
+                                                                                                                                                                     
+Mounting /home/ubuntu/uname-app/.aws-sam/build/HelloWorldFunction as /var/task:ro,delegated, inside runtime container                                                
+START RequestId: 7221da4d-346d-4e2e-831e-dcde1cb47b5b Version: $LATEST
+END RequestId: 513dbd6f-7fc0-4212-ae13-a9a4ce2f21f4
+REPORT RequestId: 513dbd6f-7fc0-4212-ae13-a9a4ce2f21f4	Init Duration: 0.26 ms	Duration: 84.22 ms	Billed Duration: 85 ms	Memory Size: 128 MB	Max Memory Used: 128 MB	
+{"statusCode": 200, "body": "{\"message\": \"aarch64\\n\"}"}
+```
+
+You are ready to use the AWS SAM CLI to build more complex functions and deploy them into AWS. Make sure to select `arm64` as the architecture for your Lambda functions. 
+

content/install-guides/_images/sysbox.gif

@@ -32,7 +32,13 @@ Below are some of the common methods to install Java. This includes both the Jav
 
 Pick the one that works best for you.
 
-## Install Java using the Linux package manager
+{{% notice Note %}}
+The Java Technology Compatibility Kit (TCK) is a test suite that verifies whether a Java implementation conforms to the Java SE Platform Specification. It's a crucial tool for ensuring that Java applications can run consistently across different platforms and implementations.
+
+Check the [OCTLA Signatories List](https://openjdk.org/groups/conformance/JckAccess/jck-access.html) to see who has been granted access to the TCK.
+{{% /notice %}}
+
+## Can I install Java using the Linux package manager?
 
 For distributions using `apt` - including Debian and Ubuntu:
 
@@ -55,7 +61,15 @@ sudo pacman -S jdk-openjdk
 sudo pacman -S jre-openjdk  
 ```
 
-## Install Java using Amazon Corretto
+## Can I install Java using Snap?
+
+For Linux distributions with `snap` you can install Java using:
+
+```console
+sudo snap install openjdk
+```
+
+## How do I install Amazon Corretto?
 
 Amazon Corretto is a no-cost distribution of the Open Java Development Kit (OpenJDK). It is maintained and supported by Amazon Web Services (AWS).
 
@@ -69,15 +83,64 @@ sudo apt-get update; sudo apt-get install -y java-21-amazon-corretto-jdk
 
 More installation options for Corretto are available in the [Amazon Corretto 21 Guide for Linux](https://docs.aws.amazon.com/corretto/latest/corretto-21-ug/linux-info.html)
 
-## Install Java using Snap
+## How do I install the Microsoft Build of OpenJDK?
 
-For Linux distributions with `snap` you can install Java using:
+The Microsoft Build of OpenJDK is a no-cost, open source distribution of OpenJDK. It includes Long-Term Support (LTS) binaries for Java 11 and Java 17 and runs on Arm Linux.
+
+{{% notice Note %}}
+The Arm architecture is not available in the repositories for the `apt` package manager. 
+{{% /notice %}}
+
+You can download a tar.gz file from [Download the Microsoft Build of OpenJDK](https://learn.microsoft.com/en-gb/java/openjdk/download)
+
+For example:
 
 ```console
-sudo snap install openjdk
+wget https://aka.ms/download-jdk/microsoft-jdk-21.0.4-linux-aarch64.tar.gz
+```
+
+Extract the contents of the file:
+
+```console
+tar xvf microsoft-jdk-21.0.4-linux-aarch64.tar.gz
 ```
 
-## Is there a way to install Java from the official website?
+Move the contents to a directory of your choice: 
+
+```console
+sudo mv  jdk-21.0.4+7/ /usr/local
+```
+
+Set up environment variables to locate your installation:
+
+```console
+export JAVA_HOME=/usr/local/jdk-21.0.4+7
+export PATH=$JAVA_HOME/bin:$PATH
+```
+
+Add the environment variables to your `~/.bashrc` file to set them permanently.
+
+For more information about the available versions and supported platforms refer to [About the Microsoft Build of OpenJDK](https://learn.microsoft.com/en-gb/java/openjdk/overview).
+
+## How do I install Eclipse Temurin from the Adoptium Working Group?
+
+The Adoptium Working Group promotes and supports high-quality, TCK certified runtimes and associated technology for use across the Java ecosystem. 
+
+Eclipse Temurin is the name of the OpenJDK distribution from Adoptium.
+
+To install Temurin on Ubuntu run:
+
+```console
+sudo apt install -y wget apt-transport-https gpg
+wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
+echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
+sudo apt update 
+sudo apt install temurin-17-jdk -y
+```
+
+For more information about the available versions and supported platforms refer to [Temurin documentation](https://adoptium.net/docs/).
+
+## How do I install Java from Oracle?
 
 You can download Java from the [Oracle website](https://www.oracle.com/java/technologies/javase-downloads.html) and install it manually. Look for the files with ARM64 in the description.
 
@@ -159,7 +222,7 @@ javac 21.0.4
 
 ## Which version of Java should I use for Arm Linux systems?
 
-It’s important to ensure that your version of Java is at least 11.0.9. There are large performance improvements starting from version 11.0.9. Since then, Java performance has steadily increased over time and newer versions will provide better performance.
+For performance and security, it’s important to ensure that your version of Java is at least 11.0.12. Earlier versions lack significant performance improvements. Java performance has steadily increased over time and newer versions will provide better performance.
 
 ## Which flags are available for tuning the JVM?