AI CodeOps

Conectar GitLab

Conecta GitLab.com o una instancia de GitLab autogestionada a AI CodeOps con OAuth o con un token de acceso personal, y mira cómo se abren los merge requests por ti.

AI CodeOps funciona con GitLab.com y con instancias de GitLab autogestionadas. Conecta una cuenta una vez; después, las sesiones escriben los cambios en una rama nueva y abren un merge request para su revisión.

Antes de empezar

  • Una cuenta de GitLab con acceso Developer como mínimo a los proyectos que quieres usar, para que pueda hacer push de ramas y abrir merge requests.
  • Para una instancia autogestionada: su dirección https pública, por ejemplo https://gitlab.example.com. La plataforma tiene que llegar a ella por internet. Las direcciones de redes privadas, localhost y los nombres .local o .internal se rechazan.

Conectar con OAuth

  1. En tu espacio de trabajo, abre Configure → Settings y desplázate hasta Git Providers.
  2. En la tarjeta GitLab, deja Instance URL (blank for gitlab.com) vacío para GitLab.com.
  3. Elige Connect via OAuth y aprueba la solicitud en GitLab.

AI CodeOps pide los scopes api y read_user. api le permite leer repositorios, hacer push de ramas y crear y fusionar merge requests; read_user muestra qué cuenta está conectada.

OAuth solo funciona con el servidor de GitLab en el que está registrada la aplicación OAuth de la plataforma (GitLab.com por defecto). La tarjeta lo ofrece solo para ese servidor. Para cualquier otra instancia, usa un token.

Conectar con un token de acceso personal

Este es el camino habitual para una instancia autogestionada.

  1. En GitLab, crea un token de acceso personal (User settings → Access tokens) con el scope api. Un token de acceso de proyecto o de grupo también sirve si tiene api y el rol Developer o superior.
  2. En la tarjeta de GitLab en AI CodeOps, introduce tu Instance URL (o déjala en blanco para GitLab.com).
  3. Pega el token en or access token y elige Connect with token.

AI CodeOps comprueba el token con tu instancia antes de guardarlo. Si no puede conectar, el mensaje dice qué parte hay que corregir: GitLab no reconoció el token, al token le falta el scope api, o ninguna API de GitLab respondió en esa dirección. Los tokens no se renuevan: cuando uno caduque en GitLab, desconecta y vuelve a conectar con uno nuevo.

Qué hace AI CodeOps con el repositorio

  • Explorar: Develop → Repositories lista tus proyectos con sus ramas, archivos y merge requests.
  • Ramas y merge requests: cuando un cambio se aprueba y supera sus controles de calidad, AI CodeOps hace push de una rama llamada codeops/run-<id> y abre un merge request hacia la rama predeterminada del proyecto. El autor de los commits es "AI CodeOps".
  • Fusión: un merge request que abrió la consola se puede fusionar desde la consola. Antes se vuelve a ejecutar el control de publicación.

Las sesiones no registran webhooks en tus proyectos, y AI CodeOps no comenta en los merge requests. Un proyecto que conectas en Build & Test → Builds es la excepción: recibe un webhook, para que un push o un merge request puedan iniciar un build, y un estado de commit con el resultado de cada build.

Tu token y tu acceso

  • Una conexión te pertenece a ti, no al espacio de trabajo. Los roles del espacio de trabajo siguen decidiendo qué puede hacer cada miembro.
  • Los tokens se cifran en reposo (AES-256-GCM). Los tokens de OAuth se renuevan antes de que caduquen.
  • Para retirar el acceso, elige Disconnect junto a la cuenta, o revoca el token en GitLab.

Siguientes pasos

¿Te resultó útil esta página?