デプロイスキル
ポートフォリオチャットエージェントLambda関数を再構築し、AWSにデプロイします。
使用タイミング
WebContent/context/内のファイルを更新した後lambda/lambda_function.pyを変更した後- ユーザーが「デプロイ」「再デプロイ」「Lambdaにプッシュ」「チャットエージェントを更新」と言ったとき
ワークフロー
- ナレッジベースを再構築 — コンテキストファイルから
lambda/knowledge_base.jsonを再生成します - 以前のビルドをクリーンアップ — 古い
package/ディレクトリとdeployment.zipを削除します - 依存関係をインストール — Linux/x86_64ターゲット用のPythonパッケージをインストールします
- パッケージ化 — ハンドラとナレッジベースをパッケージにコピーし、zipを作成します
- デプロイ — AWS CLIを介してLambda関数コードを更新します
- 確認 — デプロイの成功を確認します
コマンド
ステップ 1: ナレッジベースの再構築
python scripts/build_knowledge_base.py
出力に期待されるプロジェクト数が表示され、エラーがないことを確認します。
ステップ 2: クリーンアップと依存関係のインストール
cd lambda
rm -rf package/ deployment.zip
pip install -r requirements.txt -t package/ \
--platform manylinux2014_x86_64 \
--only-binary=:all: \
--implementation cp \
--python-version 3.12
--platform フラグと --only-binary フラグにより、コンパイル済み拡張がmacOSではなくAmazon Linux用にビルドされるようにします。
ステップ 3: デプロイメントZIPのパッケージ化
cp lambda_function.py knowledge_base.json package/
cd package && zip -r ../deployment.zip . && cd ..
ステップ 4: Lambdaへのデプロイ
aws lambda update-function-code \
--function-name portfolio-chat-agent \
--zip-file fileb://lambda/deployment.zip
リポジトリルートから実行して、fileb:// パスが正しく解決されるようにします。
ステップ 5: 確認
レスポンスに以下が含まれていることを確認します。
"LastUpdateStatus": "InProgress"または"Successful""FunctionName": "portfolio-chat-agent"- 更新された
CodeSha256の値
設定
| 設定項目 | 値 |
|---|---|
| 関数名 | portfolio-chat-agent |
| ランタイム | python3.12 |
| リージョン | us-west-1 |
| メモリ | 256 MB |
| タイムアウト | 30 秒 |
| アーキテクチャ | x86_64 |
ルール
- Anthropic APIキーを絶対に出力またはログに記録しないでください。 AWS CLIのレスポンスに環境変数が含まれている場合、ユーザーにそれらをエコーバックしないでください。
- 常に最初にナレッジベースを再構築してください。
lambda_function.pyのみが変更された場合でも、再構築によりナレッジベースが最新であることが保証されます。 - リポジトリルートから実行してください。 デプロイコマンドの
fileb://パスはワーキングディレクトリからの相対パスです。 - ユーザーが明示的にAPIキーの更新を要求した場合を除き、Lambdaの環境変数を変更しないでください。
トラブルシューティング
| 問題 | 解決策 |
|---|---|
No module named 'pydantic_core._pydantic_core' | pip install 時に --platform フラグが不足している — 依存関係がLinuxではなくmacOS用にビルドされています |
Unable to load paramfile fileb:// | ワーキングディレクトリが間違っている — リポジトリルートからデプロイコマンドを実行してください |
ResourceNotFoundException | Lambda関数がまだ存在しない — aws lambda create-function を使用してください(docs/plans/chat-agent/aws-setup.md ステップ7参照) |
CodeStorageExceededException | デプロイメントZIPが大きすぎる — requirements.txt 内の不要な依存関係を確認してください |
参考ドキュメント
- aws-setup.md — AWSアカウントの完全なセットアップ、IAMロール、初期Lambda作成、およびFunction URLの設定