More deployment examples

Author: clareliguori

README.md

@@ -134,6 +134,7 @@ Run the tool to create and publish Lambda layers that contain the PHP custom run
 ../bin/local/img2lambda -i lambda-php:latest -r us-east-1 -o ./output
 ```
 
+### Deploy Manually
 Create a PHP function that uses the layers:
 ```
 cd function
@@ -163,6 +164,78 @@ aws lambda invoke \
 cat hello-output.txt
 ```
 
+### Deploy with AWS Serverless Application Model (SAM)
+
+See [the sample template.yml](example/function/template.yml) and [the sample template.json](example/function/template.json).
+
+Insert the layers ARNs into the function definition:
+```
+cd function
+
+sed -i 's/^- /      - /' ../output/layers.yaml && \
+    sed -e "/LAYERS_PLACEHOLDER/r ../output/layers.yaml" -e "s///" template.yaml > template-with-layers.yaml
+
+OR
+
+cd function
+
+sed -e "/\"LAYERS_PLACEHOLDER\"/r ../output/layers.json" -e "s///" template.json | jq . > template-with-layers.json
+```
+
+Deploy the function:
+```
+sam package --template-file template-with-layers.yaml \
+            --output-template-file packaged.yaml \
+            --region us-east-1 \
+            --s3-bucket <bucket name>
+
+sam deploy --template-file packaged.yaml \
+           --capabilities CAPABILITY_IAM  \
+           --region us-east-1 \
+           --stack-name img2lambda-php-example
+
+OR
+
+sam package --template-file template-with-layers.json \
+            --output-template-file packaged.json \
+            --region us-east-1 \
+            --s3-bucket <bucket name>
+
+sam deploy --template-file packaged.json \
+           --capabilities CAPABILITY_IAM  \
+           --region us-east-1 \
+           --stack-name img2lambda-php-example
+```
+
+Invoke the function:
+```
+aws lambda invoke \
+    --function-name sam-php-example-hello \
+    --region us-east-1 \
+    --log-type Tail \
+    --query 'LogResult' \
+    --output text \
+    --payload '{"name": "World"}' hello-output.txt | base64 --decode
+
+cat hello-output.txt
+```
+
+### Deploy with Serverless Framework
+
+See [the sample serverless.yml](example/function/serverless.yml) for how to use the img2lambda-generated layers in your Serverless function.
+
+Deploy the function:
+```
+cd function
+
+serverless deploy -v
+```
+
+Invoke the function:
+```
+serverless invoke -f hello -l -d '{"name": "World"}'
+```
+
 ## License Summary
 
 This sample code is made available under a modified MIT license. See the LICENSE file.

example/function/serverless.yml

@@ -0,0 +1,21 @@
+service: php-example-hello
+
+provider:
+  name: aws
+  runtime: provided
+
+functions:
+  hello:
+    handler: hello.hello
+    package:
+      include:
+        - src/hello.php
+    layers:
+      ${file(../output/layers.json)}
+  goodbye:
+    handler: goodbye.goodbye
+    package:
+      include:
+        - src/goodbye.php
+    layers:
+      ${file(../output/layers.json)}

example/function/template.json

@@ -0,0 +1,26 @@
+{
+    "AWSTemplateFormatVersion": "2010-09-09",
+    "Transform": "AWS::Serverless-2016-10-31",
+    "Resources": {
+        "Hello": {
+            "Type": "AWS::Serverless::Function",
+            "Properties": {
+                "FunctionName": "sam-php-example-hello",
+                "Handler": "hello.hello",
+                "Runtime": "provided",
+                "CodeUri": "./",
+                "Layers": "LAYERS_PLACEHOLDER"
+            }
+        },
+        "Goodbye": {
+            "Type": "AWS::Serverless::Function",
+            "Properties": {
+                "FunctionName": "sam-php-example-goodbye",
+                "Handler": "goodbye.goodbye",
+                "Runtime": "provided",
+                "CodeUri": "./",
+                "Layers": "LAYERS_PLACEHOLDER"
+            }
+        }
+    }
+}

example/function/template.yaml

@@ -0,0 +1,21 @@
+AWSTemplateFormatVersion: '2010-09-09'
+Transform: 'AWS::Serverless-2016-10-31'
+
+Resources:
+  Hello:
+    Type: 'AWS::Serverless::Function'
+    Properties:
+      FunctionName: sam-php-example-hello
+      Handler: hello.hello
+      Runtime: provided
+      CodeUri: ./
+      Layers: LAYERS_PLACEHOLDER
+
+  Goodbye:
+    Type: 'AWS::Serverless::Function'
+    Properties:
+      FunctionName: sam-php-example-goodbye
+      Handler: goodbye.goodbye
+      Runtime: provided
+      CodeUri: ./
+      Layers: LAYERS_PLACEHOLDER