배포 스킬
포트폴리오 채팅 에이전트 Lambda 함수를 재구축하여 AWS에 배포합니다.
사용 시점
WebContent/context/디렉토리의 파일을 업데이트한 후lambda/lambda_function.py를 수정한 후- 사용자가 "deploy", "redeploy", "push to Lambda", "update the chat agent"라고 말할 때
워크플로우
- 지식 베이스 재구축 — 컨텍스트 파일에서
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 구성