Centro de ayuda · Empezar

¿Cómo conecto mi repositorio de GitLab o GitHub a Diavi?

Iniciar sesión con su forja, dar al espacio su acceso a los repositorios y elegir el repositorio en el que trabajará Diavi.

Haga clic en Continuar con GitLab o Continuar con GitHub: su forja prueba quién es usted, sin contraseña que crear. El acceso a los repositorios pasa por el token del espacio, que el propietario instala una vez; cada miembro trabaja después con él, sin aportar el suyo.

¿Cómo iniciar sesión?

• Con su forja (recomendado): un clic, y GitLab o GitHub confirma su identidad. Para una instancia de GitLab autoalojada, despliegue el campo opcional e indique su URL, en https://.
• Con un correo y una contraseña: se definen en Preferencias → Inicio de sesión y seguridad, una vez conectado con su forja. Práctico allí donde la forja no está abierta a todos.
• Con un token personal: solo cuando su instancia aún no ha declarado una aplicación de inicio de sesión. Sirve para probar su identidad una vez y después no se guarda.

¿Qué permisos necesita el token del espacio?

El mínimo para leer una issue, clonar el repositorio y abrir una merge request.

• GitLab: los scopes api y read_user.
• GitHub: el scope repo.

Se instala en Preferencias → Forja. Se valida contra su forja antes de guardarse: si ha caducado o le falta un scope, lo sabe enseguida y no en el primer run fallido.

¿Alguien puede volver a leer el token?

No, y es deliberado. Está cifrado en la base de datos y ninguna pantalla lo vuelve a mostrar — ni la suya ni la consola de Diavi. Si lo pierde, genera uno nuevo en su forja y lo reemplaza; no hay recuperación, solo sustitución. Diavi le avisa cuando se acerca a la antigüedad que usted fijó, y en cuanto la forja lo rechaza.

¿Y si la persona que puso el token se va?

Con un token personal, el espacio depende de esa persona: si deja el equipo o su token caduca, los runs se detienen. En GitLab, ponga mejor un token de acceso de grupo (o de proyecto): actúa en nombre de un bot que no pertenece a nadie, y Diavi lo reconoce solo — la pantalla muestra «Token del bot». En GitHub, instale la aplicación Diavi en su organización desde Preferencias → Forja, cuando se ofrezca: su token se renueva solo. Los inicios de sesión de los miembros nunca sustituyen a ninguno de los dos.

¿Y después?

Una vez conectado, Diavi ve los proyectos a los que da acceso el token del espacio. Usted elige en cuál lanzar un run en el momento del lanzamiento — nada queda bloqueado en un solo repositorio.