sendnrw/pocket-id
2
0
Fork 0
mirror of https://github.com/pocket-id/pocket-id.git synced 2026-10-02 07:49:04 +02:00
Code Issues Packages Projects Releases Wiki Activity

feat: add FRANCIS_HOST to connect to a standalone Francis runtime

Browse Source 
FRANCIS_HOST decides where the Francis actor runtime lives. When it is
empty or set to "embedded" (the default), Pocket ID starts the runtime inside its own process, backed by its own database.

Any other value is the address, or a comma-separated list of addresses, of a standalone Francis runtime. Pocket ID then connects to it as a remote actor host and starts no embedded runtime.

Note: connecting to a standalone runtime also needs FRANCIS_HOST_PSK or FRANCIS_HOST_JWT, and optionally (but recommended) FRANCIS_CA.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DMgoTZtznSjP4SHTaHbRen
This commit is contained in:
ItalyPaleAle
2026-09-15 16:02:05 +00:00
committed by Alessandro (Ale) Segala
co-authored by Claude Opus 5
parent 81cb290bed
commit cea1267f37
35 changed files with 1158 additions and 151 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CONTRIBUTING.md
+11
View File
@@ -121,6 +121,17 @@ The tests can be run like this:
If you make any changes to the application, you have to rebuild the test environment by running `docker compose up -d --build` again.
By default the test environment runs Pocket ID with the Francis actor runtime embedded in it. To run the same suite against a **standalone Francis runtime** instead, start the environment from the other Compose file:
```bash
echo "FRANCIS_VERSION=$(./francis-version.sh)" > .env
docker compose -f docker-compose-francis.yml up -d --build
```
That brings up a SQLite-backed Francis runtime alongside Pocket ID and points `FRANCIS_HOST` at it, so Pocket ID starts no embedded runtime and the actor state, alarms, and placement all live in the runtime instead. The tests themselves are unchanged. CI runs this as an extra matrix entry.
The runtime's image tag is not hardcoded: `francis-version.sh` reads it from the `github.com/italypaleale/francis` requirement in `backend/go.mod`, so the runtime is always the same version as the client Pocket ID is built against. Writing it to `.env` (rather than exporting it for one command) matters because the CLI tests shell out to `docker compose run` themselves, and Compose picks the variable up from that file.
#### Unit tests
In the backend we are using unit tests with the built-in Go testing framework. The tests are located in the same folder as the code they are testing and have the `_test.go` suffix.