mirror of
https://github.com/pocket-id/pocket-id.git
synced 2026-09-17 16:39:04 +02:00
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
34 lines
1.5 KiB
Go
34 lines
1.5 KiB
Go
package cmds
|
|
|
|
import (
|
|
"archive/zip"
|
|
"fmt"
|
|
"os"
|
|
|
|
"github.com/pocket-id/pocket-id/backend/internal/service"
|
|
)
|
|
|
|
// printRemoteActorDataNotice warns that the command does not cover the actor data, which a standalone Francis runtime owns rather than Pocket ID
|
|
// It goes to stderr so it stays visible when the archive itself is streamed to stdout
|
|
func printRemoteActorDataNotice(consequence string, remedy string) {
|
|
fmt.Fprintf(os.Stderr, `WARNING: FRANCIS_HOST points to a standalone Francis runtime.
|
|
%s.
|
|
That data covers the app configuration, signup and one-time access tokens, device
|
|
login requests, LDAP sync state, and the schedule of the background jobs.
|
|
To cover it, %s.
|
|
|
|
`, consequence, remedy)
|
|
}
|
|
|
|
// ensureNoActorsBackup rejects an archive that carries the actor data when a standalone Francis runtime owns it
|
|
// Such an archive comes from a deployment with an embedded runtime, and restoring only its Pocket ID half would leave the runtime holding actor state belonging to a different deployment
|
|
func ensureNoActorsBackup(zipReader *zip.Reader) error {
|
|
for _, f := range zipReader.File {
|
|
if f.Name == service.ActorsBackupFileName {
|
|
return fmt.Errorf("this archive contains the actor data (%s) but FRANCIS_HOST points to a standalone Francis runtime, which owns that data instead: restore it into a deployment with an embedded runtime, or load the actor data into the runtime with 'francis runtime restore'", service.ActorsBackupFileName)
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|