Merge branch 'ArmDeveloperEcosystem:main' into main

Author: dominica-of

assets/contributors.csv

@@ -39,4 +39,5 @@ Gayathri Narayana Yegna Narayanan,Arm,,,,
 Alexandros Lamprineas,Arm,,,,
 Annie Tallund,Arm,annietllnd,annietallund,,
 Cyril Rohr,RunsOn,crohr,cyrilrohr,,
-Rin Dobrescu,Arm,,,,
+Rin Dobrescu,Arm,,,,
+Przemyslaw Wirkus,Arm,PrzemekWirkus,przemyslaw-wirkus-78b73352,,

content/install-guides/_images/idle.png

@@ -73,13 +73,60 @@ To install Copilot on macOS:
 curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
 ```
 
+The help message is printed:
+
+```output
+👩‍✈️ Launch and manage containerized applications on AWS.
+
+Commands
+  Getting Started 🌱
+    init        Create a new ECS or App Runner application.
+    docs        Open the copilot docs.
+
+  Develop ✨
+    app         Commands for applications.
+                Applications are a collection of services and environments.
+    env         Commands for environments.
+                Environments are deployment stages shared between services.
+    svc         Commands for services.
+                Services are long-running ECS or App Runner services.
+    job         Commands for jobs.
+                Jobs are tasks that are triggered by events.
+    task        Commands for tasks.
+                One-off Amazon ECS tasks that terminate once their work is done.
+    run         Run the workload locally.
+
+  Release 🚀
+    pipeline    Commands for pipelines.
+                Continuous delivery pipelines to release services.
+    deploy      Deploy one or more Copilot jobs or services.
+
+  Extend 🧸
+    storage     Commands for working with storage and databases.
+    secret      Commands for secrets.
+                Secrets are sensitive information that you need in your application.
+
+  Settings ⚙️
+    version     Print the version number.
+    completion  Output shell completion code.
+
+Flags
+  -h, --help      help for copilot
+  -v, --version   version for copilot
+
+Examples
+  Displays the help menu for the "init" command.
+  `$ copilot init --help`
+```
+
 Verify Copilot CLI is installed by running:
 
 ```console
 copilot --version
 ```
-The version should be printed:
+
+The installed version is displayed:
 
 ```output
-copilot version: v1.33.0
+copilot version: v1.34.0
 ```

content/install-guides/_images/py1-woa.png

@@ -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/py2-woa.png

@@ -78,7 +78,7 @@ A dialog should appear:
 
 ## How do I enable Hyper-V from the command line?
 
-1. Open a Command Prompt or Windows PowerShell
+1. Open a Command Prompt or Windows PowerShell (as Administrator)
 
 2. Run the `DISM` command below to enable Hyper-V:
 

content/install-guides/_images/py3-woa.png

@@ -27,19 +27,19 @@ multitool_install_part: false   # Set to true if a sub-page of a multi-page arti
 layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
 ---
 
-Python has native support for [Windows on Arm](https://learn.microsoft.com/en-us/windows/arm/overview). Starting with version 3.11, an official installer is available. The latest version at time of writing is 3.12.0.
+Python has native support for [Windows on Arm](https://learn.microsoft.com/en-us/windows/arm/overview). Starting with version 3.11, an official installer is available. The latest version at time of writing is 3.13.0.
 
 A number of developer ready Windows on Arm [devices](/learning-paths/laptops-and-desktops/intro/find-hardware/) are available.
 
 Windows on Arm instances are available with Microsoft Azure. For more information, see [Deploy a Windows on Arm virtual machine on Microsoft Azure](/learning-paths/cross-platform/woa_azure/).
 
-## Download and install
+## How do I download and install Python for Windows on Arm?
 
 The installer can be downloaded from the [Python website](https://www.python.org/downloads/windows/). Locate the `ARM64` installer.
 
 You can also download from a PowerShell terminal.
 ```command
-curl https://www.python.org/ftp/python/3.12.0/python-3.12.0-arm64.exe -O python-3.12.0-arm64.exe
+curl https://www.python.org/ftp/python/3.13.0/python-3.13.0-arm64.exe --output python-3.13.0-arm64.exe
 ```
 
 Once downloaded, run the installer `exe` file on a Windows on Arm machine. 
@@ -54,44 +54,52 @@ Check `Add python.exe to PATH` if you want to easily invoke python from any dire
 
 ![Complete #center](/install-guides/_images/py2-woa.png)
 
-## Invoke python
+## How do I start Python on Windows? 
 
 At a Windows Command prompt or a PowerShell prompt use `python` or `py` to start the interpreter.
+
 ```cmd
 py
 ```
+
+The interpreter starts with output similar to:
+
 ```output
-Python 3.12.0 (tags/v3.12.0:0fb18b0, Oct  2 2023, 13:15:47) [MSC v.1935 64 bit (ARM64)] on win32
+Python 3.13.0 (tags/v3.13.0:60403a5, Oct  7 2024, 10:17:29) [MSC v.1941 64 bit (ARM64)] on win32
 Type "help", "copyright", "credits" or "license" for more information.
 >>>
 ```
-Enter `exit()` to leave interpreter.
+
+Enter `exit()` to leave the interpreter:
+
 ```python
 exit()
 ```
 
-## Test an example
+## How can I run a Python example?
 
-To confirm python is working, save the code below into a file `uname.py`.
+To confirm python is working, use a text editor to save the code below to a file named `uname.py`.
 
-#### uname.py
 ```python
 import platform
 print("Python version", platform.python_version())
 print("Machine is", platform.uname().system, platform.uname().release, platform.uname().machine)
 ```
 
-Run the code.
+Run the code:
+
 ```console
 py uname.py
 ```
+
 Running on a Windows on Arm machine produces the output similar to:
+
 ```output
-Python version 3.12.0
+Python version 3.13.0
 Machine is Windows 11 ARM64
 ```
 
-## Installing packages
+## How do I install Python packages?
 
 Python `pip` can be used to install packages. 
 
@@ -100,9 +108,8 @@ For example, to install [Flask](https://palletsprojects.com/p/flask/):
 pip install Flask
 ```
 
-Save the code below as `hello.py`:
+Use a text editor to save the code below as `hello.py`:
 
-#### hello.py
 ```python
 import platform
 from flask import Flask
@@ -131,28 +138,28 @@ WARNING: This is a development server. Do not use it in a production deployment.
  * Running on http://10.8.0.10:5000
 Press CTRL+C to quit
 ```
-Open a browser to the URL printed by the application. In this example:
+Open a browser with the URL printed by the application. In this example:
 ```url
 http://127.0.0.1:5000
 ```
 The output is displayed in the browser window.
 
 ![Complete #center](/install-guides/_images/flask-woa.png)
 
-The accesses are reported in the command prompt:
+The accesses are reported in the command window:
+
 ```output
 127.0.0.1 - - [<timestamp>] "GET / HTTP/1.1" 200 -
 127.0.0.1 - - [<timestamp>] "GET /favicon.ico HTTP/1.1" 404 -
 10.8.0.10 - - [<timestamp>] "GET / HTTP/1.1" 200 -
 10.8.0.10 - - [<timestamp>] "GET /favicon.ico HTTP/1.1" 404 -
 ```
-Use `Ctrl+C` to kill the application.
 
-## Using IDLE
+Use `Ctrl+C` to stop the application.
 
-Python `IDLE` is included in the installation. IDLE is a simple IDE for python development. You can locate it in your start menu.
+## Is Python IDLE available?
 
-![IDLE #center](/install-guides/_images/idle.png)
+Python `IDLE` is included in the installation. IDLE is a simple IDE for python development. You can locate it in your start menu.
 
 You can create and run Python applications in this environment.
 
@@ -163,5 +170,4 @@ Then select `Run` > `Run module` (`F5`) to execute.
 ![IDLE uname #center](/install-guides/_images/py3-woa.png)
 
 
-
 You are now ready to use Python on your Windows on Arm device.