Skip to content

scripts

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

scripts

README.md

Deployment and Test Scripts

This directory contains scripts for deploying and testing the Fullstack AgentCore Solution Template infrastructure and frontend.

Main Deployment Workflow

1. Deploy Infrastructure

cd infra-cdk
cdk deploy

This deploys the CDK stack. Configuration generation is handled during frontend deployment.

2. Deploy Frontend

# From root directory
python scripts/deploy-frontend.py

This script automatically:

  • Generates fresh aws-exports.json from CDK stack outputs
  • Installs/updates npm dependencies if needed
  • Builds the frontend
  • Deploys to AWS Amplify Hosting

Individual Scripts

Frontend Deployment

  • deploy-frontend.py - Cross-platform frontend deployment script (works on Windows, Mac, Linux). Uses only Python standard library and AWS CLI. Handles dependency management and config generation.

The script creates frontend/public/aws-exports.json with the following structure. This information is read by the React application to configure Cognito Authentication. If any of this is incorrect, Cognito will not work. It's generated automatically from the scripts, and you should not need to change anything:

{
  "authority": "https://cognito-idp.region.amazonaws.com/user-pool-id",
  "client_id": "your-client-id",
  "redirect_uri": "https://your-amplify-url",
  "post_logout_redirect_uri": "https://your-amplify-url",
  "response_type": "code",
  "scope": "email openid profile",
  "automaticSilentRenew": true
}

Requirements

  • AWS CLI configured with appropriate permissions
  • Python 3.11+ (standard library only, no pip install needed for deployment)
  • Node.js and npm (for frontend build)
  • CDK stack deployed with the required outputs:
    • CognitoClientId
    • CognitoUserPoolId
    • AmplifyUrl

Key Features

  • Cross-Platform: Works on Windows, Mac, and Linux
  • No Python Dependencies: Uses only standard library (no virtual environment needed)
  • Automatic Region Detection: Extracts region directly from CloudFormation stack ARN
  • Smart Dependency Management: Automatically installs npm dependencies when needed
  • Fresh Config: Always generates up-to-date configuration from current stack outputs

New User Experience

For brand new installations, simply run:

cd infra-cdk
cdk deploy
cd ..
python scripts/deploy-frontend.py

The frontend deployment script will automatically handle:

  1. Installing npm dependencies (if node_modules doesn't exist)
  2. Generating fresh aws-exports.json from your deployed stack
  3. Building and deploying the frontend

Test Scripts

Utility scripts for deployment verification and operational tasks.

Setup

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create virtual environment
uv venv

# Install dependencies
uv pip install -r requirements.txt

Available Scripts

test-agent.py

Interactive chat interface for testing agent invocations with conversation continuity. Automatically detects the agent pattern from infra-cdk/config.yaml.

Modes:

  • Remote (default): Test deployed agent via Cognito authentication
  • Local (--local): Test agent running on localhost:8080

Usage:

# Remote mode (prompts for credentials, tests deployed agent)
uv run scripts/test-agent.py

# Local mode (auto-starts agent if not running, uses pattern from config.yaml)
uv run scripts/test-agent.py --local

# Override pattern for local testing
uv run scripts/test-agent.py --local --pattern strands-single-agent

Supported Patterns:

  • strands-single-agent - Basic Strands agent
  • langgraph-single-agent - LangGraph agent with streaming

Prerequisites:

  • Remote: Deployed stack with Cognito user
  • Local: Memory ID from deployed stack

test-memory.py

Tests AgentCore Memory operations (create, list, get events and pagination).

Usage:

# Auto-discover memory from stack
uv run python scripts/test-memory.py

# Use specific memory ARN
uv run python scripts/test-memory.py --memory-arn <arn>

Tests:

  1. Create conversation events
  2. List events with pagination
  3. Get specific events by ID
  4. Session ID validation
  5. Error handling

test-feedback-api.py

Tests the deployed Feedback API endpoint with Cognito authentication.

Prerequisites:

Usage:

uv run python scripts/test-feedback-api.py

What it does:

  1. Fetches configuration from SSM Parameter Store
  2. Authenticates with Cognito (prompts for credentials)
  3. Runs API tests (positive/negative feedback, validation)
  4. Displays test results

Shared Utilities

utils.py provides common functions for test scripts:

  • Stack configuration and SSM parameter retrieval
  • Cognito authentication
  • AWS client creation
  • Session ID generation

Troubleshooting

  • Authentication fails: Verify Cognito user exists and credentials are correct
  • Stack not found: Ensure stack is deployed and config.yaml has correct stack_name_base
  • Local agent fails: Check Memory ID and AWS credentials are configured
  • Port 8080 in use: Stop other services or use remote mode