GitHub Actions で Lambda 関数の更新を自動デプロイする
目次
はじめに
こんにちは。shumpei です。
AWS Lambda は、サーバーレスアーキテクチャを実装できるサービスです。GitHub Actions を使用すると、Lambda 関数のコード変更を自動的にデプロイすることが可能です。
本記事では、GitHub Actions で CI/CD パイプラインを構築し、コードをプッシュするだけで自動的に Lambda 関数が更新される仕組みを構築する方法を紹介していきます。
構成概要
今回は以下の構成で実装していきます。
システム構成
GitHub リポジトリ
├─ lambda/index.js (Lambda 関数コード)
├─ terraform/ (インフラ定義 ※詳細は省略)
└─ .github/workflows/deploy.yml (ワークフロー定義)
│
│ git push でトリガー
↓
GitHub Actions (自動実行)
│
│ AWS に反映
↓
AWS Lambda (本番環境)更新の流れ
- コードを編集 → Lambda 関数のコードを修正
- git push → GitHub にプッシュ
- GitHub Actions が起動 → ワークフローが自動実行
- Lambda 関数を更新 → AWS に変更を自動反映
- 自動テスト → 更新後の動作確認を実行
- 完了 → 更新完了
必要なリソース
今回の GitHub Actions で Lambda 関数の更新を自動化する方法で必要となるリソースを簡単に説明していきます。
- Lambda 関数コード
実際に実行される JavaScript コードです。lambda/ディレクトリに配置します。 - GitHub Actions ワークフロー
.github/workflows/deploy.ymlに定義する自動化のパイプラインです。コードをプッシュすると自動的に実行されます。 - Terraform 定義ファイル
Lambda 関数とインフラリソースを定義します(本記事では詳細は省略します)。 - GitHub Secrets
AWS 認証情報を安全に保管するための GitHub の機能です。AWS_ACCESS_KEY_IDとAWS_SECRET_ACCESS_KEYを設定します。
前提となる基本構成
本記事では、以下の準備が完了している前提で進めていきます。
AWS側の準備
- AWS アカウントの作成
- Lambda 関数が既に作成されていること(ローカルで Terraform を使って事前に作成します)
- デプロイ用 IAM ユーザーの作成
必要な権限:AWSLambdaFullAccess,IAMFullAccess,CloudWatchLogsFullAccess
GitHub側の準備
- GitHub リポジトリの作成
- GitHub Secrets の設定
AWS_ACCESS_KEY_IDとAWS_SECRET_ACCESS_KEYを設定
Lambda 関数の事前作成
まず、ローカルで Terraform を使って Lambda 関数を作成します。
# Terraform の初期化
cd terraform
terraform init
# Lambda 関数を作成
terraform apply作成後、Terraform の state ファイルをコミットします。これにより、GitHub Actions も既存のリソースを認識できるようになります。
# state ファイルをコミット
git add terraform/terraform.tfstate
git commit -m "Add Terraform state for Lambda function"
git push origin main※本番環境では、state ファイルを Git にコミットせず、S3 バックエンドなどのリモート管理を使用することを推奨します。今回は検証目的のため、簡易的に state ファイルをコミットしています。
本記事では、既存の Lambda 関数のコードを更新する自動化に焦点を当てるため、インフラ構築の詳細は省略します。
Lambda 関数のコード
今回更新対象となる Lambda 関数のコードです。シンプルな構成になっています。
lambda/index.js
exports.handler = async (event) => {
console.log('Event:', JSON.stringify(event));
const response = {
statusCode: 200,
body: JSON.stringify({
message: 'Hello from Lambda!',
timestamp: new Date().toISOString(),
version: '1.0.0'
})
};
return response;
};lambda/package.json
{
"name": "lambda-function",
"version": "1.0.0",
"description": "Simple Lambda function with GitHub Actions deployment",
"main": "index.js"
}GitHub Actions ワークフローの実装
1. ワークフローファイルの作成
.github/workflows/deploy.yml を作成します。各ステップについてはコメントを追加しました。
# ワークフロー名
name: Deploy Lambda to AWS
# トリガー設定: main ブランチへのプッシュで自動実行
on:
push:
branches:
- main
jobs:
deploy:
name: Deploy to AWS Lambda
runs-on: ubuntu-latest
steps:
# ステップ1: リポジトリのコードをチェックアウト
- name: Checkout code
uses: actions/checkout@v3
# ステップ2: AWS 認証情報を設定
# GitHub Secrets に保存した認証情報を使用
- name: Configure AWS credentials
uses: aws-actions/configure-aws-credentials@v2
with:
aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
aws-region: ap-northeast-1
# ステップ3: Terraform のセットアップ
- name: Setup Terraform
uses: hashicorp/setup-terraform@v2
with:
terraform_version: 1.6.0
# ステップ4: Terraform の初期化
# プロバイダーやモジュールをダウンロード
- name: Terraform Init
working-directory: ./terraform
run: terraform init
# ステップ5: Terraform の実行計画を作成
# どのような変更が適用されるか確認
- name: Terraform Plan
working-directory: ./terraform
run: terraform plan -out=tfplan
# ステップ6: Terraform を実行して変更を適用
# Lambda 関数のコードを更新
- name: Terraform Apply
working-directory: ./terraform
run: terraform apply -auto-approve tfplan
# ステップ7: Lambda 関数の情報を取得
# 後続のステップで使用するために GITHUB_OUTPUT に保存
- name: Get Lambda function info
id: lambda
working-directory: ./terraform
run: |
FUNCTION_NAME=$(terraform output -raw lambda_function_name)
FUNCTION_ARN=$(terraform output -raw lambda_function_arn)
echo "function_name=$FUNCTION_NAME" >> $GITHUB_OUTPUT
echo "function_arn=$FUNCTION_ARN" >> $GITHUB_OUTPUT
# ステップ8: Lambda 関数のテスト実行
# 更新した Lambda 関数が正常に動作するか確認
- name: Test Lambda function
run: |
echo "Testing Lambda function: ${{ steps.lambda.outputs.function_name }}"
aws lambda invoke \
--function-name ${{ steps.lambda.outputs.function_name }} \
--payload '{"test": "data"}' \
--cli-binary-format raw-in-base64-out \
response.json
echo "Lambda response:"
cat response.json2. ワークフローの重要ポイント
トリガー設定main ブランチへのプッシュで自動実行されます。
AWS 認証
GitHub Secrets に保存した認証情報を使って、安全に AWS に接続します。
Terraform で更新を適用
Init、Plan、Apply といったステップが実行され、Lambda 関数のコードが自動的に更新されます。
(フォーマットチェックや構文検証を追加してもいいかもしれません)
Lambda 関数情報の取得$GITHUB_OUTPUT に書き込むことで、後続のステップから ${{ steps.lambda.outputs.function_name }} のように参照できます。
自動テスト
更新後、自動的に Lambda 関数を実行してテストします。aws lambda invoke コマンドで実際に関数を呼び出し、正常に動作することを確認します。
以上で、GitHub Actions ワークフローの実装に必要な主要設定が完了です。
ワークフローの初回セットアップ
GitHub Actions ワークフローの記述が完了したら、変更をコミットしてプッシュします。
git add .github/workflows/deploy.yml
git commit -m "Add GitHub Actions workflow for Lambda updates"
git push origin mainプッシュすると GitHub Actions が起動しますが、Lambda 関数は既に存在するため、変更がなければ何も更新されません。
動作確認
GitHub リポジトリの Actions タブを開くと、ワークフローの実行状況が確認できます。
- Actions タブ
最新のワークフロー実行を選択 - 各ステップの確認
実行状況とログを確認 - セットアップ完了の確認
✅ が表示され、すべてのステップが正常に完了していれば、セットアップ完了です
Terraform Plan で「No changes」と表示されれば、既存の Lambda 関数を正しく認識できています。
これで、コードをプッシュするだけで自動的に Lambda 関数が更新される仕組みが整いました。
Lambda 関数の更新テスト
それでは、実際に Lambda 関数のコードを更新してみましょう。
例えば、メッセージとバージョンを変更してみます。
lambda/index.js
exports.handler = async (event) => {
console.log('Event:', JSON.stringify(event));
const response = {
statusCode: 200,
body: JSON.stringify({
message: 'Hello from Updated Lambda!', // メッセージを変更
timestamp: new Date().toISOString(),
version: '2.0.0' // バージョンアップ
})
};
return response;
};コードを修正したら、GitHub にプッシュするだけです。
git add lambda/index.js
git commit -m "Update Lambda function to v2.0.0"
git push origin mainプッシュすると GitHub Actions が自動的に起動します。Terraform が Lambda 関数のコードハッシュ (source_code_hash) の変更を検知し、新しいコードで Lambda 関数を更新します。
GitHub Actions のログで「Terraform Plan」を確認すると、以下のように更新内容が表示されます:
Terraform will perform the following actions:
# aws_lambda_function.main will be updated in-place
~ resource "aws_lambda_function" "main" {
~ source_code_hash = "..." -> "..." (changed)
...
}
Plan: 0 to add, 1 to change, 0 to destroy.これにより、Lambda 関数のコードのみが更新され、IAMロールやCloudWatch Logsなどは変更されません。
更新の確認
更新完了後、実際にコードが更新されたか確認しましょう。
AWS コンソールでの確認
- Lambda を開く
my-lambda-functionを選択- Test タブでテストイベントを作成・実行
- 実行結果を確認
レスポンスに "message": "Hello from Updated Lambda!" と "version": "2.0.0" が表示されていれば、更新が正常に反映されています。
まとめ
GitHub Actions を使用して、Lambda 関数のコード更新を自動化する仕組みを構築しました。
本記事がご参考になれば幸いです。