mirror of
https://github.com/awslabs/amazon-bedrock-agentcore-samples.git
synced 2025-09-08 20:50:46 +00:00
* feat: Add AWS Operations Agent with AgentCore Runtime - Complete rewrite of AWS Operations Agent using Amazon Bedrock AgentCore - Added comprehensive deployment scripts for DIY and SDK runtime modes - Implemented OAuth2/PKCE authentication with Okta integration - Added MCP (Model Context Protocol) tool support for AWS service operations - Sanitized all sensitive information (account IDs, domains, client IDs) with placeholders - Added support for 17 AWS services: EC2, S3, Lambda, CloudFormation, IAM, RDS, CloudWatch, Cost Explorer, ECS, EKS, SNS, SQS, DynamoDB, Route53, API Gateway, SES, Bedrock, SageMaker - Includes chatbot client, gateway management scripts, and comprehensive testing - Ready for public GitHub with security-cleared configuration files Security: All sensitive values replaced with <YOUR_AWS_ACCOUNT_ID>, <YOUR_OKTA_DOMAIN>, <YOUR_OKTA_CLIENT_ID> placeholders * Update AWS Operations Agent architecture diagram --------- Co-authored-by: name <alias@amazon.com>
236 lines
8.3 KiB
Bash
Executable File
236 lines
8.3 KiB
Bash
Executable File
#!/bin/bash
|
|
|
|
# Deploy MCP Tool Lambda function using SAM
|
|
echo "🚀 Deploying MCP Tool Lambda function..."
|
|
|
|
# Configuration - Get project directory
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
PROJECT_DIR="$(dirname "$(dirname "$SCRIPT_DIR")")" # Go up two levels to reach AgentCore root
|
|
RUNTIME_DIR="$(dirname "$SCRIPT_DIR")" # agentcore-runtime directory
|
|
MCP_TOOL_DIR="${PROJECT_DIR}/mcp-tool-lambda"
|
|
|
|
# Load configuration from consolidated config files
|
|
CONFIG_DIR="${PROJECT_DIR}/config"
|
|
|
|
# Check if static config exists
|
|
if [[ ! -f "${CONFIG_DIR}/static-config.yaml" ]]; then
|
|
echo "❌ Config file not found: ${CONFIG_DIR}/static-config.yaml"
|
|
exit 1
|
|
fi
|
|
|
|
# Extract values from YAML (fallback method if yq not available)
|
|
get_yaml_value() {
|
|
local key="$1"
|
|
local file="$2"
|
|
# Handle nested YAML keys with proper indentation
|
|
grep " $key:" "$file" | head -1 | sed 's/.*: *["'\'']*\([^"'\'']*\)["'\'']*$/\1/' | xargs
|
|
}
|
|
|
|
REGION=$(get_yaml_value "region" "${CONFIG_DIR}/static-config.yaml")
|
|
ACCOUNT_ID=$(get_yaml_value "account_id" "${CONFIG_DIR}/static-config.yaml")
|
|
|
|
if [[ -z "$REGION" || -z "$ACCOUNT_ID" ]]; then
|
|
echo "❌ Failed to read region or account_id from static-config.yaml"
|
|
exit 1
|
|
fi
|
|
|
|
STACK_NAME="bac-mcp-stack"
|
|
|
|
echo "📝 Configuration:"
|
|
echo " Region: $REGION"
|
|
echo " Account ID: $ACCOUNT_ID"
|
|
echo " Stack Name: $STACK_NAME"
|
|
echo ""
|
|
|
|
# Get AWS credentials from SSO
|
|
echo "🔐 Getting AWS credentials..."
|
|
if [ -n "$AWS_PROFILE" ]; then
|
|
echo "Using AWS profile: $AWS_PROFILE"
|
|
else
|
|
echo "Using default AWS credentials"
|
|
fi
|
|
|
|
# Use configured AWS profile if specified in static config
|
|
AWS_PROFILE_CONFIG=$(grep "aws_profile:" "${CONFIG_DIR}/static-config.yaml" | head -1 | sed 's/.*aws_profile: *["'\'']*\([^"'\''#]*\)["'\'']*.*$/\1/' | xargs 2>/dev/null)
|
|
if [[ -n "$AWS_PROFILE_CONFIG" && "$AWS_PROFILE_CONFIG" != "\"\"" && "$AWS_PROFILE_CONFIG" != "''" ]]; then
|
|
echo "Using configured AWS profile: $AWS_PROFILE_CONFIG"
|
|
export AWS_PROFILE="$AWS_PROFILE_CONFIG"
|
|
fi
|
|
|
|
# Check if SAM is installed
|
|
if ! command -v sam &> /dev/null; then
|
|
echo "❌ SAM CLI is not installed. Please install SAM CLI:"
|
|
echo " https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/install-sam-cli.html"
|
|
exit 1
|
|
fi
|
|
|
|
echo "✅ SAM CLI found: $(sam --version)"
|
|
|
|
# Check if Docker is available
|
|
if ! command -v docker &> /dev/null; then
|
|
echo "❌ Docker is not installed. SAM requires Docker for building container images."
|
|
echo " Please install Docker: https://docs.docker.com/get-docker/"
|
|
exit 1
|
|
fi
|
|
|
|
# Check if Docker daemon is running
|
|
if ! docker info &> /dev/null; then
|
|
echo "❌ Docker daemon is not running. Please start Docker."
|
|
exit 1
|
|
fi
|
|
|
|
# Warning about nested virtualization
|
|
echo "⚠️ IMPORTANT: This script uses Docker and SAM which require nested virtualization."
|
|
echo " If you're running this in a virtual machine, it may fail due to nested virtualization limitations."
|
|
echo " Consider running this script on a physical machine or cloud instance with nested virtualization enabled."
|
|
echo ""
|
|
|
|
# Change to MCP tool directory
|
|
cd "${MCP_TOOL_DIR}"
|
|
|
|
# Check if template exists
|
|
if [[ ! -f "mcp-tool-template.yaml" ]]; then
|
|
echo "❌ SAM template not found: mcp-tool-template.yaml"
|
|
exit 1
|
|
fi
|
|
|
|
echo "✅ SAM template found: mcp-tool-template.yaml"
|
|
|
|
# Build the SAM application
|
|
echo "🔨 Building SAM application..."
|
|
if ! sam build --template-file mcp-tool-template.yaml; then
|
|
echo "❌ SAM build failed"
|
|
exit 1
|
|
fi
|
|
|
|
echo "✅ SAM build completed"
|
|
|
|
# Deploy the SAM application
|
|
echo "📤 Deploying SAM application..."
|
|
if sam deploy \
|
|
--template-file mcp-tool-template.yaml \
|
|
--stack-name "$STACK_NAME" \
|
|
--region "$REGION" \
|
|
--parameter-overrides "Environment=prod" \
|
|
--capabilities CAPABILITY_IAM CAPABILITY_NAMED_IAM \
|
|
--resolve-s3 \
|
|
--resolve-image-repos \
|
|
--no-fail-on-empty-changeset; then
|
|
echo "✅ SAM deployment completed"
|
|
else
|
|
echo "❌ SAM deployment failed"
|
|
exit 1
|
|
fi
|
|
|
|
# Get Lambda function ARN from CloudFormation stack outputs
|
|
echo "📋 Retrieving Lambda function details..."
|
|
FUNCTION_ARN=$(aws cloudformation describe-stacks \
|
|
--stack-name "$STACK_NAME" \
|
|
--region "$REGION" \
|
|
--query "Stacks[0].Outputs[?OutputKey=='MCPToolFunctionArn'].OutputValue" \
|
|
--output text)
|
|
|
|
FUNCTION_NAME=$(aws cloudformation describe-stacks \
|
|
--stack-name "$STACK_NAME" \
|
|
--region "$REGION" \
|
|
--query "Stacks[0].Outputs[?OutputKey=='MCPToolFunctionName'].OutputValue" \
|
|
--output text)
|
|
|
|
FUNCTION_ROLE_ARN=$(aws cloudformation describe-stacks \
|
|
--stack-name "$STACK_NAME" \
|
|
--region "$REGION" \
|
|
--query "Stacks[0].Outputs[?OutputKey=='MCPToolFunctionRoleArn'].OutputValue" \
|
|
--output text)
|
|
|
|
GATEWAY_EXECUTION_ROLE_ARN=$(aws cloudformation describe-stacks \
|
|
--stack-name "$STACK_NAME" \
|
|
--region "$REGION" \
|
|
--query "Stacks[0].Outputs[?OutputKey=='BedrockAgentCoreGatewayExecutionRoleArn'].OutputValue" \
|
|
--output text)
|
|
|
|
if [[ -z "$FUNCTION_ARN" || "$FUNCTION_ARN" == "None" ]]; then
|
|
echo "❌ Failed to retrieve Lambda function ARN from CloudFormation stack"
|
|
exit 1
|
|
fi
|
|
|
|
if [[ -z "$GATEWAY_EXECUTION_ROLE_ARN" || "$GATEWAY_EXECUTION_ROLE_ARN" == "None" ]]; then
|
|
echo "❌ Failed to retrieve Gateway Execution Role ARN from CloudFormation stack"
|
|
exit 1
|
|
fi
|
|
|
|
# Update dynamic configuration file with Lambda details
|
|
echo "📝 Updating dynamic configuration with Lambda details..."
|
|
|
|
# Update the mcp_lambda section in the dynamic configuration
|
|
DYNAMIC_CONFIG="${CONFIG_DIR}/dynamic-config.yaml"
|
|
|
|
# Check if dynamic config exists
|
|
if [[ ! -f "$DYNAMIC_CONFIG" ]]; then
|
|
echo "❌ Dynamic config file not found: $DYNAMIC_CONFIG"
|
|
exit 1
|
|
fi
|
|
|
|
# Build ECR URI from configuration values
|
|
ECR_REPOSITORY=$(get_yaml_value "ecr_repository_name" "${CONFIG_DIR}/static-config.yaml")
|
|
ECR_REPOSITORY=${ECR_REPOSITORY:-"bac-mcp-tool-repo"}
|
|
ECR_URI="${ACCOUNT_ID}.dkr.ecr.${REGION}.amazonaws.com/${ECR_REPOSITORY}"
|
|
|
|
# Use sed to update the mcp_lambda section (using | as delimiter to handle ARNs with /)
|
|
echo " 📝 Updating mcp_lambda section in dynamic-config.yaml..."
|
|
|
|
sed -i '' \
|
|
-e "s|function_name: \"\"|function_name: \"$FUNCTION_NAME\"|" \
|
|
-e "s|function_arn: \"\"|function_arn: \"$FUNCTION_ARN\"|" \
|
|
-e "s|role_arn: \"\"|role_arn: \"$FUNCTION_ROLE_ARN\"|" \
|
|
-e "s|stack_name: \"\"|stack_name: \"$STACK_NAME\"|" \
|
|
-e "s|gateway_execution_role_arn: \"\"|gateway_execution_role_arn: \"$GATEWAY_EXECUTION_ROLE_ARN\"|" \
|
|
-e "s|ecr_uri: \"\"|ecr_uri: \"${ECR_URI}:latest\"|" \
|
|
"$DYNAMIC_CONFIG"
|
|
|
|
echo "✅ Configuration updated with Lambda details"
|
|
|
|
# Test the Lambda function
|
|
echo "🧪 Testing Lambda function..."
|
|
TEST_PAYLOAD='{"name": "AgentCore"}'
|
|
|
|
if aws lambda invoke \
|
|
--function-name "$FUNCTION_NAME" \
|
|
--region "$REGION" \
|
|
--payload "$TEST_PAYLOAD" \
|
|
--cli-binary-format raw-in-base64-out \
|
|
/tmp/lambda-test-response.json > /dev/null; then
|
|
|
|
echo "✅ Lambda function test successful"
|
|
echo " Response: $(cat /tmp/lambda-test-response.json)"
|
|
rm -f /tmp/lambda-test-response.json
|
|
else
|
|
echo "⚠️ Lambda function test failed (this might be expected if tool name extraction fails)"
|
|
fi
|
|
|
|
echo ""
|
|
echo "🎉 MCP Tool Lambda Deployment Complete!"
|
|
echo "======================================"
|
|
echo "✅ Lambda function deployed and configured"
|
|
echo ""
|
|
echo "📋 Deployment Details:"
|
|
echo " • Function Name: $FUNCTION_NAME"
|
|
echo " • Function ARN: $FUNCTION_ARN"
|
|
echo " • Lambda Function Role ARN: $FUNCTION_ROLE_ARN"
|
|
echo " • Gateway Execution Role ARN: $GATEWAY_EXECUTION_ROLE_ARN"
|
|
echo " • Stack Name: $STACK_NAME"
|
|
echo " • Region: $REGION"
|
|
echo ""
|
|
echo "📋 What was deployed:"
|
|
echo " • Lambda function with MCP tool handlers"
|
|
echo " • IAM role with Bedrock and AWS service permissions"
|
|
echo " • CloudWatch log group for function logs"
|
|
echo " • SAM-managed deployment infrastructure"
|
|
echo ""
|
|
echo "🚀 Next Steps:"
|
|
echo " Run ./04-create-gateway-targets.sh to create AgentCore Gateway and targets"
|
|
echo " The Lambda function is ready to handle MCP tool calls"
|
|
echo ""
|
|
echo "💡 Function Capabilities:"
|
|
echo " • Basic tools: hello_world, get_time"
|
|
echo " • AWS service tools: EC2, S3, Lambda, RDS, and 16 more services"
|
|
echo " • Natural language query processing via Strands Agent" |