add the shell script referenced in the redame file

Author: sebsto

Examples/_MyFirstFunction/.gitignore

@@ -0,0 +1,8 @@
+.DS_Store
+/.build
+/Packages
+xcuserdata/
+DerivedData/
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc

Examples/_MyFirstFunction/clean.sh

@@ -0,0 +1,25 @@
+#!/bin/sh
+
+alias aws="aws --profile seb"
+
+echo "This script deletes the Lambda function and the IAM role created in the previous step and deletes the project files."
+read -p "Are you you sure you want to delete everything that was created? [y/n] " continue
+if [[ ! $continue =~ ^[Yy]$ ]]; then
+  echo "OK, try again later when you feel ready"
+  exit 1
+fi
+
+echo "🚀 Deleting the Lambda function and the role"
+aws lambda delete-function --function-name MyLambda
+aws iam detach-role-policy            \
+    --role-name lambda_basic_execution \
+    --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole
+aws iam delete-role --role-name lambda_basic_execution
+
+echo "🚀 Deleting the project files"
+rm -rf .build
+rm -rf ./Sources
+rm trust-policy.json
+rm Package.swift Package.resolved
+
+echo "🎉 Done! Your project is cleaned up and ready for a fresh start."

Examples/_MyFirstFunction/create_and_deploy_function.sh

@@ -0,0 +1,157 @@
+#!/bin/sh
+
+# Stop the script execution if an error occurs 
+set -e -o pipefail
+
+alias aws="aws --profile seb"
+
+# check if docker is installed
+which docker > /dev/null
+if [[ $? != 0 ]]; then
+    echo "Docker is not installed.  Please install Docker and try again."
+    exit 1
+fi
+
+# check if user has an access key and secret access key
+echo "This script creates and deploys a Lambda function on your AWS Account.
+
+You must have an AWS account and know an AWS access key, secret access key, and an optional session token.
+These values are read from '~/.aws/credentials'.
+"
+
+read -p "Are you ready to create your first Lambda function in Swift? [y/n] " continue
+if [[ ! $continue =~ ^[Yy]$ ]]; then
+  echo "OK, try again later when you feel ready"
+  exit 1
+fi
+
+echo "⚡️ Create your Swift Lambda project"
+swift package init --type executable --name MyLambda > /dev/null
+
+echo "📦 Add the AWS Lambda Swift runtime to your project"
+# The following commands are commented out until the `lambad-init` plugin will be release
+# swift package add-dependency https://github.com/swift-server/swift-aws-lambda-runtime.git --branch main
+# swift package add-dependency https://github.com/swift-server/swift-aws-lambda-events.git --branch main
+# swift package add-target-dependency AWSLambdaRuntime MyLambda --package swift-aws-lambda-runtime
+# swift package add-target-dependency AWSLambdaEvents MyLambda --package swift-aws-lambda-events
+cat <<EOF > Package.swift
+// swift-tools-version:6.0
+
+import PackageDescription
+
+let package = Package(
+    name: "swift-aws-lambda-runtime-example",
+    platforms: [.macOS(.v15)],
+    products: [
+        .executable(name: "MyLambda", targets: ["MyLambda"])
+    ],
+    dependencies: [
+        .package(url: "https://github.com/swift-server/swift-aws-lambda-runtime.git", branch: "main")
+    ],
+    targets: [
+        .executableTarget(
+            name: "MyLambda",
+            dependencies: [
+                .product(name: "AWSLambdaRuntime", package: "swift-aws-lambda-runtime")
+            ],
+            path: "."
+        )
+    ]
+)
+EOF
+
+echo "📝 Write the Swift code"
+# The following command is commented out until the `lambad-init` plugin will be release
+# swift package lambda-init --allow-writing-to-package-directory 
+cat <<EOF > Sources/main.swift
+import AWSLambdaRuntime
+
+let runtime = LambdaRuntime {
+    (event: String, context: LambdaContext) in
+    "Hello \(event)"
+}
+
+try await runtime.run()
+EOF
+
+echo "📦 Compile and package the function for deployment (this might take a while)"
+swift package archive --allow-network-connections docker > /dev/null 2>&1
+
+#
+# Now the function is ready to be deployed to AWS Lambda
+#
+echo "🚀 Deploy to AWS Lambda"
+
+# retrieve your AWS Account ID 
+echo "🔑 Retrieve your AWS Account ID"
+export AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
+
+#
+# Create an IAM role for the Lambda function
+#
+create_lambda_execution_role() {
+    role_name=$1
+
+    # Allow the Lambda service to assume the IAM role
+    cat <<EOF > trust-policy.json
+{
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Effect": "Allow",
+            "Principal": {
+                "Service": "lambda.amazonaws.com"
+            },
+            "Action": "sts:AssumeRole"
+        }
+    ]
+}
+EOF
+
+    # Create the IAM role
+    echo "🔐 Create the IAM role for the Lambda function"
+    aws iam create-role \
+    --role-name $role_name \
+    --assume-role-policy-document file://trust-policy.json > /dev/null 2>&1
+
+    # Attach basic permissions to the role
+    # The AWSLambdaBasicExecutionRole policy grants permissions to write logs to CloudWatch Logs
+    echo "🔒 Attach basic permissions to the role"
+    aws iam attach-role-policy \
+    --role-name $role_name \
+    --policy-arn arn:aws:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole > /dev/null 2>&1
+
+    echo "⏰ Waiting 10 secs for IAM role to propagate..."
+    sleep 10
+}
+
+# Check if the role already exists
+echo "🔍 Check if a Lambda execution IAM role already exists"
+aws iam get-role --role-name lambda_basic_execution > /dev/null 2>&1 || create_lambda_execution_role lambda_basic_execution
+
+# Create the Lambda function
+echo "🚀 Create the Lambda function"
+aws lambda create-function \
+--function-name MyLambda \
+--zip-file fileb://.build/plugins/AWSLambdaPackager/outputs/AWSLambdaPackager/MyLambda/MyLambda.zip \
+--runtime provided.al2 \
+--handler provided  \
+--architectures $(uname -m) \
+--role arn:aws:iam::${AWS_ACCOUNT_ID}:role/lambda_basic_execution > /dev/null 2>&1
+
+echo "⏰ Waiting 10 secs for the Lambda function to be ready..."
+sleep 10
+
+# Invoke the Lambda function
+echo "🔗 Invoke the Lambda function"
+aws lambda invoke \
+--function-name MyLambda \
+--cli-binary-format raw-in-base64-out \
+--payload '"Lambda Swift"' \
+output.txt > /dev/null 2>&1
+
+echo "👀 Your Lambda function returned:"
+cat output.txt && rm output.txt
+
+echo ""
+echo "🎉 Done! Your first Lambda function in Swift is now deployed on AWS Lambda. 🚀"