From 9eff4496d6a1ffecdbd77151970e6c652652ac39 Mon Sep 17 00:00:00 2001 From: Username Date: Tue, 17 Feb 2026 23:19:59 +0100 Subject: [PATCH] docs: update README and ROADMAP for playbook deployment --- README.md | 10 ++++++---- ROADMAP.md | 4 +++- 2 files changed, 9 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index e4e42a3..fe6ef7a 100644 --- a/README.md +++ b/README.md @@ -238,16 +238,18 @@ Note: `--network=host` required for Tor access at 127.0.0.1:9050. ### Operations Toolkit -The `tools/` directory provides CLI wrappers for multi-node operations: +The `tools/` directory provides CLI wrappers for multi-node operations. +Deployment uses an Ansible playbook over WireGuard for parallel execution +and handler-based restarts. ```sh -ppf-deploy [targets...] # deploy code + restart containers +ppf-deploy [targets...] # validate + deploy + restart (playbook) +ppf-deploy --check # dry run with diff ppf-logs [node] # view container logs (-f to follow) ppf-service [nodes...] # status / start / stop / restart ``` -Handles syntax validation, role-aware file syncing (odin vs workers), -ownership fixes, and dynamic UID discovery. See `--help` on each tool. +See `--help` on each tool. ## Troubleshooting diff --git a/ROADMAP.md b/ROADMAP.md index c8f003a..e4dbc5d 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -90,6 +90,8 @@ PPF (Proxy Fetcher) is a Python 2 proxy scraping and validation framework design | static/dashboard.js | Dashboard frontend logic | | static/dashboard.html | Dashboard HTML template | | tools/lib/ppf-common.sh | Shared ops library (hosts, wrappers, colors) | -| tools/ppf-deploy | Deploy code to nodes | +| tools/ppf-deploy | Deploy wrapper (validation + playbook) | | tools/ppf-logs | View container logs | | tools/ppf-service | Container lifecycle management | +| tools/playbooks/deploy.yml | Ansible deploy playbook | +| tools/playbooks/inventory.ini | Host inventory (WireGuard IPs) |