2.4 KiB
2.4 KiB
Operations Quick Reference
Full source of truth: docs/runbook.md
Validate Launch Env
bash scripts/validate-prod-secrets.sh staging
bash scripts/validate-prod-secrets.sh production
Gitgram Deploy
cd gitgram/backend
npm ci --legacy-peer-deps
npx prisma generate
npx prisma migrate deploy
npm run build
(
set -a
source ../../.env.gitgram
set +a
pm2 restart gitgram-api --update-env || pm2 start ../ecosystem.config.js --only gitgram-api
)
(
set -a
source .env.gitgram
source .env.gitgram-web
set +a
cd gitgram/web
npm ci --legacy-peer-deps
npm run build
cd ..
pm2 restart gitgram-web --update-env || pm2 start ecosystem.config.js --only gitgram-web
)
AITM API Deploy
cd aitimemachine/api-server
npm ci
npm run db:migrate
npm run build
(
set -a
source ../../.env.aitm-api
set +a
pm2 restart aitm-api --update-env || pm2 start ../deploy/ecosystem.config.cjs --only aitm-api
)
AITM Package Publish
cd aitimemachine
npm ci
npm run build
npm test
bash scripts/verify-npm-packages.sh
npm publish --access public
cd aitimemachine/mcp
npm ci
npm run build
npm publish --access public
Health Checks
curl -sf http://127.0.0.1:4000/health | jq .
curl -sf http://127.0.0.1:4000/health/ready | jq .
curl -sf -o /dev/null -w "%{http_code}\n" http://127.0.0.1:3000
curl -sf http://127.0.0.1:3001/health | jq .
curl -sf http://127.0.0.1:3001/health/ready | jq .
Worker status when enabled:
(
set -a
source .env.aitm-api
set +a
curl -sf -H "X-Internal-Secret: ${INTERNAL_SECRET}" \
http://127.0.0.1:3001/v1/workers/status | jq .
)
Backups
(
set -a
source .env.gitgram
set +a
cd gitgram
./scripts/backup-database.sh
)
(
set -a
source .env.aitm-api
set +a
pg_dump "$DATABASE_URL" | gzip > "/var/backups/aitm/aitm_$(date +%Y%m%d_%H%M%S).sql.gz"
)
Rollback
git checkout <previous-tag-or-commit>
pm2 restart gitgram-api --update-env
pm2 restart gitgram-web --update-env
pm2 restart aitm-api --update-env
Database rollback policy:
- Gitgram: restore from pre-migration backup or provider PITR.
- AITM: restore from pre-migration backup or provider PITR.
Useful PM2 Commands
pm2 ls
pm2 logs gitgram-api --lines 200
pm2 logs gitgram-web --lines 100
pm2 logs aitm-api --lines 200
pm2 save