xomoxcc/flickr-immich-k8s-sync-operator repository overview
flickr-immich-k8s-sync-operator
Kubernetes operator that watches per-user Flickr download Jobs in a namespace, restarts failed Jobs after a configurable delay, and retrieves pod logs and exit codes for failed Jobs before restarting them. Designed to run alongside Immich (self-hosted photo management).
Screenshots
- Source: GitHub
- PyPI: flickr-immich-k8s-sync-operator
- License: LGPLv3
Features
- Monitors configured Kubernetes Jobs for failure conditions
- Retrieves pod logs and exit codes before restarting
- Configurable check interval and restart delay
- Clean signal handling (SIGTERM/SIGINT) for graceful container shutdown
- OOMKilled-aware restart logic — skips the restart delay when pods are killed by OOM
- Structured logging via loguru
Quick start
docker run --rm xomoxcc/flickr-immich-k8s-sync-operator:latest
Configuration
| Variable | Description | Default |
|---|---|---|
LOGURU_LEVEL | Log verbosity (DEBUG, INFO, WARNING, ...) | DEBUG |
NAMESPACE | Namespace to watch | flickr-downloader |
JOB_NAMES | Comma-separated Job names to monitor (required) | -- |
CHECK_INTERVAL | Seconds between check cycles | 60 |
RESTART_DELAY | Seconds to wait after failure before restart | 3600 |
SKIP_DELAY_ON_OOM | Skip restart delay when failure reason is OOMKilled | false |
Kubernetes Deployment
The operator runs as a single-replica Deployment with a namespace-scoped ServiceAccount. See the README for full RBAC and Deployment manifests.
Image details
- Base:
python:3.14-slim-trixie - Non-root user (
pythonuser) - Entrypoint:
tini --withflickr-immich-k8s-sync-operatoras default CMD - Multi-arch:
linux/amd64,linux/arm64
Tag summary
Content type
Image
Digest
sha256:62e234956…
Size
122.3 MB
Last updated
7 months ago
docker pull xomoxcc/flickr-immich-k8s-sync-operator