Phabricator/Robots

Les robots dans Phabricator sont des utilisateurs de Phabricator pour lesquels les actions sont automatisées ou résultent d'actions de plusieurs utilisateurs. Voir la documentation amont pour plus d'informations.

Les robots de Phabricator sont semblables aux robots MediaWiki, et la majorité des règles des robots Wikimedia leur est applicable.

Voir la liste des robots enregistrés dans phabricator.wikimedia.org.

Séparer les comptes des robots des comptes personnels

Un compte d'utilisateur personnel n'est pas approprié pour des modèles d'activité répétitifs, car dans le cas humain, ils seraient presque universellement considérés comme du spam, ou au mieux seront bloqués comme compte d'une personne. L'activité qui émane d'un compte spécifique semblant envoyer des pourriels peut nécessiter de désactiver ou de supprimer le compte. Dans ces cas, si le compte perturbateur correspond au compte personnel d'un utilisateur, celui-ci ne pourra pas faire appel ni expliquer la situation.

Posséder un robot

Contrairement aux comptes Phabricator réguliers, qui sont liés à un compte Wikimedia SUL ou LDAP, les comptes des robots sont créés nativement dans Phabricator. Pour demander un compte de robot, veuilez créer une tâche dans le projet Phabricator-Bot-Requests avec les détails suivants :

• Nom
• Rôle
• Une adresse courriel (qui peut être non valide mais doit rester unique)
• Utilisateur ou organisation responsable

Administrateurs de Phabricator : étapes à réaliser

Il faut être administrateur dans Phabricator. Etapes pour créer de tels comptes :

• créer l'utilisateur du robot
• par mesure de transparence, ajoutez un propriétaire humain à la description du compte du robot
• Allez sur Manage > Edit Settings > Conduit API Tokens > Generate Token pour générer le jeton Copiez ce jeton.
• créer un objet paste contenant ce jeton et configurer View policy pour le propriétaire humain et pour vous-même
• coller le lien dans la tâche de demande de création et demander au propriétaire humain de fermer la tâche une fois qu'elle fonctionne comme prévu

Propriétaires de comptes robots : étapes à réaliser

Voici les étapes pour configurer arc afin qu'il puisse utiliser votre compte de robot.

• Acquérir le certificat du compte pour votre robot
• Créer un fichier de configuration arc correspondant aux éléments suivants, en remplaçant <your bot account id> et <your bot certificate> par les valeurs appropriées.

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

• Enregistrer ce fichier. L'emplacement par défaut du fichier arc de localisation est .arcrc dans votre répertoire home (~/.arcrc sur Linux et Mac), mais si vous avez déjà un fichier arcrc sur la machine avec laquelle vous testez, vous pouvez préférer le sauvegarder ailleurs. Pour les objectifs de cet exemple, on utilise bot.arcrc dans le répertoire de travail actuel.
• Exécutez la commande suivante en tant que test :

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

Ceci doit renvoyer un court résumé d'une tâche unique de Maniphest.