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 funcionalidades, 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.

5. Después de autorizarla, se te redirigirá de nuevo 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, selecciona 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 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 Fern usa 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 y del procesamiento futuro de cambios de código de Fern para este espacio de trabajo.

Ámbito de repositorios y ramas

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 funcionalidad 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 en producción. 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 en producción. Si no estableces ninguna, Fern usará la rama predeterminada del repositorio. Cada repositorio incluido puede usar una rama diferente y los cambios en las ramas 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 tarjeta Ramas de producción 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, a continuación, busca una rama o elige una de la lista.

Volver a la rama predeterminada

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

Cuando una rama configurada deja de existir

Si se elimina o cambia el nombre de una rama de producción en GitHub, la tarjeta Ramas de producción avisa de 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 eventos de eliminación.

Solución de problemas

Recursos adicionales

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