added comments and a README

aws-go-lambda/README.md

@@ -0,0 +1,52 @@
+# AWS Golang Lambda
+This example creates a lambda that does a simple `ToUpper` on the string input and returns it.
+
+## Deploying the App
+
+ To deploy your infrastructure, follow the below steps.
+
+### Prerequisites
+
+1. [Install Pulumi](https://www.pulumi.com/docs/get-started/install/)
+2. [Configure AWS Credentials](https://www.pulumi.com/docs/intro/cloud-providers/aws/setup/)
+3. [Clone aws-go-lambda](https://github.com/aws/aws-lambda-go)
+
+### Steps
+
+After cloning this repo, run these commands from the working directory:
+
+1. Build the go files:
+
+```bash
+make build
+```
+
+2. Create a new Pulumi stack, which is an isolated deployment target for this example:
+
+```bash
+pulumi stack init
+```
+
+3. Set the required configuration variables for this program:
+```bash
+pulumi config set aws:region us-east-1
+```
+
+4. Execute the Pulumi program to create our lambda:
+
+```bash
+pulumi up
+```
+
+5. Call our lambda function from the aws cli
+
+```bash
+aws lambda invoke \
+--function-name $(pulumi stack output lambda) \
+--region $(pulumi config get aws:region) \
+--payload '"foo"' \
+output.json
+
+cat output.json # view the output file with your tool of choice
+# "FOO"
+```

aws-go-lambda/handler/handler.go

@@ -6,6 +6,7 @@ import (
  "github.com/aws/aws-lambda-go/lambda"
 )
 
+// handler is a simple function that takes a string and does a ToUpper.
 func handler(str string) (string, error) {
  return strings.ToUpper(str), nil
 }

aws-go-lambda/main.go

@@ -40,7 +40,7 @@ func main() {
  return err
  }
 
- // Stack exports
+ // Export the lambda ARN.
  ctx.Export("lambda", function.Arn)
 
  return nil