GitHub Enterprise Server
Instala y configura la aplicación GitHub de Mintlify en tu instancia de GitHub Enterprise Server para despliegues automáticos de documentación y sincronización.
En esta guía se explica cómo configurar la aplicación de GitHub de Mintlify en tu instalación de GitHub Enterprise Server (GHES). Para conectar una instancia de GHES a Mintlify, debes crear una versión local de nuestra aplicación dentro de tu entorno autoalojado que se comunique con nuestro servidor remoto.
Si usas una instancia de GitHub alojada en la nube, consulta la página de GitHub para ver las instrucciones de configuración.
- Privilegios de administrador en tu organización de GitHub Enterprise Server donde deseas instalar la aplicación
- Acceso a los repositorios de tu organización donde deseas instalar la aplicación
- Conectividad de red para comunicarte con nuestros servicios externos (consulta la sección Requisitos de red a continuación)
La integración requiere tráfico en ambas direcciones entre tu instancia de GHES y Mintlify. Configura tu firewall para permitir las dos conexiones siguientes.
Saliente: de tu instancia de GHES a Mintlify
Tu instancia de GHES envía eventos de webhook a Mintlify por HTTPS (puerto 443) a leaves.mintlify.com.
- Permite el tráfico saliente HTTPS (puerto 443) hacia
leaves.mintlify.com. Autoriza este tráfico por nombre de host. Mintlify no publica una lista estática de direcciones IP para este endpoint, y sus direcciones IP subyacentes pueden cambiar. - Asegúrate de que tu instancia de GHES pueda resolver
leaves.mintlify.commediante DNS. Si tus servidores usan un resolutor DNS interno, confirma que resuelva nombres de host públicos.
Entrante: de Mintlify a tu instancia de GHES
Mintlify se conecta a tu instancia de GHES por HTTPS (puerto 443) para llamar a la API de GitHub, informar sobre estados de check runs y despliegues, y leer contenido del repositorio. Estas conexiones se originan desde la dirección IP estática de egreso de Mintlify: 54.242.90.151.
Si un firewall o una lista de IPs permitidas restringe el acceso a tu instancia de GHES, permite el tráfico entrante HTTPS (puerto 443) desde 54.242.90.151.
Las ejecuciones del agente clonan y hacen push desde una infraestructura sandbox independiente que, por defecto, usa direcciones IP dinámicas. Si tu instancia de GHES aplica una lista de IPs permitidas, consulta Solucionar ejecuciones del agente bloqueadas por una lista de IPs permitidas.
Consulta Registrar una aplicación de GitHub en la documentación de GitHub para obtener instrucciones detalladas.
Ve a la configuración de tu organización
- En la esquina superior derecha de cualquier página de GitHub, haz clic en tu foto de perfil.
- Haz clic en Your organizations.
- Haz clic en Settings junto a la organización para la que quieres crear la aplicación.
Crea una nueva aplicación de GitHub
- En la barra lateral izquierda, haz clic en Developer settings.
- Haz clic en GitHub Apps.
- Haz clic en New GitHub App.
Configura la información básica de la aplicación
Configura lo siguiente:
- GitHub App name:
Mintlify - Description:
Integration with Mintlify services - Homepage URL:
https://mintlify.com - User authorization callback URL:
https://your-github-server.com/(reemplaza con tu dominio real de GHES)
Configurar permisos del repositorio
Establece los siguientes permisos para la aplicación. La aplicación no necesita permisos de organización, cuenta ni Enterprise:
- Checks: Lectura y escritura
- Contents: Lectura y escritura
- Deployments: Lectura y escritura
- Metadata: Solo lectura
- Pull Requests: Lectura y escritura
Suscribirse a eventos
Selecciona los siguientes eventos de webhook:
- Installation
- Installation Target
- Create
- Delete
- Public
- Pull Request
- Push
- Repository
Crear la app
Haz clic en Create GitHub App.
GitHub te redirige a la página de configuración de la app.
Generar clave privada
- Desplázate hacia abajo hasta la sección Private keys.
- Haz clic en Generate a private key.
- Descarga el archivo
.pemy guárdalo de forma segura.
Anotar credenciales de la app
Toma nota de lo siguiente:
- App ID (visible en la parte superior de la página de configuración)
- Client ID (en la sección “About”)
- Client Secret (genéralo y guárdalo de forma segura)
Ir a la instalación de la app
- Desde la página de configuración de la app, haz clic en Install App en la barra lateral izquierda.
- Selecciona tu organización de la lista.
Elegir el alcance de la instalación
Selecciona una de las siguientes opciones:
- All repositories (para acceso en toda la organización)
- Only select repositories (elige repositorios específicos)
Recomendamos seleccionar Only select repositories y limitar la app solo a los repositorios donde se encuentra tu documentación.
Completar la instalación
- Haz clic en Install.
- Anota el ID de instalación de la URL. Por ejemplo, en
https://your-github-server.com/settings/installations/12345, la cadena12345es el ID de instalación.
Volver a la configuración de la aplicación
- Regresa a la página de configuración de tu aplicación.
- Desplázate hasta la sección Webhook.
Configurar la URL del webhook
Configura lo siguiente:
- Webhook URL:
https://leaves.mintlify.com/github-enterprise/:subdomain(reemplaza:subdomaincon la URL que te proporcionemos) - Webhook secret: Genera una cadena aleatoria (de 32 caracteres o más) y guárdala de forma segura. Mintlify también puede generarla y proporcionártela.
Comparte la siguiente información con nuestro equipo utilizando tu método preferido de transferencia segura de información.
- URL base de GitHub Enterprise Server: https://your-github-server.com
- ID de la aplicación (App ID): (del paso 3)
- ID de cliente de la aplicación (App client ID): (del paso 3)
- Secreto de cliente de la aplicación (App client secret): (del paso 3)
- ID de la instalación (Installation ID): (del paso 4)
- Installation owner: El nombre de la organización de GitHub propietaria de la instalación de la aplicación
- Clave privada: Todo el contenido del archivo
.pem(compártelo mediante transferencia segura de archivos) - Secreto del webhook (Webhook secret): (del paso 5)
- Repository names: Nombres de los repositorios específicos donde has instalado la aplicación
- GitHub Enterprise Server version: La encontrarás en el panel de administración de tu sitio
Recibimos las credenciales que nos proporcionas y las almacenamos cifradas en una ubicación segura. Luego trabajamos contigo para:
- Integrar tu entorno GHES con un despliegue existente de Mintlify.
- Integrar tu entorno GHES con un nuevo despliegue de Mintlify que aprovisionamos para ti.
Después de integrar tu entorno GHES con un despliegue de Mintlify, podrás habilitar los webhooks de tu GitHub App.
La URL del webhook puede cambiar según nuestra configuración. Probamos la integración y te proporcionamos la nueva URL.
Verificar la entrega del webhook
- Ve a la configuración de tu GitHub App.
- Haz clic en la pestaña Advanced.
- Revisa “Recent Deliveries” para comprobar que haya entregas de webhook correctas.
- Busca respuestas HTTP 200.
Probar el acceso al repositorio
- Crea un issue o pull request de prueba en un repositorio instalado.
- Asegúrate de que Mintlify responda correctamente.