23 日目！
今日は、AWS Lambda 関数を作ってみます。
もちろん、AWS CLIで。
23日目の要約
サーバレスコンピューティング！
AWS CLI の準備
このあたりをみて、好きなバージョンとお使いのOSにあった環境設定をしてくださいね。
なんなら、 AWS CloudShell で実行するのも楽でよいと思います。
この記事シリーズは、AWS CloudShell で実行し、実行例を載せています。
バージョン１
https://docs.aws.amazon.com/ja_jp/cli/latest/userguide/install-cliv1.html
バージョン２
https://docs.aws.amazon.com/ja_jp/cli/latest/userguide/install-cliv2.html
概要
AWS Lambda 関数を作成します
さあ、やってみよう！
AWS Lambda 関数用の IAM ロールを作る
Lambda 関数がログを出力するために使う IAM ロールを作っていきます。
まずは iam create-policy コマンドでポリシーを作成します。
aws iam create-policy --policy-name pol-lambda-adventcalendar2021 \
--policy-document '{"Version": "2012-10-17","Statement":[{"Effect": "Allow", "Action": ["logs:CreateLogGroup","logs:CreateLogStream","logs:PutLogEvents"],"Resource": "*"}]}'
ポリシー作成が成功すると、以下のような json が返ります。
{
"Policy": {
"PolicyName": "pol-lambda-adventcalendar2021",
"PolicyId": "ANPA*****************",
"Arn": "arn:aws:iam::************:policy/pol-lambda-adventcalendar2021",
"Path": "/",
"DefaultVersionId": "v1",
"AttachmentCount": 0,
"PermissionsBoundaryUsageCount": 0,
"IsAttachable": true,
"CreateDate": "2021-12-22T09:35:58+00:00",
"UpdateDate": "2021-12-22T09:35:58+00:00"
}
}
次に IAM ロールを作っていきます。
iam create-role コマンドを実行します。
aws iam create-role --role-name role-lambda-AdventCalendar2021 \
--assume-role-policy-document '{"Version": "2012-10-17", "Statement":[{"Effect": "Allow", "Principal":{"Service":"lambda.amazonaws.com"}, "Action":"sts:AssumeRole"}]}'
IAM ロールの作成に成功すると以下のような json が返ります。
{
"Role": {
"Path": "/",
"RoleName": "role-lambda-AdventCalendar2021",
"RoleId": "AROA*****************",
"Arn": "arn:aws:iam::************:role/role-lambda-AdventCalendar2021",
"CreateDate": "2021-12-22T09:36:43+00:00",
"AssumeRolePolicyDocument": {
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lambda.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
}
}
そして、IAM ロールに IAM ポリシーを関連づけます。
aws iam attach-role-policy --role-name role-lambda-AdventCalendar2021 \
--policy-arn arn:aws:iam::<AWSアカウントID>:policy/pol-lambda-adventcalendar2021
ロールへポリシーの割り当てが成功すると、特に何も返りません。
Lambda 関数を作る
さて、今日の本番。Lambda 関数を作っていきます。
まずは、テキストエディタでコードを書いていきます。
以下の例は、 AWS Lambda の OS 環境情報やストレージの容量などを取得し、HTML 出力するコードです。
import subprocess
def lambda_handler(event, context):
return_html="<HTML><TITLE>AWS Lambda Environment Information</TITLE><BODY>"
return_html=return_html+"<h1>AWS Lambda Environment Information</h1>"
return_html=return_html+"<h2>AWS Lambda Environmental Variables</h2>"
cmd = ["env"]
out = subprocess.run(cmd, stdout=subprocess.PIPE).stdout.decode()
return_html=return_html+out.replace('\n','<br>')
return_html=return_html+"<h2>AWS Lambda Storage Information</h2>"
cmd = ["df","-h"]
out = subprocess.run(cmd, stdout=subprocess.PIPE).stdout.decode()
return_html=return_html+out.replace('\n','<br>')
return_html=return_html+"<h2>AWS Lambda Directory Information</h2>"
cmd = ["ls","-al", "/"]
out = subprocess.run(cmd, stdout=subprocess.PIPE).stdout.decode()
return_html=return_html+out.replace('\n','<br>')
return_html=return_html+"</BODY></HTML>"
return return_html
保存したら、zip コマンドで圧縮します。
zip -r adcale.zip lambda_function.py
コードを封入した zip ファイルと IAM ロール、その他設定を指定して、 lambda create-function コマンドで Lambda 関数を作成します。
aws lambda create-function --function-name adventcalendar2021 \
--role arn:aws:iam::<AwS アカウントID>:role/role-lambda-AdventCalendar2021 \
--zip-file fileb://adcale.zip \
--runtime python3.8 \
--handler lambda_function.lambda_handler
正常に関数の作成が行えると、以下のような json が返ってきます。
{
"FunctionName": "adventcalendar2021",
"FunctionArn": "arn:aws:lambda:ap-northeast-1:************:function:adventcalendar2021",
"Runtime": "python3.8",
"Role": "arn:aws:iam::************:role/role-lambda-AdventCalendar2021",
"Handler": "lambda_function.lambda_handler",
"CodeSize": 470,
"Description": "",
"Timeout": 3,
"MemorySize": 128,
"LastModified": "2021-12-22T07:55:07.710+0000",
"CodeSha256": "********************************************",
"Version": "$LATEST",
"TracingConfig": {
"Mode": "PassThrough"
},
"RevisionId": "********-****-****-****-************",
"State": "Pending",
"StateReason": "The function is being created.",
"StateReasonCode": "Creating",
"PackageType": "Zip",
"Architectures": [
"x86_64"
]
}
動作確認
作成した Lambda 関数の動作確認をします。lambda invoke コマンドを実行します。
aws lambda invoke --function-name adventcalendar202102 outfile
outfile にLambda 関数の return で指定した変数の内容が出力されます。
今回の例では、開業が入っておらず見づらいので、以下のように sed コマンドで見やすくします。
cat outfile | sed "s/>/>\n/g"
以下のような HTML 形式の内容が出力されれば成功です！
"<HTML>
<TITLE>
AWS Lambda Environment Information</TITLE>
<BODY>
<h1>
AWS Lambda Environment Information</h1>
<h2>
AWS Lambda Environmental Variables</h2>
AWS_LAMBDA_FUNCTION_VERSION=$LATEST<br>
(以下、略)
まとめ
Lambda 関数の作成や実行も AWS CLI で簡単に行えてしまいました。
明日は、この Lambda 関数が出力する HTML を API Gateway から返すように設定していきます。