kjh2064
b34b0dd7d6
2.7 KiB
OMS·WMS·ERP Production Deployment Guide
Overview
OMS·WMS·ERP uses Gitea Actions CI/CD for production deployments.
Critical Rule: ALL production deployments MUST go through Gitea Actions CI/CD. Manual deployments are FORBIDDEN.
Deployment Workflow
Stage 1: Prepare Release (prepare-release.yml)
Trigger: Manual via Gitea Actions
- Go to: https://gitea.taxbaik.com/kjh2064/oms-wms-erp/actions
- Select workflow: prepare-release.yml
- Click "Run workflow"
- Input version: 1.0.0
- Confirm
What it does:
- npm run build → dist/ (173KB)
- Create git tag (v1.0.0)
- Create Gitea Release
- Upload artifact (oms-wms-erp-v1.0.0.tar.gz)
Result: Release ready at https://gitea.taxbaik.com/kjh2064/oms-wms-erp/releases/tag/v1.0.0
Stage 2: Deploy Release (deploy-prod.yml)
Trigger: Manual via Gitea Actions (after prepare-release.yml completes)
- Same Actions page
- Select workflow: deploy-prod.yml
- Click "Run workflow"
- Input release: 1.0.0 (or leave empty for latest)
- Confirm
What it does:
- Download artifact from Gitea Release
- SSH upload to 178.104.200.7:/home/kjh2064/deployments/
- Extract to deployment directory
- npm install --legacy-peer-deps --production
- Update symlink: ~/oms-wms-erp_active
- Restart: sudo systemctl restart oms-wms-erp.service
- Health checks (6-point verification)
- Automatic rollback on failure
Result: Deployment complete or rolled back with clear status message
Pre-Deployment Checklist
BEFORE pushing to main:
✅ npm run build (0 errors) ✅ npm run test:unit (all pass) ✅ npm run test:e2e (all pass) ✅ npm run lint (0 warnings) ✅ npm run preview (works locally) ✅ git status (clean)
Required Secrets
Configure in Gitea: Settings → Secrets
- GITEA_TOKEN: Personal access token
- DEPLOY_SSH_KEY: SSH private key (PEM or base64)
- DEPLOY_HOST: 178.104.200.7
- DEPLOY_USER: kjh2064
Post-Deployment Verification
SSH into server: ssh kjh2064@178.104.200.7
Check status: sudo systemctl status oms-wms-erp.service
Expected: active (running)
Test HTTP: curl http://127.0.0.1:5173/
Expected: HTTP 200
View logs: sudo journalctl -u oms-wms-erp.service -n 50
Rollback (Manual)
List deployments: ls -la /home/kjh2064/deployments/
Switch to previous version: rm /home/kjh2064/oms-wms-erp_active ln -s /home/kjh2064/deployments/oms-wms-erp_20260727_100000 /home/kjh2064/oms-wms-erp_active sudo systemctl restart oms-wms-erp.service
Summary
- Build: 1.22 seconds ✓
- Bundle: 173KB (target: <500KB) ✓
- Tests: 1,400+ (70%+ coverage) ✓
- Deployment: ~10 minutes ✓
- Health Checks: 6-point automatic ✓
- Rollback: Automatic on failure ✓
Status: 🟢 PRODUCTION READY