Integrace RichPear Home

GitHub

GitHub dodává stavy a měření. Nejprve ověřte aktualizaci hodnot a teprve potom je použijte v automatizacích.

Doména: github
Kategorie: senzory
Komunikace: cloud-polling
Kvalita: Není uvedeno

Připravte přístup a síť

Před přidáním integrace si připravte účet, IP adresu, token, párovací režim nebo API klíč podle typu zařízení. U lokálních zařízení ověřte, že jsou ve stejné síti jako RichPear Home.

U této integrace počítejte hlavně s: cloudový účet, token nebo API přístup, třídu komunikace cloud-polling.

Lokální adresa

Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123.

Přidejte integraci v RichPear Home

Otevřete Nastavení → Zařízení a služby → Přidat integraci, vyhledejte GitHub a projděte průvodce nastavením.

Dokumentace integrace podporuje přidání přes integrační průvodce. V RichPear Home proto začněte vyhledáním integrace v nastavení.

Pokud integrace vyžaduje cloudový účet, používejte samostatný servisní účet, kde to dává smysl. U zařízení v domácí síti nejdřív ověřte pevnou IP adresu nebo spolehlivé mDNS jméno.

Zkontrolujte entity, funkce a akce

Po dokončení nastavení otevřete detail integrace, zkontrolujte vytvořená zařízení a entity a přiřaďte je do správných oblastí.

Pokud integrace vytvoří akce nebo služby, otestujte je nejdřív ručně a teprve potom je použijte v automatizaci.

Token a repozitáře

Pro GitHub připravte osobní přístupový token s minimálním rozsahem oprávnění. Pro veřejné repozitáře není potřeba dávat tokenu přístup k soukromému kódu.

V průvodci nastavte sledované repozitáře a po přidání zkontrolujte vytvořené senzory. Typicky sledujete stav posledních workflow běhů, otevřené issues nebo další metriky podle konfigurace.

Automatizace vývoje

Senzory GitHubu používejte pro upozornění na neúspěšný build, novou release nebo změnu stavu projektu. Notifikace směrujte jen správcům, kteří s projektem pracují.

Po odebrání autorizace nebo změně tokenu zkontrolujte integraci v RichPear Home. Neplatný token se projeví chybami aktualizace a zastavením senzorů.

Provozní kontrola

Při použití v provozu nastavte notifikace jen pro repozitáře a větve, které opravdu sledujete. U monorepa může každá drobná změna spustit mnoho workflow běhů a bez filtru rychle zahltit správce.