new-api/ops/remote/TEMPLATE.AGENT.md
zizi e6bced5dc2 chore: rebuild dev/1.0.0 from main with docs and deploy config
- Rebase dev/1.0.0 on latest upstream main (drop Muse relay code)
- Preserve: troubleshooting records, remote layout, Docker deploy workflow
- Simplify docker-compose.yml to app-only (external PG/Redis)
- Add ops/remote/ host documentation
- Update .env.example with host/docker connection profiles
2026-05-18 23:39:31 +08:00

1.4 KiB

Remote Host AGENT Template

1. Host Identity

  • Host name:
  • Host role:
  • Region or environment:
  • Primary access path:
  • Tailscale IP:
  • Other important IPs or domains:

2. Access and Safety

  • SSH profile or connection method:
  • Primary operator:
  • Privilege model:
  • Proxy requirements:
  • Secrets location:
  • Important do-not-touch items:

3. Runtime Topology

  • Main deployment styles on this host:
  • Shared Docker networks:
  • Shared databases or caches:
  • Host-level ports in use:
  • Reverse proxy or ingress layer:

4. Project Inventory

Project:

  • Purpose:
  • Deploy mode:
  • Runtime entrypoint:
  • Source repo path:
  • Runtime directory:
  • Main service or container names:
  • Public or internal endpoints:
  • Config files:
  • Data location:
  • Backup location:
  • Logs and inspection commands:
  • Upgrade path:
  • Known traps:

5. Git and Repository Strategy

  • Writable repositories:
  • Mirror repositories:
  • Upstream repositories:
  • Default push targets:
  • Branch strategy:
  • Sync workflow:

6. Data and Backup

  • Databases in use:
  • Named volumes or bind mounts:
  • Backup commands:
  • Restore notes:
  • High-risk destructive actions to avoid:

7. Routine Operations

  • Check health:
  • Check logs:
  • Restart service:
  • Restart containers:
  • Verify ports:
  • Verify external access:

8. Incident Notes

  • Recent incidents:
  • Root causes found:
  • Permanent fixes applied:
  • Remaining risks:

9. Change Log

  • YYYY-MM-DD: