GitHub App y permisos
HeyDeer funciona mediante una GitHub App instalada en tu cuenta personal o en tu organización. Tú eliges qué repositorios puede leer y revisar HeyDeer.
Instalar HeyDeer
Cada espacio de trabajo pertenece a una cuenta de GitHub: una cuenta personal o una organización.
- Selecciona Instalar en GitHub o Instalar en otra cuenta. Durante la primera configuración, está en Conecta tus repositorios. Para conectar otra cuenta más adelante, selecciona primero Añadir espacio de trabajo en el menú del espacio de trabajo.
- En GitHub, elige la cuenta y después los repositorios que HeyDeer puede revisar.
- Confirma en GitHub. Después, HeyDeer abre el espacio de trabajo de la cuenta.
En una organización, solo un propietario puede instalar la GitHub App; si no lo eres, GitHub envía una solicitud a los propietarios. Mientras está pendiente, HeyDeer muestra Esperando la aprobación de un propietario de GitHub, y los administradores del espacio de trabajo ya pueden configurar los ajustes.
Cuando un propietario la aprueba, el espacio de trabajo se conecta solo y HeyDeer envía un correo a la dirección de notificaciones del espacio de trabajo.
Añadir repositorios
En GitHub, elige Only select repositories y selecciona los que quieres revisar. All repositories también incluye los repositorios que se creen más adelante.
Para añadir repositorios más adelante, selecciona Añadir repositorios en la página Repositorios, o Gestionar acceso a GitHub en Configuración del espacio de trabajo → Conexión con GitHub. Solo un propietario de la cuenta de GitHub puede guardar cambios en GitHub. Los demás ven Pedir ayuda al equipo, con una solicitud que pueden copiar y enviar a un propietario.
Los repositorios añadidos siguen los valores predeterminados del espacio de trabajo en Reglas de revisión. Una persona ve un repositorio y sus revisiones en HeyDeer cuando tanto ella como HeyDeer tienen acceso a él en GitHub. Solicitar una revisión requiere acceso de escritura; consulta Comandos en comentarios de PR.
Permisos
| Permiso | Acceso | Para qué lo usa HeyDeer |
|---|---|---|
| Contents | Lectura y escritura | Leer código e historial, resolver las conversaciones de revisión de HeyDeer y subir ramas y commits para correcciones y solicitudes a @heydeer. |
| Pull requests | Lectura y escritura | Leer pull requests, publicar revisiones, comentarios y respuestas, y abrir, actualizar y fusionar los pull requests que pidas. |
| Workflows | Lectura y escritura | Actualizar archivos de flujos de trabajo de GitHub Actions cuando una corrección o solicitud los cambia. |
| Checks | Lectura y escritura | Mostrar la comprobación HeyDeer Review y recibir las solicitudes de sus botones. |
| Actions | Lectura | Leer los registros de los trabajos fallidos de GitHub Actions para que Autopilot pueda corregirlos. |
| Issues | Lectura y escritura | Recibir menciones y comandos de @heydeer, confirmarlos con reacciones, leer issues relacionados, y abrir y actualizar los issues que pidas. |
| Metadata | Lectura | Leer información básica del repositorio y quién tiene acceso de escritura. |
| Members (organización) | Lectura | Listar los miembros del espacio de trabajo y comprobar las condiciones de miembros y equipos en los filtros de revisión automática y en Acceso a revisiones manuales. |
| Email addresses (cuenta) | Lectura | Sugerir tu correo verificado como dirección de notificaciones. |
Si GitHub no ha concedido un permiso que HeyDeer necesita, Configuración del espacio de trabajo → Conexión con GitHub muestra Se necesita un permiso de GitHub o Hay permisos adicionales de GitHub disponibles. Un propietario de la cuenta de GitHub selecciona Revisar solicitud de permisos y la acepta en GitHub.
Para saber cómo trata HeyDeer tu código y tus datos, consulta Seguridad y tratamiento de datos.
Cuando falta una cuenta o un repositorio
Una organización aparece al conectar solo cuando HeyDeer está instalado en ella. Para añadir una, selecciona Instalar en GitHub o Instalar en otra cuenta y elígela en GitHub; si no eres propietario, GitHub envía una solicitud a los propietarios. Si una organización que tiene HeyDeer sigue sin aparecer, inicia sesión en ella con SSO en GitHub, abre ¿No ves tu cuenta? y selecciona Volver a iniciar sesión en GitHub.
Si una organización no tenía espacio de trabajo cuando un propietario aprobó tu solicitud, HeyDeer lo crea contigo como administrador.
Si HeyDeer muestra Restablece tu acceso a los repositorios, tu cuenta de GitHub no puede acceder a los repositorios a los que se dio acceso a HeyDeer. Selecciona Actualizar acceso a GitHub. Consulta Solución de problemas para otros casos.
Cuando el acceso de HeyDeer a GitHub se pausa o se retira
Si HeyDeer está suspendido en GitHub, Configuración del espacio de trabajo → Conexión con GitHub muestra El acceso a GitHub está pausado y no se pueden ejecutar revisiones. Un propietario de la cuenta de GitHub selecciona Reanudar el acceso a GitHub.
Si HeyDeer se desinstala, muestra HeyDeer se ha desinstalado de GitHub. Un propietario selecciona Reinstalar HeyDeer; el espacio de trabajo conserva su configuración y su historial de revisiones.