AI CodeOps

Conectar Forgejo

Conecta un servidor Forgejo, como Codeberg o tu propia instancia, a AI CodeOps con un token de acceso personal, y mira qué hace la plataforma con tus repositorios.

AI CodeOps funciona con servidores Forgejo, tanto si gestionas el tuyo como si usas una instancia pública. Te conectas con la dirección del servidor y un token de acceso personal. Después, las sesiones escriben los cambios en una rama nueva y abren un pull request para su revisión.

Antes de empezar

  • La dirección https pública del servidor, por ejemplo https://forgejo.example.com. AI CodeOps se ejecuta en la nube y tiene que llegar a él por internet.
  • Las direcciones de redes privadas, localhost, las direcciones link-local y los nombres .local o .internal se rechazan, igual que las URL con una cadena de consulta o un #fragment.
  • Una cuenta con acceso de escritura a los repositorios que quieres usar.
  • En Codeberg (https://codeberg.org), lee primero sus Condiciones de uso: no permiten proyectos que consistan en su mayor parte en código escrito por herramientas de IA generativa.

Crea un token en Forgejo

  1. En Forgejo, abre Settings → Applications y genera un token de acceso nuevo.
  2. Concede lectura y escritura en repository (clonar, hacer push de ramas, crear y fusionar pull requests) y lectura en user (mostrar qué cuenta está conectada).
  3. Copia el token ahora. Forgejo solo lo muestra una vez.

Conecta el token

  1. En tu espacio de trabajo, abre Configure → Settings y desplázate hasta Git Providers.
  2. En la tarjeta Forgejo, introduce la Instance URL. Es obligatoria.
  3. Pega el token en or access token y elige Connect with token.

AI CodeOps comprueba el token con el servidor antes de guardarlo. Si no puede conectar, el mensaje dice qué parte hay que corregir: Forgejo no reconoció el token, el token no tiene permiso para leer tu cuenta (indica los scopes que hay que añadir), o ninguna API de Forgejo respondió en esa dirección.

OAuth

Connect via OAuth solo funciona para el único servidor Gitea o Forgejo en el que está registrada la aplicación OAuth de la plataforma, así que la tarjeta lo ofrece solo para ese servidor. Para cualquier otro servidor, usa un token.

Qué hace AI CodeOps con el repositorio

  • Explorar: Develop → Repositories lista los repositorios que la cuenta puede ver, con sus ramas, archivos y pull requests.
  • Ramas y pull 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 pull request hacia la rama predeterminada del proyecto. El autor de los commits es "AI CodeOps".
  • Fusión: un pull request que abrió la consola se puede fusionar desde la consola. Antes se vuelve a ejecutar el control de publicación.

Las sesiones no instalan webhooks en el servidor, y AI CodeOps no comenta en los pull requests. Un repositorio que conectas en Build & Test → Builds es la excepción: recibe un webhook, para que un push o un pull request puedan iniciar un build, y un estado de commit con el resultado de cada build. AI CodeOps tampoco lee los resultados de Forgejo Actions; las pruebas se ejecutan en el sandbox propio de la sesión.

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.
  • El token se cifra en reposo (AES-256-GCM) y no se escribe en la configuración de Git de ningún repositorio.
  • Para retirar el acceso, elige Disconnect, o elimina el token en Forgejo. Para rotarlo, desconecta y vuelve a conectar.

Siguientes pasos

¿Te resultó útil esta página?