Phabricator/Roboti

Phabricator roboti jsou uživatelé ve Phabricatoru, pro které jsou akce automatizované nebo jsou důsledkem akcí více uživatelů. Více informací naleznete v dokumentaci k upstreamu.

Roboti Phabricatoru jsou podobní robotům MediaWiki a velká část obecných zásad pro roboty Wikimedie se jich týká.

Podívejte se na seznam robotů registrovaných na phabricator.wikimedia.org.

Oddělení robotických účtů od osobních účtů

Osobní uživatelský účet není vhodný pro opakující se vzorce aktivit, protože v lidském případě by byly téměř univerzálně považovány za spam nebo by v nejlepším případě byly uzamčeny k něčímu osobnímu účtu. Aktivita pocházející z konkrétního účtu, která se jeví jako spam, může vyžadovat deaktivaci nebo smazání daného účtu. V těchto případech, pokud je problematický účet zároveň osobním účtem uživatele, nebude se moci odvolat ani situaci vysvětlit.

Získání robota

Na rozdíl od běžných účtů Phabricator, které jsou propojeny s účtem Wikimedia SUL nebo LDAP, se účty robotů vytvářejí nativně ve Phabricatoru. Chcete-li požádat o účet robota, prosím, vytvořte úkol v rámci projektu Phabricator-Bot-Requests s následujícími údaji:

• Název
• Účel
• E-mailová adresa (která může být neplatná, ale musí být jedinečná)
• Odpovědný uživatel nebo organizace

Administrátoři Phabricatoru: Postup

Kroky pro administrátory Phabricatoru k vytvoření takového účtu:

• Vytvořit uživatele robota
• Pro účely transparentnosti přidejte do popisu účtu robota lidského vlastníka.
• Přejděte do sekce "Manage" (spravovat), poté do sekce "Edit Settings" (upravit nastavení), poté do sekce "Conduit API Tokens" (tokeny rozhraní Conduit API) a klikněte na tlačítko "Generate Token" (generovat token). Zkopírujte token.
• Vytvořit vložený soubor obsahující daný token a nastavit "Zásady zobrazení" na lidského vlastníka a sebe
• Vložte odkaz do úkolu s požadavkem na vytvoření a požádejte vlastníka o uzavření úkolu, jakmile bude fungovat podle očekávání.

Držitelé robotických účtů: Postup

Toto jsou kroky pro konfiguraci ARC pro použití vašeho účtu robota.

• Získejte certifikát účtu pro svého robota
• Vytvořte konfigurační soubor ARC odpovídající následujícímu a nahraďte hodnoty "<vaše ID účtu bota>" a "<váš certifikát robota>“.

 {
   "config": {
     "default": "https:\/\/phabricator.wikimedia.org\/"
   },
   "hosts": {
     "https:\/\/phabricator.wikimedia.org\/api\/": {
       "token": "api-token_which_starts_with_api"
     }
   }
 }

• Uložte si někam tento soubor. Výchozí umístění arc ve vašem domovském adresáři vypadá jako ".arcrc" (~/.arcrc v Linuxu a Macu), ale pokud již máte soubor arcrc na počítači, na kterém testujete, můžete jej raději uložit jinam. Pro účely tohoto příkladu použijeme v aktuálním pracovním adresáři "bot.arcrc".
• Spusťte následující příkaz jako test:

 $ arc tasks --unassigned --limit 1 --arcrc-file bot.arcrc

Toto by mělo vrátit krátké shrnutí jednoho úkolu z Manifestu.