Skip to main content

Esta versión de GitHub Enterprise Server se discontinuará el 2024-03-07. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener rendimiento mejorado, seguridad mejorada y nuevas características, actualice a la versión más reciente de GitHub Enterprise Server. Para obtener ayuda con la actualización, póngase en contacto con el soporte técnico de GitHub Enterprise.

Tablero de administración del sitio

Puedes utilizar el tablero administrativo del sitio para administrar usuarios, organizaciones y repositorios en tu instancia de GitHub Enterprise Server.

Para acceder al panel, en la esquina superior derecha de cualquier página, haz clic en .

Explorar

Los datos de la página de tendencias de GitHub se calculan en intervalos de tiempo diarios, semanales y mensuales para los repositorios y los desarrolladores. Puede ver cuándo se almacenaron en caché por última vez estos datos y poner en cola nuevos trabajos de cálculo de tendencias en la sección Explore (Explorar).

Informes

Si necesitas obtener información sobre los usuarios, las organizaciones y los repositorios de la tu instancia de GitHub Enterprise Server, normalmente capturarías los datos JSON mediante la API de GitHub. Lamentablemente, es posible que la API no proporcione todos los datos que deseas y se requiera algo de conocimiento técnico para usarla. El panel de administración del sitio ofrece una sección Reports (Informes) como alternativa, la cual facilita la descarga de informes CSV con gran parte de la información que probablemente necesite para los usuarios, las organizaciones y los repositorios.

Específicamente, puedes descargar informes CSV que enumeren a

  • todos los usuarios
  • todos los usuarios activos
  • todos los usuarios inactivos
  • todos los usuarios que han sido suspendidos
  • todas las organizaciones
  • todos los repositorios

También puedes acceder a estos informes mediante programación a través de una autenticación estándar de HTTP con una cuenta de administrador del sitio. Debes usar un personal access token con el ámbito site_admin. Para obtener más información, vea «Administración de tokens de acceso personal».

Por ejemplo, así es como descargarías el informe "todos los usuarios" en un comando curl:

curl --remote-name \
     --location \
     --user 'USERNAME:TOKEN' \
     http(s)://HOSTNAME/stafftools/reports/all_users.csv

Para acceder a los demás informes mediante programación, reemplace all_users por active_users, dormant_users, suspended_users, all_organizations o all_repositories.

Nota: La solicitud curl inicial devolverá una respuesta 202 HTTP si no hay informes en caché disponibles; se generará un informe en segundo plano. Puedes enviar una segunda solicitud para descargar el informe. Puede usar una contraseña o un token de OAuth con el ámbito site_admin en lugar de una contraseña.

Informes del usuario

ClaveDescripción
created_atCuándo fue creada la cuenta de usuario (como una marca de tiempo ISO 8601)
idID de la cuenta para el usuario o la organización
loginNombre de inicio de sesión de la cuenta
emailDirección principal de correo electrónico de la cuenta
roleSi la cuenta es de un usuario administrador o de un usuario común
suspended?Si la cuenta ha sido suspendida
last_logged_ipLa dirección IP más reciente que se registró en la cuenta
reposCantidad de repositorios que posee la cuenta
ssh_keysCantidad de claves SSH registradas en la cuenta
org_membershipsCantidad de organizaciones a las que pertenece la cuenta
dormant?Si la cuenta está inactiva
last_activeCuándo la cuenta estuvo activa por última vez (como una marca de tiempo ISO 8601)
raw_loginInformación de inicio de sesión sin procesar (en formato JSON)
2fa_enabled?Si el usuario ha habilitado autenticación de dos factores

Informes de la organización

ClaveDescripción
idIdentificador de la organización
created_atCuándo se creó la organización
loginNombre de inicio de sesión de la organización
emailDirección principal de correo electrónico de la organización
ownersCantidad de propietarios de la organización
membersCantidad de miembros de la organización
teamsCantidad de equipos de la organización
reposCantidad de repositorios de la organización
2fa_required?Si la organización requiere autenticación de dos factores

Informes del repositorio

ClaveDescripción
created_atCuándo fue creado el repositorio
owner_idID del propietario del repositorio
owner_typeSi el repositorio es propiedad de un usuario o de una organización
owner_nameNombre del propietario del repositorio
idID del repositorio
nameNombre del repositorio
visibilitySi el repositorio es público o privado
readable_sizeEl tamaño del repositorio en un formato legible
raw_sizeTamaño del repositorio como un número
collaboratorsCantidad de colaboradores del repositorio
fork?Si el repositorio es una bifurcación
deleted?Si el repositorio ha sido borrado

Indización

Las características de búsqueda de GitHub se basan en la tecnología ElasticSearch. Esta sección del tablero de administración del sitio muestra el estado actual de tu cluster de ElasticSearch y brinda diversas herramientas para controlar el comportamiento de búsqueda e indexación.

Para obtener más información sobre la búsqueda de código, consulta "Búsqueda en la documentación de GitHub". Para más información sobre Elasticsearch, consulta el sitio web de Elasticsearch.

Nota: En uso normal, los administradores del sitio no necesitan crear nuevos índices ni programar trabajos de reparación. Para solucionar problemas u otros fines de soporte técnico, Soporte de GitHub puede indicarte que ejecutes un trabajo de reparación.

Administración de índices

GitHub Enterprise Server reconcilia el estado del índice de búsqueda con los datos de la instancia de forma automática y periódica.

  • Propuestas, solicitudes de incorporación de cambios, repositorios y usuarios en la base de datos
  • Repositorios de Git (código fuente) en disco

La instancia usa trabajos de reparación para conciliar los datos y programa un trabajo de reparación en segundo plano cuando se producen los siguientes eventos.

  • Se crea un nuevo índice de búsqueda;
  • faltan datos que se deben reponer; o
  • los datos de búsqueda antiguos deben ser actualizados.

Puedes crear un nuevo índice o hacer clic en un índice existente en la lista para administrar el índice. Puedes realizar las siguientes operaciones en un índice.

  • Haz que el índice se pueda buscar.
  • Haz que el índice se pueda escribir.
  • Actualiza el índice.
  • Elimina el índice.
  • Restablece el estado de reparación del índice.
  • Comienza una nueva tarea de reparación de índice.
  • Habilita o inhabilita tareas de reparación de índices.

Una barra de progreso muestra el estado actual de la tarea de reparación a través de todos sus trabajadores en segundo plano. La barra es la diferencia de porcentaje de la compensación de reparación con el ID de registro más alto en la base de datos. Puedes omitir el valor que se muestra en la barra de progreso después de que se haya completado un trabajo de reparación. La barra de progreso muestra la diferencia entre la compensación de reparación y el identificador de registro más alto de la base de datos. Además, este valor disminuirá a medida que se agreguen más repositorios a la tu instancia de GitHub Enterprise Server, incluso aunque esos repositorios estén indexados.

Para minimizar los efectos que esto tendrá en el desempeño de E/S y reducir las posibilidades de que las operaciones queden inactivas, trata de ejecutar una tarea de reparación durante las horas de poca actividad. A medida que el trabajo reconcilia el índice de búsqueda con la base de datos de Git y los datos del repositorio, se usará una CPU. Supervisa los promedios de carga del sistema y el uso de CPU con una utilidad como top. Si no observas ningún aumento significativo en el consumo de recursos, también debe ser seguro ejecutar un trabajo de reparación de índices durante las horas de más actividad.

Las tareas de reparación utilizan una "compensación de reparación" para la paralelización. Esto es una compensación dentro de la tabla de base de datos para el registro que se está compaginando. Múltiples tareas en segundo plano pueden sincronizar el trabajo en base a esta compensación.

Esto te permite habilitar o deshabilitar tanto las operaciones de búsqueda como de indexación en el código fuente.

Inicios de sesión reservados

Algunas palabras se reservan para uso interno en la tu instancia de GitHub Enterprise Server, lo cual significa que estas no pueden usarse como nombres de usuario.

Por ejemplo, las siguientes palabras, entre otras, son reservadas:

  • admin
  • enterprise
  • login
  • staff
  • support

Para una lista completa de palabras reservadas, navega a la sección de "Inicios de sesión reservados" en el tablero de administrador de sitio.