Integrace RichPear Home

GitLab-CI

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

Doména: gitlab_ci
Kategorie: senzory
Komunikace: cloud-polling
Kvalita: legacy

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 Konfigurační soubory a následná kontrola v Nastavení → Zařízení a služby, vyhledejte GitLab-CI a projděte průvodce nastavením.

Dokumentace integrace zmiňuje YAML nebo ruční konfiguraci. V RichPear Home proto počítejte s kontrolou konfigurace a restartem služby, pokud průvodce není dostupný.

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.

Projekt a token

GitLab-CI sleduje stav pipeline pro vybraný projekt. Připravte URL GitLabu, ID nebo cestu projektu a token s oprávněním číst pipeline.

U self-hosted GitLabu ověřte certifikát a dostupnost z RichPear Home. Pokud server používá interní doménu, musí ji systém umět přeložit.

Senzory pipeline

Po přidání zkontrolujte stav posledního běhu, branch a případné atributy s odkazem na pipeline. Senzor používejte pro upozornění při pádu buildů nebo dlouhodobě běžící pipeline.

Automatizace nastavte tak, aby neposílala zprávu při každém přechodném stavu. Vhodnější je čekat na finální stav failed, success nebo canceled.

Provozní kontrola

Pokud používáte chráněné větve nebo self-hosted runner, přidejte do panelu i stav runnerů mimo tuto integraci. Stav pipeline sám neřekne, zda problém vznikl v kódu, runneru nebo přístupu k repozitáři.