Integrace RichPear Home
Digital Ocean
Digital Ocean zpřístupňuje informace o dropletech přes API token a umožňuje je sledovat jako binární senzory nebo ovládat jako spínače.
- Doména
digital_ocean- Kategorie
- binární senzor, spínač, systémový monitoring
- Komunikace
- cloudové dotazování přes API
- Nastavení
- YAML
- Stav screenshotů
- čeká na reálný API token a droplet
Ukázka v RichPear Home
Screenshoty ukazují české rozhraní RichPear Home při vyhledání integrace a při prvním bezpečném kroku nastavení.
Co umí
Integrace nejdřív nastaví hub s API tokenem. Nad tím lze přidat binární senzory pro sledování dropletů a spínače pro start nebo stop vybraných dropletů.
Je určená pro konkrétní názvy dropletů uvedené v konfiguraci. Nejde o obecnou správu celého účtu ani všech funkcí cloudové platformy.
Příprava
RichPear Home v místní síti otevřete na http://rphome.local:8123. Pokud místní název v dané síti neodpoví, použijte http://IP-ADRESA:8123.
V účtu Digital Ocean vytvořte API access token a připravte přesné názvy dropletů, které chcete sledovat nebo ovládat. Token držte jako citlivý údaj a nedávejte mu širší použití, než potřebujete.
Nastavení
Tato integrace se nastavuje ručně v konfiguraci. Po úpravě YAML ověřte syntaxi, restartujte systém a až potom kontrolujte vytvořené entity.
digital_ocean:
access_token: YOUR_API_KEY
binary_sensor:
- platform: digital_ocean
droplets:
- "fedora-512mb-nyc3-01"
switch:
- platform: digital_ocean
droplets:
- "fedora-512mb-nyc3-01"Položka access_token je povinná. U binárního senzoru i spínače nastavte seznam dropletů, se kterými má RichPear Home pracovat.
Kontrola
Po restartu ověřte, že se vytvořily binární senzory a spínače pro uvedené droplety. Porovnejte názvy a stav proti dashboardu cloudové služby.
U spínače nejdřív testujte na dropletu, kde krátké vypnutí nezpůsobí škodu. Start a stop cloudového serveru může mít provozní dopad.
Automatizace
Binární senzory použijte pro dohled dostupnosti nebo upozornění na stav dropletu. Spínače používejte opatrně pro plánované zapnutí nebo vypnutí testovacích serverů.
Pro produkční servery přidejte víc podmínek a potvrzení. Automatizace nesmí omylem vypnout službu, kterou někdo používá.
Provoz
Při rotaci API tokenu aktualizujte konfiguraci a restartujte systém. Po přejmenování dropletu upravte také seznam v YAML.
Přístupový token neukládejte do veřejných repozitářů ani ho neposílejte v diagnostice bez kontroly.
Řešení problémů
Když entity nevzniknou, ověřte token, názvy dropletů a oprávnění API. Názvy v YAML musí odpovídat skutečným názvům v účtu.
Pokud spínač nereaguje, ověřte, zda token dovoluje ovládání dropletu a zda cloudová služba hlásí chybu nebo probíhající operaci.