GitHub Actions から Go で書いた Lambda 関数をデプロイしてみた

go-lambda-actions/
├── .github/
│   └── workflows/
│       └── go.yml              # GitHub Actions ワークフロー
├── lambda/
│   ├── main.go                 # Lambda 関数ソースコード
│   ├── go.mod                  # Go モジュール定義（自動生成）
│   └── go.sum                  # 依存関係ロックファイル（自動生成）
└── infrastructure/
    ├── bin/
    │   └── app.ts              # CDK アプリケーション
    ├── lib/
    │   └── main-stack.ts       # CDK スタック定義
    ├── package.json
    └── cdk.json

cd lambda
go mod init lambda
go get github.com/aws/aws-lambda-go/lambda

// lambda/main.go
package main

import "github.com/aws/aws-lambda-go/lambda"

// handler は Lambda から呼ばれたときに実行される関数
func handler() (string, error) {
    return "Hello, World!", nil
}

// main は Lambda の起動時に実行される関数
func main() {
    // handler 関数を Lambda に登録
    lambda.Start(handler)
}

cd infrastructure
npm install @aws-cdk/aws-lambda-go-alpha

import * as cdk from 'aws-cdk-lib';
import * as go from '@aws-cdk/aws-lambda-go-alpha';
import { Construct } from 'constructs';

export class MainStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    const lambdaFunction = new go.GoFunction(this, 'GoLambda', {
      entry: '../lambda',
      runtime: cdk.aws_lambda.Runtime.PROVIDED_AL2023,
      architecture: cdk.aws_lambda.Architecture.ARM_64,
      timeout: cdk.Duration.seconds(10),
    });
  }
}

name: Go Lambda Deploy

# トリガー設定: このワークフローが実行される条件
on:
  # Pull Request がトリガー
  pull_request:
    # PR のライフサイクルイベント
    types: 
      - opened        # PR が新規作成されたとき
      - synchronize   # PR に新しいコミットがプッシュされたとき
      - reopened      # クローズされた PR が再オープンされたとき
    # 対象ブランチ: main ブランチへの PR のみ
    branches: [ main ]
    # パスフィルター: 以下のファイルが変更された場合のみ実行
    paths:
      - 'lambda/**'                    # Lambda 関数のコード変更
      - 'infrastructure/**'            # CDK インフラストラクチャの変更
      - '.github/workflows/go.yml'     # このワークフロー自体の変更

  # 手動実行を許可（GitHub の Actions タブから実行可能）
  workflow_dispatch:

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest

    # Environment: GitHub の Environment 設定を使用
    # ASSUME_ROLE_TOKYO_ARN などの変数が定義されている
    environment: DEVELOPMENT

    # 権限設定: このワークフローに付与される権限
    permissions:
      id-token: write   # OIDC トークンの取得に必要（AWS 認証用）
      contents: read    # リポジトリのコードを読み取る権限

    steps:
      # リポジトリのコードをチェックアウト
      - uses: actions/checkout@v5

      # Go のセットアップ
      # CDK が Go のビルドを実行する際に必要
      - name: Set up Go
        uses: actions/setup-go@v5
        with:
          # Go のバージョンを明示的に指定
          # 省略すると最新の安定版が使用される
          go-version: '1.21'

      # Node.js のセットアップ
      # CDK（TypeScript）の実行に必要
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          # Node.js のバージョンを指定
          node-version: '22'

      # CDK の依存関係をインストール
      - name: Install CDK dependencies
        run: |
          cd infrastructure
          npm ci

      # AWS 認証（OIDC）
      # IAM ロールを AssumeRole して一時的な認証情報を取得
      - name: Assume AWS Role for Tokyo
        uses: aws-actions/configure-aws-credentials@v4
        with:
          # Environment 変数から IAM ロールの ARN を取得
          # GitHub の Settings > Environments > DEVELOPMENT で設定
          role-to-assume: ${{ vars.ASSUME_ROLE_TOKYO_ARN }}
          aws-region: ap-northeast-1

      # CDK が自動的に Go をビルドし、Lambda 関数にデプロイする
      - name: CDK Deploy
        run: |
          cd infrastructure
          # CDK が内部で以下を実行する
          #   1. Go のビルド（go build）
          #   2. CloudFormation スタックの更新
          #   3. Lambda 関数のデプロイ
          npx cdk deploy --require-approval never