fix(deploy): use /ready/ healthcheck and /srv/mnemosyne path
- Change app healthcheck from /live/ to /ready/ to verify full readiness including dependencies (DB, Neo4j, S3) - Increase healthcheck timeout from 5s to 10s to accommodate dependency checks - Add S3 bucket connectivity check to readiness probe - Update deployment documentation to use /srv/mnemosyne instead of /opt/mnemosyne as the compose project directory
This commit is contained in:
@@ -13,7 +13,7 @@ one-time steps, and verification checks.
|
||||
| Item | Value |
|
||||
|------|-------|
|
||||
| Deploy target | `puck.incus` (Incus container, 10.10.0.0/24) |
|
||||
| Compose project directory | `/opt/mnemosyne` |
|
||||
| Compose project directory | `/srv/mnemosyne` |
|
||||
| Image registry | `git.helu.ca/r/mnemosyne:latest` |
|
||||
| Public host port | **23181** (nginx → HAProxy on Titania → `https://mnemosyne.ouranos.helu.ca`) |
|
||||
| Internal app port | `app:8000` (Django/gunicorn) |
|
||||
@@ -49,7 +49,7 @@ credentials; it does not provision these hosts.
|
||||
### 3.1 Directory & file layout
|
||||
|
||||
```
|
||||
/opt/mnemosyne/
|
||||
/srv/mnemosyne/
|
||||
├── docker-compose.yaml ← copied from repo (or symlinked via git pull)
|
||||
├── nginx/
|
||||
│ └── mnemosyne.conf ← copied from repo nginx/mnemosyne.conf
|
||||
@@ -57,7 +57,7 @@ credentials; it does not provision these hosts.
|
||||
```
|
||||
|
||||
The role should:
|
||||
1. Create `/opt/mnemosyne/` and `nginx/` (owner: `root`, mode `0750`).
|
||||
1. Create `/srv/mnemosyne/` and `nginx/` (owner: `root`, mode `0750`).
|
||||
2. Render `.env` from the vault-sourced Jinja2 template (mode `0600`, owner `root`).
|
||||
3. Copy (or `git pull`) `docker-compose.yaml` and `nginx/mnemosyne.conf` from the repo.
|
||||
|
||||
@@ -66,12 +66,12 @@ The role should:
|
||||
```yaml
|
||||
- name: Pull latest image
|
||||
community.docker.docker_compose_v2:
|
||||
project_src: /opt/mnemosyne
|
||||
project_src: /srv/mnemosyne
|
||||
pull: always
|
||||
|
||||
- name: Bring stack up
|
||||
community.docker.docker_compose_v2:
|
||||
project_src: /opt/mnemosyne
|
||||
project_src: /srv/mnemosyne
|
||||
state: present
|
||||
```
|
||||
|
||||
@@ -85,16 +85,16 @@ an explicit `when: mnemosyne_first_deploy` flag.
|
||||
|
||||
```bash
|
||||
# Apply Django ORM migrations (PostgreSQL schema)
|
||||
docker compose -f /opt/mnemosyne/docker-compose.yaml \
|
||||
docker compose -f /srv/mnemosyne/docker-compose.yaml \
|
||||
run --rm app migrate
|
||||
|
||||
# Create Neo4j vector + full-text indexes and load library-type defaults
|
||||
docker compose -f /opt/mnemosyne/docker-compose.yaml \
|
||||
docker compose -f /srv/mnemosyne/docker-compose.yaml \
|
||||
run --rm app setup
|
||||
|
||||
# Create the daedalus-service user (HTTP Basic auth for ingest API)
|
||||
# Pass --password from vault; idempotent if user already exists.
|
||||
docker compose -f /opt/mnemosyne/docker-compose.yaml \
|
||||
docker compose -f /srv/mnemosyne/docker-compose.yaml \
|
||||
run --rm app \
|
||||
python manage.py ensure_service_user \
|
||||
--username daedalus-service \
|
||||
@@ -103,7 +103,7 @@ docker compose -f /opt/mnemosyne/docker-compose.yaml \
|
||||
# Seed the MCP signing key (for Phase 2 per-turn JWT auth)
|
||||
# --retire-other deactivates any previously-active key.
|
||||
# Print the secret_hex and store in vault as vault_mnemosyne_signing_secret.
|
||||
docker compose -f /opt/mnemosyne/docker-compose.yaml \
|
||||
docker compose -f /srv/mnemosyne/docker-compose.yaml \
|
||||
run --rm app \
|
||||
python manage.py seed_signing_key --kid daedalus-1 --retire-other
|
||||
```
|
||||
@@ -261,7 +261,7 @@ relevant service `environment:` blocks. The per-service scoping is defined in
|
||||
After `docker compose up -d`, wait for all services to report healthy:
|
||||
|
||||
```bash
|
||||
docker compose -f /opt/mnemosyne/docker-compose.yaml ps
|
||||
docker compose -f /srv/mnemosyne/docker-compose.yaml ps
|
||||
```
|
||||
|
||||
Expected: `app`, `mcp`, `worker`, `web` all `healthy`; `static-init` `exited (0)`.
|
||||
@@ -315,7 +315,7 @@ curl -H "Authorization: Bearer <token>" \
|
||||
A standard upgrade (new image pushed to `git.helu.ca/r/mnemosyne:latest`):
|
||||
|
||||
```bash
|
||||
cd /opt/mnemosyne
|
||||
cd /srv/mnemosyne
|
||||
docker compose pull
|
||||
docker compose up -d # static-init re-seeds; running containers replaced
|
||||
docker compose run --rm app migrate # no-op if no new migrations
|
||||
|
||||
Reference in New Issue
Block a user