username/ppf
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: reflect podman-compose on all nodes

Browse Source 
Remove stale systemd unit and standalone podman run references.
All nodes now managed exclusively via compose.
This commit is contained in:
Username
2026-02-17 23:44:35 +01:00
parent 7a271896a8
commit 6800995361
2 changed files with 17 additions and 43 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
CLAUDE.md
View File

@@ -25,7 +25,7 @@
│ Host │ Code Location │ Container Mount │ Host │ Code Location │ Container Mount
├──────────┼─────────────────────────┼──────────────────────────────────────────┤ ├──────────┼─────────────────────────┼──────────────────────────────────────────┤
│ odin │ /home/podman/ppf/*.py │ Mounts ppf/ directly to /app │ odin │ /home/podman/ppf/*.py │ Mounts ppf/ directly to /app
│ workers │ /home/podman/ppf/src/ │ Mounts ppf/src/ to /app (via systemd) │ workers │ /home/podman/ppf/src/ │ Mounts ppf/src/ to /app (via compose)
└──────────┴─────────────────────────┴──────────────────────────────────────────┘ └──────────┴─────────────────────────┴──────────────────────────────────────────┘
``` ```
@@ -187,20 +187,15 @@ batch_size = clamp(fair_share, min=100, max=1000)
- Workers shuffle their batch locally to avoid testing same proxies simultaneously - Workers shuffle their batch locally to avoid testing same proxies simultaneously
- Claims expire after 5 minutes if not completed - Claims expire after 5 minutes if not completed
## Worker Container ## Container Management
Workers run as podman containers with `--restart=unless-stopped`: All nodes run via `podman-compose` with role-specific compose files:
```bash - **Odin**: `compose.master.yml` -> deployed as `compose.yml`
podman run -d --name ppf-worker --network=host --restart=unless-stopped \ - **Workers**: `compose.worker.yml` -> deployed as `compose.yml`
-e PYTHONUNBUFFERED=1 \
-v /home/podman/ppf/src:/app:ro,Z \ Containers are managed exclusively through compose. No systemd user
-v /home/podman/ppf/data:/app/data:Z \ services or standalone `podman run` commands.
-v /home/podman/ppf/config.ini:/app/config.ini:ro,Z \
-v /home/podman/ppf/servers.txt:/app/servers.txt:ro,Z \
localhost/ppf-worker:latest \
python -u ppf.py --worker --server http://10.200.1.250:8081
```
## Rebuilding Images ## Rebuilding Images

39
README.md
View File

@@ -197,44 +197,23 @@ stale_count INT -- checks without new proxies
## Deployment ## Deployment
### Systemd Service
```ini
[Unit]
Description=PPF Python Proxy Finder
After=network-online.target tor.service
Wants=network-online.target
[Service]
Type=simple
User=ppf
WorkingDirectory=/opt/ppf
# ppf.py is the main entry point (runs harvester + validator)
ExecStart=/usr/bin/python2 ppf.py
Restart=on-failure
RestartSec=30
[Install]
WantedBy=multi-user.target
```
### Container Deployment ### Container Deployment
All nodes use `podman-compose` with role-specific compose files. All nodes use `podman-compose` with role-specific compose files
(rootless, as `podman` user). `--network=host` required for Tor
access at 127.0.0.1:9050.
```sh ```sh
# Build image # Build image
podman build -t ppf:latest . podman build -t ppf:latest .
# Run standalone (single node) # Start via compose
podman run -d --name ppf \ podman-compose up -d
--network=host \
-v ./data:/app/data:Z \
-v ./config.ini:/app/config.ini:ro \
ppf:latest python ppf.py
```
Note: `--network=host` required for Tor access at 127.0.0.1:9050. # View logs / stop
podman-compose logs -f
podman-compose down
```
### Operations Toolkit ### Operations Toolkit