AWS Lambda Control Tool - Simple CLI for managing Lambda functions
npm install @infodb/lctlbash
pnpx @infodb/lctl [コマンド] [設定ファイル名] [オプション]
`基本的な使用方法
$3
project/
├── configs/ # 設定ファイル（必須）
│ ├── my-function.yaml
│ └── other-function.yaml
├── functions/ # Lambda関数コード（必須）
│ ├── my-function.py
│ └── utils.py
└── my-function.zip # 生成されるデプロイパッケージ
$3
:
`yaml
基本設定
function_name: my_function # 実際のLambda関数名
runtime: python3.12
handler: my_function.handler
role: arn:aws:iam::123456789012:role/lambda-execution-roleファイル設定
files:
- my_function.py
- utils.pyPython依存関係（自動インストール）
requirements:
- requests>=2.28.0
- boto3>=1.26.0環境変数
environment:
ENV: production権限設定
permissions:
- service: apigateway
source_arn: "arn:aws:execute-api:us-east-1:123456789012:*"
`$3
bash
一括デプロイ（推奨）
pnpx @infodb/lctl deploy my-functionまたは個別実行
pnpx @infodb/lctl makezip my-function # ZIPパッケージ作成
pnpx @infodb/lctl export my-function # スクリプト生成
bash deploy-my-function.sh # デプロイ実行
`コマンド一覧
$3
bash
pnpx @infodb/lctl makezip [オプション]
`必須引数:
-
: 設定ファイル名（.yaml拡張子は不要）オプション:
-
--verbose: 詳細なログを出力機能:
-
requirementsセクションがあれば自動的にpip installを実行
- 既存のvendorフォルダを削除
- 適切なディレクトリ構造でを作成例:
`bash
pnpx @infodb/lctl makezip my-function --verbose
`$3
bash
pnpx @infodb/lctl deploy [オプション]
`必須引数:
-
: 設定ファイル名（.yaml拡張子は不要）オプション:
-
--verbose: 詳細なログを出力動作:
1.
makezipコマンドを自動実行（ZIPパッケージ作成）
2. exportコマンドを自動実行（デプロイスクリプト生成）
3. 生成されたスクリプトを実行（AWS Lambda関数デプロイ）例:
`bash
基本的な使用方法
pnpx @infodb/lctl deploy my-function詳細ログ付き
pnpx @infodb/lctl deploy my-function --verbose
`$3
bash
pnpx @infodb/lctl export [オプション]
`必須引数:
-
: 設定ファイル名（.yaml拡張子は不要）オプション:
-
--output : 出力ファイルパス（デフォルト: deploy-{config-name}.sh）
- --verbose: 詳細なログを出力機能:
-
の存在チェックを含むスクリプトを生成
- CI/CD環境で個別実行するのに適している例:
`bash
スクリプト生成
pnpx @infodb/lctl export my-functionカスタム出力ファイル
pnpx @infodb/lctl export my-function --output custom-deploy.sh
`$3
bash
pnpx @infodb/lctl delete [オプション]
`必須引数:
-
: 設定ファイル名（.yaml拡張子は不要）オプション:
-
--verbose: 詳細なログを出力例:
`bash
pnpx @infodb/lctl delete my-function
`$3
bash
pnpx @infodb/lctl info [オプション]
`必須引数:
-
: 設定ファイル名（.yaml拡張子は不要）オプション:
-
--verbose: 詳細なログを出力例:
`bash
pnpx @infodb/lctl info my-function
`$3
bash
pnpx @infodb/lctl gen-routes [オプション]
`入力:
-
: terraform show -json を保存したファイルパスオプション:
-
--output : 生成する routes.json の出力先（デフォルト: routes.json）
- --verbose: 解析過程を詳細表示機能:
-
aws_apigatewayv2_route / aws_apigatewayv2_integration リソースを走査し、routeKey と Lambda の紐付けを抽出
- Integration URI から Lambda 関数名を解析して { "method": "GET", "path": "/foo", "lambda": "lambda_foo" } 形式に整形
- 紐付けが不完全な場合はエラー終了し、問題箇所を表示例:
`bash
terraform show -json tfplan.out > tfplan.json
pnpx @infodb/lctl gen-routes tfplan.json --output routes.json
`$3
bash
pnpx @infodb/lctl serve [オプション]
`オプション:
-
: routes.json のパス（デフォルト: routes.json）
- --port : 起動ポート（デフォルト: 3000）
- --config-dir : configs/ を別パスに変更したい場合に指定
- --functions-dir : Lambda ソースが配置されたディレクトリ（デフォルト: functions/）
- --verbose: ルーティングや Lambda 実行ログを詳細表示機能:
-
routes.json と YAML 設定からローカルの Lambda ハンドラーを特定
- Express ベースの HTTP サーバを起動し、API Gateway HTTP API v2 のイベント（version, routeKey, rawPath, headers, body, requestContext.http）を再現
- Node.js ランタイムは require で直接呼び出し、Python ランタイムは python3 サブプロセス経由で handler(event, context) を実行
- Lambda の戻り値 { statusCode, headers, body } を HTTP レスポンスへ変換利用例:
`bash
1. Terraform から routes.json を生成
pnpx @infodb/lctl gen-routes tfplan.json2. ローカル HTTP サーバを起動
pnpx @infodb/lctl serve --routes routes.json --port 4000
`注意:
-
に存在しない Lambda、または handler がエクスポートされていない場合は起動時/実行時に例外となります。
- Python モジュールは functions/ を PYTHONPATH に追加してインポートします。依存モジュールは同ディレクトリに配置してください。使用シナリオ
$3
`bash
一括デプロイ（最も簡単）
pnpx @infodb/lctl deploy my-function
`$3
bash
段階的デプロイ（制御しやすい）
pnpx @infodb/lctl makezip my-function # ZIPパッケージ作成
pnpx @infodb/lctl export my-function # スクリプト生成
bash deploy-my-function.sh # デプロイ実行
`$3
#### export - デプロイメントスクリプトの出力
bash
pnpx @infodb/lctl export [オプション]
`必須引数:
-
: 設定ファイル名（.yaml拡張子は不要）オプション:
-
--output : 出力ファイルパス（デフォルト: deploy-{config-name}.sh）
- --verbose: 詳細なログを出力例:
`bash
スクリプト出力
pnpx @infodb/lctl export my-function --output deploy-script.sh環境変数を使用してスクリプト出力
ENV_NAME=prod DB_HOST=prod.example.com pnpx @infodb/lctl export my-function
`YAML設定ファイル（必須）
設定ファイルは
ディレクトリに配置し、configs/ 形式で命名します。$3
`yaml
configs/my-function.yaml
関数名設定（オプション）
function_name: ${ENV_NAME}_my_function # 環境変数を使用した動的命名
function_name: my_function # 固定名
未設定の場合、設定ファイル名（my-function）を使用
基本設定
runtime: python3.12
handler: my_function.handler
role: arn:aws:iam::123456789012:role/lambda-execution-role
architecture: x86_64 # x86_64 または arm64
memory: 256
timeout: 30
description: "マイ Lambda 関数"デプロイするファイル（functionsディレクトリ内の相対パス）
files:
- my_function.py
- utils.py
- "lib/*/.py" # glob パターンも使用可能Python依存関係（自動インストール）
requirements:
- requests>=2.28.0
- boto3>=1.26.0
- pandas>=1.5.0環境変数
environment:
DB_HOST: ${DB_HOST}
DB_PORT: ${DB_PORT}
API_KEY: ${API_KEY}
ENV: ${ENV_NAME}権限設定（外部サービスからの呼び出し許可）
permissions:
- service: apigateway
source_arn: "arn:aws:execute-api:us-east-1:123456789012:*"
statement_id: "api-gateway-invoke"
- service: events
source_arn: "arn:aws:events:us-east-1:123456789012:rule/my-rule"
statement_id: "eventbridge-invoke"ログ設定
log_retention_days: 14 # ログ保持期間（日）
auto_create_log_group: true # ロググループ自動作成ZIP除外設定
zip_excludes: # ZIP化時の除外パターン
- ".git"
- "node_modules/*"
- "*.zip"
- "*.pyc"
- "__pycache__/*"タグ
tags:
Environment: ${ENV_NAME}
Team: backend
Project: my-project
`$3
yaml
高度な設定
reserved_concurrency: 100
provisioned_concurrency: 10
ephemeral_storage: 1024 # MB (512-10240)レイヤー
layers:
- arn:aws:lambda:us-east-1:123456789012:layer:my-layer:1
- arn:aws:lambda:us-east-1:580247275435:layer:LambdaInsightsExtension:14VPC設定
vpc:
subnets:
- subnet-12345678
- subnet-87654321
security_groups:
- sg-12345678デッドレターキュー
dead_letter_queue:
target_arn: arn:aws:sqs:us-east-1:123456789012:my-dlq
`$3
外部サービスやIAMユーザー・ロールからLambda関数を呼び出すための権限を自動設定します。
#### サービス別の権限設定
yaml
permissions:
- service: apigateway # API Gateway
source_arn: "arn:aws:execute-api:region:account:api-id/*"
- service: events # EventBridge
source_arn: "arn:aws:events:region:account:rule/rule-name"
- service: sns # SNS
source_arn: "arn:aws:sns:region:account:topic-name"
- service: s3 # S3
source_arn: "arn:aws:s3:::bucket-name"
- service: elasticloadbalancing # ALB
source_arn: "arn:aws:elasticloadbalancing:region:account:targetgroup/name"
`#### IAMユーザー・ロールの直接指定
yaml
permissions:
- principal: "arn:aws:iam::123456789012:user/MyUser"
statement_id: "allow-my-user"
action: "lambda:InvokeFunction"
- principal: "arn:aws:iam::123456789012:role/MyRole"
statement_id: "allow-my-role"
- principal: "123456789012" # AWS Account ID
statement_id: "allow-account"
`#### 混合設定例
yaml
permissions:
# サービス別設定（principalは自動設定）
- service: apigateway
source_arn: "arn:aws:execute-api:region:account:api-id/*"
statement_id: "api-gateway-invoke"
# IAMユーザー直接指定
- principal: "arn:aws:iam::123456789012:user/DeployUser"
statement_id: "deploy-user-invoke"
action: "lambda:InvokeFunction"
# IAMロール直接指定
- principal: "arn:aws:iam::123456789012:role/CrossAccountRole"
statement_id: "cross-account-invoke"
source_arn: "arn:aws:iam::123456789012:role/CrossAccountRole"
`注意:
または principal のどちらか一方を必ず指定してください。両方指定した場合は principal が優先されます。$3
`yaml
環境変数を使用した設定
function_name: ${ENV_NAME}_my_function
role: arn:aws:iam::123456789012:role/lambda-role-${ENV_NAME}
environment:
DB_HOST: ${DB_HOST}
ENV: ${ENV_NAME}
tags:
Environment: ${ENV_NAME}
`実行時に環境変数を設定：
bash
ENV_NAME=prod DB_HOST=prod.example.com pnpx @infodb/lctl deploy my-function
`環境要件
- Node.js 16以上
- AWS CLI v2がインストールされていること
- 適切なAWS認証情報が設定されていること
-
と functions/ ディレクトリが存在することAWS認証情報の設定
以下のいずれかの方法でAWS認証情報を設定してください：
1. AWS CLIによる設定：
`bash
aws configure
`2. 環境変数による設定：
bash
export AWS_ACCESS_KEY_ID=your-access-key
export AWS_SECRET_ACCESS_KEY=your-secret-key
export AWS_DEFAULT_REGION=us-east-1
`3. IAMロールの使用（EC2、Lambda等）
トラブルシューティング
$3
1. AWS CLI not found: AWS CLI v2がインストールされていることを確認
2. 権限エラー: 適切なIAMロールとポリシーが設定されていることを確認
3. YAML設定ファイルが見つからない: が存在することを確認
4. YAML構文エラー: YAML ファイルの構文を確認
5. 環境変数が見つからない: ${VAR_NAME} で参照する環境変数が設定されていることを確認$3
`bash
詳細ログ出力
pnpx @infodb/lctl deploy my-function --verboseスクリプト出力してデバッグ
pnpx @infodb/lctl export my-function --output debug-script.sh
bash debug-script.sh
``