- Inicio
- Documentación
- Conectar Gitea
Conectar Gitea
Conecta tu propio servidor Gitea a AI CodeOps con un token de acceso personal: la URL de la instancia, los scopes de token que necesita y cómo se abren los pull requests por ti.
AI CodeOps funciona con los servidores Gitea que tú gestionas. Te conectas con la dirección de tu servidor y un token de acceso personal. Después, las sesiones escriben los cambios en una rama nueva y abren un pull request en tu servidor para su revisión.
Antes de empezar
- La dirección https pública de tu servidor Gitea, por ejemplo
https://gitea.example.com. AI CodeOps se ejecuta en la nube, así que debe poder llegar al servidor por internet. - Las direcciones de redes privadas,
localhost, las direcciones link-local y los nombres.localo.internalse rechazan. También las URL con una cadena de consulta o un#fragment. El error dice: "Use the public https address of your Git server". - Una cuenta con acceso de escritura a los repositorios que quieres usar.
Crea un token en Gitea
- En Gitea, abre Settings → Applications y genera un token nuevo.
- Dale acceso de lectura y escritura a repository (para clonar, hacer push de ramas, y crear y fusionar pull requests) y acceso de lectura a user (para mostrar qué cuenta está conectada).
- Copia el token. Gitea solo lo muestra una vez.
Conecta el token
- En tu espacio de trabajo, abre Configure → Settings y desplázate hasta Git Providers.
- En la tarjeta Gitea, introduce la Instance URL. Es obligatoria.
- Pega el token en or access token y elige Connect with token.
AI CodeOps comprueba el token con tu servidor antes de guardarlo. Si no puede conectar, el mensaje dice qué parte hay que corregir: Gitea 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 Gitea 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 tu propio 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 tu 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.
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 Gitea. Para rotar un token, desconecta y vuelve a conectar con el nuevo.
Siguientes pasos
- Crea un proyecto a partir de un repositorio de Gitea.
- Ejecuta tu primera sesión.
- Solución de problemas