153 lines
2.9 KiB
Markdown
153 lines
2.9 KiB
Markdown
# Deployment Quick Reference
|
|
|
|
**Last Updated**: 2026-04-16
|
|
**Purpose**: Quick command reference for The Order deployment operations on Sankofa Phoenix / Proxmox
|
|
|
|
---
|
|
|
|
## Prerequisites Check
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
./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
|
|
|
|
```bash
|
|
# Confirm the local env file has the issuer values this environment needs.
|
|
./scripts/deploy/phase3-identity-secrets.sh
|
|
```
|
|
|
|
---
|
|
|
|
## Phase 5: Local Artifact / Runtime Preparation
|
|
|
|
```bash
|
|
./scripts/deploy/phase5-container-registry.sh
|
|
cat .deployment/artifacts/image-manifest-dev.txt
|
|
```
|
|
|
|
---
|
|
|
|
## Phase 6: Build & Package
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
./scripts/deploy/phase13-monitoring.sh
|
|
|
|
# Tail logs directly
|
|
ssh [email protected] "pct exec 10090 -- journalctl -u the-order-portal-public -f"
|
|
```
|
|
|
|
---
|
|
|
|
## Phase 14: Testing
|
|
|
|
```bash
|
|
./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
|
|
|
|
```bash
|
|
ssh [email protected] "pct status 10090 && pct status 10210"
|
|
curl -fsS https://the-order.sankofa.nexus/api/health
|
|
```
|
|
|
|
### View logs
|
|
|
|
```bash
|
|
ssh [email protected] "pct exec 10090 -- journalctl -u the-order-portal-public -n 100 --no-pager"
|
|
```
|
|
|
|
### Restart the app
|
|
|
|
```bash
|
|
ssh [email protected] "pct exec 10090 -- systemctl restart the-order-portal-public"
|
|
```
|
|
|
|
### Preview the public edge
|
|
|
|
```bash
|
|
curl -i -H 'Host: the-order.sankofa.nexus' http://192.168.11.39/
|
|
```
|