Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Tableau de bord d’administration de site

Vous pouvez utiliser le tableau de bord d’administration du site pour gérer les utilisateurs, les organisations et les dépôts dans votre entreprise directement dans GitHub Enterprise Server.

Pour accéder au tableau de bord, dans l’angle supérieur droit de n’importe quelle page, cliquez sur . Icône de fusée donnant accès aux paramètres d’administration de site

Consultez cette section du tableau de bord d’administration de site pour rechercher des utilisateurs et des dépôts et pour interroger le journal d’audit.

Management Console

Ici, vous pouvez lancer la Management Console pour gérer les paramètres de l’appliance virtuelle comme le domaine, l’authentification et SSL.

Explorer

Les données relatives à la page des tendances de GitHub sont calculées pour des périodes d’une journée, d’une semaine et d’un mois pour les dépôts et les développeurs. Vous pouvez voir à quel moment ces données ont été mises en cache pour la dernière fois et mettre en file d’attente de nouveaux travaux de calcul de tendances à partir de la section Explorer.

Journal d’audit

GitHub Enterprise Server tient à jour un journal des actions auditées que vous pouvez interroger.

Par défaut, le journal d’audit affiche une liste de toutes les actions auditées dans un ordre chronologique inversé. Vous pouvez filtrer cette liste en entrant des paires clé-valeur dans la zone de texte Requête, puis en cliquant sur Rechercher, comme expliqué dans « Recherche dans le journal d’audit de votre entreprise ».

Pour plus d’informations sur la journalisation d’audit en général, consultez « À propos du journal d’audit de votre entreprise ». Pour obtenir la liste complète des actions auditées, consultez « Événements du journal d’audit pour votre entreprise ».

Rapports

Si vous avez besoin d’obtenir des informations sur les utilisateurs, les organisations et les dépôts de your GitHub Enterprise Server instance, vous pouvez être tenté d’extraire des données JSON via l’API GitHub. Malheureusement, vous n’êtes pas assuré d’en tirer toutes les données souhaitées et elle demande un certain bagage technique. Le tableau de bord d’administration de site propose une alternative avec sa section Rapports, d’où vous pouvez facilement télécharger des rapports CSV contenant la plupart des informations dont vous pouvez avoir besoin à propos des utilisateurs, des organisations et des dépôts.

Plus précisément, vous pouvez télécharger des rapports CSV qui listent

  • tous les utilisateurs
  • tous les utilisateurs actifs
  • tous les utilisateurs dormants
  • tous les utilisateurs qui ont été suspendus
  • toutes les organisations
  • tous les dépôts

Vous pouvez aussi accéder à ces rapports par programmation via l’authentification HTTP standard avec un compte d’administrateur de site. Vous devez utiliser un personal access token avec l’étendue site_admin. Pour plus d’informations, consultez « Création d’un personal access token ».

Par exemple, voici comment télécharger le rapport « tous les utilisateurs » à l’aide d’une commande curl :

curl -L -u USERNAME:TOKEN http(s)://HOSTNAME/stafftools/reports/all_users.csv

Pour accéder aux autres rapports par programmation, remplacez all_users par active_users, dormant_users, suspended_users, all_organizations ou all_repositories.

Remarque : La demande initiale curl retourne une réponse HTTP 202 si aucun rapport mis en cache n’est disponible ; un rapport est généré en arrière-plan. Vous pouvez envoyer une deuxième demande pour télécharger le rapport. Vous pouvez utiliser un mot de passe ou un jeton OAuth avec l’étendue site_admin à la place d’un mot de passe.

Rapports utilisateur

CléDescription
created_atDate/heure de création du compte d’utilisateur (horodatage ISO 8601)
idID de compte de l’utilisateur ou de l’organisation
loginNom de connexion du compte
emailAdresse e-mail principale du compte
roleIndique si le compte est de type administrateur ou utilisateur ordinaire
suspended?Indique si le compte a été suspendu
last_logged_ipDernière adresse IP à s’être connectée au compte
reposNombre de dépôts dont le compte est propriétaire
ssh_keysNombre de clés SSH inscrites au niveau du compte
org_membershipsNombre d’organisations auxquelles le compte appartient
dormant?Indique si le compte est dormant
last_activeDate/heure auxquelles le compte a été actif pour la dernière fois (horodatage ISO 8601)
raw_loginInformations de connexion brutes (au format JSON)
2fa_enabled?Indique si l’utilisateur a activé l’authentification à 2 facteurs

Rapports d’organisation

CléDescription
idID d’organisation
created_atDate/heure de création de l’organisation
loginNom de connexion de l’organisation
emailAdresse e-mail principale de l’organisation
ownersNombre de propriétaires de l’organisation
membersNombre de membres de l’organisation
teamsNombre d’équipes de l’organisation
reposNombre de dépôts de l’organisation
2fa_required?Indique si l’organisation exige une authentification à 2 facteurs

Rapports de dépôt

CléDescription
created_atDate/heure de création du dépôt
owner_idID du propriétaire du dépôt
owner_typeIndique si le dépôt est la propriété d’un utilisateur ou d’une organisation
owner_nameNom du propriétaire du dépôt
idID du dépôt
nameNom du dépôt
visibilityIndique si le dépôt est public ou privé
readable_sizeTaille du dépôt dans un format compréhensible
raw_sizeTaille du dépôt sous forme de nombre
collaboratorsNombre de collaborateurs dans le dépôt
fork?Indique si le dépôt est une duplication (fork)
deleted?Indique si le dépôt a été supprimé

Indexation

Les fonctionnalités de recherche de GitHub sont basées sur la technologie Elasticsearch. Cette section du tableau de bord d’administration de site vous montre l’état actuel de votre cluster Elasticsearch et vous propose plusieurs outils permettant de contrôler le comportement de la recherche et de l’indexation.

Pour plus d’informations sur la recherche de code, consultez « Recherche d’informations sur GitHub ». Pour plus d’informations sur Elasticsearch, consultez le site web d’Elasticsearch.

Remarque : Dans le cadre d’une utilisation normale, les administrateurs de site n’ont pas besoin de créer de nouveaux index ni de planifier des travaux de réparation. Dans le cadre d’une assistance, GitHub Support peut vous demander d’exécuter un travail de réparation.

Gestion des index

GitHub Enterprise Server rapproche l’état de l’index de recherche et les données de l’instance automatiquement et régulièrement.

  • Problèmes, demandes de tirage, dépôts et utilisateurs dans la base de données
  • Dépôts Git (code source) sur disque

Votre instance utilise des travaux de réparation pour rapprocher les données et planifier un travail de réparation en arrière-plan lorsque les événements suivants se produisent.

  • Un index de recherche est créé.
  • Des données manquantes doivent être provisionnées.
  • D’anciennes données de recherche doivent être mises à jour.

Vous pouvez créer un index ou cliquer sur un index existant dans la liste afin de le gérer. Vous pouvez effectuer les opérations suivantes sur un index.

  • Rendre l’index recherchable.
  • Rendre l’index accessible en écriture.
  • Mettre à jour l’index.
  • Supprimer l’index.
  • Réinitialiser l’état de réparation de l’index.
  • Démarrer un nouveau travail de réparation d’index.
  • Activer ou désactiver les travaux de réparation d’index.

Une barre de progression affiche l’état actuel d’un travail de réparation pour l’ensemble des Workers en arrière-plan. Cette barre correspond à la différence en pourcentage du décalage de réparation avec l’ID d’enregistrement le plus élevé dans la base de données. Vous pouvez ignorer la valeur affichée dans la barre de progression une fois que la tâche de réparation est terminée. La barre de progression montre la différence entre le décalage de réparation et l’ID d’enregistrement le plus élevé dans la base de données. Elle diminuera à mesure que d’autres dépôts seront ajoutés à your GitHub Enterprise Server instance, même si ces dépôts sont réellement indexés.

Pour limiter les effets sur le niveau de performance en E/S et réduire les risques d’expiration des opérations, exécutez un travail de réparation pendant les heures creuses. Un seul processeur est utilisé pendant que le travail rapproche l’index de recherche et les données de la base de données et du dépôt Git. Monitorez les moyennes de charge et l’utilisation processeur de votre système avec un utilitaire comme top. Si vous ne remarquez aucune augmentation significative de la consommation des ressources, cela signifie que vous pouvez sans problème exécuter un travail de réparation d’index pendant les heures de pointe.

Les travaux de réparation utilisent un « décalage de réparation » pour la parallélisation. Il s’agit d’un décalage dans la table de base de données pour l’enregistrement faisant l’objet d’un rapprochement. Plusieurs travaux en arrière-plan peuvent synchroniser le travail en fonction de ce décalage.

L’objectif est ici de vous permettre d’activer ou de désactiver les opérations de recherche et d’indexation dans le code source.

Connexions réservées

Certains mots sont réservés à une utilisation interne dans your GitHub Enterprise Server instance, ce qui signifie que ces mots ne peuvent pas être utilisés comme noms d’utilisateurs.

Voici quelques exemples de mots réservés :

  • admin
  • enterprise
  • login
  • staff
  • support

Pour obtenir la liste complète des mots réservés, accédez à « Connexions réservées » dans le tableau de bord d’administration de site.

Advanced Security Committers

Vous pouvez voir le nombre de committeurs actifs qui utilisent actuellement des sièges pour GitHub Advanced Security, et vous pouvez calculer le nombre de sièges supplémentaires qui seraient utilisé(e)s si vous activiez GitHub Advanced Security pour d’autres organisations et dépôts.

Sous « Nombre actuel de validateurs actifs », vous pouvez voir le nombre de validateurs actifs des dépôts sur lesquels GitHub Advanced Security est activée. Il s’agit du nombre de licences sièges actuellement utilisé(e)s.

Sous « Nombre maximum de validateurs sur l’ensemble de l’instance », vous pouvez voir le nombre de validateurs actifs utilisés dans tous les dépôts de votre entreprise. Il s’agit du nombre de sièges qui seraient utilisé(e)s si vous activiez GitHub Advanced Security pour chaque dépôt de votre entreprise.

Sous « Calculer les commiteurs avancés supplémentaires », vous pouvez calculer le nombre de sièges supplémentaires qui seront utilisé(e)s si vous activez GitHub Advanced Security pour des organisations et des dépôts spécifiques. Sous « Organisations et dépôts », entrez ou collez une liste d’organisations et de dépôts, avec une organisation ou un dépôt par ligne.

example-org
octo-org/octo-repo

Le résultat indique le nombre de sièges supplémentaires qui seraient utilisé(e)s si vous activiez GitHub Advanced Security pour ces organisations et dépôts.

Pour plus d’informations sur la facturation de la Advanced Security, consultez « À propos de la Advanced Security ».

Vue d’ensemble de l’entreprise

Consultez cette section du tableau de bord d’administration de site pour gérer les organisations, les personnes, les stratégies et les paramètres.

Référentiels

Il s’agit de la liste des dépôts sur your GitHub Enterprise Server instance. Vous pouvez cliquer sur un nom de dépôt et accéder à des fonctions permettant d’administrer le dépôt.

tous les utilisateurs

Ici, vous pouvez voir tous les utilisateurs de your GitHub Enterprise Server instance et lancer un audit de clé SSH.

Administrateurs de site

Ici, vous pouvez voir tous les administrateurs de your GitHub Enterprise Server instance et lancer un audit de clé SSH.

Utilisateurs dormants

Ici, vous pouvez voir et suspendre tous les utilisateurs inactifs sur your GitHub Enterprise Server instance. Un compte d’utilisateur est considéré comme inactif (« dormant ») dans les cas suivants :

  • Il a dépassé le seuil de dormance défini pour your GitHub Enterprise Server instance.
  • Il n’a généré aucune activité au cours de cette période.
  • Il n’est pas administrateur de site.

Le seuil de repos est la durée pendant laquelle un utilisateur doit être inactif pour être considéré comme étant en sommeil. Le seuil de repos par défaut est de 90 jours, mais vous pouvez le personnaliser pour your GitHub Enterprise Server instance. Pour plus d’informations, consultez « Gestion des utilisateurs dormants ».

Utilisateurs suspendus

Ici, vous pouvez voir tous les utilisateurs qui ont été suspendus sur your GitHub Enterprise Server instance et lancer un audit de clé SSH.