Come pubblicare i Fedora Badges

Il demone back-end che assegna i badge, fedbadges, si attiva quando riceve un evento fedmsg. Confronta il messaggio e la cronologia in datanommer con una serie di regole. Se un contributore corrisponde ai criteri descritti in una di queste regole, gli viene assegnato un badge.

Il front-end è un’applicazione web chiamata Tahrir. Si tratta per lo più di un’interfaccia che permette agli utenti di guardare i loro badge. Tuttavia, dispone anche di un’interfaccia di amministrazione per aggiungere manualmente nuovi badge, assegnare badge e creare "inviti" (codici QR) per i badge.

Il demone del back-end che assegna i badge, fedbadges, viene eseguito sul nodo badges-backend01. Il processo è fedmsg-hub e i log sono in /var/log/fedmsg/fedmsg-hub.log.

Il front-end viene eseguito sotto apache/mod_wsgi sui nodi badges-web0{1,2}.

La pubblicazione dei badge consiste in due operazioni:

Chiunque abbia i permessi di scrittura su fedora-badges può inserire i badge. Si possono usare anche le richieste di pull. Solo i membri del gruppo FAS sysadmin-badges e amministratori dell’interfaccia web possono aggiungere badge.

Gli artisti dei badge e gli sviluppatori di badge dovrebbero inviare le risorse del design (arte png e svg) e le regole (yaml) al repository fedora-badges.

Per eseguire questa operazione, è necessario far parte del gruppo FAS sysadmin-badges.

C’è uno script installato su badges-backend01 in /usr/local/bin/award-badge. Ha delle opzioni di aiuto che possono essere richiamate con award-badge -h. Richiede l’opzione --user FAS_USERNAME e l’opzione --badge BADGE_ID. Per esempio, la seguente invocazione assegnerà il badge "Associate Editor" a "ralph":

Il BADGE_ID di un badge può essere trovato visitando la sua pagina sull’interfaccia web. Il badge si trova all’indirizzo https://badges.fedoraproject.org/badge/associate-editor.

Lo script award-badge e il codice sorgente sono gestiti da ansible.git. Il codice sorgente si trova in roles/badges/backend/files/award-badge.

Spesso c’è bisogno di un flusso di lavoro per assegnare in batch un badge a un certo numero di persone. Per esempio, il badge Keepin' Fedora Beautiful è il risultato dell’invio di un ticket da parte di un membro del Design Team con un elenco di nomi utente FAS (ad esempio fedora-badges#129).

For cases, like that you can wget the file with the list of FAS usernames on badges-backend01 and run something like:

È possibile revocare le autorizzazioni per badge o badge in modo simile allo script award-badges. È possibile concatenare l’invocazione dello script revoke-badge o revoke-authorization nello stesso modo dello script award-badges.

Sarebbe bello poter concedere automaticamente l’accesso come amministratore nell’interfaccia web ai membri del gruppo FAS sysadmin-badges. Attualmente non disponiamo di questa funzione e dobbiamo gestire separatamente l’elenco degli amministratori dell’interfaccia web.

Il file di configurazione per la web app front-end dei badge è gestito da ansible.git. Il codice sorgente si trova in roles/badges/frontend/templates/tahrir.ini.

In questo file, trovare l’opzione tahrir.admin. Si tratta di un elenco separato da virgole d’indirizzi e-mail ai quali, una volta effettuato il login, devono essere concessi i diritti d’accesso ai pannelli di amministrazione di badges.fedoraproject.org.

Per aggiungere un nuovo amministratore, aggiungere la sua email FAS_USERNAME@fedoraproject.org a questa riga, eseguire il commit e il push. Usare Ansible per eseguire il playbook groups/badges-web.yml per pubblicare la modifica della configurazione ai nodi web front-end.

La procedura viene eseguita attraverso il pannello di amministrazione dell’interfaccia web (anche se probabilmente si può scrivere uno script da utilizzare sul nodo di back-end).

Gli inviti e i codici QR sono tipicamente creati per gli eventi Fedora. Ad esempio, in occasione della conferenza Flock 2013 Fedora Contributors, abbiamo creato un badge per premiare i partecipanti. È stata seguita la procedura seguente per generare un invito e un codice QR. Successivamente, il codice QR è stato distribuito agli organizzatori della conferenza. Questi hanno aggiunto il codice QR alla brochure del programma che è stata consegnata a ogni partecipante. Quindi, ogni partecipante che ha scansionato il codice è stato reindirizzato sul proprio telefono all’app Badge, dove ha ottenuto il badge.

See ansible/roles/badges/backend/files/ for the motherload. These all get deployed to /usr/local/bin/ on badges-backend01 where you can login to execute them.