diff options
| author | Pjotr <wrk@bosa.lan> | 2026-10-04 08:17:08 +0000 |
|---|---|---|
| committer | Pjotr <wrk@bosa.lan> | 2026-10-04 08:17:08 +0000 |
| commit | c01411e98a0d3a5671ee6914c844215ce578efe5 (patch) | |
| tree | b62138329aeb702ab573c827c1b80d9cc5584c6b | |
| parent | 205d331011d0b64e534499baac65b3fd9d593825 (diff) | |
| download | genecup-c01411e98a0d3a5671ee6914c844215ce578efe5.tar.gz | |
doc: RELEASE_NOTES 1.9.2 (container deployment); bump VERSION
Documents the Guix system container deployment (services and container definition in gn-machines, pointing at the new documents), the genecup-gemini package in guix-bioinformatics now fetched from this repository at build time, the four packaging fixes found by the container smoke test (curl/wget/xargs on the wrapper PATH, CA bundle environment, EDIRECT_LOCAL_ARCHIVE export with the pubmed symlink archive layout, and the tolerant archive-existence check), the 11-check smoke test and the operational notes (datadir, optional Gemini credentials, optional shared PubMed archive). VERSION bumped to 1.9.2 (the version the /about page reports).
| -rw-r--r-- | RELEASE_NOTES.md | 69 | ||||
| -rw-r--r-- | VERSION | 2 |
2 files changed, 70 insertions, 1 deletions
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index 0d73f75..26c8737 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -39,3 +39,72 @@ - Moved dead code to old/server.py - Removed unused TensorFlow/Keras dependencies - Removed stress_prompt.txt dependency (batch classifier builds its own prompt) + +## Version 1.9.2 (2026-10-04) + +### Guix system container (new) + +- **Deployable as a Guix system container** through the + gn-machines repository: + `genenetwork/services/genecup.scm` (services) and + `genenetwork/containers/genecup-container.scm` (the container). + nginx runs in the foreground as a reverse proxy on port 4201 in + front of the Flask app on 127.0.0.1:4202; the Anubis AI-bot + firewall can challenge browser traffic (anubis? #t, bundled into + the nginx shepherd service). Container SSH on port 2223 with the + pinned hello-container-key, same as the BNW and cgit containers. + Build with: + + guix system container --network \ + -L $base/guix-bioinformatics \ + -L $base/gn-machines \ + -L $base/contrib/guix-forge/guix \ + $base/gn-machines/genenetwork/containers/genecup-container.scm + +- **genecup-gemini 1.9 in guix-bioinformatics** + (`gn/packages/genecup.scm`): this repository is now fetched from + https://git.genenetwork.org/genecup at build time (git-fetch, + commit-pinned) instead of the local-source guix.scm. guix.scm + stays for interactive development (`guix shell -L . -C -N -F ...`). + +### Packaging fixes found by the container smoke test + +All four surfaced as silent environment failures during a live +end-to-end run in the minimal container: + +- edirect's `nquire` shells out to curl/wget and + `join-into-groups-of` shells out to xargs; the genecup wrapper now + puts curl, wget and findutils (xargs) on its PATH +- curl exited 60/77 (CA verification) in the minimal container: the + wrapper exports SSL_CERT_FILE and CURL_CA_BUNDLE pointing at the + profile-generated /etc/ssl/certs/ca-certificates.crt +- xfetch/rchive require EDIRECT_LOCAL_ARCHIVE in the environment; + the wrapper exports it pointing at + `<out>/share/genecup-archive`, whose `pubmed` symlink exposes the + bundled minipubmed archive in the `<archive>/pubmed/Archive/<NN>` + layout xfetch expects (minipubmed itself is laid out flat). The + startup check in more_functions.py now accepts both the full + edirect layout and the flat minipubmed layout, so the server + boots without a full local archive (abstract fetches fall back to + NCBI efetch over the network) + +### Testing + +- `genenetwork/services/test/genecup_smoke.py` (in gn-machines) + drives the full anonymous flow against a running container: front + page, about (version), search kickoff, the /search SSE stream, + cytoscape graph, table view, a /sentences page and the static + assets -- 11/11 green. Note: the SSE stream must be read to EOF + (the generator writes nodes.json/edges.json only after the final + yield). + +### Operational notes + +- Writable state (userspub.sqlite, per-user folders) lives under + GENECUP_DATADIR=/var/lib/genecup in the container +- Gemini features are optional: share a 0400 credentials file into + the container at /var/lib/genecup/.config/gemini/credentials +- A full local PubMed archive can be shared into the container and + selected with the pubmed-archive field (exports + EDIRECT_LOCAL_ARCHIVE); without it edirect queries NCBI over the + network, subject to eutils rate limits diff --git a/VERSION b/VERSION index 9ab8337..8fdcf38 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -1.9.1 +1.9.2 |
