37 lines
842 B
Markdown
37 lines
842 B
Markdown
|
# Deployment
|
||
|
|
|
||
|
|
## Environment
|
||
|
|
|
||
|
|
Required:
|
||
|
|
|
||
|
|
- `SUB2API_CRM_ADMIN_TOKEN`: control-plane bearer token
|
||
|
|
|
||
|
|
Optional:
|
||
|
|
|
||
|
|
- `SUB2API_CRM_LISTEN_ADDR` (default `:8080`)
|
||
|
|
- `SUB2API_CRM_SQLITE_DSN` (default `file:sub2api-cn-relay-manager.db?_foreign_keys=on&_busy_timeout=5000`)
|
||
|
|
|
||
|
|
## Local Docker Compose
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cp .env.example .env
|
||
|
|
# edit SUB2API_CRM_ADMIN_TOKEN before startup
|
||
|
|
mkdir -p data
|
||
|
|
docker compose up --build -d
|
||
|
|
curl -fsS http://127.0.0.1:8080/healthz
|
||
|
|
```
|
||
|
|
|
||
|
|
## Standalone Binary
|
||
|
|
|
||
|
|
```bash
|
||
|
|
go build -o bin/sub2api-cn-relay-manager ./cmd/server
|
||
|
|
SUB2API_CRM_ADMIN_TOKEN=replace-me ./bin/sub2api-cn-relay-manager
|
||
|
|
```
|
||
|
|
|
||
|
|
## Runtime Notes
|
||
|
|
|
||
|
|
- SQLite file should be mounted on persistent storage.
|
||
|
|
- Admin token must be rotated outside source control.
|
||
|
|
- The service is stateless except for SQLite runtime state.
|
||
|
|
- Use `/healthz` for container liveness checks.
|