Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Esta versión de GitHub Enterprise se discontinuó el 2020-11-12. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Instalar la información de GitHub

Puedes instalar GitHub Insights y conectar la aplicación autónoma para Servidor de GitHub Enterprise.

Los propietarios de la organización en GitHub Enterprise con los permisos de lectura para el repositorio github/insights-releases y el acceso administrativo al servidor de aplicaciones pueden instalar GitHub Insights.

GitHub Insights se encuentra disponible con GitHub One. Para obtener más información, consulta "Productos de GitHub".

En este artículo

Prerrequisitos

  • Debes tener un archivo de licencia GitHub Enterprise que incluya GitHub Insights. Después de comprar GitHub Insights, puedes descargar el archivo de licencia actualizado en el portal web GitHub Enterprise.

  • GitHub Insights requiere una máquina, llamada servidor de la aplicación, hospedada ya sea en la nube o localmente. Para obtener más información, consulta "Descripción general del sistema para GitHub Insights".

  • Debes instalar dependencias en el servidor de aplicaciones.

    Nota: El servidor de aplicaciones puede requerir que el demonio de Docker se ejecute como sudo. Kubernetes no es compatible.

Crear un App GitHub

Para conectar GitHub Insights a GitHub Enterprise, debes crear un App GitHub en una organización en GitHub Enterprise. Se mostrará una versión con slugged del nombre de tu app en GitHub Enterprise cuando tu integración realiza una acción.

  1. Ingresa en tu instancia de servidor de GitHub Enterprise a través de http(s)://HOSTNAME/login.

  2. Navega hasta la organización a la que deseas conectarte GitHub Insights.

  3. Debajo de tu nombre de organización, da clic en Configuración.

    Botón de configuración de organización

  4. En la barra lateral izquierda, haz clic en App GitHubs.

    Configuración de App GitHub

  5. Haz clic en New (nuevo) App GitHub.

    Botón nueva app de GitHub

  6. En "Name (nombre) App GitHub", escribe un nombre para la app. Tu app no puede tener el mismo nombre que un usuario o una organización existente, a menos que el nombre sea tu propio nombre de usuario o de organización.

    Campo de nombre de app de GitHub

  7. En "Homepage URL" (URL de página principal), escribe la URL del servidor de aplicaciones para GitHub Insights. Para obtener más información, consulta "Descripción general del sistema para GitHub Insights".

    Campo de URL de página principal

  8. En "User authorization callback URL" (URL de llamada de vuelta de autorización del usuario), escribe lo siguiente, reemplazando <application-server-url> con la URL del servidor de aplicaciones.

    <application-server-url>/Public/applogin
    

    Campo llamada de vuelta de autorización del usuario

  9. En "Setup URL" (configurar URL), escribe <application-server-url>/public/setup.

    Campo de configuración de URL

  10. En "Webhook URL" (URL de webhook), escribe <application-server-url>/webhooks.

    Campo de URL de webhook

  11. En "Secreto de webhook", escribe un secreto y luego graba el secreto para una referencia posterior.

    Campo secreto de webhook

  12. En "Permissions" (permisos), usa los menús desplegables y configura los siguientes permisos para la app.

    • Repositorio:
      • Contenido: De solo lectura
      • Metadatos: De solo lectura
      • Solicitudes de extracción: De solo lectura
      • Estados de confirmación: De solo lectura
    • Organización:
      • Miembros: De solo lectura
      • Proyectos: De solo lectura

    Menús desplegables de permisos

  13. En "Subscribe to Events" (suscribirse a eventos), selecciona:

    • Miembro
    • Solicitud de extracción
    • Subir
    • Repositorio
    • Equipo
      Casillas de verificación para suscribirse a eventos
  14. Para habilitar el App GitHub para acceder a los datos de cualquier usuario u organización en tu instancia de servidor de GitHub Enterprise, en "¿Dónde puede App GitHub ser instalado? ", selecciona Cualquier cuenta.

    Botones de opción para habilitar el acceso a cualquier cuenta

  15. Haz clic en Create (crear) App GitHub.

    Botón crear una app de GitHub

  16. Revisa la configuración de tu app.

  17. En "Private Keys" (claves privadas), haz clic en Generar una clave privada.

    Genera un botón de llave privada

  18. Guarda el archivo PEM resultante para una referencia posterior.

  19. Anota la siguiente información acerca de tu app para una referencia posterior.

    • ID de app
    • ID de cliente
    • Secreto del cliente
    • Llave privada
    • Secreto de webhook

Instalar GitHub Insights

  1. Desde el servidor de la aplicación, navega hasta el último lanzamiento de GitHub Insights en la Página de lanzamientos para github/insights-releases.
  2. Para descargar el último lanzamiento, debajo de "Activos", da clic en insights-VERSION.tar.gz.
    Activo de instalación
  3. Descomprime el directorio.
  4. Ejecuta el script del shell Install.sh.
  5. Para habilitar SSL, ingresa el certificado SSL (.crt/.cer/.pem). Si no quieres habilitar SSL, déjalo en blanco.
  6. Si eliges habilitar SSL, ingresa la llave SSL (.key). De lo contrario, déjalo en blanco.
  7. Ingresa el nombre del host, el cual es la misma URL que utilizas para el servidor de la aplicación cuando creas la App GitHub.
  8. La instalación tardará unos minutos en ejecutarse. Una vez que esté completo, verás un mensaje impreso en el terminal.
    Installation complete
    Run /opt/insights/scripts/start.sh to start GitHub Insights
    
  9. Para iniciar con GitHub Insights, ejecuta el script del shell /opt/insights/scripts/start.sh.
  10. Si es la primera vez que inicias GitHub Insights, el script tomará algunos minutos en ejecutarse. Una vez que esté completo, verás un mensaje impreso en el terminal.
    GitHub Insights is running!
    

Configurar GitHub Insights

Para configurar GitHub Insights para conectarse a Servidor de GitHub Enterprise, debes proporcionar la información que grabaste en los pasos anteriores.

  1. En tu navegador, desplázate hasta <application-server-url>/setup.
  2. Debajo de "URL de la API de GitHub", teclea la URL que utilizas para acceder a GitHub Enterprise.
    Campo de URL de la API de GitHub Enterprise
  3. Debajo de "Licencia de GitHub Insights", da clic en "Escoger Archivos", y luego carga tu archivo de licencia de GitHub Enterprise.
    Botón de escoger archivos
  4. Debajo de "App ID", teclea la ID de la App de tu App GitHub, la cual grabaste cuando creaste dicha app.
    Campo de App ID
  5. Debajo de "ID de Cliente", teclea la ID de cliente de tu App GitHub, la cual grabaste cuando creaste la app.
    Campo de ID de Cliente
  6. Debajo de "Secreto de Cliente", teclea el secreto del cliente de tu App GitHub, el cual grabaste cuando creaste la app.
    Campo de secreto de cliente
  7. Debajo de "Llave Privada", teclea la llave privada de tu App GitHub, la cual se contiene en el archivo PEM que descargaste mientras creabas la app.
    Campo de llave privada
  8. Debajo de "Secretod e Webhook", teclea el secreto de webhook de tu App GitHub, el cual grabaste cuando la creaste.
    Campo secreto de webhook
  9. Si no proporcionaste un certificado SSL durante la instalación, selecciona Saltar Verificación de Certificado SSL.
    Casilla de saltar verificación de certificado SSL
  10. Haz clic en Submit (enviar).
  11. Haz clic en Log in with (inicia sesión con) GitHub.
  12. Para autorizar el App GitHub y acceder a GitHub Insights, haz clic en Authorize (autorizar) App GitHub.

Leer más