adobe-to-docusign-migrator/docs/oracle-vm-deploy-cheat-shee...

2.9 KiB
Raw Blame History

Oracle VM Deploy Cheat Sheet — Adobe Sign → DocuSign Migrator

Last updated: 2026-04-21

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

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
  • Dont overwrite .env, .env-adobe, or private.key casually
  • If the site breaks, check journalctl -u adobe-migrator