Integración con GitHub

Conecta tu cuenta de GitHub a Ferndesk para que Fern pueda explorar tu base de código y comprender cómo funcionan las funciones, lo que ayuda a generar artículos del centro de ayuda más precisos y relevantes.

Conectar GitHub

1. Desde el panel de Ferndesk, haz clic en Integraciones en la barra lateral.

   

2. Después de abrir Integraciones, haz clic en Conectar la primera herramienta, Conectar integración o Explorar todo; luego busca GitHub y haz clic en Conectar.

   

3. Se te redirigirá a GitHub para autorizar la conexión. Inicia sesión en tu cuenta de GitHub si aún no lo has hecho.

4. Concede a Ferndesk permiso para acceder a tu cuenta de GitHub. Puedes seleccionar qué repositorios conectar. Puedes elegir varios repositorios si tu proyecto abarca varios repositorios, como un backend y un panel en repositorios separados. La cuenta de GitHub que complete esta autorización debe tener acceso a la instalación de la aplicación de GitHub.

5. Después de autorizarla, volverás a Ferndesk. La integración con GitHub aparecerá como conectada.

Reutilizar una conexión de GitHub

Si administras varios espacios de trabajo de Ferndesk que comparten una instalación de GitHub, puedes reutilizar una conexión de GitHub existente de otro espacio de trabajo en lugar de autorizarla de nuevo. Los propietarios y administradores pueden reutilizar una conexión de un espacio de trabajo que administren.

1. En el cuadro de diálogo de conexión de GitHub, elige Reutilizar una conexión de GitHub.

2. Selecciona una conexión de otro espacio de trabajo que administres. Las conexiones reutilizables se agrupan por instalación de GitHub y no se pueden seleccionar las conexiones que ya están vinculadas a este espacio de trabajo. La conexión seleccionada muestra los espacios de trabajo que la utilizan.

Después de reutilizar una conexión, sus repositorios actuales comienzan como ignorados en este espacio de trabajo, para que puedas elegir tus propios repositorios antes de que Fern use el código. Los demás espacios de trabajo conservan su propia configuración de repositorios.

Administrar repositorios conectados

Los repositorios que usa Fern se configuran por espacio de trabajo en Ferndesk. Abre Integraciones desde la barra lateral del panel, selecciona tu conexión de GitHub y busca la sección Repositorios.

Marca cada repositorio como Incluido o ignorado para el espacio de trabajo actual. La configuración se guarda automáticamente y los repositorios nuevos se incluyen automáticamente.

Los repositorios ignorados se excluyen de la investigación del código de Fern y del procesamiento futuro de cambios de código para este espacio de trabajo.

Delimitación por repositorio y rama

Cuando Fern explora tu base de código, puede dirigirse a un repositorio o una rama específicos de tu cuenta de GitHub conectada, en lugar de depender únicamente del repositorio predeterminado.

Si tienes varios repositorios conectados, Fern puede centrarse en el repositorio relevante durante el análisis. Para trabajos específicos de una rama, como revisar una función no publicada o una solicitud de incorporación de cambios, Fern también puede explorar una rama específica cuando se proporciona una.

También puedes establecer una rama de producción para cada repositorio para que Fern sepa qué rama representa tu código activo. Consulta Establecer una rama de producción a continuación.

Establecer una rama de producción

Establece una rama de producción para cada repositorio incluido para que Fern sepa qué rama representa tu código activo. Si no estableces ninguna, Fern usa la rama predeterminada del repositorio. Cada repositorio incluido puede usar una rama diferente y los cambios de rama se guardan automáticamente.

Elegir una rama de producción

1. Abre Integraciones desde la barra lateral del panel y selecciona tu conexión de GitHub.

2. Busca la sección Repositorios en la página de detalles de la conexión.

3. Busca el repositorio que quieres configurar. Usa el campo de búsqueda si tienes muchos repositorios.

4. Haz clic en el selector de ramas de ese repositorio y, después, busca una rama o elige una de la lista.

Volver a la rama predeterminada

Abre el selector de ramas y elige Usar la rama predeterminada. Fern volverá a usar la rama predeterminada del repositorio.

Cuando una rama configurada deja de existir

Si una rama de producción se elimina o cambia de nombre en GitHub, la tarjeta Ramas de producción advierte que la rama ya no existe. Elige otra rama o selecciona Usar la rama predeterminada para continuar.

Cuando GitHub notifica a Ferndesk que se eliminó una rama, Fern elimina la configuración y vuelve a la rama predeterminada. Esto requiere que la aplicación de GitHub esté suscrita a los eventos de eliminación.

Solución de problemas

Recursos adicionales

Para obtener más información sobre las funciones de GitHub, visita la documentación de GitHub.