Shell Command

Příprava

Připravte přesný příkaz, pracovní prostředí, oprávnění a očekávaný čas běhu. Názvy příkazů pište malými písmeny a používejte podtržítka.

Před přidáním integrace si připravte názvy místností, zařízení a účel použití. Pokud jde o zařízení, které něco fyzicky ovládá, nejdřív ověřte ruční ovládání mimo automatizace.

Nastavení v RichPear Home

Příkazy se definují ručně v konfiguraci. Po změně konfigurace ověřte spuštění na neškodném příkladu a zkontrolujte případnou odpověď.

Tahle integrace vyžaduje ruční konfiguraci. Po úpravě konfigurace vždy proveďte kontrolu nastavení a až potom restart nebo znovunačtení příslušné části systému.

Po prvním přidání otevřete detail integrace a projděte dostupné volby. Zaměřte se na intervaly, povolené entity, režimy a limity služby.

Entity a funkce

Příkaz lze volat ze skriptu nebo automatizace. Proces má omezený čas běhu a nemá sloužit pro dlouhé úlohy bez kontroly.

Podle typu integrace očekávejte hlavně tyto entity nebo funkce: automatizace. Skutečný seznam závisí na modelu zařízení, oprávnění účtu a dostupnosti služby.

Každou důležitou entitu pojmenujte podle skutečné místnosti nebo účelu. Pomůže to při pozdějším ladění automatizací i při běžném používání dashboardu.

Provoz a automatizace

Do příkazů neposílejte neověřený vstup od uživatele. U příkazů přes SSH používejte samostatný klíč s omezenými právy a jasnou cílovou akcí.

Hodnoty sledujte alespoň jeden běžný provozní cyklus, aby bylo jasné, jak rychle se mění a kdy mohou být dočasně nedostupné.

U akcí, které ovlivňují zařízení, nejdřív proveďte ruční test. Do automatizace přidejte podmínku dostupnosti entity a rozumnou prodlevu, aby krátký výpadek nezpůsobil chybnou reakci.

Řešení potíží

Když příkaz selže, ověřte cestu k programu, oprávnění, proměnné prostředí a výstup chyby. Příkaz nejdřív spusťte ručně pod stejným uživatelem.

Při potížích projděte podporovaný model, přístupové údaje, síť, oprávnění a známá omezení služby nebo zařízení.

Pokud integrace používá účet nebo vzdálenou službu, ověřte také stav účtu a limity služby. Pokud používá lokální komunikaci, začněte IP adresou, portem, dosahem a firewallem.

Kontrola po nasazení

Po nastavení integrace Shell Command sledujte alespoň jeden běžný provozní cyklus. U cloudových služeb počítejte se zpožděním, u lokálních zařízení ověřte chování po restartu routeru, zařízení i RichPear Home.

Do automatizací vkládejte jen hodnoty, které jste viděli v reálném provozu. Důležité akce doplňte podmínkou dostupnosti entity, režimem domácnosti a ruční možností zásahu.

Před předáním běžným uživatelům ověřte názvy entit, práva uživatelů a chování při nedostupnosti služby. U zařízení, která něco fyzicky spínají nebo řídí, ponechte dostupné i ruční ovládání mimo RichPear Home.