Automerging con Mergify

Configuración de Mergify

Pasos para configurar Mergify

1. Inicia sesión en https://dashboard.mergify.com/.
2. Haz click en Enable Mergify on a new account o ve a https://github.com/apps/mergify/installations/new
3. GitHub ahora te ofrecerá seleccionar los repositorios a los que quieres dar acceso a Mergify. Selecciona el repositorio que gustes, o todos si lo deseas.
   
   
4. Serás redirigido al dashboard.

Archivo de configuración

1. Crea una configuracion de Mergify en cada repositorio en el que quieres usar Mergify.
2. Debería crearse el archivo de configuración en el directorio raíz del repositorio y nombrarse o .mergify.yml o .mergify/config.yml o .github/mergify.yml.
3. Como el nombre del archivo lo dice, el formato del archivo de configuración se basa en YAML.

Las reglas del archivo de configuración

• El archivo de configuración se compone de una clave principal llamada pull_request_rules que contiene una lista de reglas.

• Un name que describe lo que la regla hace. No es interpretada por Mergify y puede ser cualquier cosa que te guste y que te ayude a identificar la regla.
• Una lista de conditions. Todas las condiciones deben coincidir con la regla a aplicarse.
• Una lista de actions. Cada acción se aplicará tan pronto como la pull request coinicida con las condiciones.

Creando la primera regla

• El nombre de la regla no se usa directamente por Mergify, pero es realmente útil cuando Merigify reporta su status y para reglas de depuración.
• Conditions define la lista de condiciones que una pull request debe cumplir con el fin de que el motor ejecute las acciones configuradas. En este ejemplo, hay sólo una condición por cumplirse para que la regla sea aplicada a una pull request. Approved-reviews-by variable contiene la lista de colaboradores que aprobaron la pull request y en este caso, la variable debe contener al menos 1 miembro (nótese que el operador length # es usado aquí).
• Action es para realizar el merge para la pull request. Se activa especificando la acción de merge con un parámetro de método que contiene el método de merge a usarse.

Creando el archivo de configuración

1. Ve a tu dashboard de Mergify y escoge el editor de config para tu organización.
2. Entonces, selecciona un repositorio donde activaste Mergify.
   
   
3. Si tu repositorio tiene pull requests existentes, puedes probar tu configuración a aquellas escribiendo un numero de pull request en el formulario arriba.
4. Cuando esté hecha, haz click en el botón Create a pull request with this configuration.
5. Una nueva pull request será creada en tu repositorio con la nueva configuración de Mergify.
6. Puedes hacerles merge haciendo click en el botón merge



7. Una vez realizada la merge, Mergify se la aplicará a todos tus pull requests.

Entendiendo el reporte de revisión de Mergify