Giới thiệu Go Lambda Functions trên Netlify

06-12-2018 / tatthien

Bài viết này mình xin giới thiệu cách deploy một lambda function viết bằng Go lên Netlify.

Thật ra chúng ta đang sử dịch vụ AWS Lambda của Amazon, tuy nhiên functions được quản lí thông qua Netlify và bạn không cần phải có tài khoản AWS. Gói miễn phí của Netlify cung cấp 125.000 function requests/tháng và 100 giờ run time/tháng. Trong khi đó, gói free của AWS cung cấp cho bạn 1 triệu request/tháng và 400 nghìn Gb-Giây (gb*giây).

Chuẩn bị

Cài đặt Netlify Command Line Interface , giúp chúng ta deploy project lên Netlify.

npm install -g netlify-cli

Khởi tạo project với cấu trúc sau:

├── .gitignore
├── main.go
├── Makefile
└── site
    └── index.html

Viết function

Đầu tiên chúng ta cần cài đặt package chính thức của AWS hỗ trợ AWS Lambda Functions.

go get github.com/aws/aws-lambda-go

Code của chúng ta sẽ nằm trong main.go

package main

import (
	"github.com/aws/aws-lambda-go/events"
	"github.com/aws/aws-lambda-go/lambda"
)

func handler(request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
	return events.APIGatewayProxyResponse{
		StatusCode: 200,
		Body:       "Hello from 12bit.vn",
	}, nil
}

func main() {
	lambda.Start(handler)
}

Đoạn code trên thực hiện một tác vụ đơn giản đó là trả về chuỗi “Hello from 12bit.vn” khi chúng ta gởi một request vào đúng endpoint của function đó.

Body có kiểu string, chính là những gì sẽ trả về cho người dùng, nếu bạn muốn trả về kiểu JSON, thì phải tự marshal, cast []byte về kiểu string và gửi vào body, đồng thời thêm vào header:

Content-Type: application/json

Chúng ta thay đổi code bên trong function handler một chút.

func handler(request events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {
	body, _ := json.Marshal(map[string]interface{}{
		"msg": "Hello from 12bit.vn",
	})
	return events.APIGatewayProxyResponse{
		Headers: map[string]string{
			"content-type": "application/json",
		},
		StatusCode: 200,
		Body:       string(body),
	}, nil
}

Dữ liệu trả về sẽ có type JSON

{
    "msg": "Hello from 12bit.vn"
}

Build và Deploy

Để có thể gởi request lên function bên trên, chúng ta cần deploy project lên Netlify.

Để làm được điều này chúng ta có 2 bước:

Build project thành file binary.
Deploy file binary đó lên Netlify.

Chúng ta sẽ dùng Make và định nghĩa các câu lệnh trong Makefile để giảm thời gian gõ lại lệnh build và cũng tiện để implement auto deployment.

Build binary file

build:
   mkdir -p functions
   go get ./...
   GOOS=linux go build -o functions/hello main.go

Lệnh build gồm 3 bước:

Tạo folder chứa file binary sau khi build.
Get tất cả packages cần thiết.
Build file main.go với flag -o functions/hello để định nghĩa đường dẫn sau khi build của file binary.

Vì lambda chạy trên các máy chủ linux, vì vậy bạn cần phải chỉ định các biên ENV là GOO và GOARCH để go có thể build ra file thực thi phù có thể chạy trên linux.

Sau khi định nghĩa command build trong makefile, ta dùng lệnh sau để build:

make build

Kết quả sau build sẽ sinh ra folder functions chứa file thực thi.

├── functions
│   └── hello
├── .gitignore
├── main.go
├── Makefile
└── site
    └── index.html

Deploy lên Netlify

Tiếp tục trong Makefile, chúng ta định nghĩa lệnh deploy

deploy:
   netlify deploy --dir=site --functions=functions --prod

Để biết và hiểu các option khi deploy, các bạn gõ lệnh:

netlify deploy --help

Một điểm cần lưu ý đó là các bạn phải trỏ đúng tên folder chứa các functions ở phần --functions=functions. Cụ thể folder của chúng ta đang là functions

Để deploy, các bạn gõ lệnh make deploy. Sau khi deploy, Netlify cung cấp cho chúng ta đường dẫn để request vào các functions như sau:

Unique Deploy URL: https://5c0756bcc9659235c6174832--go-lambda-netlify.netlify.com
Live URL: https://go-lambda-netlify.netlify.com

Để truy cập vào function các bạn theo cú pháp sau:

[site_name].netlify.com/.netlify/functions/[function_name]

Trong ví dụ của chúng ta thì endpoint sẽ như sau:

https://go-lambda-netlify.netlify.com/.netlify/functions/hello

Các bạn có thể dùng Unique Deploy URL hoặc Live URL đều được, tùy mục đích sử dụng.

Kết luận

Bài viết trên với mục đích giới thiệu cho các bạn một tính năng hay của Netlify, giúp chúng ta có thể deploy AWS Lambda Function một cách dễ dàng.

Các bạn có thể đọc thểm về Functions trên Netlify tại đây: https://www.netlify.com/docs/functions/

Source code: https://github.com/12bitvn/go-lambda-netlify/

Request url: https://go-lambda-netlify.netlify.com/.netlify/functions/hello