RubyでのAWSLambda関数の構築、テスト、デプロイ

Lambdaは、AWSが提供するサーバーレスコンピューティングサービスです。コードが実行される実際のサーバー管理を必要とせずに、必要に応じてコードを実行するために使用できます。 Lambdaを使用して、非同期プロセス、REST API、またはスケジュールされたジョブを実行できます。 ハンドラー関数を作成するだけです。 関数をAWSLambdaにプッシュします。 Lambdaは、イベントに基づいてタスクを実行する役割を果たします。 。イベントは、APIゲートウェイ、SQS、S3などのさまざまなソースによってトリガーできます。別のコードベースによってトリガーすることもできます。トリガーされると、このLambda関数はイベントとコンテキストパラメーターを受け取ります。これらのパラメーターの値は、トリガーのソースによって異なります。これらのイベントをハンドラーに渡すことで、手動またはプログラムでLambda関数をトリガーすることもできます。ハンドラーは2つの引数を取ります：

イベント -イベントは通常、トリガーのソースから渡されるKey-Valueハッシュです。これらの値は、SQS、Kinesis、APIゲートウェイなどのさまざまなソースによってトリガーされると自動的に渡されます。手動でトリガーする場合、ここでイベントを渡すことができます。イベントには、Lambda関数ハンドラーの入力データが含まれています。たとえば、APIゲートウェイでは、リクエストの本文はこのイベント内に含まれています。

コンテキスト -コンテキストは、ハンドラー関数の2番目の引数です。これには、トリガーのソース、Lambda関数名、バージョン、request-idなどの特定の詳細が含まれます。

ハンドラーの出力は、Lambda関数をトリガーしたサービスに戻されます。 Lambda関数の出力は、ハンドラー関数の戻り値です。

AWS Lambdaは、Rubyを含む7つの異なる言語をサポートしています。ここでは、AWSRuby-sdkを使用してDynamoDBに接続します。

コードを書く前に、SAMテンプレートを使用してLambdaのインフラストラクチャを作成しましょう：

AWSTemplateFormatVersion: "2010-09-09"
Transform: AWS::Serverless-2016-10-31
Description: "Serverless users app"

Resources:
  CreateUserFunction:
    Type: AWS::Serverless::Function
    Properties:
      Handler: users.create
      Runtime: ruby2.7
      Policies:
        - DynamoDBWritePolicy:
            TableName: !Ref UsersTable
      Environment:
        Variables:
          USERS_TABLE: !Ref UsersTable

ハンドラーには、実行する関数への参照をHandler: <filename>.<method_name>として記述します。 。

使用するリソースに基づいてLambdaにアタッチできるポリシーについては、サーバーレスポリシーテンプレートを参照してください。 Lambda関数はDynamoDBに書き込むため、DynamoDBWritePolicyを使用しました ポリシーセクションで。

また、指定されたデータベースにリクエストを送信できるように、環境変数USERS_TABLEをLambda関数に提供しています。

だから、それは私たちが以下のラムダに必要なものです。それでは、Lambda関数が実行するDynamoDBでユーザーを作成するコードを記述しましょう。

AWSレコードをGemfileに追加します：

# Gemfile
source 'https://rubygems.org' do
  gem 'aws-record', '~> 2'
end

DynamoDBに入力を書き込むコードを追加します：

# users.rb
require 'aws-record'

class UsersTable
  include Aws::Record
  set_table_name ENV['USERS_TABLE']
  string_attr :id, hash_key: true
  string_attr :body
end

def create(event:,context:)
  body = event["body"]
  id = SecureRandom.uuid
  user = UsersTable.new(id: id, body: body)
  user.save!
  user.to_h
end

とても速くて簡単です。 AWSはaws-recordを提供しています Railsのactiverecordに非常によく似たDynamoDBにアクセスするためのgem 。

次に、次のコマンドを実行して依存関係をインストールします。

注：Lambdaで定義されているものと同じバージョンのRubyを使用していることを確認してください。この例では、マシンにRuby2.7をインストールする必要があります。

# install dependencies

$ bundle install
$ bundle install --deployment

変更をパッケージ化します：

$ sam package --template-file sam.yaml \
              --output-template-file out.yaml \
              --s3-bucket serverless-users-bucket

デプロイ：

sam deploy --template-file out.yaml \
             --stack-name serverless-users-app \
             --capabilities CAPABILITY_IAM

このコードで、Lambdaが実行され、データベースに入力を書き込むことができます。 Lambdaの前にAPIゲートウェイを追加して、HTTP呼び出しを介してアクセスできるようにすることができます。 APIゲートウェイは、レート制限や認証など、多くのAPI管理機能を提供します。ただし、使用法によっては高額になる可能性があります。 API管理なしでHTTPAPIのみを使用するより安価なオプションがあります。ユースケースに基づいて、最も適切なものを選択できます。

AWSLambdaにはいくつかの制限があります。それらのいくつかは変更できますが、他は修正されています：

• メモリ -デフォルトでは、Lambdaの実行時に128MBのメモリがあります。これは、64MB刻みで最大3,008MBまで増やすことができます。
• タイムアウト -Lambda関数には、コードを実行するための時間制限があります。デフォルトの制限は3秒です。これは最大900秒まで増やすことができます。
• ストレージ -Lambdaは/tmpを提供します ストレージ用のディレクトリ。このストレージの制限は512MBです。
• リクエストとレスポンスのサイズ -同期トリガーの場合は最大6MB、非同期トリガーの場合は最大256MB。
• 環境変数 -最大4KB

Lambdaにはこれらの制限のいくつかがあるため、これらの制限内に収まるコードを作成することをお勧めします。そうでない場合は、コードを分割して、あるLambdaが別のLambdaをトリガーするようにすることができます。 AWSが提供するステップ関数もあり、これを使用して複数のLambda関数をシーケンスできます。

サーバーレスアプリケーションをローカルでテストするにはどうすればよいですか？

サーバーレスアプリケーションの場合、マネージドサーバーレスサービスを提供するベンダーが必要です。アプリケーションのテストはAWSに依存しています。アプリケーションをテストするために、AWSが提供するいくつかのローカルオプションがあります。 AWSサーバーレステクノロジーと互換性のある一部のオープンソースツールを使用して、アプリケーションをローカルでテストすることもできます。

Lambda関数とDynamoDBをテストしてみましょう。そのためには、これらをローカルで実行する必要があります。

まず、Dockerネットワークを作成します。ネットワークは、Lambda関数とDynamoDB間の通信に役立ちます。

$ docker network create lambda-local --docker-network lambda-local

DynamoDB localは、AWSが提供するDynamoDBのローカルバージョンであり、ローカルでテストするために使用できます。次のDockerイメージを実行して、DynamoDBローカルを実行します。

$ docker run -p 8000:8000 --network lambda-local --name dynamodb amazon/dynamodb-local

user.rbに次の行を追加します ファイル。これにより、LambdaがローカルのDynamoDBに接続されます：

local_client = Aws::DynamoDB::Client.new(
  region: "local",
  endpoint: 'https://dynamodb:8000'
)
UsersTable.configure_client(client: local_client)

input.jsonを追加します Lambdaの入力を含むファイル：

{
  "name": "Milap Neupane",
  "location": "Global"
}

Lambdaを実行する前に、ローカルのDynamoDBにテーブルを追加する必要があります。そのために、aws-migrateが提供する移行機能を使用します。ファイルmigrate.rbを作成し、次の移行を追加しましょう：

require 'aws-record'
require './users.rb'

local_client = Aws::DynamoDB::Client.new(
  region: "local",
  endpoint: 'https://localhost:8000'
)
migration = Aws::Record::TableMigration.new(UsersTable, client: local_client)

migration.create!(
  provisioned_throughput: {
    read_capacity_units: 5,
    write_capacity_units: 5
  }
)
migration.wait_until_available

最後に、次のコマンドを使用してローカルでLambdaを実行します。

$ sam local invoke "CreateUserFunction" -t sam.yaml \
                                        -e input.json \
                                        --docker-network lambda-local

これにより、DynamoDBテーブルにユーザーのデータが作成されます。

AWSスタックをローカルで実行するためのlocalstackなどのオプションがあります。