workshop-deployment

name	workshop-deployment
description	Package code and assets, sync to S3, and push content to AWS Workshop Studio. Use when deploying workshop changes or when asked to update the workshop.
metadata	{"author":"agentic-analytics-team","version":"1.0"}

Workshop Deployment

Prerequisites

Install git-remote-workshopstudio plugin (one-time)

pipx install --index-url https://plugin.us-east-1.prod.workshops.aws git-remote-workshopstudio==0.2.0 --pip-args="--extra-index-url https://pypi.org/simple"

Clone WS repo (one-time, one level up from GitLab repo)

cd /Users/diponego/Projects/agentic-analytics
git clone workshopstudio://ws-content-173b87a9-7267-4478-b7ec-0cd16a7cb520/run-llama-on-aws ws2

Steps

1. Get Workshop Studio Credentials

Go to Workshop Studio → your workshop → Repository credentials → Assets access instructions. Save to /tmp/ws-creds.sh:

cat > /tmp/ws-creds.sh << 'EOF'
export WS_REPO_SOURCE="s3"
export AWS_DEFAULT_REGION="us-east-1"
export AWS_ACCESS_KEY_ID="..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_SESSION_TOKEN="..."
EOF

Credentials expire — refresh if you get auth errors.

2. Package

cd infrastructure/scripts
bash package_for_workshop.sh

Creates workshop/assets/ (Lambda ZIPs, templates, data, repo ZIP with overlay) and workshop/static/main-stack.yaml.

3. Sync assets to S3

source /tmp/ws-creds.sh
cd ../../workshop
aws s3 sync ./assets s3://ws-assets-us-east-1/173b87a9-7267-4478-b7ec-0cd16a7cb520 --delete

4. Check for others' pushes

source /tmp/ws-creds.sh
cd ../../ws2
git fetch origin
git log --oneline origin/mainline -5

If someone pushed after your last sync, pull first or merge carefully.

5. Push content to WS repo

source /tmp/ws-creds.sh
cd ../../ws2
cp ../gitlab/agentic-analytics/workshop/contentspec.yaml .
cp ../gitlab/agentic-analytics/workshop/static/main-stack.yaml static/
rm -rf content && cp -r ../gitlab/agentic-analytics/workshop/content .
cp -r ../gitlab/agentic-analytics/workshop/static/images static/ 2>/dev/null
git add -A
git commit -m "Update workshop"
git push

Use --force only if you're sure your version supersedes the remote.

Important Notes

• S3 assets only affect NEW deployments. Existing sandboxes keep old code until participants git pull from GitLab.
• The repo ZIP includes the workshop overlay (workshop/code/ applied on top).
• contentspec.yaml defines CFN deployment with DeployMode=workshop and magic variables for S3 bucket/prefix.
• main-stack.yaml goes to workshop/static/ (WS repo). Child templates go to S3 templates/.