Repositorios Git en Gantlog

Si tu empresa tiene el complemento de repositorios Git y un administrador te dio Acceso a repositorios, en el menú aparece Repositorios. Ahí ves los repositorios a los que tienes acceso, ordenados en grupos como en GitLab. Cada proyecto muestra los suyos en la pestaña Código.

Qué puedes hacer en cada repositorio

Depende de tu rol en el grupo del repositorio o en sus grupos de arriba:

• Lector: clonar, traer cambios y comentar en los pull requests.
• Desarrollador: además, hacer push, abrir pull requests y revisarlos.
• Mantenedor: además, crear subgrupos y repositorios, renombrar, mover, archivar, enviar a la papelera (se borra a los 30 días; mientras tanto se restaura) y dar acceso.

Quien mantiene un repositorio puede darte en él un rol mayor que el del grupo (sección Miembros del repositorio): por ejemplo, Lector en el grupo y Desarrollador solo en ese repositorio. Nunca te baja el rol del grupo. Si estás en el equipo de un proyecto abierto que usa el repositorio, eres desarrollador en él. Si solo ves ese proyecto, eres lector. Al cerrarse el proyecto vuelves al rol que tengas en el grupo.

Crear un repositorio

Si mantienes algún grupo, arriba en Repositorios está Nuevo repositorio:

1. Deja Vacío, elige el Grupo y escribe el nombre (letras, números, punto, guion o guion bajo, sin espacios). Debajo ves la ruta que tendrá, por ejemplo cliente-x/erp/api.
2. Pulsa Crear repositorio. El repositorio vacío muestra los comandos para subir tu primer commit.

Importar un repositorio

Si tu código ya está en GitHub, GitLab, Bitbucket u otro servidor Git, tráelo con todas sus ramas y etiquetas:

1. Nuevo repositorio (arriba en Repositorios; aparece si mantienes algún grupo) → Importar desde una URL, y elige el grupo.
2. Pega la dirección https del repositorio (por ejemplo, https://github.com/empresa/proyecto.git). El nombre se propone solo; puedes cambiarlo.
3. Si es privado, marca Es privado y pega un token de solo lectura del servidor de origen (en GitHub, un token con permiso de lectura del contenido). No pongas el usuario ni el token dentro de la URL.
4. Importar. Corre en segundo plano: ves el avance en la ficha y puedes salir de la pantalla.

Gantlog guarda el token cifrado solo mientras importa y lo borra al terminar; nunca lo muestra. La rama principal queda la misma del origen. Mientras se importa no se puede clonar ni hacer push. Si falla, la ficha dice el motivo (por ejemplo, que hace falta un token) y Volver a intentar pide el token otra vez. Solo se importa desde servidores públicos por https, hasta el tamaño máximo de un repositorio y lo que quede de la cuota, en hasta 30 minutos. No trae issues, pull requests ni archivos de Git LFS: solo el historial de Git.

Ver el código en Gantlog

Al elegir un repositorio, arriba queda su ficha en dos renglones (el nombre y la descripción; debajo la ruta, el tamaño, el último push, la rama principal y de dónde se importó), con tu rol, la estrella de favoritos, Clonar y, si lo mantienes, ⋮ (cambiar nombre o descripción, mover, archivar o enviar a la papelera). A la izquierda queda su menú en lugar del árbol de grupos: Repositorios (vuelve al grupo, con el árbol) y sus secciones Archivos, Commits, Ramas, Miembros y Actividad. Con el botón del menú lo dejas solo con iconos para ganar espacio, y Gantlog lo recuerda. En el teléfono, el menú es una franja arriba del contenido.

• Rama o etiqueta: elige qué versión ver. Por defecto, la rama principal.
• Archivos: las carpetas y archivos, con el README de cada carpeta debajo. Al abrir un archivo de código lo ves con colores y números de línea; un archivo Markdown, con Vista (con formato) o Código. Historial muestra los commits que lo cambiaron y Descargar lo baja tal cual.
• Commits: del más nuevo al más viejo, agrupados por día. Cada uno muestra su mensaje, quién lo hizo y a qué hora, Fusión si une dos ramas y su código corto, que puedes copiar completo con el botón de al lado. Al abrir uno ves qué archivos cambió y, línea a línea, lo que se agregó (+) y lo que se quitó (−).

La dirección de la página cambia con lo que ves: puedes copiarla y compartir un archivo o un commit con alguien que tenga acceso al repositorio.

Por seguridad, Gantlog nunca ejecuta lo que hay en un repositorio: el HTML y el SVG se muestran como texto, y en un README no se cargan imágenes ni estilos (una imagen aparece como enlace). Los archivos binarios o de más de 1 MB se descargan.

Enlazar el código a una tarea

Si el repositorio está vinculado a un proyecto, menciona el ID de una de sus tareas (por ejemplo, WEB-12) en el mensaje del commit o en el nombre de la rama. Al hacer push, la rama y los commits aparecen en la tarea, en Desarrollo, y la rama nueva queda en su historial. Un pull request que menciona la tarea en su título, su descripción o su rama también aparece ahí, con su estado (abierto, en revisión, fusionado o cerrado). Funciona igual que con GitHub, GitLab o Bitbucket, también para las automatizaciones.

Actividad

La sección Actividad del repositorio cuenta qué pasó y quién lo hizo, una línea por cambio, agrupado por día (Hoy, Ayer o la fecha) y con la hora de cada cambio: pushes, cambios de nombre o de grupo, archivado, papelera y proyectos vinculados. También quedan las ramas creadas, borradas, protegidas o desprotegidas desde Gantlog, los cambios de rama principal y los pull requests abiertos, fusionados, cerrados o reabiertos. En un push, cada rama o etiqueta va en una pastilla (las borradas dicen «borrada» y un push forzado, «forzado»), junto a cuántos commits nuevos trajo. En un grupo, la sección Actividad muestra sus cambios y los de sus miembros; la ve quien tiene un rol en el grupo.

Crear un token

Git no usa tu contraseña de Gantlog: por HTTPS usa un token personal, y por SSH, una llave.

1. Entra en Repositorios y pulsa Tokens y llaves.
2. Escribe un nombre que te diga dónde lo usas (por ejemplo, «Portátil del trabajo»).
3. Elige Solo lectura para clonar y traer, o Lectura y push si también vas a subir cambios.
4. Elige cuándo vence: en 30 días, en 90 días, en un año o nunca.
5. Pulsa Crear y copia el token. No se vuelve a mostrar.

El token nunca te da más de lo que permite tu rol. Puedes tener hasta 20 activos. Sirve solo para la empresa en la que lo creaste.

Clonar un repositorio

En el repositorio, pulsa Clonar y copia el comando. Por ejemplo:

git clone https://gantlog.com/git/mi-empresa/cliente-x/erp/api.git

Cuando git te pida los datos, escribe tu correo como usuario y el token como contraseña. Para que no te los pida cada vez, guárdalos en el administrador de credenciales de tu sistema (en Windows y macOS, git lo hace solo después de la primera vez).

Si alguien renombra o mueve el repositorio, la dirección anterior sigue funcionando hasta que otro repositorio la use. Aun así, conviene actualizarla:

git remote set-url origin https://gantlog.com/git/mi-empresa/nueva/ruta.git

Clonar por SSH

Si prefieres no escribir el token, usa una llave SSH:

1. Si aún no tienes una, créala en tu equipo:

   ssh-keygen -t ed25519 -C "tu-correo@empresa.com"

2. En Repositorios › Tokens y llaves, pega en Llaves SSH el contenido de ~/.ssh/id_ed25519.pub (la llave pública, la que termina en .pub) y pulsa Agregar llave.

3. En el repositorio, pulsa Clonar y copia el comando de Clonar con SSH.

La primera vez, ssh te muestra la huella del servidor y pregunta si confías en él. Compárala con la que aparece en Llaves SSH: si es la misma, responde yes.

Las llaves aceptadas son ed25519 (recomendada), ECDSA y RSA de al menos 2048 bits. Una llave te da lo mismo que tu rol en cada repositorio. Si dejas de usar un equipo, quita su llave.

Ramas

La sección Ramas del repositorio lista sus ramas, la principal primero y luego de la más reciente a la más vieja. Cada una muestra su último commit (quién y cuándo), cuántos commits va adelante o atrás de la principal (o «Al día con la principal») y, si corresponde, las pastillas Principal y Protegida. Arriba puedes buscar por nombre.

• Nueva rama (desarrolladores): escribe el nombre (por ejemplo, feature/WEB-12-login; sin espacios) y elige desde qué rama sale. Si el nombre lleva el ID de una tarea de un proyecto vinculado, la rama aparece en la tarea.
• En el menú ⋮ de cada rama: Ver archivos y Ver commits de esa rama, Copiar nombre y Borrar rama (desarrolladores; no se puede borrar la principal ni una protegida, y lo que solo estaba en esa rama deja de verse).
• Proteger, Quitar protección y Hacer principal (mantenedores). Al proteger eliges cuántas aprobaciones de otras personas pide un pull request para fusionarse en ella (ninguna, 1 o 2) y si exige que sus conversaciones estén resueltas.

Ramas protegidas

Una rama protegida no se puede borrar ni reescribir con git push --force, y solo los mantenedores hacen push directo a ella; quien es desarrollador sube sus cambios a otra rama y pide que la fusionen. La rama principal (normalmente main) siempre está protegida; el primer push de un repositorio vacío lo puede hacer cualquier desarrollador. Si cambias la rama principal, la anterior sigue protegida hasta que le quites la protección. Solo se aceptan ramas y etiquetas.

Pull requests

Un pull request pide revisar los cambios de una rama antes de llevarlos a otra, por ejemplo de feature/WEB-12-login a main. Están en la sección Pull requests del repositorio: arriba eliges Abiertos, Fusionados o Cerrados (con cuántos hay de cada uno) y puedes buscar por título, número o rama. Cada uno tiene un número en el repositorio (!3) y muestra de qué rama a cuál va, quién lo abrió, sus aprobaciones y sus comentarios.

Abrir uno (desarrolladores): Nuevo pull request, elige Desde la rama (la que tiene tus cambios) y Fusionar en (por defecto, la principal). Debajo ves los commits y los cambios que traería. El título se sugiere del único commit o del nombre de la rama; agrega una descripción (qué cambia, cómo probarlo) y pulsa Abrir pull request. Si ya hay uno abierto entre esas ramas, Gantlog te lleva a él.

Un pull request abierto tiene tres pestañas:

• Conversación: la descripción y, debajo, la caja para fusionar: dice si está Listo para fusionar o qué falta (aprobaciones, conflictos, que alguien pidió cambios, conversaciones sin resolver). Si eres desarrollador y no es tuyo, ahí mismo lo Apruebas o Pides cambios (escribe qué hay que cambiar). Si ya lo aprobaste, ves «Aprobaste» y puedes Quitar aprobación; si llegaron commits nuevos, te avisa que tu aprobación era de una versión anterior. Después va la actividad en orden (comentarios, revisiones y cambios de estado) y al final escribes un comentario.
• Commits: los commits que trae.
• Cambios: como en GitLab, a la izquierda el árbol de carpetas con los archivos cambiados (cada uno con su icono de agregado, modificado o borrado y sus líneas +/−; puedes filtrarlo y plegar carpetas) y al centro los archivos línea a línea. Al tocar un archivo del árbol vas a él, y el que estás leyendo queda marcado. Ocultar árbol deja más espacio (se recuerda); en el celular el árbol va arriba. En la cabecera de cada archivo, el botón de comentario comenta todo el archivo, y la casilla Revisado lo marca para ti: el archivo se pliega, el árbol lo muestra con un visto y arriba ves cuántos llevas («2 de 5 revisados»). Si el archivo cambia después, vuelve a quedar sin revisar. Cada conversación de una línea o de un archivo se cierra con Ocultar para leer el código tranquilo: queda un icono azul fijo (con cuántos comentarios) en esa línea o en la cabecera del archivo, y al tocarlo se vuelve a abrir. Arriba, Ocultar comentarios / Mostrar comentarios lo hace con todas a la vez. Cuando se atendió, Resolver la marca como resuelta (un desarrollador o quien la empezó; también desde Conversación): queda cerrada con un visto y «Resuelta por …», y Reabrir la vuelve a abrir, igual que una respuesta nueva. Al responder puedes elegir Comentar y resolver para hacer las dos cosas en un paso. Pasa el mouse sobre una línea (en el celular, toca el botón de la izquierda) para comentar esa línea; la conversación de la línea queda debajo de ella y también en Conversación, con el archivo y el número de línea.

Si haces push a la rama de origen, el pull request se actualiza solo. Las aprobaciones anteriores dejan de contar (hay que aprobar lo nuevo) y los comentarios de una versión anterior se marcan Versión anterior.

Fusionar

Cuando nada lo frena, quien puede fusionar elige cómo:

• Con commit de fusión: conserva los commits y agrega uno que une las dos ramas.
• En un solo commit: junta todos los cambios en uno, con el título del pull request.
• Rebasando: copia los commits uno por uno encima de la rama de destino, sin commit de fusión (no se puede si la rama trae commits de fusión).

Puedes marcar Borrar la rama al fusionar (no se ofrece si es la principal o está protegida). Gantlog nunca reescribe la rama de destino: si cambió mientras tanto, te pide volver a intentar.

Quién puede fusionar:

• En una rama sin protección, cualquier desarrollador.
• En una rama protegida que pide aprobaciones, cualquier desarrollador cuando tiene esas aprobaciones de otras personas sobre el último commit (el autor no se aprueba a sí mismo).
• En una rama protegida que no pide aprobaciones (la principal, si nadie lo cambió), solo un mantenedor.
• Si alguien pidió cambios, esa persona tiene que aprobar antes.
• Si la rama de destino pide conversaciones resueltas, todas las de líneas y archivos tienen que estar resueltas.

Si hay conflictos, resuélvelos en tu equipo: trae la rama de destino a la tuya (git merge main), corrige los archivos, haz commit y push. El autor o un mantenedor también puede Cerrar sin fusionar y, después, Volver a abrir.

Límites

• Cada archivo puede pesar hasta 100 MB, y cada push hasta 2 GB.
• Cada repositorio puede ocupar hasta 5 GB. Desde 4 GB, git te avisa al hacer push.
• Los repositorios cuentan en el espacio de archivos de tu empresa. Si se llena, solo puedes borrar ramas o etiquetas hasta que haya espacio.
• Puedes descargar (clonar y traer) hasta 10 GB al mes. Se renueva el día 1.
• Si haces demasiadas peticiones seguidas, git recibe «Too Many Requests»: espera un momento y vuelve a intentar.

Si la empresa exporta o borra sus datos

La exportación de la empresa (Empresa → Tus datos) incluye cada repositorio con su historia, ramas y etiquetas como un archivo .bundle; para recuperar uno: git clone portal/web.bundle. Si la empresa borra sus datos, también se borran sus repositorios y las llaves SSH.

Si algo falla

• Te pide la contraseña una y otra vez: el token venció, lo revocaste o lo escribiste mal. Crea otro en Tokens y llaves.
• Falla sin pedirte los datos («Authentication failed»): git usó un token que tenías guardado y que venció o revocaste. Al fallar lo borra: ejecuta el comando otra vez y te los pedirá.
• «Repository not found»: revisa la dirección, o pide acceso a quien mantiene el grupo.
• «403» al hacer push: tu token es de solo lectura, tu rol es Lector o el repositorio está archivado.
• «La rama … está protegida»: no puedes hacer push directo a esa rama (o intentaste borrarla o un push --force). Sube tus cambios a otra rama y abre un pull request.
• No puedo fusionar mi pull request: la caja de fusión dice qué falta. Lo más común: la rama pide aprobaciones de otras personas, alguien pidió cambios o hay conflictos.
• «Permission denied (publickey)» por SSH: tu llave no está registrada en esta empresa o la quitaste. Agrégala en Tokens y llaves.
• «Pack exceeds the limit»: el repositorio o el espacio de la empresa están llenos. Avísale a tu administrador.

Si dejas de usar un equipo, revoca su token o quita su llave en Tokens y llaves. Deja de servir en el acto.