build-rest-api-use-aws-web-console-trungquandev-18

Xây dựng một REST API với Nodejs, Lambda và API Gateway sử dụng AWS Web Console

Xin chào tất cả các bạn, ở bài trước, sau khi đã tìm hiểu Serverless là gì, hôm nay chúng ta sẽ cùng nhau đi xây dựng một REST API sử dụng giao diện điều khiển web console của aws amazon nhé.

“Bài này thuộc bài số 02 trong loạt bài Xây dựng các ứng dụng không máy chủ với Nodejs, AWS Lambda, API Gateway, Serverless Framework và DynamoDB

Những nội dung có trong bài này:

1. Chuẩn bị một tài khoản AWS.

2. Tạo API trong API Gateway và cấu hình tới dịch vụ Lambda Function.


1. Chuẩn bị một tài khoản AWS.

Bước đầu tiên, chắc chắn rồi, chúng ta phải có một tài khoản AWS, các bạn vào link sau để đăng ký tài khoản:

https://portal.aws.amazon.com/billing/signup#/start

build-rest-api-use-aws-web-console-trungquandev-01

Mặc định mình sẽ coi như các bạn đã làm qua bước này rồi vì cũng khó để mả hướng dẫn chi tiết phần này được. Mình có một số lưu ý sau cho các bạn chuẩn bị trước:

  • Như ở hình trên sau khi vào link đăng ký, các bạn có thể thấy Amazon cho chúng ta sử dụng 12 tháng gói miễn phí có giới hạn bao gồm khá nhiều dịch vụ như EC2, S3, DynamoDB, CodeBuild… Các bạn có thể nghiên cứu kỹ gói miễn phí giới hạn đó tại link này:
    https://aws.amazon.com/vi/free/
  • Để đăng ký được tài khoản AWS và nhận gói free trên thì bạn phải có một cái thẻ VISA thanh toán quốc tế, debit hay credit đều được. Và trong thẻ phải có ít nhất $1 để Amazon xác nhận tài khoản, số tiền này sẽ được trả lại cho bạn sau vài ngày, như lần mình đăng ký thì 7 ngày sau nó mới trả lại tiền (slowmotion) (khoc)
  • Và một lưu ý nữa trong phần này đó là gói miễn phí thì sẽ có một số dịch vụ chỉ có thể dùng ở Location bên Mỹ, ví dụ như CodeBuild, nếu chọn location là Singapore thì sẽ không sử dụng được. Yên tâm mình sẽ nói kỹ hơn cái này ở những bài tiếp theo.

2. Tạo API trong API Gateway và cấu hình tới dịch vụ Lambda Function.

Sau khi đã có tài khoản và đăng nhập vào AWS Web Console, chọn dịch vụ API Gateway. (Ấn vào mục Services gõ tìm kiếm API Gateway là sẽ thấy.)

Chọn button Create new API, còn với tài khoản mới chưa tạo API nào thì bạn sẽ thấy màn hình Get Started như dưới đây.

build-rest-api-use-aws-web-console-trungquandev-02

Có một vài cách để tạo API như Clone từ một API có sẵn, Import từ Swagger hoặc tham khảo từ một API mẫu của AWS, ở đây chúng ta đang tạo mới nên mình sẽ chọn New API:

  • API name*: Tên của API – Get adorable cats
  • Description: Mô tả API.
  • Enpoint type: Nơi mà API của sẽ được deploy, trong bài này mình sẽ chọn Regional, và có 3 option trong phần này mình giải thích tóm tắt lại, đó là:

build-rest-api-use-aws-web-console-trungquandev-03

Nhấn Create API, sang bước kế tiếp, trong bảng điều khiển của API Get adorable cats mình vừa tạo, chọn Resources > Actions > Create resource

build-rest-api-use-aws-web-console-trungquandev-04

Làm tiếp bước nhập name + path cho resource, mình nhập nó là cats, rồi nhấn Create resource

build-rest-api-use-aws-web-console-trungquandev-05

Việc tiếp theo là chúng ta cần định nghĩa method cho resource này, mình sẽ tạo một method GET để lấy ra thông tin những con mèo. Đứng từ resource cats, chọn Action > Create method

build-rest-api-use-aws-web-console-trungquandev-06

Chọn method GET:

build-rest-api-use-aws-web-console-trungquandev-07

Có method rồi, bây giờ cần cấu hình dịch vụ backend mà sẽ trả về dữ liệu khi chúng ta gọi đến phương thức GET này, có nhiều dịch vụ như Lambda function, một HTTP enpoint hiện có, Mock (giả lập nội dung trả về) hoặc nhiều dịch vụ khác của AWS…vv. Mình sẽ chọn Lambda function làm backend.

build-rest-api-use-aws-web-console-trungquandev-08

Vì chưa có function nào ở dịch vụ Lambda nên bạn sẽ thấy dòng thông báo như trên, click vào Create a Lambda Function để sang tab mới của dịch vụ này. Tab API Gateway thì bạn cứ giữ nguyên, lát nữa sau khi tạo xong lambda function thì chúng ta sẽ quay lại.

Trước khi tạo Function Lambda, chúng ta cần tạo một cái role để cấp quyền thực thi lambda. Truy cập vào một service tên là IAM > Roles > Create role

Chọn typeAWS service, dịch vụ là Lambda như hình dưới, rồi Next: Permissions

build-rest-api-use-aws-web-console-trungquandev-09

Các bạn tìm và chọn cho mình một cái Policy có tên là AWSLambdaFullAccess, rồi Next: Tags

build-rest-api-use-aws-web-console-trungquandev-09-1

Bước thêm tags thì các bạn bỏ qua, sang phần Next: Review luôn

Trong bước review, mình nhập tên cho cái role này là execute-lambda-full-access, rồi nhấn Create role

build-rest-api-use-aws-web-console-trungquandev-09-2

Bây giờ quay lại màn hình tạo function Lambda – Create Lambda function, chọn Author from scratch, nhập các thông tin như hình dưới rồi ấn Create function.

  • Name: Tên của function – getCats
  • Runtime: Môi trường chạy, mình chọn Node.js 8.10, phiên bản nodejs cao nhất mà AWS hỗ trợ ở thời điểm hiện tại.
  • Role: chọn cái role mà chúng ta vừa tạo ở trên service-role/execute-lambda-full-access

build-rest-api-use-aws-web-console-trungquandev-09-3

Tiếp theo là viết code cho function getCats này, mình sẽ viết một đoạn code đơn giản trả về một mảng danh sách 2 con mèo dưới dạng chuỗi json.

build-rest-api-use-aws-web-console-trungquandev-10

Nhấn Save để lưu  function.

Quay lại màn hình API Gateway ban nãy, nhập tên function vừa tạo vào phần Lambda function rồi nhấn Save. AWS sẽ hỏi bạn Add Permission to Lambda Function thì cứ ấn ok.

build-rest-api-use-aws-web-console-trungquandev-11

Sau một hồi hại não với mấy cái cấu hình này thì bây giờ đã có kết quả rồi 😀

build-rest-api-use-aws-web-console-trungquandev-12

Hiện tại chúng ta đã có thể test API trước khi deploy, ấn vào nút Test như hình trên, vì API chúng ta tạo ở đây không có yêu cầu gì về query string hay header, body gì cả nên cứ để trống và test, kết quả trả về đúng như những gì đã code ban nãy 😀

build-rest-api-use-aws-web-console-trungquandev-13

Tới bước cuối cùng, deploy API này cho thế giới bên ngoài biết :v

Chọn Action > Deploy API

build-rest-api-use-aws-web-console-trungquandev-14

Nó lại còn bắt mình nhập stage nữa, nhiều bước quá (khoc), đại loại stage là sẽ nhập tên với mô tả giai đoạn mà chúng ta triển khai API, dạng như giai đoạn thử nghiệm, giai đoạn đưa ra thị trường gì gì đấy…

build-rest-api-use-aws-web-console-trungquandev-15

Xong rồi ấn Deploy. Bạn sẽ nhận được URL của API tương tự như thế này:

build-rest-api-use-aws-web-console-trungquandev-16

Bây giờ ra trình duyệt mở URL đó lên hoặc dùng Postman test thử sẽ nhận được kết quả:

build-rest-api-use-aws-web-console-trungquandev-17


Xong rồi đó, khá nhiều công đoạn phải không, bài kế tiếp chúng ta sẽ không dùng nhiều tới giao diện Web Console này nữa mà sẽ đi xây dựng một CRUD API sử dụng Serverless Framework và DynamoDB.

Xin chào và hẹn gặp lại các bạn ở những bài viết tiếp theo.

Best Regards – Trung Quân – Green Cat

trungquandev-img-modal