단계 3: Targets 생성

가상 환경 확인: 터미널에서 (.venv) 프롬프트가 보이는지 확인하세요. 보이지 않으면 다음을 실행하세요:

cd /workspace/workshop-module-1/agentcore-reference && source .venv/bin/activate

Targets 개요

AgentCore Gateway에 연결할 세 가지 Lambda 함수를 배포합니다:

타겟	설명	Lambda 함수
DNSResolutionTool	DNS 호스트명을 IP 주소 또는 인스턴스 ID로 확인	dns-resolve-tool
ConnectivityTool	VPC Reachability Analyzer를 사용하여 네트워크 문제 식별	connectivity-tool
CloudWatchTool	CloudWatch 로그 및 메트릭 검색	cloudwatch-tools

배포

각 Lambda 함수를 순서대로 배포합니다:

DNSResolutionTool 배포

cd prerequisite/lambda-dns
chmod +x deploy-dns-tool.sh && ./deploy-dns-tool.sh

🔍 이 스크립트는 무엇을 하나요?

1. Docker 이미지 빌드 (x86_64) → ECR 푸시

2. Lambda 실행 역할 생성 (Route 53 + EC2 권한)

3. Lambda 함수 dns-resolve-tool 생성 (512MB, 5분 타임아웃)

4. SSM에 Lambda ARN 저장 (/app/troubleshooting/agentcore/dns_lambda_arn)

ConnectivityTool 배포

cd .. && cd lambda-connectivity
chmod +x deploy-connectivity-tool.sh && ./deploy-connectivity-tool.sh

🔍 이 스크립트는 무엇을 하나요?

1. Docker 이미지 빌드 → ECR 푸시

2. Lambda 실행 역할 생성 (VPC Reachability Analyzer + 보안그룹 수정 권한)

3. Lambda 함수 connectivity-tool 생성 (3GB 메모리, 15분 타임아웃)

4. SSM에 Lambda ARN 저장 (/app/troubleshooting/agentcore/connectivity_lambda_arn)

CloudWatchTool 배포

cd .. && cd lambda-cloudwatch
chmod +x deploy-cloudwatch-tool.sh && ./deploy-cloudwatch-tool.sh

🔍 이 스크립트는 무엇을 하나요?

1. Docker 이미지 빌드 → ECR 푸시

2. Lambda 실행 역할 생성 (CloudWatch Alarms/Logs/Metrics + EC2/RDS 읽기 권한)

3. Lambda 함수 cloudwatch-tools 생성 (1GB 메모리, 5분 타임아웃)

4. SSM에 Lambda ARN 저장 (/app/troubleshooting/agentcore/cloudwatch_lambda_arn)

검증

모든 Lambda 함수가 정상적으로 배포되었는지 확인합니다:

printf "=== Lambda Functions Status ===\n" && \
aws lambda get-function --function-name dns-resolve-tool \
  --query '{Function:Configuration.FunctionName,State:Configuration.State,Runtime:Configuration.Runtime}' && \
aws lambda get-function --function-name connectivity-tool \
  --query '{Function:Configuration.FunctionName,State:Configuration.State,Runtime:Configuration.Runtime}' && \
aws lambda get-function --function-name cloudwatch-tools \
  --query '{Function:Configuration.FunctionName,State:Configuration.State,Runtime:Configuration.Runtime}'

세 Lambda 함수 모두 State: Active로 표시되어야 합니다.

Verification

선택 사항: AWS 콘솔 기반 검증

이 단계가 완료되었습니다. Next를 클릭하여 진행하세요.

코드 분석: Lambda 함수 핵심 로직

dns-resolve Lambda (526줄)

• Route53 Private Hosted Zone에서 DNS 이름 해석

• CNAME 체인 추적 지원 (resolve_dns_from_route53)

• IP → EC2/ENI/RDS 리소스 매핑 (find_aws_resources_by_ip)

Key code snippet (simplified):

def resolve_dns_from_route53(hostname, region="us-east-1"):
    """Route 53 Private Hosted Zone에서 DNS 이름 해석"""
    route53 = boto3.client('route53')
    # Private Hosted Zone에서 레코드 조회
    # CNAME 체인이 있으면 재귀적으로 추적
    # 최종 IP 주소 반환

def find_aws_resources_by_ip(ip_address, region="us-east-1"):
    """IP 주소로 EC2 인스턴스, ENI, RDS 인스턴스 검색"""
    ec2 = boto3.client('ec2')
    # describe_instances로 private IP 매칭
    # describe_network_interfaces로 ENI 검색

connectivity Lambda (828줄)

• VPC Reachability Analyzer를 사용한 네트워크 경로 분석

• 보안 그룹 규칙 자동 수정 (최소 권한 원칙)

• action="check"와 action="fix" 두 가지 모드

Key code snippet:

def run_vpc_reachability_analysis(source, destination, protocol, port):
    """VPC Reachability Analyzer로 네트워크 경로 분석"""
    ec2 = boto3.client('ec2')
    # create_network_insights_path → 분석 경로 생성
    # start_network_insights_analysis → 분석 실행
    # 결과에서 차단 지점 식별 (예: ENI_SG_RULES_MISMATCH)

def apply_connectivity_fix(source, destination, protocol, port):
    """최소 권한 보안 그룹 규칙 적용"""
    # 필요한 인바운드 규칙만 추가
    # 소스 보안 그룹 참조 방식으로 최소 권한 유지

cloudwatch-monitoring Lambda (741줄)

• CloudWatch 알람, 메트릭, 로그 통합 모니터링

• VPC Flow Logs 쿼리 (호스트명 → ENI-ID 변환)

• 7가지 operation 지원: describe_alarms, get_metric_data, query_logs, list_log_groups, get_log_events, create_alarm, delete_alarm

코드 구조 패턴: 세 Lambda 함수 모두 동일한 패턴을 따릅니다 — lambda_handler가 extract_tool_name()으로 도구명을 추출하고, 해당 핸들러 함수로 라우팅합니다. 이 패턴은 AgentCore Gateway의 MCP 프로토콜과 호환됩니다.