UNPKG

serverless-sam

Version:

Serverless framework plugin to export AWS SAM templates for a service

github.com/SAPessi/serverless-sam

SAPessi/serverless-sam

99 lines (75 loc) • 3.14 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
<!-- title: AWS Serving Dynamic HTML via API Gateway example in NodeJS description: This example illustrates how to hookup an API Gateway endpoint to a Lambda function to render HTML on a GET request. layout: Doc --> # Serving Dynamic HTML via API Gateway Example This example illustrates how to hookup an API Gateway endpoint to a Lambda function to render HTML on a `GET` request. ## Use-cases - Landing pages for marketing activities - Single use dynamic webpages ## How it works Instead of returning the default `json` from a request, you can display custom dynamic HTML by setting the `Content-Type` header to `text/html`. ```js const response = { statusCode: 200, headers: { 'Content-Type': 'text/html', }, body: html, }; // callback will send HTML back callback(null, response); ``` ## Deploy In order to deploy the you endpoint simply run ```bash serverless deploy ``` The expected result should be similar to: ```bash Serverless: Creating Stack... Serverless: Checking Stack create progress... ..... Serverless: Stack create finished... Serverless: Packaging service... Serverless: Uploading CloudFormation file to S3... Serverless: Uploading service .zip file to S3 (1.01 KB)... Serverless: Updating Stack... Serverless: Checking Stack update progress... ........................... Serverless: Stack update finished... Service Information service: serve-dynamic-html-via-http-endpoint stage: dev region: us-east-1 api keys: None endpoints: GET - https://nzkl1kas89.execute-api.us-east-1.amazonaws.com/dev/landing-page functions: serve-dynamic-html-via-http-endpoint-dev-landingPage: arn:aws:lambda:us-east-1:377024778620:function:serve-dynamic-html-via-http-endpoint-dev-landingPage ``` ## Usage You can now send an HTTP request directly to the endpoint using a tool like curl ```bash curl https://nzkl1kas89.execute-api.us-east-1.amazonaws.com/dev/landing-page?name=Nik%20Graf ``` The expected result should be similar to: ```bash <html> <style> h1 { color: #73757d; } </style> <body> <h1>Landing Page</h1> <p>Hey Nik Graf!</p> </body> </html>% ``` Of course you can visit the URL in your browser and this is how it should look like: ![Screenshot without a name](https://cloud.githubusercontent.com/assets/223045/20668061/12c6db9a-b56d-11e6-911c-8396d545471a.png) To greet a specific person provide attach the query parameter with the name of that person e.g. `?name=Nik%20Graf`. The response should now contain the provided name: ![Screenshot with a name](https://cloud.githubusercontent.com/assets/223045/20668055/0758b4cc-b56d-11e6-80ce-3e137151311f.png) ## Scaling By default, AWS Lambda limits the total concurrent executions across all functions within a given region to 100. The default limit is a safety limit that protects you from costs due to potential runaway or recursive functions during initial development and testing. To increase this limit above the default, follow the steps in [To request a limit increase for concurrent executions](http://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html#increase-concurrent-executions-limit).