Integrace RichPear Home
Cloudflare R2
Cloudflare R2 přidá cílové úložiště pro zálohy RichPear Home. Zálohy se ukládají do připraveného R2 bucketu přes S3 kompatibilní endpoint.
- Doména
cloudflare_r2- Kategorie
- zálohy
- Komunikace
- cloudové události
- Nastavení
- průvodce v rozhraní
- Úložiště
- S3 kompatibilní R2 bucket
Co integrace přidá
Integrace slouží jako zálohovací cíl. Umí nahrát zálohu do bucketu, zapsat k ní metadata, vypsat dostupné zálohy, stáhnout je zpět a odstranit je z úložiště.
Pro připojení potřebujete existující R2 bucket, Access Key ID, Secret Access Key, S3 endpoint a oprávnění pro čtení i zápis objektů do vybraného bucketu.
Volitelně lze nastavit prefix složky uvnitř bucketu, například backups/richpear-home. Prefix se používá bez úvodního a koncového lomítka.
Kontrolní témata
- Existující R2 bucket
- Klíč omezený na konkrétní bucket
- Správný S3 endpoint
- Ověřené nahrání i obnovení zálohy
Příprava před přidáním
V Cloudflare účtu vytvořte R2 bucket s jedinečným názvem. Pro běžné zálohy stačí standardní třída úložiště, pokud nemáte výslovný důvod volit jinou.
V části správy API tokenů vytvořte uživatelský API token pro R2. Povolte čtení a zápis objektů a token omezte pouze na bucket určený pro zálohy RichPear Home.
Uložte si Access Key ID, Secret Access Key, název bucketu a S3 endpoint. Secret Access Key se po vytvoření chová jako citlivý údaj, neukládejte ho do veřejných poznámek ani screenshotů.
RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.
Nastavení v RichPear Home
Otevřete http://rphome.local:8123, přejděte na Nastavení → Zařízení a služby → Přidat integraci, vyhledejte Cloudflare R2 a spusťte průvodce.
Vyplňte Access key ID, Secret access key, Bucket name, Endpoint URL a případně Folder prefix. Bucket musí už existovat a zadaný klíč do něj musí umět zapisovat.
Průvodce kontroluje endpoint, název bucketu a přístupové údaje. Pokud validace neprojde, opravte údaje v Cloudflare účtu nebo endpointu a průvodce opakujte.
Kontrola entit a funkcí
Po nastavení vytvořte ruční zálohu a ověřte, že se v R2 bucketu objeví soubor zálohy i odpovídající metadata. U prefixu zkontrolujte, že jsou objekty uložené ve správné cestě.
Potom v RichPear Home ověřte, že je záloha v seznamu vzdálených záloh dostupná ke stažení. U kritických instalací proveďte test obnovy na odděleném testovacím prostředí.
Po nastavení
- Ověřte úspěšné nahrání nové zálohy.
- Zkontrolujte metadata zálohy v bucketu.
- Vyzkoušejte stažení vybrané zálohy.
- Uložte bezpečný postup rotace přístupového klíče.
Použití v automatizacích
Automatizace stavte kolem samotného zálohovacího procesu: pravidelná tvorba záloh, oznámení po neúspěchu a kontrola, že poslední záloha není starší než provozní limit.
Než nastavíte mazání starých záloh, ověřte, že retenční pravidla odpovídají požadavkům domácnosti nebo provozovny. Mazání testujte nejdřív na nedůležité záloze.
Provoz a údržba
Po změně bucketu, endpointu, prefixu nebo přístupového klíče znovu vytvořte ruční zálohu a ověřte její stažení. Změna jen v Cloudflare účtu bez kontroly v RichPear Home nestačí.
Pravidelně kontrolujte obsazené místo, náklady na úložiště a platnost přístupových údajů. Pokud klíč rotujete, nejdřív nastavte nový a až po ověření smažte starý.
Řešení problémů
Když se nastavení neuloží, zkontrolujte formát endpointu, název bucketu, oprávnění klíče a to, zda endpoint patří k R2. Chybný název bucketu nebo endpoint se obvykle projeví už při průvodci.
Když selhává až zálohování, ověřte práva pro zápis a čtení objektů, nastavený prefix, dostupnost služby a logy v Nastavení → Systém → Logy podle domény cloudflare_r2.