GitHub Actions で Lambda 関数の更新を自動デプロイする

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 (本番環境)

更新の流れ

  1. コードを編集 → Lambda 関数のコードを修正
  2. git push → GitHub にプッシュ
  3. GitHub Actions が起動 → ワークフローが自動実行
  4. Lambda 関数を更新 → AWS に変更を自動反映
  5. 自動テスト → 更新後の動作確認を実行
  6. 完了 → 更新完了

必要なリソース

今回の 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.json

2. ワークフローの重要ポイント

トリガー設定
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 タブを開くと、ワークフローの実行状況が確認できます。

  1. Actions タブ
    最新のワークフロー実行を選択
  2. 各ステップの確認
    実行状況とログを確認
  3. セットアップ完了の確認
    ✅ が表示され、すべてのステップが正常に完了していれば、セットアップ完了です

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 コンソールでの確認

  1. Lambda を開く
  2. my-lambda-function を選択
  3. Test タブでテストイベントを作成・実行
  4. 実行結果を確認

レスポンスに "message": "Hello from Updated Lambda!" と "version": "2.0.0" が表示されていれば、更新が正常に反映されています。

まとめ

GitHub Actions を使用して、Lambda 関数のコード更新を自動化する仕組みを構築しました。

本記事がご参考になれば幸いです。

この記事をシェアする
著者:shumpei
エンジニア2年生。文系大卒未経験でエンジニアスタート。