Initial Go Lambda example commit (#24)

add readme

---------

Signed-off-by: Madhav Mehta <madhav.mehta@chainguard.dev>

Author: shucking

aws-lambda-go/Dockerfile

@@ -0,0 +1,20 @@
+#Define Chainguard org to pull images from
+ARG CHAINGUARD_ORG="chainguard"
+
+# BUILD STAGE: Use Chainguard distroless go variant for build stage. You may optionally switch to -dev if additional utilities are needed to build your app.
+FROM cgr.dev/${CHAINGUARD_ORG}/go:latest AS build
+
+# Set working directory
+WORKDIR /helloworld
+
+# Copy dependencies list
+COPY go.mod go.sum ./
+
+# Build
+COPY main.go .
+RUN go build -o main main.go
+
+# FINAL STAGE: Copy artifacts to a clean image. Chainguard recommends using glibc-dynamic or static as a runtime for go applications. For more info, visit https://images.chainguard.dev/directory/image/go/overview#compatibility-notes
+FROM cgr.dev/${CHAINGUARD_ORG}/glibc-dynamic
+COPY --from=build /helloworld/main /main
+ENTRYPOINT [ "/main" ]

aws-lambda-go/README.md

@@ -0,0 +1,107 @@
+# aws-lambda-go
+An example of using the Chainguard `python` image as a base image for an AWS
+Lambda function as described in [this documentation](https://docs.aws.amazon.com/lambda/latest/dg/go-image.html#go-image-other)
+
+## Requirements
+
+You should have these utilities installed:
+
+- `aws`
+- `docker`
+- `jq`
+
+## Usage
+
+Export a name for your Lambda function. We'll use this value in later steps.
+
+```
+$ export FUNCTION_NAME=chainguard-python-lambda
+```
+
+Login to AWS. This may be different depending on how you authenticate to AWS.
+
+```
+$ aws sso login
+```
+
+Export the AWS account ID and region. We'll use these values in later steps.
+
+```
+$ export AWS_REGION=us-west-2
+$ export ACCOUNT_ID=$(aws sts get-caller-identity | jq -r .Account)
+```
+
+Create an AWS ECR repository.
+
+```
+$ aws ecr create-repository --repository-name "${FUNCTION_NAME}"
+```
+
+Login to AWS ECR.
+
+```
+$ aws ecr get-login-password \
+    | docker login \
+        --username AWS \
+        --password-stdin "${ACCOUNT_ID}.dkr.ecr.${AWS_REGION}.amazonaws.com"
+```
+
+Build and push the image.
+
+```
+$ docker buildx build \
+    --push \
+    --platform linux/amd64 \
+    --provenance=false \
+    -t "${ACCOUNT_ID}.dkr.ecr.${AWS_REGION}.amazonaws.com/${FUNCTION_NAME}:latest" \
+    .
+```
+
+Create a role for the Lambda.
+
+```
+$ aws iam create-role \
+  --role-name "${FUNCTION_NAME}" \
+  --assume-role-policy-document '{"Version": "2012-10-17","Statement": [{ "Effect": "Allow", "Principal": {"Service": "lambda.amazonaws.com"}, "Action": "sts:AssumeRole"}]}'
+```
+
+Create the Lambda function.
+
+```
+$ aws lambda create-function \
+  --function-name "${FUNCTION_NAME}" \
+  --package-type Image \
+  --code "ImageUri=${ACCOUNT_ID}.dkr.ecr.${AWS_REGION}.amazonaws.com/${FUNCTION_NAME}:latest" \
+  --role "arn:aws:iam::${ACCOUNT_ID}:role/${FUNCTION_NAME}"
+```
+
+Invoke the Lambda function.
+
+```
+$ aws lambda invoke --function-name "${FUNCTION_NAME}" /dev/stderr >/dev/null
+```
+
+The output should look similar to this:
+```
+{"statusCode":200,"headers":null,"multiValueHeaders":null,"body":"\"Hello from Lambda!\""}
+```
+
+## Clean Up
+
+Delete the Lambda function.
+
+```
+$ aws lambda delete-function --function-name "${FUNCTION_NAME}"
+```
+
+Delete the IAM role.
+
+```
+$ aws iam delete-role --role-name "${FUNCTION_NAME}"
+```
+
+Delete the ECR repository.
+
+```
+$ aws ecr delete-repository --repository-name "${FUNCTION_NAME}" --force
+```

aws-lambda-go/go.mod

@@ -0,0 +1,5 @@
+module aws-lambda-go
+
+go 1.22.5
+
+require github.com/aws/aws-lambda-go v1.50.0 // indirect

aws-lambda-go/go.sum

@@ -0,0 +1,2 @@
+github.com/aws/aws-lambda-go v1.50.0 h1:0GzY18vT4EsCvIyk3kn3ZH5Jg30NRlgYaai1w0aGPMU=
+github.com/aws/aws-lambda-go v1.50.0/go.mod h1:dpMpZgvWx5vuQJfBt0zqBha60q7Dd7RfgJv23DymV8A=

aws-lambda-go/main.go

@@ -0,0 +1,20 @@
+package main
+
+import (
+	"context"
+
+	"github.com/aws/aws-lambda-go/events"
+	"github.com/aws/aws-lambda-go/lambda"
+)
+
+func handler(ctx context.Context, event events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
+	response := events.APIGatewayProxyResponse{
+		StatusCode: 200,
+		Body:       "\"Hello from Lambda!\"",
+	}
+	return response, nil
+}
+
+func main() {
+	lambda.Start(handler)
+}