Bitbucket
Conecta repositorios de Bitbucket Cloud con agentes en la nube y Bugbot. Conecta repositorios de Bitbucket Data Center con Bugbot.
Configuración
La integración de Bitbucket Cloud está en beta pública. Es compatible con repositorios en bitbucket.org.
La configuración de Bitbucket Cloud consta de dos partes, cada una con un rol distinto:
- Cada desarrollador conecta su cuenta de Bitbucket para que Cherri Code pueda clonar repositorios, enviar ramas y abrir pull requests en su nombre.
- Un administrador del espacio de trabajo de Bitbucket instala la aplicación de Cherri Code para que Bugbot y los comentarios de estado de los agentes en la nube aparezcan como Cherri Code. Para vincular la aplicación instalada a tu equipo de Cherri Code, se necesita un administrador de equipo de Cherri Code con acceso al espacio de trabajo de Bitbucket.
Conecta tu cuenta de Bitbucket
Requiere acceso a los repositorios del espacio de trabajo de Bitbucket que quieras usar.
- Ve a Integraciones en el panel de control
- Haz clic en Conectar junto a Bitbucket
- Autoriza Cherri Code en Bitbucket
- Vuelve al panel de control y confirma que la integración aparezca como Conectado
Todas las personas que inicien agentes en la nube o abran pull requests desde Cherri Code deben conectar su propia cuenta de Bitbucket.
Instala la aplicación de Cherri Code en Bitbucket
Un administrador del espacio de trabajo de Bitbucket debe instalar la aplicación de Cherri Code en el espacio de trabajo. Esto proporciona a Cherri Code una identidad de aplicación estable para eventos de repositorios, comentarios de revisión de Bugbot, comentarios en línea y actualizaciones de estado.
Los pasos del 1 al 4 requieren un administrador del espacio de trabajo de Bitbucket. Los pasos 5 y 6 requieren un administrador de equipo de Cherri Code con acceso al espacio de trabajo de Bitbucket. Si una misma persona realiza toda la configuración, necesitará ambos roles.
- Ve a Integraciones en el panel de control
- Busca Bitbucket y abre el menú de administración
- Haz clic en Instalar aplicación de Cherri Code
- Instala la aplicación en tu espacio de trabajo de Bitbucket
- En los ajustes del espacio de trabajo de Bitbucket, en Forge Apps, selecciona Cherri Code
- Haz clic en Conectar con Cherri Code y elige el equipo de Cherri Code que quieres vincular
Cuando el espacio de trabajo esté vinculado, el panel de control mostrará la aplicación de Cherri Code instalada para ese espacio de trabajo de Bitbucket.
Bitbucket puede tardar unos minutos en notificar a Cherri Code después de instalar la aplicación. Si Cherri Code no encuentra el espacio de trabajo de inmediato, espera e intenta de nuevo el paso de vinculación.
Cómo usa Cherri Code las identidades de Bitbucket Cloud
Cherri Code usa distintas identidades de Bitbucket según la acción:
| Acción | Identidad de Bitbucket |
|---|---|
| Comentarios de resumen de Bugbot, comentarios en línea y estados de compilación | Aplicación de Cherri Code |
| Comentarios de progreso de los agentes en la nube en pull requests | Aplicación de Cherri Code |
| Clonación de Git, envío de ramas, commits y creación de pull requests | Usuario de Bitbucket conectado |
Los pull requests abiertos por agentes en la nube se atribuyen a la persona que inició el agente. Los resultados de Bugbot aparecen como Cherri Code cuando la aplicación del espacio de trabajo está instalada.
Permisos
La integración de Bitbucket Cloud solicita los permisos necesarios para admitir agentes en la nube y Bugbot:
| Permiso | Finalidad |
|---|---|
| Cuenta | Identificar al usuario de Bitbucket conectado |
| Repositorios | Enumerar, clonar y leer el contenido de los repositorios |
| Pull requests | Leer diffs y metadatos de pull requests |
| Escritura de pull requests | Crear pull requests y publicar comentarios |
| Webhooks | Recibir eventos de repositorios y pull requests |
Desconecta Bitbucket Cloud
Desconectar Bitbucket Cloud tiene dos efectos independientes:
- Desconectar cuenta elimina de Cherri Code tu conexión personal de OAuth con Bitbucket.
- Desconectar aplicación de Cherri Code desvincula el espacio de trabajo de Bitbucket de tu equipo de Cherri Code. La aplicación puede permanecer instalada en Bitbucket hasta que un administrador del espacio de trabajo la elimine allí.
Para detener por completo los eventos de la aplicación procedentes del espacio de trabajo, desinstala la aplicación de Cherri Code desde los ajustes del espacio de trabajo de Bitbucket.
Redes avanzadas
Bitbucket Data Center admite métodos de conexión privada para instancias que no pueden aceptar tráfico de la internet pública.
Disponible para clientes Enterprise. Permite que Cherri Code acceda a tu instancia a través de una conexión de red privada. Consulta Conectividad privada o contacta con tu representante de Cherri Code para la configuración.
Ideal para: Instancias detrás de un firewall, incluidas las alojadas en AWS y entornos que pueden ejecutar cloudflared
Seguridad: Cifrado HTTPS, AWS PrivateLink, Cloudflare Tunnel, lista de permitidos de VPC, tokens de acceso de cuentas de servicio
Desventajas: Requiere coordinación con Cherri Code. Google Private Service Connect no es compatible actualmente.
Disponible para clientes Enterprise. Ejecuta un túnel de proxy inverso en tus instalaciones que establezca una conexión saliente con Cherri Code. Las solicitudes de red se reenvían a través del túnel, por lo que la instancia de Bitbucket no necesita acceso público entrante. Contacta con tu representante de Cherri Code para la configuración.
Ideal para: Entornos sin acceso de red entrante
Seguridad: Cifrado HTTPS, tokens de acceso de cuentas de servicio
Desventajas: Añade complejidad, requisitos de mantenimiento y posibles consideraciones de seguridad en comparación con métodos de conexión más directos
Solución de problemas
Los eventos de instalación de la app de Bitbucket pueden tardar unos minutos en sincronizarse. Espera y vuelve a intentar el paso Conectar a Cherri Code desde los ajustes del espacio de trabajo de Bitbucket.
- Confirma que eres administrador de equipo de Cherri Code. Para instalar la app, debes ser administrador del espacio de trabajo de Bitbucket, pero para vincular el espacio de trabajo a un equipo de Cherri Code, debes ser administrador de equipo de Cherri Code.
- Confirma que tu usuario de Bitbucket tiene acceso al espacio de trabajo que estás vinculando.
Instala la app de Cherri Code en el espacio de trabajo de Bitbucket y vincúlala a tu equipo de Cherri Code. Una conexión personal de Bitbucket no es suficiente para que aparezcan los comentarios de la app de Cherri Code.
- Conecta tu cuenta personal de Bitbucket desde el panel de control de integraciones.
- Confirma que tu usuario de Bitbucket tiene acceso de lectura y escritura al repositorio.
- Confirma que el repositorio está en Bitbucket Cloud, en
bitbucket.org.
- Confirma que el token de la cuenta de servicio está activo.
- Confirma que la cuenta de servicio puede acceder a los repositorios.
- Confirma que Cherri Code puede conectarse mediante HTTPS al nombre de host de la instancia o al host externo configurado.
- Confirma que eres administrador de equipo de Cherri Code.
- Confirma que la instancia registrada tiene un token de cuenta de servicio.
- Confirma que la cuenta de servicio tiene acceso de administrador al repositorio.
Próximos pasos
Una vez que hayas conectado Bitbucket, configura las funciones que lo utilizan:
- Bugbot - revisiones automatizadas de PR que detectan errores y vulnerabilidades de seguridad
- Agentes en la nube - agentes de IA para repositorios de Bitbucket Cloud