3.2 KiB

Raw Permalink Blame History

Oracle VM Deploy Cheat Sheet — Adobe Sign → DocuSign Migrator

Last updated: 2026-04-21 (post-deploy note added)

This is the short version of the deployment process. Use this when you already know what you are doing and just need the commands.

Local project path

cd /home/paulh/.openclaw/workspace/projects/adobe-to-docusign-migrator

1. Check what changed

git status
git branch --show-current

2. Run tests

Full suite:

pytest tests/ -v

Quick smoke test:

pytest tests/test_api_health.py -v
pytest tests/test_api_auth.py -v
pytest tests/test_api_templates.py -v
pytest tests/test_api_migrate.py -v

3. Commit and push

git add .
git commit -m "Describe the change"
git push origin <branch-name>

If deploying master:

git push origin master

4. SSH to Oracle VM

Using IP:

ssh ubuntu@<VM_PUBLIC_IP>

Using hostname:

ssh ubuntu@dstemplate.mooo.com

If SSH fails on a new machine with host key verification issues:

ssh-keyscan -H dstemplate.mooo.com >> ~/.ssh/known_hosts
ssh ubuntu@dstemplate.mooo.com

5. Pull latest code on VM

cd /home/ubuntu/projects/adobe-to-docusign-migrator
git branch --show-current
git status

Deploy master:

git checkout master
git pull origin master

Deploy a feature branch intentionally:

git checkout <branch-name>
git pull origin <branch-name>

6. Update dependencies

cd /home/ubuntu/projects/adobe-to-docusign-migrator
source venv/bin/activate
pip install -r requirements.txt

7. Restart app

sudo systemctl restart adobe-migrator
sudo systemctl status adobe-migrator --no-pager

8. Smoke test on VM

App health:

curl http://127.0.0.1:8000/health

HTML through nginx:

curl http://127.0.0.1/

9. Check logs if broken

journalctl -u adobe-migrator -n 100 --no-pager
journalctl -u adobe-migrator -f

Check nginx:

sudo nginx -t
sudo systemctl reload nginx

10. Important paths

Local project:

/home/paulh/.openclaw/workspace/projects/adobe-to-docusign-migrator

VM project:

/home/ubuntu/projects/adobe-to-docusign-migrator

Service file:

/etc/systemd/system/adobe-migrator.service

Nginx site:

/etc/nginx/sites-available/dstemplate
/etc/nginx/sites-enabled/dstemplate

Public URL:

http://dstemplate.mooo.com

One-block deploy command set

If code is already pushed and you are deploying master:

ssh ubuntu@dstemplate.mooo.com '
  cd /home/ubuntu/projects/adobe-to-docusign-migrator &&
  git checkout master &&
  git pull origin master &&
  source venv/bin/activate &&
  pip install -r requirements.txt &&
  sudo systemctl restart adobe-migrator &&
  sudo systemctl status adobe-migrator --no-pager &&
  curl -s http://127.0.0.1:8000/health
'

Safety reminders

Know which branch you are deploying
Run tests first
Commit before deploy
Don’t overwrite .env, .env-adobe, or private.key casually
Don’t casually delete .session-store/ while testers are active
If the site breaks, check journalctl -u adobe-migrator

3.2 KiB Raw Permalink Blame History Unescape Escape