go-standard-handler-serverless: A Shell repository from yuecen

go-standard-handler-serverless

這是一個範例 repo，主要是要示範如何利用 davyzhang/agw 撰寫 standard handler 來實作 AWS lambda function，而不需將 handler 改為官方 lambda handler 的寫法。好處是可同時將相同性質的 route path (/foo or /bar...) 全部置放在一個 lambda function 下。

例如：

Standard handler

// 你原來 golang handler
func myHandler(w http.ResponseWriter, r *http.Request) {
    // ...
}

Lambda handler (我們希望沿用上面的寫法，而不是需要把它改為下方的方式)

// AWS lambda 要你實作的 handler
func HandleRequest(ctx context.Context, name MyEvent) (string, error) {
    // ...
}

方便演示，製作了簡單的工具 tools.sh 包含了四種功能：

init: 製作所需的工具 docker image
build: 編譯 go 範例程式
deploy: 使用 serverless 部署編譯過後的 go binary file
remove: 使用 serverless 移除 aws 上的 lambda 包含 s3 內的檔案

必要的安裝與資訊

Docker

您必須安裝 docker 環境，才能進行編譯與部署，是用來產生一個環境 image, image 內有 Go 語言與 serverless 套件。

Access Key ID and Secret Access Key

您必須產生或跟您的 AWS 管理員拿一組使用者 credentials (包含 access key ID 與 Secret Access Key)，為了後續使用 serverless 部署自動化。

拿到你的 credentials 後，請先置換 tools.sh 第四五行的 <AWS_ACCESS_KEY_ID>, <AWS_SECRET_ACCESS_KEY> 變數。

建立環境 Docker Image

$ ./tools.sh init
# ... init ...

$ docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
go-serverless       1.x                 2b51d1f2f6b3        4 seconds ago       507MB

利用 Docker Image 去編譯 Go 程式碼

$ ./tools.sh build

Serverless 部署

$ ./tools.sh deploy

使用 vegeta 進行壓力測試

剛部署完執行第一次

ConcurrentExecutions: 86/500

# attack -rate=250 -duration=30s -timeout=10s | tee results.bin | vegeta report

Requests      [total, rate, throughput]  7500, 250.03, 150.13
Duration      [total, attack, wait]      35.249241776s, 29.995864107s, 5.253377669s
Latencies     [mean, 50, 95, 99, max]    6.14179192s, 6.00710603s, 10.003507574s, 10.00595233s, 10.010931736s
Bytes In      [total, mean]              14119062, 1882.54
Bytes Out     [total, mean]              0, 0.00
Success       [ratio]                    70.56%
Status Codes  [code:count]               0:2208  200:5292

執行完第一次後馬上進行第二次測試

注意：在第二次測試期間如果發現還有大量 status code 0 的存在，請檢察網路狀況。

ConcurrentExecutions: 36/500

# attack -rate=250 -duration=30s -timeout=10s | tee results.bin | vegeta report

Requests      [total, rate, throughput]  7500, 250.04, 242.10
Duration      [total, attack, wait]      30.978660944s, 29.995366366s, 983.294578ms
Latencies     [mean, 50, 95, 99, max]    244.586671ms, 206.843599ms, 454.935527ms, 860.13199ms, 1.262971858s
Bytes In      [total, mean]              19995008, 2666.00
Bytes Out     [total, mean]              0, 0.00
Success       [ratio]                    100.00%
Status Codes  [code:count]               200:7500

經過十分鐘後執行第三次測試

ConcurrentExecutions: 31/500

# attack -rate=250 -duration=30s -timeout=10s | tee results.bin | vegeta report

Requests      [total, rate, throughput]  7500, 250.04, 248.35
Duration      [total, attack, wait]      30.199815986s, 29.995067623s, 204.748363ms
Latencies     [mean, 50, 95, 99, max]    231.096304ms, 205.78514ms, 296.76661ms, 867.371262ms, 1.244541141s
Bytes In      [total, mean]              20009998, 2668.00
Bytes Out     [total, mean]              0, 0.00
Success       [ratio]                    100.00%
Status Codes  [code:count]               200:7500

yuecen/go-standard-handler-serverless