Repositorios Git: acceso, grupos y proyectos

Con el complemento de repositorios Git, tu empresa guarda su código en Gantlog: repositorios ordenados en grupos, como en GitLab, que se clonan y reciben push por HTTPS o SSH y que se enlazan con las tareas. Lo que hace cada persona en ellos está en el manual Repositorios Git en Gantlog.

Activar el complemento y dar acceso

El complemento se cobra por persona con acceso: US$ 2 al mes en Equipo y US$ 3 en Empresa (en el pago anual, 10 meses). Sin nadie con acceso no se cobra y en la prueba gratuita está incluido. Para contratarlo, en Configuración → Empresa → Suscripción pulsa Contratar el complemento…; para dejar de pagarlo, Apagar el complemento… (los repositorios y los accesos no se borran). Ahí mismo, Próximo cobro muestra cuánto suma el complemento. Con el complemento activo, en Configuración → Empresa aparece el recuadro Repositorios Git:

• Arriba ves cuántas personas tienen acceso y cuánto ocupan los repositorios.
• Marca a cada persona que usará los repositorios. Sin Acceso a repositorios no ve la opción Repositorios del menú ni la pestaña Código de los proyectos, y no puede clonar, aunque vea el proyecto.

Los repositorios cuentan en el almacenamiento de archivos de la empresa (lo ves en Almacenamiento de archivos).

Grupos y miembros

Los administradores mantienen todo. En Repositorios:

• Nuevo grupo (en Toda la empresa) crea un grupo de primer nivel; dentro de un grupo, Nuevo subgrupo. La ruta del grupo forma parte de la dirección de sus repositorios.
• ⋮ → Miembros abre la lista de miembros del grupo (con buscador; Agregar miembro y el ⋮ de cada fila para cambiar o quitar) y da un rol a una persona en el grupo: Lector (clona y trae), Desarrollador (además hace push) o Mantenedor (además crea, renombra, mueve, archiva y da acceso). El rol vale para todo lo que está dentro; la lista muestra también los heredados de los grupos de arriba («de »).
• ⋮ → Cambiar nombre o ruta, Mover (con todo lo que contiene) o Borrar grupo (solo vacío). Al renombrar o mover, la dirección anterior de cada repositorio sigue funcionando hasta que otro la use.

Nuevo repositorio (arriba en la página) crea uno vacío o lo importa desde GitHub, GitLab, Bitbucket u otro servidor.

En cada repositorio, la sección Ramas permite a sus mantenedores proteger ramas (nadie las borra ni las reescribe y solo los mantenedores hacen push directo; un pull request pide 0, 1 o 2 aprobaciones de otras personas para fusionarse en ellas) y elegir la rama principal, que siempre está protegida.

Los pull requests usan esas aprobaciones: en una rama protegida que pide 1 o 2, cualquier desarrollador fusiona cuando tiene ese número de aprobaciones de otras personas sobre el último commit; en una protegida que no pide ninguna, solo un mantenedor. Para que todo cambio a main pase por revisión, protégela con 1 o 2 aprobaciones. Con Exigir conversaciones resueltas, un pull request hacia esa rama no se fusiona mientras haya conversaciones sin resolver. Los mantenedores pueden cerrar y reabrir cualquier pull request y borrar comentarios.

En la sección Miembros de un repositorio, quien lo mantiene da a una persona un rol mayor que el que hereda del grupo solo en ese repositorio (por ejemplo, Lector en el grupo y Desarrollador o Mantenedor en ese repositorio). El rol del grupo nunca se baja; quitar el rol propio deja el heredado.

Vincular repositorios a un proyecto

En el proyecto, pestaña Código → Vincular repositorio. Lo hace quien administra el proyecto y además mantiene el repositorio. Un proyecto puede usar varios repositorios y un repositorio, varios proyectos.

Mientras el proyecto está abierto, su equipo puede hacer push a sus repositorios vinculados y quien solo ve el proyecto puede clonarlos. Al cerrarse el proyecto, cada persona vuelve al rol que tenga en el grupo. Eliminar un proyecto solo quita sus vínculos: los repositorios siguen.

Papelera, exportación y borrado

• Un repositorio enviado a la papelera se borra para siempre a los 30 días; mientras tanto, quien lo mantiene lo restaura desde Papelera.
• La exportación de la empresa (Empresa → Tus datos) incluye cada repositorio como un archivo .bundle.
• Borrar la empresa borra también sus repositorios y las llaves SSH de sus personas.