feat: 4 examples with Lambda Function ARN and URL

Author: shawnhankim

Makefile

@@ -1,8 +1,14 @@
 start-01:
-	docker-compose -f examples/01-proxy-to-all-lambda-functions/docker-compose.yml up -d
+	docker-compose -f examples/01-all-lambda-function-arns/docker-compose.yml up -d
 
 start-02:
-	docker-compose -f examples/02-proxy-to-each-lambda-function/docker-compose.yml up -d
+	docker-compose -f examples/02-one-lambda-function-arn/docker-compose.yml up -d
+
+start-03:
+	docker-compose -f examples/03-one-lambda-function-url/docker-compose.yml up -d
+
+start-04:
+	docker-compose -f examples/04-lambda-function-arn-and-url/docker-compose.yml up -d
 
 ps:
 	docker ps --format "table {{.ID}}\t{{.Image}}\t{{.Ports}}\t{{.Names}}"
@@ -11,10 +17,16 @@ watch:
 	watch 'docker ps --format "table {{.ID}}\t{{.Image}}\t{{.Ports}}\t{{.Names}}"'
 
 down-01:
-	docker-compose -f examples/01-proxy-to-all-lambda-functions/docker-compose.yml down
+	docker-compose -f examples/01-all-lambda-function-arns/docker-compose.yml down
 
 down-02:
-	docker-compose -f examples/02-proxy-to-each-lambda-function/docker-compose.yml down
+	docker-compose -f examples/02-one-lambda-function-arn/docker-compose.yml down
+
+down-03:
+	docker-compose -f examples/03-one-lambda-function-url/docker-compose.yml down
+
+down-04:
+	docker-compose -f examples/04-lambda-function-arn-and-url/docker-compose.yml down
 
 clean: 
 	docker kill $$(docker ps -q) 2> /dev/null || true

examples/01-all-lambda-function-arns/README.md

@@ -0,0 +1,3 @@
+# Example: Proxy To All Lambda Function ARNs
+
+This is an example of a NGINX proxy to all of the AWS Lambda Function ARNs.

examples/01-proxy-to-all-lambda-functions/docker-compose.yml renamed to examples/01-all-lambda-function-arns/docker-compose.yml

@@ -12,7 +12,7 @@ services:
       # Enable this when using NGINX Plus
       # dockerfile: ./docker/Dockerfile.plus
     volumes:
-      - ../../examples/01-proxy-to-all-lambda-functions/:/etc/nginx/conf.d/
+      - ../../examples/01-all-lambda-function-arns/:/etc/nginx/conf.d/
       - ../../core:/etc/nginx/lambda
     ports:
       - "80:80"

examples/01-proxy-to-all-lambda-functions/frontend.conf renamed to examples/01-all-lambda-function-arns/frontend.conf

@@ -4,10 +4,10 @@ server {
     include "lambda/lambda_ngx_apis.conf";
     listen 80;
 
-    # Example of all endpoint to be proxied to all AWS Lambda Function ARNs.
+    # Example of a proxy to all of the AWS Lambda Function ARNs.
     location / {
         auth_request /aws/credentials/retrieval;
-        js_content lambdagateway.redirectToLambda;
+        js_content lambdagateway.redirectToLambdaFunctionARN;
     }
 
     # Enable when debugging is needed

examples/01-all-lambda-function-arns/lambda_function.py

@@ -0,0 +1,11 @@
+import json
+
+def lambda_handler(event, context):
+    # TODO implement
+    return {
+        'statusCode': 200,
+        'body': {
+            'request': event,
+            'response': 'Hello from NGINX Lambda Gateway - /foo!'
+        }
+    }

examples/02-one-lambda-function-arn/README.md

@@ -0,0 +1,3 @@
+# Example: Proxy To One Lambda Function ARN
+
+This is an example of a NGINX proxy to one the AWS Lambda Function ARN.

examples/02-proxy-to-each-lambda-function/docker-compose.yml renamed to examples/02-one-lambda-function-arn/docker-compose.yml

@@ -12,7 +12,7 @@ services:
       # Enable this when using NGINX Plus
       # dockerfile: ./docker/Dockerfile.plus
     volumes:
-      - ../../examples/02-proxy-to-each-lambda-function/:/etc/nginx/conf.d/
+      - ../../examples/02-one-lambda-function-arn/:/etc/nginx/conf.d/
       - ../../core:/etc/nginx/lambda
     ports:
       - "80:80"

examples/02-one-lambda-function-arn/frontend.conf

@@ -0,0 +1,16 @@
+include "lambda/lambda_ngx_http.conf";
+
+server {
+    include "lambda/lambda_ngx_apis.conf";
+    listen 80;
+
+    # Example of a proxy to one AWS Lambda Function ARN.
+    location /2015-03-31/functions/foo/invocations {
+        auth_request /aws/credentials/retrieval;
+        js_content lambdagateway.redirectToLambdaFunctionARN;
+    }
+
+    # Enable when debugging is needed
+    error_log  /var/log/nginx/error.log  debug; # Reduce severity level as required
+    access_log /var/log/nginx/access.log main;
+}

examples/02-one-lambda-function-arn/lambda_function.py

@@ -0,0 +1,11 @@
+import json
+
+def lambda_handler(event, context):
+    # TODO implement
+    return {
+        'statusCode': 200,
+        'body': {
+            'request': event,
+            'response': 'Hello from NGINX Lambda Gateway - /foo!'
+        }
+    }

examples/03-one-lambda-function-url/README.md

@@ -0,0 +1,4 @@
+# Example: Proxy To One Lambda Function URL
+
+This is an example of a NGINX proxy to one the AWS Lambda Function URL.
+

examples/03-one-lambda-function-url/docker-compose.yml

@@ -0,0 +1,20 @@
+version: '3'
+services:
+  nginx_lambda:
+    hostname: nginx_lambda
+    container_name: nginx_lambda
+    image: nginx_lambda
+    build:
+      context: ../../
+      # Enable this when using NGINX OSS
+      dockerfile: ./docker/Dockerfile.oss
+      
+      # Enable this when using NGINX Plus
+      # dockerfile: ./docker/Dockerfile.plus
+    volumes:
+      - ../../examples/03-one-lambda-function-url/:/etc/nginx/conf.d/
+      - ../../core:/etc/nginx/lambda
+    ports:
+      - "80:80"
+    env_file:
+      - ../../settings.test

examples/03-one-lambda-function-url/frontend.conf

@@ -0,0 +1,16 @@
+include "lambda/lambda_ngx_http.conf";
+
+server {
+    include "lambda/lambda_ngx_apis.conf";
+    listen 80;
+
+    # Example of a proxy to one AWS Lambda Function URL.
+    location /bar {
+        auth_request /aws/credentials/retrieval;
+        js_content lambdagateway.redirectToLambdaFunctionURL;
+    }
+
+    # Enable when debugging is needed
+    error_log  /var/log/nginx/error.log  debug; # Reduce severity level as required
+    access_log /var/log/nginx/access.log main;
+}

examples/03-one-lambda-function-url/lambda_function.py

@@ -0,0 +1,8 @@
+import json
+
+def lambda_handler(event, context):
+    # TODO implement
+    return {
+        'statusCode': 200,
+        'body': json.dumps('Hello from NGINX Lambda Gateway - /bar!')
+    }

examples/04-lambda-function-arn-and-url/README.md

@@ -0,0 +1,3 @@
+# Example: Proxy To The Lambda Function ARN and URL
+
+This shows the combined example of NGINX proxies to the AWS Lambda Function ARN and URL.

examples/04-lambda-function-arn-and-url/docker-compose.yml

@@ -0,0 +1,20 @@
+version: '3'
+services:
+  nginx_lambda:
+    hostname: nginx_lambda
+    container_name: nginx_lambda
+    image: nginx_lambda
+    build:
+      context: ../../
+      # Enable this when using NGINX OSS
+      dockerfile: ./docker/Dockerfile.oss
+      
+      # Enable this when using NGINX Plus
+      # dockerfile: ./docker/Dockerfile.plus
+    volumes:
+      - ../../examples/04-lambda-function-arn-and-url/:/etc/nginx/conf.d/
+      - ../../core:/etc/nginx/lambda
+    ports:
+      - "80:80"
+    env_file:
+      - ../../settings.test

examples/02-proxy-to-each-lambda-function/frontend.conf renamed to examples/04-lambda-function-arn-and-url/frontend.conf

@@ -4,19 +4,19 @@ server {
     include "lambda/lambda_ngx_apis.conf";
     listen 80;
 
-    # Example of all endpoint to be proxied to all AWS Lambda Function ARNs.
+    # Example of a proxy to all of the AWS Lambda Function ARNs.
     location / {
         auth_request /aws/credentials/retrieval;
         js_content lambdagateway.redirectToLambdaFunctionARN;
     }
 
-    # Example of a specific endpoint to be proxied to an AWS Lambda Function ARN.
+    # Example of a proxy to one AWS Lambda Function ARN.
     location /2015-03-31/functions/foo/invocations {
         auth_request /aws/credentials/retrieval;
         js_content lambdagateway.redirectToLambdaFunctionARN;
     }
 
-    # Example of a specific endpoint to be proxied to AWS Lambda Function URL.
+    # Example of a proxy to one AWS Lambda Function URL.
     location /bar {
         auth_request /aws/credentials/retrieval;
         js_content lambdagateway.redirectToLambdaFunctionURL;

examples/04-lambda-function-arn-and-url/lambda_function_bar.py

@@ -0,0 +1,8 @@
+import json
+
+def lambda_handler(event, context):
+    # TODO implement
+    return {
+        'statusCode': 200,
+        'body': json.dumps('Hello from NGINX Lambda Gateway - /bar!')
+    }

examples/04-lambda-function-arn-and-url/lambda_function_foo.py

@@ -0,0 +1,11 @@
+import json
+
+def lambda_handler(event, context):
+    # TODO implement
+    return {
+        'statusCode': 200,
+        'body': {
+            'request': event,
+            'response': 'Hello from NGINX Lambda Gateway - /foo!'
+        }
+    }

examples/README.md

@@ -0,0 +1,6 @@
+# NGINX Lambda Gateway Examples
+
+- [NGINX Lambda Gateway to all of the AWS Lambda Function ARNs](./01-all-lambda-function-arns/)
+- [NGINX Lambda Gateway to one AWS Lambda Function ARN](./02-one-lambda-function-arn/)
+- [NGINX Lambda Gateway to one AWS Lambda Function URL](./03-one-lambda-function-url/)
+- [NGINX Lambda Gateway to the AWS Lambda Function ARN and URL](./04-lambda-function-arn-and-url/)