diff --git a/10-systems/services/gnexus-creds.md b/10-systems/services/gnexus-creds.md index 8b2d0e9..48b96d9 100644 --- a/10-systems/services/gnexus-creds.md +++ b/10-systems/services/gnexus-creds.md @@ -1,7 +1,7 @@ --- owner: gmikcon status: active -last_reviewed: 2026-05-21 +last_reviewed: 2026-10-01 review_interval: 90d confidence: high source_of_truth: deployment-verified @@ -16,14 +16,26 @@ - **Method**: Docker Compose - **Port**: 80 (External) $\to$ 8000 (Internal) - **Database**: PostgreSQL 17 (Containerized) +- **Repository**: https://git.gnexus.space/git/root/gnexus-creds.git (branch master) +- **Current version**: 4c6a4f7 (2026-10-01, updated by rei; includes PWA shell, biometric reveal gate, extension 0.1.1, ui-kit 1.0) ## Configuration - Environment variables are managed via `.env` file in `/home/ubuntu/gnexus-creds`. - Production mode enabled (`GNEXUS_CREDS_ENV=production`). - Secrets (`SECRET_KEY`, `MCP_TOKEN`) are randomly generated. +## Local runtime adaptation (do not overwrite) +`docker-compose.yml` has an uncommitted local modification that matches the live stack: +- service renamed `postgres` $\to$ `db` (container names gnexus-creds-db-1 / app-1 depend on it); +- port mapping `80:8000` (upstream default is `8000:8000`); +- app healthcheck uses python urllib instead of curl (curl not in image); +- `restart: unless-stopped` on both services. +Preserve it across updates: `git stash push docker-compose.yml` $\to$ pull $\to$ `git stash pop`. + ## Operations - **Health Check**: `GET /health` - **Readiness Check**: `GET /ready` - **Migrations**: `docker compose run --rm app alembic upgrade head` - **Logs**: `docker compose logs -f app` +- **Update procedure** (verified 2026-10-01): backup `.env` + `docker-compose.yml` to `~/backups/` $\to$ stash compose $\to$ `git pull --ff-only origin master` $\to$ stash pop $\to$ `sudo docker compose up -d --build` $\to$ `alembic upgrade head` $\to$ check `/health`, `/ready` and https://creds.gnexus.space/health. +- **SSH access**: ubuntu@192.168.1.173, password same as navi swarm password (see gnexus-creds secret "navi (192.168.1.168) — SSH ubuntu"); sudo same password. No dedicated secret for this host yet. diff --git a/90-maintenance/pending-changes/20261001192159-3b700379.json b/90-maintenance/pending-changes/20261001192159-3b700379.json new file mode 100644 index 0000000..10c7380 --- /dev/null +++ b/90-maintenance/pending-changes/20261001192159-3b700379.json @@ -0,0 +1,19 @@ +{ + "id": "20261001192159-3b700379", + "kind": "doc", + "target": "10-systems/services/gnexus-creds.md", + "summary": "gnexus-creds updated to 4c6a4f7 (2026-10-01): documented local compose adaptation, update procedure, SSH access", + "reason": "Service updated to 4c6a4f7 on 2026-10-01 by rei; documented local compose adaptation, update procedure, and SSH access method.", + "payload": { + "content": "---\nowner: gmikcon\nstatus: active\nlast_reviewed: 2026-10-01\nreview_interval: 90d\nconfidence: high\nsource_of_truth: deployment-verified\n---\n\n# gnexus-creds\n\nPersonal secret storage service with REST API, MCP HTTP/SSE adapter, and Vue UI.\n\n## Deployment\n- **Host**: [[gnexus-creds-host]] (192.168.1.173)\n- **Method**: Docker Compose\n- **Port**: 80 (External) $\\to$ 8000 (Internal)\n- **Database**: PostgreSQL 17 (Containerized)\n- **Repository**: https://git.gnexus.space/git/root/gnexus-creds.git (branch master)\n- **Current version**: 4c6a4f7 (2026-10-01, updated by rei; includes PWA shell, biometric reveal gate, extension 0.1.1, ui-kit 1.0)\n\n## Configuration\n- Environment variables are managed via `.env` file in `/home/ubuntu/gnexus-creds`.\n- Production mode enabled (`GNEXUS_CREDS_ENV=production`).\n- Secrets (`SECRET_KEY`, `MCP_TOKEN`) are randomly generated.\n\n## Local runtime adaptation (do not overwrite)\n`docker-compose.yml` has an uncommitted local modification that matches the live stack:\n- service renamed `postgres` $\\to$ `db` (container names gnexus-creds-db-1 / app-1 depend on it);\n- port mapping `80:8000` (upstream default is `8000:8000`);\n- app healthcheck uses python urllib instead of curl (curl not in image);\n- `restart: unless-stopped` on both services.\nPreserve it across updates: `git stash push docker-compose.yml` $\\to$ pull $\\to$ `git stash pop`.\n\n## Operations\n- **Health Check**: `GET /health`\n- **Readiness Check**: `GET /ready`\n- **Migrations**: `docker compose run --rm app alembic upgrade head`\n- **Logs**: `docker compose logs -f app`\n- **Update procedure** (verified 2026-10-01): backup `.env` + `docker-compose.yml` to `~/backups/` $\\to$ stash compose $\\to$ `git pull --ff-only origin master` $\\to$ stash pop $\\to$ `sudo docker compose up -d --build` $\\to$ `alembic upgrade head` $\\to$ check `/health`, `/ready` and https://creds.gnexus.space/health.\n- **SSH access**: ubuntu@192.168.1.173, password same as navi swarm password (see gnexus-creds secret \"navi (192.168.1.168) — SSH ubuntu\"); sudo same password. No dedicated secret for this host yet." + }, + "status": "applied", + "created_at": "2026-10-01T19:21:59Z", + "updated_at": "2026-10-01T19:22:00Z", + "applied_at": "2026-10-01T19:22:00Z", + "validation": { + "status": "ok", + "issue_count": 0, + "issues": [] + } +}