2.9 KiB
2.9 KiB
Deployment Quick Reference
Last Updated: 2026-04-16 Purpose: Quick command reference for The Order deployment operations on Sankofa Phoenix / Proxmox
Prerequisites Check
# Verify tools
node --version # >= 18.0.0
pnpm --version # >= 8.0.0
docker --version
ssh -V
tar --version
# Verify Proxmox access
ssh [email protected] "echo ok"
Phase 1: Prerequisites
git clone <repo-url> && cd the-order
git submodule update --init --recursive
pnpm install --frozen-lockfile
./scripts/deploy/phase1-prerequisites.sh
Phase 2: Sankofa Phoenix Target Preparation
./scripts/deploy/phase2-sankofa-phoenix-target.sh
# Preview the Order edge config directly from the parent Proxmox workspace
bash ../scripts/deployment/provision-order-haproxy-10210.sh --dry-run
Phase 3: Identity Provider Secrets
# Confirm the local env file has the issuer values this environment needs.
./scripts/deploy/phase3-identity-secrets.sh
Phase 5: Local Artifact / Runtime Preparation
./scripts/deploy/phase5-container-registry.sh
cat .deployment/artifacts/image-manifest-dev.txt
Phase 6: Build & Package
# Build packages and local images
./scripts/deploy/phase6-build-package.sh
# Preview the Phoenix sync artifact only
./scripts/deploy/sync-portal-public-to-sankofa-phoenix.sh --dry-run --skip-build
Phase 11: Frontend Apps
# Standard deploy
./scripts/deploy/deploy.sh --phase 11 --environment dev
# Direct sync
./scripts/deploy/sync-portal-public-to-sankofa-phoenix.sh
# Verify
curl -fsS http://192.168.11.36:3000/api/health
curl -fsS -H 'Host: the-order.sankofa.nexus' http://192.168.11.39/api/health
curl -fsS https://the-order.sankofa.nexus/api/health
Phase 12: Networking
# Refresh HAProxy and NPM routing from the parent Proxmox workspace
bash ../scripts/deployment/provision-order-haproxy-10210.sh
bash ../scripts/nginx-proxy-manager/update-npmplus-proxy-hosts-api.sh
Phase 13: Monitoring
./scripts/deploy/phase13-monitoring.sh
# Tail logs directly
ssh [email protected] "pct exec 10090 -- journalctl -u the-order-portal-public -f"
Phase 14: Testing
./scripts/deploy/phase14-testing.sh
# Quick health probes
curl -fsS https://phoenix.sankofa.nexus/health
curl -fsS https://the-order.sankofa.nexus/api/health
pnpm --dir apps/portal-public test
Common Operations
Check deployment status
ssh [email protected] "pct status 10090 && pct status 10210"
curl -fsS https://the-order.sankofa.nexus/api/health
View logs
ssh [email protected] "pct exec 10090 -- journalctl -u the-order-portal-public -n 100 --no-pager"
Restart the app
ssh [email protected] "pct exec 10090 -- systemctl restart the-order-portal-public"
Preview the public edge
curl -i -H 'Host: the-order.sankofa.nexus' http://192.168.11.39/