Deploy Pipeline

Safe deployment workflow for VPS bot code. Never edit production code via SSH sed/echo.

The Rule

Edit locally -> validate -> SCP -> backup -> restart -> verify -> (rollback if needed)

Workflow

1. Edit Locally

Make all changes in your local workspace. Use your editor, not SSH.

2. Validate Locally

python3 -m py_compile bot.py          # syntax check
python3 -c "import ast; ast.parse(open('bot.py').read())"  # parse check
grep -n "f'" bot.py | head -20        # spot-check f-strings

3. Backup Current VPS Version

# Read SSH details from TOOLS.md first
ssh $VPS_HOST "cp -r $BOT_DIR ${BOT_DIR}.bak.$(date +%Y%m%d-%H%M)"

4. Deploy via SCP

scp bot.py $VPS_HOST:$BOT_DIR/bot.py
# For multiple files:
scp -r ./bot-src/ $VPS_HOST:$BOT_DIR/

5. Restart & Verify

ssh $VPS_HOST "cd $BOT_DIR && pkill -f bot.py; sleep 2; nohup python3 bot.py > bot.log 2>&1 &"
sleep 3
ssh $VPS_HOST "pgrep -f bot.py && tail -5 $BOT_DIR/bot.log"

Check for:

• PID exists (exactly 1 process)
• No tracebacks in last 5 log lines
• Bot is making API calls (check log for recent activity)

6. Rollback (if something's wrong)

ssh $VPS_HOST "pkill -f bot.py; cp -r ${BOT_DIR}.bak.XXXXXX/* $BOT_DIR/"
ssh $VPS_HOST "cd $BOT_DIR && nohup python3 bot.py > bot.log 2>&1 &"

Pre-Deploy Checklist

• Code edited locally (NOT via SSH)
• Syntax check passes
• Backup taken on VPS
• SCP transfer complete
• Bot restarted
• Exactly 1 PID confirmed (pgrep -c -f bot.py = 1)
• Logs clean (no tracebacks)
• Bot actively trading (check within 5 min)

Common Gotchas

After Deploy

Update today's daily note in ~/obsidian-vault/memory/YYYY-MM-DD.md with:

• What was deployed
• Result (pass/fail)
• Any issues encountered
• Next steps