Add MCP deployment section to RUNBOOK.md
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
50
RUNBOOK.md
50
RUNBOOK.md
@@ -187,6 +187,56 @@ grpcurl -cacert ca.pem -cert client.pem -key client-key.pem \
|
||||
-d '{"rule": {"type": "FIREWALL_RULE_TYPE_IP", "value": "203.0.113.50"}}'
|
||||
```
|
||||
|
||||
## Deployment with MCP
|
||||
|
||||
mc-proxy runs on rift as a single container managed by MCP. The service
|
||||
definition lives at `~/.config/mcp/services/mc-proxy.toml` on rift (reference
|
||||
copy at `deploy/mc-proxy-rift.toml` in this repo). The container mounts
|
||||
`/srv/mc-proxy` which holds the config file, SQLite database, GeoIP database,
|
||||
and TLS certificates for backends. It runs as `--user 0:0` under rootless
|
||||
podman.
|
||||
|
||||
Listeners: `:443` (L7 terminating), `:8443` (L4 passthrough), `:9443` (L4
|
||||
passthrough).
|
||||
|
||||
### Deploy or Update
|
||||
|
||||
```bash
|
||||
mcp deploy mc-proxy
|
||||
```
|
||||
|
||||
### Restart / Stop
|
||||
|
||||
```bash
|
||||
mcp restart mc-proxy
|
||||
mcp stop mc-proxy
|
||||
```
|
||||
|
||||
### Check Status
|
||||
|
||||
```bash
|
||||
mcp ps
|
||||
mcp status mc-proxy
|
||||
```
|
||||
|
||||
### View Logs
|
||||
|
||||
```bash
|
||||
ssh rift 'doas su - mcp -s /bin/sh -c "podman logs mc-proxy"'
|
||||
```
|
||||
|
||||
### Update Routes
|
||||
|
||||
Edit the config at `/srv/mc-proxy/mc-proxy.toml` on rift, then restart:
|
||||
|
||||
```bash
|
||||
mcp restart mc-proxy
|
||||
```
|
||||
|
||||
Routes added at runtime via the gRPC admin API are persisted in the database
|
||||
and survive restarts. Editing the TOML config is only necessary for changing
|
||||
listener definitions or static seed routes.
|
||||
|
||||
## Incident Procedures
|
||||
|
||||
### Proxy Not Starting
|
||||
|
||||
Reference in New Issue
Block a user