English Spanish
The `award-badge` script and source code is managed by ansible.git. The source code is in https://pagure.io/fedora-infra/ansible/blob/master/f/roles/badges/backend/files/award-badge[roles/badges/backend/files/award-badge]. El script `award-badge` y el código fuente están gestionados por ansible.git. El código fuente está en https://pagure..io/fedora-infra/ansible/blob/master/f/roles/badges/backend/files/award-badge[roles/badges/backend/files/award-badge].
The badge-awarding back-end daemon, https://github.com/fedora-infra/fedbadges[fedbadges], runs on the `badges-backend01` node. The process is `fedmsg-hub` and logs are in `/var/log/fedmsg/fedmsg-hub.log`. El demonio que otorga insignias, https://github.com/fedora-infra/fedbadges[fedbadges], corre sobre el nodo `badges-backend01`. El proceso es `fedmsg-hub` y los registros están en `/var/log/fedmsg/fedmsg-hub.log`.
The badge-awarding back-end daemon, https://github.com/fedora-infra/fedbadges[fedbadges], wakes up when it receives a https://fedmsg.readthedocs.io[fedmsg] event. It compares that message and the history in https://github.com/fedora-infra/datanommer[datanommer] against a series of rules. If a contributor matches the criteria described in one of those rules, then they are awarded a badge. El demonio de punto final que otorga insignias, https://github.com/fedora-infra/fedbadges[fedbadges], despierta cuando recibe un evento https://fedmsg.readthedocs.io[fedmsg]. Compara ese mensaje y el histórico de https://github.com/fedora-infra/datanommer[datanommer] con una serie de reglas. Si un contribuyente cumple con los criterios descritos en una de esas reglas, se le premia con una insignia.
The `BADGE_ID` for a badge can be found by visiting its page on the web UI. That badge can be found at `https://badges.fedoraproject.org/badge/associate-editor`. La `BADGE_ID` para una insignia se puede encontrar visitando su pagina en la web UI. Esta insignia se puede encontrar en `https://badges.fedoraproject.org/badge/associate-editor`.
The badge is now created. You should be able to find in the https://badges.fedoraproject.org/explore/badges[badges index]. La insignia se ha creado. Debería ser capaz de encontrarla en el https://badges.fedoraproject.org/explore/badges[índice de insignias].
The configuration file for the badges front-end web app is managed by ansible.git. The source code is in https://pagure.io/fedora-infra/ansible/blob/master/f/roles/badges/frontend/templates/tahrir.ini[roles/badges/frontend/templates/tahrir.ini]. El fichero de configuración para la aplicación web de insignias es manejada por ansible.git. El código fuente está en https://pagure.io/fedorainfra/ansible/blob/master/f/roles/badges/frontend/templates/tahrir.ini[roles/badges/frontend/templates/tahrir.ini].
The front-end is a web application called https://github.com/fedora-infra/tahrir[Tahrir]. It mostly is just an interface for users to look at their badges. However, it also has an admin interface for manually adding new badges, awarding badges, and creating "invitations" (QR codes) for badges. La interfaz es una aplicación web llamada https://github.com/fedora-infra/tahrir[Tahrir]. Principalmente es soo una interfaz para que los usuarios vean sus insignias. Sin embargo, también tiene una interfaz de administración para el añadido manual de nuevas insignias, la concesión de insignias y la creación de "invitaciones" (códigos QR) para las insignias.
The front-end runs under `apache/mod_wsgi` on `badges-web0{1,2}` nodes. La interfaz corre bajo `apache/mod_wsgi` sobre nodos `badges-web0{1,2}`.
There is a script installed on `badges-backend01` in `/usr/local/bin/award-badge`. It has help options that you can pull up with `award-badge -h`. It takes a required `--user FAS_USERNAME` and a required `--badge BADGE_ID` option. For example, the following invocation would award the "Associate Editor" badge to "ralph": Este es un script instalado sobre `badges-backend01` en `/usr/local/bin/award-badge`. Tiene opciones de ayuda que puede ver con `award-badge -h`. Toma una opción `--user FAS_USERNAME` requerida y una opción `--badge BADGE_ID` también requerida. Por ejemplo, la siguiente invocación otorgará la insignia "Associate Editor" a "ralph":
This is done through the admin panel of the web interface (although we can probably write a script for it to be used on the back-end node). Esto se hace a través del panel de administración de la interfaz web (a pesar de que probablemente podamos escribir un script para ser usado en el nodo back-end).
To add a new admin, add their `FAS_USERNAME@fedoraproject.org` email to that line, commit, and push. Use Ansible to run the `groups/badges-web.yml` playbook to push the config change out to the web front-end nodes. Para añadir un nuevo administrador, añada su correo electrónico `FAS_USERNAME@fedoraproject.org` en esa línea, confirme y envíe. Use Ansible para ejecutar el libro de jugadas `groups/badges-web.yml` para enviar el cambio de configuración a los nodos web.
To add multiple users, repeat this process for each user. Para añadir múltiples usuarios, repita este proceso por cada usuario.
To perform this, you must be in the `sysadmin-badges` FAS group. Para llevar a cabo esto, debe estar en grupo FAS `sysadmin-badges`.
Under the _Invitations_ section, add this information: Bajo la sección _Invitations_, añada esta información:
Update the description and the criteria link for a badge. Useful in the event you created it incorrectly, or if feedback from other stakeholders requires us to change something. Actualiza la descripción y el criterio de enlace para una insignia. Útil en el caso de que lo haya creado incorrectamente o si los comentarios de otras partes interesadas nos lleven a cambiar algo.
Upstream documentation Documentación
Useful scripts for manual work Scipts útiles para trabajo manual
You may revoke badge or badge authorizations in a similar fashion to the `award-badges` script. You may chain the invocation of the `revoke-badge` or `revoke-authorization` script in the same manner as the `award-badges` script. Puede revocar una insignia o autorizaciones insignias de modo similar al script `award-badges`. Puede encadenar la invocación del script `revoke-badge` o `revoke-authorization` de la misma manera que el script `award-badges`.