r2-transfer-service-playbook

Coordinate R2 transfer pipeline changes across Python, Cloudflare Workers, and PHP with validations.

Updated May 18, 2025
One-click install
npx skills add https://github.com/ki2pixel/render_signal_server --skill r2-transfer-service-playbook
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: r2-transfer-service-playbook
Source: https://github.com/ki2pixel/render_signal_server/tree/main/.windsurf/skills/r2-transfer-service-playbook
Command: npx skills add https://github.com/ki2pixel/render_signal_server --skill r2-transfer-service-playbook

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage changes to the R2 transfer pipeline (Python service, Cloudflare Workers, PHP logger) with mandatory validations, allowlists, and regression checks.

Core Features & Use Cases

  • Validate environment prerequisites (R2_BASE_URL, R2_FETCH_TOKEN, ALLOWED_R2_DOMAINS) before deploys.
  • Enforce domain allowlists and deliver resilient, auditable updates across Python services, Cloudflare Workers, and PHP components.
  • Provide a repeatable workflow for dependency validation, header injection, logging, and dry-run deployments with clear testing guidance.

Quick Start

Run the .windsurf/skills/r2-transfer-service-playbook/test_r2_worker.sh script to validate the R2 transfer workflow.

Frequently Asked Questions about r2-transfer-service-playbook

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate R2 transfer pipeline changes across Python services and Cloudflare Workers?

To coordinate R2 transfer pipeline changes, this playbook analyzes updates across Python services, Cloudflare Workers, and PHP loggers to enforce domain validations, token injections, and regression checks for safe deployments.

What environment variables are required to validate an R2 transfer workflow before deployment?

Validating an R2 transfer workflow requires setting R2_BASE_URL, R2_FETCH_TOKEN, and ALLOWED_R2_DOMAINS as environment prerequisites to enforce domain allowlists and ensure resilient updates before deploys.

How do I test an R2 worker without triggering a full production deployment?

You can test an R2 worker safely by running the test_r2_worker.sh script to validate the transfer workflow, utilizing dry-run deployments to verify headers, logging, and domain validations without production impact.

Does the R2 transfer playbook support logging configurations that prevent PII leakage?

Yes, the R2 transfer playbook enforces logging configurations that explicitly exclude PII, ensuring auditable updates across Python services and PHP components while maintaining compliance during pipeline modifications.

What is the best way to enforce domain allowlists for Cloudflare Workers fetching from R2 storage?

The best way to enforce domain allowlists for Cloudflare Workers is by configuring ALLOWED_R2_DOMAINS, which the playbook validates to deliver resilient and auditable updates across the transfer pipeline.

Can I use this playbook to update r2_transfer_service.py and email orchestrator components simultaneously?

Yes, you can use this playbook to simultaneously update r2_transfer_service.py and email_processing/orchestrator.py, coordinating changes to delivery links and r2_url configurations with mandatory regression checks.