Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. 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.

Tablero de administración del sitio

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

Para acceder al tablero, en la esquina superior derecha de cualquier página, haz clic en . Icono de cohete para acceder a la configuración de administrador del sitio

Aquí puedes iniciar la Consola de administración para administrar las configuraciones del aparato virtual como el dominio, la autenticación y SSL.

Consola de administración

Aquí puedes iniciar la Consola de administración para administrar las configuraciones del aparato virtual como el dominio, la autenticación y SSL.

Explorar

Los datos para la página de tendencia de GitHub se calculan en lapsos de tiempo diarios, semanales y mensuales para ambos repositorios y programadores. Puedes ver cuándo estos datos fueron almacenados en caché por última vez y poner en cola las tareas nuevas de cálculo de tendencia desde la sección Explore (Explorar).

Registro de auditoría

GitHub Enterprise Server mantiene un registro continuo de las acciones auditadas que puedes consultar.

Por defecto, el registro de auditoría te muestra una lista de todas las acciones auditadas en orden cronológico reverso. Puedes filtrar esta lista al ingresar pares de valores clave en el casillero de texto de Query (Consulta) y después hacer clic en Search (Buscar), como se explicó en "Buscar el registro de auditoría."

Para obtener más información acerca de las bitácoras de auditoria en general, consulta "Bitácoras de Auditoría". Para encontrar una lista completa de las acciones auditadas, consulta la sección "Acciones auditadas".

Informes

Si necesitas obtener información sobre los usuarios, organizaciones y repositorios en tu instancia de GitHub Enterprise Server, comúnmente extraerías datos JSON a través de 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. Este tablero de administración del sitio ofrece una sección de Reports (Informes) como una alternativa, haciendo que sea fácil descargar informes CSV con la mayoría de la información que probablemente necesites para los usuarios, las organizaciones y los repositorios.

Específicamente, puedes descargar informes CSV que enumeren a

  • todos los usuarios
  • todos los usuarios que han estado activos dentro del último mes
  • todos los usuarios que han estado inactivos durante un mes o más
  • 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 utilizar un token de acceso personal con alcance de site_admin. Para obtener más información, consulta la sección "Crear un token de acceso personal".

Por ejemplo, así es como descargarías el informe "todos los usuarios" utilizando cURL:

curl -L -u username:token http(s)://hostname/stafftools/reports/all_users.csv

Para acceder a otros informes mediante programación, reemplaza all_users con 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. Puedes utilizar una contraseña o un token de OAuth con el alcance site_admin en lugar de la contraseña.

Informes del usuario

ClaveDescripción
created_at (creado en)Cuá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
correo electrónicoDirección principal de correo electrónico de la cuenta
rolSi 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
idID de la organización
created_at (creado en)Cuándo se creó la organización
loginNombre de inicio de sesión de la organización
correo electrónicoDirección principal de correo electrónico de la organización
ownersCantidad de propietarios de la organización
membersCantidad de miembros de la organización
equiposCantidad 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_at (creado en)Cuá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
name (nombre)Nombre del repositorio
visibilidadSi 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

Indexar

Las funciones de búsqueda de código de GitHub son propulsadas por ElasticSearch. Esta sección del tablero de administración del sitio muestra el estado actual de tu agrupación de ElasticSearch y brinda diversas herramientas para controlar el comportamiento de búsqueda e indexación. Estas herramientas están separadas en las siguientes tres categorías.

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

Reparación del índice de búsqueda de código

Esto controla cómo se repara el índice de búsqueda de código. Puedes

  • habilitar o inhabilitar tareas de reparación de índices
  • comenzar una nueva tarea de reparación de índice
  • restablecer todos los estados de reparación de índices

GitHub Enterprise utiliza tareas de reparación para compaginar el estado del índice de búsqueda con los datos almacenados en una base de datos (propuestas, solicitudes de extracción, repositorios y usuarios) y los datos almacenados en los repositorios de Git (código fuente). Esto sucede cuando

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

En otras palabras, las tareas de reparación se inician según se necesiten y se ejecutan en segundo plano, no están programados por los administradores del sitio de ningún modo.

Además, 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.

Una barra de progreso muestra el estado actual de la tarea de reparación a través de todos sus trabajadores en segundo plano. 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. No te preocupes sobre el valor que se muestra en la barra de progreso después de que una tarea de reparación se haya completado: ya que muestra la diferencia entre la compensación de reparación y el ID del registro más alto en la base de datos, disminuirá a medida que se agreguen más repositorios a tu instancia de GitHub Enterprise Server incluso aquellos repositorios que están de hecho indexados.

Puedes comenzar una nueva tarea de reparación de índice de búsqueda de código en cualquier momento. Utilizará una CPU única ya que compagina el índice de búsqueda con la base de datos y los datos del repositorio de Git. Para minimizar los efectos que esto tendrá en el desempeño de I/O y reducir las posibilidades de que las operaciones queden inactivas, trata de ejecutar una tarea de reparación durante las horas valle en primer lugar. Controla las cargas promedio de tu sistema y el uso de tu CPU con una herramienta como top; si no notas cambios significativos, debería ser seguro ejecutar una tarea de reparación de índice también durante las horas pico.

Reparación de índice de propuestas

Esto controla de qué manera se repara el índice de propuestas. Puedes

  • habilitar o inhabilitar tareas de reparación de índices
  • comenzar una nueva tarea de reparación de índice
  • restablecer todos los estados de reparación de índices

Inicios de sesión reservados

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

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

  • admin
  • empresa
  • login
  • staff
  • asistencia

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.

Todos los usuarios

Aquí puedes ver todos los usuarios que han sido suspendidos en tu instancia de servidor de GitHub Enterprise, e iniciar una auditoría clave de SSH.

Repositorios

Es una lista de los repositorios en tu instancia de GitHub Enterprise Server. Puedes hacer clic en un nombre de repositorio y acceder a las funciones para administrar el repositorio.

Todos los usuarios

Aquí puedes ver a todos los usuarios en tu instancia de GitHub Enterprise Server e iniciar una auditoría de llaves de SSH.

Administrador del sitio

Aquí puedes ver todos los administradores en tu instancia de GitHub Enterprise Server, e iniciar una auditoría clave en SSH.

Usuarios inactivos

Aquí puedes ver y suspender todos los usuarios inactivos en tu instancia de GitHub Enterprise Server. Una cuenta de usuario se considera inactiva ("dormant") cuando:

  • Ha existido durante más tiempo del umbral de inactividad que está establecido para tu instancia de GitHub Enterprise Server.
  • No ha generado ninguna actividad dentro de ese período.
  • No es un administrador del sitio.

El umbral de inactividad es cuánto tiempo debe estar inactivo un usuario para considerarse como inactivo. El umbral de inactividad predeterminado es de 90 días, sin embargo, puedes personalizar este umbral para tu instancia de GitHub Enterprise Server. Para obtener más información, consulta "Administrar usuarios inactivos."

Usuarios suspendidos

Aquí puedes ver todos los usuarios que han sido suspendidos en tu instancia de GitHub Enterprise Server, e iniciar una auditoría clave de SSH.