65 lines
1.7 KiB
Markdown
65 lines
1.7 KiB
Markdown
# Animatrix Runbook
|
|
|
|
## Production Runtime
|
|
|
|
- frontend: `127.0.0.1:3200`
|
|
- backend: `127.0.0.1:8200`
|
|
- public hostname: `animatrix.desineuron.in`
|
|
- Comfy dependency: `https://comfy.desineuron.in`
|
|
- frontend service root: `/opt/animatrix/frontend/.next/standalone`
|
|
- backend env should include `BACKEND_BASE_URL=https://animatrix.desineuron.in`
|
|
|
|
## Frontend Build Packaging
|
|
|
|
The frontend is deployed using Next.js standalone output. After every build, static assets must be copied into the standalone directory or the site will render unstyled because `/_next/static/css/*` will 404.
|
|
|
|
Required packaging flow:
|
|
|
|
```bash
|
|
cd /opt/animatrix
|
|
./scripts/build_frontend_standalone.sh
|
|
sudo systemctl restart animatrix-frontend
|
|
sudo systemctl restart animatrix-backend
|
|
```
|
|
|
|
If the site looks like plain HTML with unstyled buttons and form controls, check:
|
|
|
|
```bash
|
|
curl -I https://animatrix.desineuron.in/_next/static/css/<hash>.css
|
|
```
|
|
|
|
That request must return `200`, not `404`.
|
|
|
|
## Auth Cookie Safety
|
|
|
|
The backend now treats forwarded HTTPS headers from nginx as authoritative for cookie security. Even so, keep:
|
|
|
|
```bash
|
|
BACKEND_BASE_URL=https://animatrix.desineuron.in
|
|
```
|
|
|
|
in the production backend environment so generated backend URLs and cookie policy stay aligned with the public host.
|
|
|
|
## First Production Check
|
|
|
|
1. Open `https://animatrix.desineuron.in/login`
|
|
2. Register a user
|
|
3. Upload one image
|
|
4. Upload one video or one audio file depending on mode
|
|
5. Submit a job
|
|
6. Confirm job transitions out of `created`
|
|
|
|
## Expected Non-Test Scope
|
|
|
|
This deployment verifies:
|
|
|
|
- app hosting
|
|
- TLS
|
|
- backend reachability
|
|
- auth flow
|
|
- asset upload
|
|
- job creation
|
|
- ComfyUI connectivity path
|
|
|
|
It does not assert final video quality or creative correctness.
|