R2 Transfer Service Playbook

r2-transfer-service-playbook

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

diegosouzapw/awesome-omni-skill·0installs62starsDevOps & CI/CD

SKILL.md

Full skill instructions

R2 Transfer Service Playbook

Portée

Utilise ce skill lorsqu'une tâche touche :

services/r2_transfer_service.py
email_processing/orchestrator.py (section delivery_links / r2_url)
deployment/cloudflare-worker/*
deployment/public_html/config_api.php, deployment/public_html/test-direct.php, pages de test R2

Pré-requis

ENV obligatoires : R2_BASE_URL, R2_FETCH_TOKEN, ALLOWED_R2_DOMAINS.
Virtualenv /mnt/venv_ext4/venv_render_signal_server pour les scripts/tests.
Accès au déploiement Cloudflare Workers (wrangler).

Workflow

Analyse des dépendances
- Confirmer la présence des ENV ci-dessus.
- Vérifier les allowlists (Dropbox/FromSmash/SwissTransfer) avant toute nouvelle source.
Mises à jour Python
- Toujours valider les domaines via is_allowed_domain.
- Injecter le header X-R2-FETCH-TOKEN pour chaque requête Worker.
- Conserver les logs sans PII et retour fallback raw_url en cas d'échec.
Workers Cloudflare
- Garder le mode fetch avec timeout 120s pour Dropbox /scl/fo/.
- Mettre à jour httpMetadata.contentDisposition pour préserver le nom de fichier.
- Exécuter wrangler deploy --dry-run (documenter la sortie).
PHP Logger / Diagnostics
- Assurer que config_api.php continue d'écrire les paires source_url/r2_url.
- Tester deployment/public_html/test-direct.php pour valider le flux complet.
Tests & validation
- Lancer le helper ./.cline/skills/r2-transfer-service-playbook/test_r2_worker.sh.
- Compléter si besoin avec des tests ciblés sur les nouvelles sources.
Documentation & Memory Bank
- Mettre à jour docs/processing/file-offload.md ou section dédiée R2.
- Ajouter une entrée dans la Memory Bank si de nouvelles sources sont supportées.

Ressources

test_r2_worker.sh : active le venv, exécute les tests R2 et vérifie la page de test PHP.

Conseils

En cas de nouvelle plateforme de fichiers, créer un helper dédié (normalisation URL, validation).
Limiter les retries côté Worker, gérer les erreurs HTTP explicitement.
Garder les scripts de cleanup alignés (expiration 24h par défaut).

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/diegosouzapw/awesome-omni-skill --skill r2-transfer-service-playbook

View on GitHub

skills/devops/r2-transfer-service-playbook/SKILL.md

More DevOps & CI/CD skills

View all

DevOps & CI/CD

google-agents-cli-scaffold

Project scaffolding, deployment configuration, and CI/CD setup for Google ADK agents.

6K 472.6K

View

DevOps & CI/CD

google-agents-cli-observability

Set up tracing, logging, and monitoring for deployed ADK agents across Cloud Trace, BigQuery, and third-party platforms.

6K 472.6K

View

DevOps & CI/CD

azure-enterprise-infra-planner

Enterprise Azure infrastructure architect generating Bicep or Terraform from workload descriptions.

1.5K 454.3K

View

DevOps & CI/CD

azure-kubernetes

Plan and configure production-ready Azure Kubernetes Service clusters with Day-0 and Day-1 best practices.

1.5K 447.1K

View

DevOps & CI/CD

Raw mechanical interfaces fusing Swiss typographic print with military terminal aesthetics. Rigid grids, extreme type scale contrast, utilitarian color, analog degradation effects. For data-heavy dashboards, portfolios, or editorial sites that need to feel like declassified blueprints.

92.7K 354.9K

View

DevOps & CI/CD

just-scrape

Web search, scraping, extraction, crawling, and monitoring via ScrapeGraph AI CLI.

69 245K

View

DevOps & CI/CD

firebase-hosting-basics

Skill for working with Firebase Hosting (Classic). Use this when you want to deploy static web apps, Single Page Apps (SPAs), or simple microservices. Do NOT use for Firebase App Hosting.

462 159.7K

View

DevOps & CI/CD

firebase-app-hosting-basics

Deploy and manage web apps with Firebase App Hosting. Use this skill when deploying Next.js/Angular apps with backends.

462 159.1K

View

DevOps & CI/CD

deploy-to-vercel

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

31.9K 146.6K

View

DevOps & CI/CD

programmatic-seo

Build SEO-optimized pages at scale using templates, data, and proven playbook patterns.

53.3K 140.1K

View

DevOps & CI/CD

convex-create-component

Design and build isolated, reusable Convex backend components with clear boundaries and app-facing wrappers.

63 123.5K

View

DevOps & CI/CD

vercel-cli-with-tokens

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

31.9K 116.1K

View