Phabricator/Bots/nl

Phabricator bots zijn gebruikers in Phabricator waarvan de acties geautomatiseerd zijn of een gevolg zijn van acties van meerdere gebruikers. Meer upstream documentatie.

Phabricator bots zijn vergelijkbaar met MediaWiki bots, het meeste van het algemene Wikimedia bot beleid is voor hen relevant.

Bekijk de lijst met de in phabricator.wikimedia.org geregistreerde bots.

Scheiden botaccounts van persoonlijke accounts

Een persoonlijk gebruikersaccount is niet geschikt voor herhaalde activiteitspatronen, bij mensen denkt men dan in het algemeen dat het spam is of op zijn best dat het echt persoonlijk moet blijven. Activiteiten van een bepaald account die spam lijken te zijn, kan er voor zorgen dat het account uitgeschakeld of verwijderd wordt. Al in die gevallen het uitvoerende account ook het persoonlijke gebruikersaccount is, dan kan de gebruiker die situatie niet meer uitleggen of zich verweren.

Een bot aanvragen

Anders dan normale Phabricator accounts, die gebonden zijn aan een Wikimedia SUL of LDAP account worden bot accounts alleen in Phabricator aangemaakt. Als u een bot account wilt hebben, maak dan een taak aan in het Phabricator-Bot-Requests project met de volgende gegevens:

• Naam
• Doel
• Een e-mailadres (dat ongeldig kan zijn, maar wel uniek moet zijn)
• Verantwoordelijke gebruiker of organisatie

Phabricator beheerders: Uit te voeren stappen

Stappen voor Phabricator beheerders om een bot account aan te maken:

• Maak de bot gebruiker aan
• Voeg voor de openbaarheid de eigenaar toe aan de beschrijving van het bot account
• Ga naar "Manage", "Edit Settings", "Conduit API Tokens". Klik daar op "Generate Token". Kopieer dat token.
• Maak een paste aan die dat token bevat en zet "View policy" op de persoonlijke eigenaar en uzelf
• Kopieer de link in het taakverzoek voor het aanmaken en vraag de persoonlijke eigenaar (de aanvrager van het bot account) om de taak te sluiten als het bot-account als verwacht werkt

Bot accounthouders: Uit te voeren stappen

Om het bot account te kunnen gebruiken dient arc te worden geconfigureerd.

• Verkrijg een account certificaat voor uw bot
• maak een configuratie-bestand voor arc aan, vervang "<your bot account id>" en "<your bot certificate>" met de toegekende waarden.

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

• Sla het bestand op. De locatie waar arc zoekt is ".arcrc" in uw thuismap (~/.arcrc op Linux en Mac), maar als u al een arcrc bestand op de computer heeft, dan kunt u de locatie instellen. In dit voorbeeld gebruiken we "bot.arcrc" in de huidige werkmap.
• Voer even een test uit:

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

U zou nou als resultaat een korte samenvatting van een enkele taak in Maniphest moeten zien.